---
title: "Get wallet open-position notional"
method: GET
path: "/v4/data/prediction/wallets/{address}/value"
tags: ["Prediction API"]
---

# Get wallet open-position notional

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

/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.

## Path parameters

- `address` string, 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.

## Query parameters

- `market` string

## Response `200`

OK

- PredictionWalletValueResponse — Wallet open-position notional response.
  - `data` PredictionWalletValue, required — Total USD notional of a wallet's currently open positions.
    - `user` string, required — Wallet address (0x + 40 hex, lowercased).
    - `value` number, required — Total USD notional, rounded to 2 decimal places.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
- `403` — Forbidden. The request is authenticated, but it is not possible to perform the operation due to logical error or invalid permissions.
- `500` — Internal server error. There was an error on the server during the processing of the request.

---

[API](https://skmtc.net/tatum/apis/blockchain-data.md) · [All operations](https://skmtc.net/tatum/apis/blockchain-data/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tatum/blockchain-data/versions/8622ee4b8fae/schema)