Aggregated who-bought/sold summary for any token by address, powered by Nansen on-chain analytics.
What it does
The Nansen TGM Who Bought/Sold endpoint provides an aggregated summary of DEX trade volumes in USD for individual addresses that traded a specific token within a given time period. By supplying a chain, token address, date range, and buy/sell direction, callers receive per-address breakdowns of bought volume, sold volume, and net trade volume in both token units and USD. Results can be filtered by smart money labels (Whale, Smart Trader, Fund, Exchange, Public Figure, etc.) and sorted by various volume fields.
This endpoint is part of Nansen's broader Token God Mode (TGM) suite, which covers flows, holders, DEX trades, transfers, PnL leaderboards, OHLCV data, and more across 24+ chains. The who-bought/sold endpoint specifically helps identify net buyers or sellers of a token — useful for detecting accumulation, distribution, or whale activity around specific on-chain assets.
Pricing is $0.01 per request via the x402 protocol (fixed). The endpoint also supports traditional API-key authentication with a credit cost of 10 credits (free tier) or 1 credit (pro tier). Rate limits and remaining credits are returned in response headers.
Capabilities
Use cases
- —Identify which addresses are net buyers or sellers of a token over a specific period
- —Detect smart money accumulation or distribution patterns for a given token
- —Build automated trading signals based on whale buying/selling activity
- —Audit token holder behavior around key on-chain events
- —Screen for tokens with concentrated buying from labeled wallets
Fit
Best for
- —Crypto traders tracking smart money flows
- —On-chain analysts investigating token accumulation/distribution
- —Trading bots that need per-address buy/sell volume data
- —Research teams profiling token holder behavior
Not for
- —Off-chain or CEX-only trade data needs
- —Real-time sub-second streaming trade feeds
- —Non-crypto or traditional finance analytics
Quick start
curl -X POST https://api.nansen.ai/api/v1/tgm/who-bought-sold \
-H 'Content-Type: application/json' \
-d '{
"chain": "ethereum",
"token_address": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
"buy_or_sell": "BUY",
"date": {"from": "2025-01-01T00:00:00Z", "to": "2025-01-07T23:59:59Z"},
"pagination": {"page": 1, "per_page": 10}
}'Example
Request
{
"date": {
"to": "2025-01-07T23:59:59Z",
"from": "2025-01-01T00:00:00Z"
},
"chain": "ethereum",
"filters": {
"trade_volume_usd": {
"min": 1000
},
"include_smart_money_labels": [
"Whale",
"Smart Trader"
]
},
"pagination": {
"page": 1,
"per_page": 10
},
"buy_or_sell": "BUY",
"token_address": "0x6982508145454ce325ddbe47a25d4ec3d2311933"
}Response
{
"data": [
{
"address": "0x28c6c06298d514db089934071355e5743bf21d60",
"address_label": "Binance 14",
"sold_volume_usd": 3500,
"trade_volume_usd": 21500,
"bought_volume_usd": 25000,
"sold_token_volume": 200000,
"token_trade_volume": 1300000,
"bought_token_volume": 1500000
}
],
"pagination": {
"page": 1,
"per_page": 10,
"is_last_page": false
}
}Endpoint
Quality
Full OpenAPI 3.1 schema with detailed request/response models, clear pricing ($0.01 via x402), and a confirmed live 402 challenge. Docs pages on the origin return 404 but the OpenAPI spec itself is comprehensive. Minor deduction for lack of standalone human-readable documentation pages.
Warnings
- —No standalone documentation pages found at api.nansen.ai/docs — rely on the OpenAPI spec for integration details.
- —x402 payment requires a Payment-Signature header; no API key alternative pricing details beyond credit costs are documented in the spec.
Citations
- —The endpoint is POST /api/v1/tgm/who-bought-sold with x402 fixed price $0.01 and credit cost 10 (free) / 1 (pro).https://api.nansen.ai
- —The endpoint returns aggregated trade volumes in USD for addresses, identifying net buyers or sellers of a token within a time period.https://api.nansen.ai
- —The endpoint returned HTTP 402 with x402 payment challenge, confirming it is live.https://api.nansen.ai/api/v1/tgm/who-bought-sold