Trader signals API
Tracked traders brief: who the leaderboard traders are
Each trader best-ranked first with handle, X handle, wallet addresses and best leaderboard placement.
/api/external/signals/signals-traders-briefWhat it returns
The brief of signals-traders; prefer it unless you need links, avatars, every placement or wallet details. The same traders in the same order, with the same filters and paging (cursor pages both alike), each reduced to the board, id, handle, X handle, best rank, wallet addresses and the one placement that carries that rank (board, rank, PnL in USD). Keep limit at the default or lower: a page of 200 traders is larger than an agent can take whole.
Chains
This endpoint is not tied to a chain: it takes no chain in its request.
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-traders-brief"
| Parameter | Description |
|---|---|
sourcequery · 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. |
boardquery · string · optional | Only traders placed on this leaderboard period (24h, 7d or 30d), ranked by it.24h7d30d |
chainTypequery · string · optional | Only traders with a wallet of this kind.solanaevm |
walletquery · string · optional | Only the traders tied to this wallet. |
limitquery · integer · optional | Rows per page, 1 to 200. |
cursorquery · string · optional | The cursor of the previous page, unchanged, with the same filters. Absent = the first page. |
Response fields
A JSON response. Every field is always present; null means the value could not be established, never zero.
| Field | Type | Description |
|---|---|---|
traders | object[] | Best rank first, then by board and id. |
traders[].id | string | The trader, "<SOURCE>:<id>" — the subject signals-trader takes. |
traders[].source | string | The board that tracks the trader. |
traders[].handle | string | null | The name the trader goes by on that board. null when not stated. |
traders[].xHandle | string | null | The trader's X (Twitter) username. null when not linked. |
traders[].bestRank | integer | null | The best rank among the placements that still stand (on board when one was asked). null when unranked. |
traders[].wallets | string[] | The addresses of the wallets tied to the trader. |
traders[].placement | object | null | The standing placement that carries bestRank. null when the trader is unranked. |
traders[].placement.board | string | The leaderboard period: 24h, 7d or 30d. |
traders[].placement.rank | integer | The rank on it, 1 = best. |
traders[].placement.pnlUsd | number | null | The PnL in USD the board ranks on. 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