Market Top Holders

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 a market's largest holders — there is no date-range parameter or historical look-back, and positions reflect within the standard live latency.

Get Prediction Market Top Holders

post

Get the largest position holders for a Polymarket prediction market. Positions are computed from on-chain ERC-1155 token transfers on Polygon, with SAFE proxy wallet resolution to identify actual users.

What it helps to answer:

1. Who are the biggest holders in this prediction market?

2. What are the position sizes and entry prices of top holders?

3. What is the unrealized PnL of major positions?

4. Are whales positioned Yes or No?

Authorizations

ApiKeyAuth

apikeystringRequired

API key for authentication

Body

application/json

Request for top holders endpoint.

market_idstring · min: 1 · max: 100Required

Polymarket market ID

Example: 654412

order_byany ofOptional

Sort order

Example: [{"direction":"DESC","field":"position_size"}]

sortany ofOptionalDeprecated

Deprecated: use 'order_by' instead.

Responses

200

Top holder 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/top-holders

HTTPcURLJavaScriptPython

POST /api/v1/prediction-market/top-holders HTTP/1.1
Host: api.nansen.ai
apikey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 118

{
  "market_id": "654412",
  "pagination": {
    "page": 1,
    "per_page": 10
  },
  "order_by": [
    {
      "direction": "DESC",
      "field": "position_size"
    }
  ]
}

{
  "pagination": {
    "page": 1,
    "per_page": 10,
    "is_last_page": true
  },
  "data": [
    {
      "market_id": "654412",
      "outcome_index": 1,
      "address": "0x1234567890abcdef1234567890abcdef12345678",
      "owner_address": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
      "side": "Yes",
      "position_size": 15000,
      "avg_entry_price": 0.45,
      "current_price": 0.52,
      "unrealized_pnl_usd": 1050
    }
  ]
}