Skip to main content
GET
Token trades
Newest first. Page back with the next of the previous page as cursor; next is null on the last page. wallet= keeps one wallet’s trades.
  • A row is one wallet’s side of a swap. One transaction can give several rows, also for one wallet: on Solana two wallets that sign it are two rows; a multi-hop swap through the token can be a sell and a buy of the same wallet, and a swap routed through several pools several rows on the same side; on EVM chains a row is one swap log.
  • Rows have no id, and the pages of one walk do not repeat a row. If a list needs a key, use signature + wallet + side + amount; never signature alone, or signature + wallet.
  • side is the side of the token: buy means the wallet received it.
  • quoteAmount and quoteSymbol are the other side of the swap (SOL, USDC, WETH, BNB, …), in whole units.
  • pool and dex can be null: history rows often lack them, and EVM live rows have no dex. volumeUsd, priceUsd, quoteAmount and quoteSymbol can be null on a history row too.
  • The row count does not end the walk: a page can hold fewer rows than limit, even none, and still carry next. A Solana page may also hold more than limit rows, when one transaction alone has more, and the first page may leave out the last half second of trades, which the live channel carries.
  • A Solana page may answer 503 with Retry-After: it cannot be served right now. Ask again after it, with the same cursor.
Live: the trades channel sends the last 100 trades, then every new one.

Authorizations

x-api-key
string
header
required

Path Parameters

chain
string
required

sol, eth, bsc, base or robinhood (or an alias or network id)

Example:

"sol"

address
string
required

Token address (mint or contract)

Example:

"DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"

Query Parameters

limit
integer
default:50

Rows per page; a Solana page may hold more when one transaction alone has more

Required range: x <= 200
cursor
string

The next of the previous page, as given (URL-encoded). Opaque, and its format may change; one the server can no longer honour is a 400: start again from the first page. A cursor that keeps failing while the first page loads: start again from the first page too.

wallet
string

Only this wallet's trades (on Solana, a 32-byte key)

Response

A page of trades

data
object[]
next
string | null