v1

latestOpenAPI 3.1.02026-07-243035381.4 MB

Prediction API

Get wallet open-position notional

/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

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

Example response

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