Skip to main content
GET
GET /v1/pool/trades · 1 credit Trade tape of one market, addressed by pool. Same row shape, badges and filters as /v1/token/trades; the only difference is scope - exactly this pool. Each trade carries a stable id, timestamp (ms), price, size, side, maker, badges and tx hash.
Pagination. Each page is bounded by limit and by a scan window over the tape: a page can hold fewer than limit rows while meta.hasMore is true. Keep passing meta.nextCursor until hasMore is false; cursors never skip or repeat a trade, and hasMore: false means the requested history is fully served.
Every row carries poolAddress, the market it happened on: here always this pool, the same field the token-wide tape uses to tell markets apart. quoteToken is this pool’s quote token (address, symbol, name, decimals), the unit of amountQuote; priceUsd is priced like volumeUsd (meta.usdBasis).
An unknown pool returns 404 (never a silently-empty 200). maker is the trader behind the swap (resolved through relays, solvers and smart accounts, otherwise the transaction sender). feesNative is the total fee paid by the trader for the transaction (gas and priority fee, plus the validator tip on Solana) in the chain’s native unit, null when it is not available for that row. meta.usdBasis states how each volumeUsd was priced: spot on EVM, trade on Solana. isWash is a boolean on Solana and null on EVM. On EVM each row is one swap event (a swap routed through several pools yields one row per pool, sharing txHash); on Solana the legs of a transaction are aggregated per transaction and side. fromAt and toAt are unix milliseconds; a value in seconds is rejected with 400.

Authorizations

Authorization
string
header
required

Your raw API key (not needed on the demo server).

Query Parameters

chain
string
required

Public chain id - evm:<id> or solana.

address
string
required

Pool / pair address (the stable market id on its chain - Uniswap V4 poolIds supported).

maker
string

Filter trades by participant address.

tradeType
Available options:
buy
usdMin
number
Required range: x >= 0
usdMax
number
Required range: x >= 0
nativeMin
number
Required range: x >= 0
nativeMax
number
Required range: x >= 0
tokenAmountMin
number
Required range: x >= 0
tokenAmountMax
number
Required range: x >= 0
fromAt
integer

Unix MILLISECONDS, inclusive lower bound. A value in seconds is rejected (400).

Required range: x >= 0
toAt
integer

Unix MILLISECONDS, inclusive upper bound (at most 7 days ahead). A value in seconds is rejected (400).

Required range: x >= 0
cursor
string

Opaque cursor from meta.nextCursor.

sort
default:desc
Available options:
asc
washFilter

Keep only wash-tagged or only organic transactions (solana only)

Available options:
washOnly
limit
integer
default:100
Required range: 1 <= x <= 500
include
string

CSV opt-ins: traderTxCounts

Response

200

Standard { data, meta } envelope.