Trader signals API

What have the tracked traders been buying and selling?

Buys and sells by leaderboard-ranked traders, newest first, filterable by token, wallet, trader, side and USD size, with the PnL the board reports.

GET/api/external/signals/signals-tracked-trades/{chain}

Get a free API key Try it in the API reference

What it returns

Buys and sells by tracked traders — wallets ranked on public trader leaderboards — on one chain, newest first, filterable by token, wallet, trader, side and minimum USD size. Each row carries the trade and, where the board reports it, the trader's PnL on the position. The same fill reported by two boards is two rows; signals-whos-in merges them per wallet. Paged with cursor.

Chains

Solana SOL
BNB Chain BNB
Ethereum ETH
Base BASE
Robinhood Chain RHC

Request

Send your key in the x-dex-data-key header. Replace each <placeholder> with a real value.

curl -H "x-dex-data-key: $DEXDATA_API_KEY" \
  "https://api.dexdata.io/api/external/signals/signals-tracked-trades/SOL"

Parameters
Parameter	Description
`token` query · string · optional	Only trades in this token.
`wallet` query · string · optional	Only trades by this wallet. PUMP fills on an EVM chain carry no wallet, so filter those by `trader`.
`trader` query · string · optional	Only this trader, as `trader.id` publishes it ("<SOURCE>:<id>"). Not combinable with `source` — the id already names its board.
`side` query · string · optional	Only buys, or only sells.`buysell`
`minUsd` query · number · optional	Only trades of at least this many USD. Trades without a USD figure are left out.
`source` query · string[] · optional	Only the traders ranked by these boards: PUMP, FOMO, KOLSCAN (any case). Repeat the parameter or comma-separate the values. Absent = every board.
`limit` query · integer · optional	Rows per page, 1 to 200.
`cursor` query · string · optional	The `cursor` of the previous page, unchanged, with the same filters. Absent = the first page.
`chain` path · string · required	The chain to query. Served on SOL, BNB, ETH, BASE, RHC; every other chain returns 400.

Response fields

A JSON response. Every field is always present; null means the value could not be established, never zero.

Response fields of What have the tracked traders been buying and selling?
Field	Type	Description
`chain`	string	The chain asked about.
`trades`	object[]	Newest executed first.
`trades[].id`	string	The trade at its source; one fill two boards report is two rows.
`trades[].source`	string	The board that reported it.
`trades[].trader`	object \| null	The tracked trader. null when the row names none.
`trades[].trader.id`	string	The trader, "<SOURCE>:<id>" — the subject `signals-trader` takes.
`trades[].trader.source`	string	The board that tracks the trader.
`trades[].trader.handle`	string \| null	The name the trader goes by on that board. null when not stated.
`trades[].wallet`	string \| null	The wallet that traded. null on a PUMP fill on an EVM chain: it is relayed on chain by a sender shared between traders, so it has no wallet of its own.
`trades[].walletResolution`	string \| null	How the wallet is tied to the trader: "native" (the board ids the trader by it), "confirmed" or "candidate".
`trades[].address`	string	The token traded.
`trades[].side`	string \| null	Buy or sell.
`trades[].usdAmount`	number \| null	The trade size in USD. null when not reported.
`trades[].tokenAmount`	number \| null	Tokens bought or sold, decimal-adjusted. null when not reported.
`trades[].nativeAmount`	number \| null	The size in the chain's native coin. null when not reported.
`trades[].priceUsd`	number \| null	The token price in USD at the trade. null when not reported.
`trades[].marketCapUsd`	number \| null	The token's market cap in USD at the trade. null when not reported.
`trades[].txHash`	string \| null	The transaction.
`trades[].dex`	string \| null	Where it traded, as the board names it. null when not reported.
`trades[].executedAt`	integer \| null	When it executed, unix seconds.
`trades[].observedAt`	integer \| null	When it was recorded, unix seconds.
`trades[].isFirstBuy`	boolean \| null	Whether it was the wallet's first buy of the token. null when not reported.
`trades[].isExit`	boolean \| null	Whether it closed the position. null when not reported.
`trades[].thesis`	string \| null	The note the trader attached. null when none.
`trades[].realizedPnlUsd`	number \| null	Realized PnL on the position in USD. null when not reported.
`trades[].unrealizedPnlUsd`	number \| null	Unrealized PnL on the position in USD. null when not reported.
`trades[].pnlPercent`	number \| null	PnL on the position in percent. null when not reported.
`count`	integer	Rows on this page.
`more`	boolean	Whether another page follows.
`cursor`	string \| null	Pass back as `cursor`, with the same filters, for the next page. null on the last page.

Start building with DexData today

Sign in, create a key and make your first call in a minute. Free credits every month, and you only pay for calls that succeed.

Get a free API key