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.

GET/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"
Parameters
ParameterDescription
period

query · 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
date

query · 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.
limit

query · 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.
chain

path · 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.

Response fields of Tracked-KOL realized-profit ranking, Solana only
FieldTypeDescription
windowstringWhich window actually answered this request.
periodstring | nullEchoes the requested period shorthand, only when window is period.
datestring | nullEchoes the resolved date, only when window is date.
tradersobject[]Ranked highest window.realizedUsd first.
traders[].walletstringThe wallet address.
traders[].identityobject | nullThe celebrity tag for the wallet, or null if untagged. Never partially populated.
traders[].identity.namestring | null
traders[].identity.twitterstring | null
traders[].identity.avatarstring | null
traders[].windowobjectFigures scoped to the REQUESTED window.
traders[].window.realizedUsdnumber | nullRealized profit banked within the requested window.
traders[].window.unrealizedUsdnumber | nullPaper gain/loss within the window. Only the all-time window publishes this.
traders[].window.totalUsdnumber | nullrealizedUsd + unrealizedUsd for this same window.
traders[].window.volumeUsdnumber | nullTraded volume within the window. null on the all-time window.
traders[].lifetimeobjectLifetime-to-date figures, as of now or as of the requested date.
traders[].lifetime.realizedUsdnumber | null
traders[].lifetime.unrealizedUsdnumber | null
traders[].lifetime.totalUsdnumber | null
traders[].lifetime.investedUsdnumber | nullLifetime cost basis. null on the period window.
traders[].lifetime.proceedsUsdnumber | nullLifetime sale proceeds. null on the period window.
traders[].winRatenumber | null0-100. Only the all-time window publishes this.
traders[].roinumber | nullPercent return on invested capital, lifetime. Only the all-time window publishes this.
hasNextbooleanWhether 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