Trader signals API
Who are the tracked traders?
Every leaderboard-ranked trader, best rank first, with wallets, links and placements; filter by board, period, wallet kind or one wallet.
/api/external/signals/signals-tradersWhat it returns
The traders the public trader leaderboards rank today, best rank first (unranked last), each with their wallets, links and placements. Filter by board (source), leaderboard period (board, which also ranks by that period), wallet kind, or one wallet — "which tracked trader owns this wallet?". Not scoped to any chain. Paged with cursor.
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"
| 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[].telegramUrl | string | null | The trader's Telegram link. null when not linked. |
traders[].avatarUrl | string | null | The trader's picture. null when none. |
traders[].wallets | object[] | The wallets tied to the trader. |
traders[].wallets[].address | string | The wallet. |
traders[].wallets[].chainType | string | null | A Solana wallet, or an EVM one (the same address on every EVM chain). |
traders[].wallets[].resolution | string | null | How sure the tie is: "native" (the board ids the trader by it), "confirmed" or "candidate". |
traders[].placements | object[] | The trader's placements on the board's leaderboards. |
traders[].placements[].board | string | The leaderboard period: 24h, 7d or 30d. |
traders[].placements[].rank | integer | null | The rank on it, 1 = best. |
traders[].placements[].pnlUsd | number | null | The PnL in USD the board ranks on. null when not reported. |
traders[].placements[].pnlNative | number | null | The PnL in the chain's native coin. null when not reported. |
traders[].placements[].wins | integer | null | Winning trades in the period. null when not reported. |
traders[].placements[].losses | integer | null | Losing trades in the period. null when not reported. |
traders[].placements[].observedAt | integer | null | When the placement was read, unix seconds. |
traders[].placements[].freshUntil | integer | null | Until when it still stands, unix seconds. |
traders[].placements[].fresh | boolean | null | Whether it still stands now. |
traders[].firstRankedAt | integer | null | When a board first ranked the trader, unix seconds. |
traders[].lastRankedAt | integer | null | When a board last ranked the trader, unix seconds. |
traders[].bestRank | integer | null | The best rank among the placements that still stand (on board when one was asked). null when unranked. |
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