# Get outcome token holders

GET /api/v1/market-data/holders

## Get outcome token holders

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

```json
{"openapi":"3.1.1","info":{"title":"FortyTwo Read API","version":"1.0"},"tags":[{"description":"GET /api/v1/market-data/holders","name":"get-outcome-token-holders"}],"servers":[{"url":"https://rest.ft.42.space/"}],"paths":{"/api/v1/market-data/holders":{"get":{"description":"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.","tags":["get-outcome-token-holders"],"summary":"Get outcome token holders","parameters":[{"schema":{"type":"string"},"description":"Market contract address","name":"market","in":"query","required":true},{"schema":{"type":"string"},"description":"Outcome token ID","name":"token_id","in":"query","required":true},{"schema":{"type":"integer"},"description":"Page size (default 20, max 100)","name":"limit","in":"query"},{"schema":{"type":"integer"},"description":"Pagination offset","name":"offset","in":"query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/api.PaginatedResponse-handler_HolderEntry"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/api.ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/api.ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/api.ErrorResponse"}}}}}}}},"components":{"schemas":{"api.PaginatedResponse-handler_HolderEntry":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/handler.HolderEntry"}},"pagination":{"$ref":"#/components/schemas/api.Pagination"}}},"handler.HolderEntry":{"type":"object","properties":{"amount":{"type":"number"},"avgPrice":{"type":"number"},"currentPrice":{"type":"number"},"heldQuantity":{"type":"number"},"mintedQuantity":{"type":"number"},"outcomeName":{"type":"string"},"outcomeSymbol":{"type":"string"},"payout":{"type":"number"},"realizedPnl":{"type":"number"},"unrealizedPnl":{"type":"number"},"userAddress":{"type":"string"}}},"api.Pagination":{"type":"object","properties":{"hasMore":{"type":"boolean"},"totalResults":{"type":"integer"}}},"api.ErrorResponse":{"type":"object","properties":{"code":{"type":"integer"},"error":{"type":"string"},"message":{"type":"string"}}}}}}
```