Discovery and markets API
Tracked-KOL realized-profit ranking, Solana only
A curated roster of tracked KOL wallets ranked by realized profit: all-time, a rolling window or one day. Distinct from realized-pnl-leaders, an UNRESTRICTED ranking.
/api/external/discovery/kol-realized-pnl-leaders/{chain}What it returns
Ranks a curated, FINITE roster of wallets tagged as a known KOL — NOT "top traders overall" (see realized-pnl-leaders for the unrestricted ranking). Three windows, resolving to exactly one upstream call each: the default (neither period nor date given) is ALL-TIME; period ranks within a selectable rolling window; date ranks within ONE calendar day. period and date are mutually exclusive (400 if both are given). Every trader carries a window block (scoped to whatever was requested) and a lifetime block (as-of-now or as-of-that-date) — a field not available for that window is null in the matching block, never borrowed from the other block or defaulted to 0. identity is the WHOLE object or null — a wallet is never partially tagged. There is no sort/direction parameter: this endpoint always ranks by realized profit, descending.
Chains
- Solana SOL
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/discovery/kol-realized-pnl-leaders/SOL"
| Parameter | Description |
|---|---|
periodquery · string · optional | Ranks within this rolling window instead of all-time. Mutually exclusive with date (400 if both are given). Omit both for the all-time ranking.1d7d14d30d90dall |
datequery · string · optional | Ranks within this ONE calendar day (YYYY-MM-DD) instead of all-time. Mutually exclusive with period and with limit (400 if either is also given) — this window returns the full day roster in one call and has no limit parameter of its own. |
limitquery · integer · optional | 1-100. Defaults to 25. Only meaningful on the all-time/period windows — refused together with date, which has no limit parameter on that window. limit ≤ 60 keeps the answer under 32 KB. |
chainpath · string · required | Solana only; every other chain returns 400, because the wired source has no chain parameter at all — it indexes Solana exclusively. |
Response fields
A JSON response. Every field is always present; null means the value could not be established, never zero.
| Field | Type | Description |
|---|---|---|
window | string | Which window actually answered this request. |
period | string | null | Echoes the requested period shorthand, only when window is period. |
date | string | null | Echoes the resolved date, only when window is date. |
traders | object[] | Ranked highest window.realizedUsd first. |
traders[].wallet | string | The wallet address. |
traders[].identity | object | null | The celebrity tag for the wallet, or null if untagged. Never partially populated. |
traders[].identity.name | string | null | |
traders[].identity.twitter | string | null | |
traders[].identity.avatar | string | null | |
traders[].window | object | Figures scoped to the REQUESTED window. |
traders[].window.realizedUsd | number | null | Realized profit banked within the requested window. |
traders[].window.unrealizedUsd | number | null | Paper gain/loss within the window. Only the all-time window publishes this. |
traders[].window.totalUsd | number | null | realizedUsd + unrealizedUsd for this same window. |
traders[].window.volumeUsd | number | null | Traded volume within the window. null on the all-time window. |
traders[].lifetime | object | Lifetime-to-date figures, as of now or as of the requested date. |
traders[].lifetime.realizedUsd | number | null | |
traders[].lifetime.unrealizedUsd | number | null | |
traders[].lifetime.totalUsd | number | null | |
traders[].lifetime.investedUsd | number | null | Lifetime cost basis. null on the period window. |
traders[].lifetime.proceedsUsd | number | null | Lifetime sale proceeds. null on the period window. |
traders[].winRate | number | null | 0-100. Only the all-time window publishes this. |
traders[].roi | number | null | Percent return on invested capital, lifetime. Only the all-time window publishes this. |
hasNext | boolean | Whether a further page exists. Always false on the date window. |
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