Discovery and markets API
Which tokens is smart money trading on this chain?
Tokens smart wallets traded over 1d/7d/30d on one chain: smart-wallet count per risk cohort, net USD flow (buys minus sells), buy and sell volume, price, liquidity, cap.
/api/external/discovery/smart-money-tokens/{chain}What it returns
The tokens that wallets classed as smart money traded on this chain over a window (1d, 7d or 30d): per token, how many smart wallets traded it, the net USD flow (buys minus sells), buy and sell volume, price, liquidity and market cap.
One row per (token, cohort). Smart wallets are split into cohorts by risk appetite (riskAverse, riskBalanced, trenchers). With style=all (default) a token traded by several cohorts appears once per cohort; only smartWallets differs between its rows, and the flow, volume and market figures are the token's and repeat, so do not sum them across rows. style narrows the list to one cohort.
The order is the ranking's own for sortBy and order; offset pages through it (20 rows at most per request). The 1d window is not the trailing 24h, and its volume is not a share of the token's market volume. For the individual trades of known KOL and whale wallets, use smart-money.
Chains
- Solana SOL
- BNB Chain BNB
- Ethereum ETH
- Base BASE
- Robinhood Chain RHC
- Arc ARC
- Arbitrum ARB
- Optimism OP
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/smart-money-tokens/SOL"
| Parameter | Description |
|---|---|
windowquery · string · optional | The window the figures cover. Defaults to 1d.1d7d30d |
stylequery · string · optional | One smart-money cohort, or all (default): every cohort, one row per (token, cohort).allriskAverseriskBalancedtrenchers |
sortByquery · string · optional | What ranks the list: smartWallets (default), netFlow, or marketCap.smartWalletsnetFlowmarketCap |
orderquery · string · optional | desc (default) or asc. sortBy=netFlow&order=asc lists the heaviest net selling first.descasc |
offsetquery · integer · optional | Rows to skip from the top of the ranking, 0 to 9980. Defaults to 0. |
limitquery · integer · optional | How many rows to return, 1 to 20. Defaults to 20. |
chainpath · string · required | The chain to query. SOL, BNB, ETH, BASE, RHC, ARC, ARB and OP are served; STABLE, CELO and SCROLL return 400. CELO and SCROLL return 400 here. |
Response fields
A JSON response. Every field is always present; null means the value could not be established, never zero.
| Field | Type | Description |
|---|---|---|
chain | string | The chain asked. |
window | string | The window the figures cover. |
style | string | The cohort filter applied. |
sortBy | string | What ranks the list. |
order | string | The sort direction. |
offset | integer | Rows skipped from the top of the ranking. |
limit | integer | The most rows asked for. |
count | integer | How many rows are in tokens. 0 past the end of the ranking, or when one cohort traded nothing. |
tokens | object[] | In ranking order. |
tokens[].address | string | Mint (Solana) or contract address; EVM addresses lower-cased. |
tokens[].symbol | string | null | Ticker. |
tokens[].name | string | null | Name. |
tokens[].logoUrl | string | null | Logo image URL. |
tokens[].traderStyle | string | null | The smart-money cohort this row counts, by risk appetite: riskAverse, riskBalanced, or trenchers (the riskiest; its rows lean to small, new tokens). A token traded by several cohorts has one row per cohort. Null for a cohort label this API does not know yet. |
tokens[].smartWallets | integer | null | How many smart wallets of this cohort traded the token in the window. |
tokens[].netFlowUsd | number | null | Buy volume minus sell volume in the window, USD: positive = net buying. A token-level figure, the same on each of the token's cohort rows. |
tokens[].volumeUsd | number | null | Buy plus sell volume in the window, USD. Token-level, like netFlowUsd. Not a share of the token's market volume: it was measured above the token's own trailing-24h volume. |
tokens[].buyVolumeUsd | number | null | Buy volume in the window, USD. Token-level. |
tokens[].sellVolumeUsd | number | null | Sell volume in the window, USD. Token-level. |
tokens[].priceUsd | number | null | Price in USD. |
tokens[].priceChangePercent | number | null | Price change over the window, in PERCENT (12.5 = +12.5 %). |
tokens[].liquidityUsd | number | null | USD liquidity. |
tokens[].marketCapUsd | number | null | Market cap, USD. |
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