Trader signals API
Who is this tracked trader?
One leaderboard-ranked trader: handle, X and Telegram links, every wallet tied to them, and their 24h, 7d and 30d ranks and PnL.
/api/external/signals/signals-trader/{id}What it returns
One tracked trader — ranked on a public trader leaderboard — by the id every signals row publishes for it: their handle and links, the wallets tied to them and how sure each tie is, and their placements on the board's 24h, 7d and 30d leaderboards. Answered whether or not a board lists them today. Not scoped to any chain. An id no tracked trader has answers 404.
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-trader/<id>"
| Parameter | Description |
|---|---|
idpath · string · required | One tracked trader, written "<SOURCE>:<id>" (e.g. "KOLSCAN:8deJ9xeUvXSJwicYptA9mHsU2rN2pDx37KWzkDkEXhU6") exactly as trader.id in the signals listings publishes it — SOURCE is PUMP, FOMO or KOLSCAN, in any case. Not a bare wallet address, and not scoped to any chain. |
Response fields
A JSON response. Every field is always present; null means the value could not be established, never zero.
| Field | Type | Description |
|---|---|---|
trader | object | |
trader.id | string | The trader, "<SOURCE>:<id>" — the subject signals-trader takes. |
trader.source | string | The board that tracks the trader. |
trader.handle | string | null | The name the trader goes by on that board. null when not stated. |
trader.xHandle | string | null | The trader's X (Twitter) username. null when not linked. |
trader.telegramUrl | string | null | The trader's Telegram link. null when not linked. |
trader.avatarUrl | string | null | The trader's picture. null when none. |
trader.wallets | object[] | The wallets tied to the trader. |
trader.wallets[].address | string | The wallet. |
trader.wallets[].chainType | string | null | A Solana wallet, or an EVM one (the same address on every EVM chain). |
trader.wallets[].resolution | string | null | How sure the tie is: "native" (the board ids the trader by it), "confirmed" or "candidate". |
trader.placements | object[] | The trader's placements on the board's leaderboards. |
trader.placements[].board | string | The leaderboard period: 24h, 7d or 30d. |
trader.placements[].rank | integer | null | The rank on it, 1 = best. |
trader.placements[].pnlUsd | number | null | The PnL in USD the board ranks on. null when not reported. |
trader.placements[].pnlNative | number | null | The PnL in the chain's native coin. null when not reported. |
trader.placements[].wins | integer | null | Winning trades in the period. null when not reported. |
trader.placements[].losses | integer | null | Losing trades in the period. null when not reported. |
trader.placements[].observedAt | integer | null | When the placement was read, unix seconds. |
trader.placements[].freshUntil | integer | null | Until when it still stands, unix seconds. |
trader.placements[].fresh | boolean | null | Whether it still stands now. |
trader.firstRankedAt | integer | null | When a board first ranked the trader, unix seconds. |
trader.lastRankedAt | integer | null | When a board last ranked the trader, unix seconds. |
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