# Get all outcome tokens

GET /api/v1/markets/tokens

## Get all outcome tokens

> Returns a paginated list of all tradeable outcome tokens across markets. Filter by market address, token ID, or outcome index. Supports sorting by price, market cap, or token ID.

```json
{"openapi":"3.1.1","info":{"title":"FortyTwo Read API","version":"1.0"},"tags":[{"description":"GET /api/v1/markets/tokens","name":"get-all-outcome-tokens"}],"servers":[{"url":"https://rest.ft.42.space/"}],"paths":{"/api/v1/markets/tokens":{"get":{"description":"Returns a paginated list of all tradeable outcome tokens across markets. Filter by market address, token ID, or outcome index. Supports sorting by price, market cap, or token ID.","tags":["get-all-outcome-tokens"],"summary":"Get all outcome tokens","parameters":[{"schema":{"type":"string"},"description":"Filter by market address","name":"market_address","in":"query"},{"schema":{"type":"string"},"description":"Filter by token ID","name":"token_id","in":"query"},{"schema":{"type":"integer"},"description":"Filter by outcome index (0-based)","name":"outcome_index","in":"query"},{"schema":{"type":"integer"},"description":"Results per page (default 50, max 500)","name":"limit","in":"query"},{"schema":{"type":"integer"},"description":"Pagination offset (default 0)","name":"offset","in":"query"},{"schema":{"type":"string"},"description":"Sort field: price, market_cap, token_id, outcome_index","name":"order","in":"query"},{"schema":{"type":"boolean"},"description":"Sort ascending (default false = descending)","name":"ascending","in":"query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/api.PaginatedResponse-handler_TokenResponse"}}}},"400":{"description":"Bad Request","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_TokenResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/handler.TokenResponse"}},"pagination":{"$ref":"#/components/schemas/api.Pagination"}}},"handler.TokenResponse":{"type":"object","properties":{"market":{"$ref":"#/components/schemas/handler.TokenMarketResponse"},"marketCap":{"type":"string"},"outcomeIndex":{"type":"integer"},"outcomeName":{"type":"string"},"price":{"type":"string"},"tokenId":{"type":"string"}}},"handler.TokenMarketResponse":{"type":"object","properties":{"marketAddress":{"type":"string"},"question":{"$ref":"#/components/schemas/handler.TokenQuestionResponse"},"slug":{"type":"string"}}},"handler.TokenQuestionResponse":{"type":"object","properties":{"questionId":{"type":"string"},"slug":{"type":"string"},"title":{"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"}}}}}}
```