Trades
GET/v1/token/{mint}/tradesPublic
The trade tape, newest first, keyset-paginated. Pass nextCursor as ?cursor= to page back; optional from/to clip it to a time window.
Path parameters
| Field | Type | Description |
|---|
mintrequired | string | Token mint address (base58). |
Query parameters
| Field | Type | Description |
|---|
limitoptional | number | Trades per page (≤200). default 50 |
cursoroptional | string | The nextCursor from the previous page. |
fromoptional | number (unix sec) | Only trades at or after this time. Lifted to your plan's history floor. |
tooptional | number (unix sec) | Only trades at or before this time. |
networkoptional | mainnet | devnet | Network to read. Devnet returns an empty payload (with a note) until its ingestor lands. default mainnet |
Response fields
| Field | Type | Description |
|---|
trades[].time | number | Block time (unix seconds) — same value the WS trades frame carries. |
trades[].signature | string | The transaction signature (base58). |
trades[].dex | string | Venue: raydium / orca / meteora. |
trades[].side | string | buy or sell. |
trades[].baseAmount / quoteAmount | number | Token and quote-leg sizes (human units). |
trades[].priceUsd / volumeUsd | number | null | Execution price and trade size in USD. |
trades[].signer | string | The wallet (base58). |
trades[].poolAddress | string | The pool the swap hit. |
nextCursor | string | null | Pass as ?cursor= for the next page; null = end. |
windowClamped | boolean | Present (true) when a from/to below your plan's history floor was lifted to the floor. |
indexed | boolean | Present (false) only when the tape is empty because the mint was never indexed. |
note | string | Honest-empty hint (unindexed mint → POST /v1/tokens/register pointer; or the devnet note). |