Get outcome token holders

GET /api/v1/market-data/holders

Get outcome token holders

get

Returns a paginated list of all token holders for a single outcome of a given market, excluding the treasury address. For finalised markets, this also includes positions held at the time of resolution. Both market and token_id are required.

Query parameters

marketstringRequired

Market contract address

token_idstringRequired

Outcome token ID

limitintegerOptional

Page size (default 20, max 100)

offsetintegerOptional

Pagination offset

Responses

200

OK

application/json

400

Bad Request

application/json

404

Not Found

application/json

500

Internal Server Error

application/json

get

/api/v1/market-data/holders

HTTPcURLJavaScriptPython

GET /api/v1/market-data/holders?market=text&token_id=text HTTP/1.1
Host: rest.ft.42.space/
Accept: */*

{
  "data": [
    {
      "amount": 1,
      "avgPrice": 1,
      "currentPrice": 1,
      "heldQuantity": 1,
      "mintedQuantity": 1,
      "outcomeName": "text",
      "outcomeSymbol": "text",
      "payout": 1,
      "realizedPnl": 1,
      "unrealizedPnl": 1,
      "userAddress": "text"
    }
  ],
  "pagination": {
    "hasMore": true,
    "totalResults": 1
  }
}