---
updatedAt: 2026-08-25T15:15:58.000Z
agentTools:
  projectIndex: https://docs.tatum.io/llms.txt
---

# Get wallet open-position notional

<p style='display: none'>/v4/data/prediction/wallets/{address}/value</p>
<p><b>50 credits per API call</b></p>

<p>Total USD notional of a wallet's currently open positions. A single-number
endpoint — useful for sparkline-style summaries and headline KPIs without
paying the cost of pulling the full positions list.</p>

<p><b>Platform support</b></p>
<ul>
<li>Polymarket only. Kalshi wallets return <code>400</code>.</li>
</ul>

<p><b>Filtering</b></p>
<ul>
<li><code>market</code> scopes the total to a comma-separated list of condition
ids (<code>0x</code> + 64 hex), up to 50 entries. Omit for the wallet-wide
total.</li>
</ul>

<p><b>Other notes</b></p>
<ul>
<li><code>value</code> is rounded to 2 decimal places.</li>
<li><code>user</code> is the lowercased address.</li>
</ul>


# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "servers": [
    {
      "url": "https://api.tatum.io"
    }
  ],
  "info": {
    "version": "1.2",
    "title": "Blockchain Data"
  },
  "tags": [
    {
      "name": "Prediction API"
    }
  ],
  "paths": {
    "/v4/data/prediction/wallets/{address}/value": {
      "get": {
        "description": "<p style='display: none'>/v4/data/prediction/wallets/{address}/value</p>\n<p><b>50 credits per API call</b></p>\n\n<p>Total USD notional of a wallet's currently open positions. A single-number\nendpoint — useful for sparkline-style summaries and headline KPIs without\npaying the cost of pulling the full positions list.</p>\n\n<p><b>Platform support</b></p>\n<ul>\n<li>Polymarket only. Kalshi wallets return <code>400</code>.</li>\n</ul>\n\n<p><b>Filtering</b></p>\n<ul>\n<li><code>market</code> scopes the total to a comma-separated list of condition\nids (<code>0x</code> + 64 hex), up to 50 entries. Omit for the wallet-wide\ntotal.</li>\n</ul>\n\n<p><b>Other notes</b></p>\n<ul>\n<li><code>value</code> is rounded to 2 decimal places.</li>\n<li><code>user</code> is the lowercased address.</li>\n</ul>\n",
        "operationId": "GetPredictionWalletValue",
        "parameters": [
          {
            "description": "Wallet address (0x + 40 hex). Kalshi addresses return `400`.",
            "in": "path",
            "name": "address",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/PredictionWalletAddress"
            }
          },
          {
            "description": "Comma-separated list of condition ids (0x + 64 hex) to scope the total to.\nUp to 50 entries. Omit for the wallet-wide total.\n",
            "in": "query",
            "name": "market",
            "schema": {
              "type": "string",
              "example": "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PredictionWalletValueResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "$ref": "#/components/responses/Error400"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "403": {
            "$ref": "#/components/responses/Error403"
          },
          "500": {
            "$ref": "#/components/responses/Error500"
          }
        },
        "security": [
          {
            "X-API-Key": []
          }
        ],
        "x-codeSamples": [],
        "summary": "Get wallet open-position notional",
        "tags": [
          "Prediction API"
        ]
      }
    }
  },
  "components": {
    "securitySchemes": {
      "X-API-Key": {
        "type": "apiKey",
        "name": "x-api-key",
        "in": "header",
        "description": "Your **API key** is used to identify your account & your plan, including the number of API calls per second and total monthly calls you have.\n\nEach key is for individual use only.\n\nIf you don't have a key already you can [Sign up for a Free Tatum account](https://co.tatum.io/signup) to get two keys (testnet and mainnet), allowing up to 5 API calls per second and 1,000,000 Credits.\n\nFor testing purposes, you can use the following key which only works inside docs and has limited functionality (e.g. you cannot create virtual accounts or notification subscriptions with it):\n* t-66a730ccccfd17001c479705-2f597d14ad7543f289a03418\n\nFor more details on limits and plans, [click here](https://docs.tatum.io/docs/plans-limits).\n"
      }
    },
    "responses": {
      "Error400": {
        "description": "Bad Request",
        "content": {
          "application/json": {
            "schema": {
              "properties": {
                "errorCode": {
                  "example": "validation.failed",
                  "description": "validation.failed",
                  "type": "string"
                },
                "message": {
                  "example": "Request validation failed. Please see data for additional information.",
                  "description": "Request validation failed. Please see data for additional information.",
                  "type": "string"
                },
                "statusCode": {
                  "example": 400,
                  "description": "400",
                  "type": "number"
                },
                "data": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "required": [
                      "target"
                    ],
                    "properties": {
                      "target": {
                        "type": "object",
                        "additionalProperties": true,
                        "description": "Request object present in the body of the HTTP request",
                        "example": {
                          "property": 12345
                        }
                      },
                      "value": {
                        "type": "number",
                        "description": "Value of the target object which validation is wrong. Can be of any data type, example here is using type number.",
                        "example": 12345
                      },
                      "property": {
                        "type": "string",
                        "description": "Property name of the target object which validation is wrong",
                        "example": "property1"
                      },
                      "constraints": {
                        "type": "object",
                        "additionalProperties": true,
                        "description": "Object of failed constraints for the target object. Key is the constraint, value is detailed description of the failed constraint.",
                        "example": {
                          "min": "property1 must not be less than 50000"
                        }
                      }
                    }
                  }
                }
              },
              "required": [
                "errorCode",
                "message",
                "statusCode",
                "data"
              ],
              "type": "object"
            }
          }
        }
      },
      "Error401": {
        "description": "Unauthorized. Not valid or inactive subscription key present in the HTTP Header.",
        "content": {
          "application/json": {
            "schema": {
              "oneOf": [
                {
                  "properties": {
                    "errorCode": {
                      "example": "subscription.not.active",
                      "description": "subscription.not.active",
                      "type": "string"
                    },
                    "message": {
                      "example": "Subscription not active anymore.",
                      "description": "Subscription not active anymore.",
                      "type": "string"
                    },
                    "statusCode": {
                      "example": 401,
                      "description": "401",
                      "type": "number"
                    }
                  },
                  "required": [
                    "errorCode",
                    "message",
                    "statusCode"
                  ],
                  "type": "object"
                },
                {
                  "properties": {
                    "errorCode": {
                      "example": "subscription.invalid",
                      "description": "subscription.invalid",
                      "type": "string"
                    },
                    "message": {
                      "example": "Unable to find valid subscription for '${apiKey}'",
                      "description": "Unable to find valid subscription for '${apiKey}'",
                      "type": "string"
                    },
                    "statusCode": {
                      "example": 401,
                      "description": "401",
                      "type": "number"
                    }
                  },
                  "required": [
                    "errorCode",
                    "message",
                    "statusCode"
                  ],
                  "type": "object"
                }
              ]
            }
          }
        }
      },
      "Error403": {
        "description": "Forbidden. The request is authenticated, but it is not possible to perform the operation due to logical error or invalid permissions.",
        "content": {
          "application/json": {
            "schema": {
              "properties": {
                "message": {
                  "example": "Forbidden",
                  "description": "Forbidden",
                  "type": "string"
                },
                "statusCode": {
                  "example": 403,
                  "description": "403",
                  "type": "number"
                }
              },
              "required": [
                "statusCode",
                "message"
              ],
              "type": "object"
            }
          }
        }
      },
      "Error500": {
        "description": "Internal server error. There was an error on the server during the processing of the request.",
        "content": {
          "application/json": {
            "schema": {
              "properties": {
                "message": {
                  "example": "Internal server error",
                  "description": "Internal server error",
                  "type": "string"
                },
                "statusCode": {
                  "example": 500,
                  "description": "500",
                  "type": "number"
                }
              },
              "required": [
                "statusCode",
                "message"
              ],
              "type": "object"
            }
          }
        }
      }
    },
    "schemas": {
      "PredictionWalletAddress": {
        "type": "string",
        "description": "EVM wallet address — `0x`-prefixed, 40 hex characters. Returned lowercased\nin response payloads. Non-EVM inputs (e.g. Kalshi user identifiers) return\n`400` from every wallets endpoint.\n",
        "pattern": "^0x[a-fA-F0-9]{40}$",
        "example": "0x56687bf447db6ffa42ffe2204a05edaa20f55839"
      },
      "PredictionWalletValue": {
        "type": "object",
        "description": "Total USD notional of a wallet's currently open positions.",
        "required": [
          "user",
          "value"
        ],
        "properties": {
          "user": {
            "type": "string",
            "description": "Wallet address (0x + 40 hex, lowercased).",
            "example": "0x56687bf447db6ffa42ffe2204a05edaa20f55839"
          },
          "value": {
            "type": "number",
            "description": "Total USD notional, rounded to 2 decimal places.",
            "example": 5421.18
          }
        }
      },
      "PredictionWalletValueResponse": {
        "type": "object",
        "description": "Wallet open-position notional response.",
        "required": [
          "data"
        ],
        "properties": {
          "data": {
            "$ref": "#/components/schemas/PredictionWalletValue"
          }
        }
      }
    }
  }
}
```