TAtatum
Prediction API

Get wallet open-position notional

Changed on

/v4/data/prediction/wallets/{address}/value

50 credits per API call

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.

Platform support

  • Polymarket only. Kalshi wallets return 400.

Filtering

  • market scopes the total to a comma-separated list of condition ids (0x + 64 hex), up to 50 entries. Omit for the wallet-wide total.

Other notes

  • value is rounded to 2 decimal places.
  • user is the lowercased address.
get/v4/data/prediction/wallets/{address}/value

Request

  • Base URL
    https://api.tatum.io
  • URL
    https://api.tatum.io/v4/data/prediction/wallets/{address}/value
  • Auth
    API key in header x-api-key

Path parameters

addressstring required

EVM wallet address — 0x-prefixed, 40 hex characters. Returned lowercased in response payloads. Non-EVM inputs (e.g. Kalshi user identifiers) return 400 from every wallets endpoint.

Example:0x56687bf447db6ffa42ffe2204a05edaa20f55839

Wallet address (0x + 40 hex). Kalshi addresses return 400.

Query parameters

marketstring
Example:0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917

Comma-separated list of condition ids (0x + 64 hex) to scope the total to. Up to 50 entries. Omit for the wallet-wide total.

Response

OK

Example response

{
  "data": {
    "user": "0x56687bf447db6ffa42ffe2204a05edaa20f55839",
    "value": 5421.18
  }
}

Changes