> For the complete documentation index, see [llms.txt](https://hyperliquid-ohlc.gitbook.io/api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hyperliquid-ohlc.gitbook.io/api-docs/rest-api/trades-fills/trades-by-token.md).

# Trades by Token

## Get trades by token with cursor pagination

> Retrieve trades for a specific token across all wallets with cursor-based pagination.

```json
{"openapi":"3.1.0","info":{"title":"BlockLiquidity API Service","version":"1.0.0"},"servers":[{"url":"https://data.blockliquidity.xyz"}],"security":[{"HTTPBearer":[]}],"components":{"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"}},"schemas":{"TradeByTokenResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/MarketTrade"},"type":"array","title":"Data"},"pagination":{"$ref":"#/components/schemas/PaginationInfo"}},"type":"object","required":["data","pagination"],"title":"TradeByTokenResponse"},"MarketTrade":{"properties":{"timestamp":{"type":"integer","title":"Timestamp"},"hash":{"type":"string","title":"Hash"},"tid":{"type":"integer","title":"Tid"},"token":{"type":"string","title":"Token"},"px":{"type":"number","title":"Px"},"sz":{"type":"number","title":"Sz"},"side":{"type":"string","title":"Side"},"buyer":{"type":"string","title":"Buyer"},"seller":{"type":"string","title":"Seller"}},"type":"object","required":["timestamp","hash","tid","token","px","sz","side","buyer","seller"],"title":"MarketTrade"},"PaginationInfo":{"properties":{"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"},"has_more":{"type":"boolean","title":"Has More"},"limit":{"type":"integer","title":"Limit"},"start_timestamp":{"type":"integer","title":"Start Timestamp"},"end_timestamp":{"type":"integer","title":"End Timestamp"}},"type":"object","required":["has_more","limit","start_timestamp","end_timestamp"],"title":"PaginationInfo"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/v1/trades/token/{token}":{"get":{"tags":["Trade Data"],"summary":"Get trades by token with cursor pagination","description":"Retrieve trades for a specific token across all wallets with cursor-based pagination.","operationId":"get_hl_trade_by_token_v1_trades_token__token__get","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"Number of records to return per page","default":30,"title":"Limit"},"description":"Number of records to return per page"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Pagination cursor from previous response","title":"Cursor"},"description":"Pagination cursor from previous response"},{"name":"start_timestamp","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"description":"Start timestamp in Unix epoch milliseconds (subject to subscription limits)","title":"Start Timestamp"},"description":"Start timestamp in Unix epoch milliseconds (subject to subscription limits)"},{"name":"end_timestamp","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"description":"End timestamp in Unix epoch milliseconds","title":"End Timestamp"},"description":"End timestamp in Unix epoch milliseconds"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TradeByTokenResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```