Market Position Details

Data Freshness & Historical Coverage

For data freshness and historical coverage, see Data Coverage by Chain; this endpoint follows it except where noted below.

• Returns a current, point-in-time snapshot of each holder's positions — there is no date-range parameter or historical look-back, and values reflect within the standard live latency.

Get Prediction Market Position Detail

post

Get detailed per-token position data for all holders in a specific prediction market. Includes token balances, entry prices, current prices, and per-token PnL.

What it helps to answer:

1. What are the exact positions of each holder in this market?

2. What is the average entry price vs current price for each position?

3. How much has each token position gained or lost?

Authorizations

ApiKeyAuth

apikeystringRequired

API key for authentication

Body

application/json

Request for position detail endpoint.

market_idstring · min: 1 · max: 100Required

Polymarket market ID

Example: 654412

Responses

200

Position detail data

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

402

Payment Required

application/json

403

Forbidden

application/json

404

Not Found

application/json

422

Unprocessable Content

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

502

Bad Gateway

application/json

503

Service Unavailable

application/json

504

Gateway Timeout

application/json

post/api/v1/prediction-market/position-detail

HTTPcURLJavaScriptPython

POST /api/v1/prediction-market/position-detail HTTP/1.1
Host: api.nansen.ai
apikey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 60

{
  "market_id": "654412",
  "pagination": {
    "page": 1,
    "per_page": 10
  }
}

{
  "pagination": {
    "page": 1,
    "per_page": 10,
    "is_last_page": true
  },
  "data": [
    {
      "address": "text",
      "owner_address": "text",
      "outcome": "Yes",
      "outcome_index": 1,
      "token_id": "text",
      "balance": 1,
      "buy_cost_usd": 1,
      "buy_tokens": 1,
      "sell_proceeds_usd": 1,
      "sell_tokens": 1,
      "avg_entry_price": 1,
      "current_price": 1,
      "unrealized_value_usd": 1,
      "redemption_value_usd": 1,
      "token_pnl_usd": 1,
      "event_id": "text",
      "event_title": "text",
      "market_resolved": true,
      "market_id": "654412"
    }
  ]
}