Nansen Token God Mode: individual DEX trades for any token with trader labels, amounts, and prices.
What it does
The Nansen TGM DEX Trades endpoint (`/api/v1/tgm/dex-trades`) provides individual DEX trading transactions for a specific token on a given chain. Each trade record includes the trader address and Nansen label, the action (BUY/SELL), token amounts for both sides of the swap, estimated swap price in USD, and estimated trade value in USD. Results can be filtered by smart money labels (whale, exchange, public figure, etc.), date range, trader address, trade value, and more. An `only_smart_money` flag restricts results to smart money wallets only. The endpoint supports pagination (up to 1000 per page) and custom sort ordering.
This endpoint is part of Nansen's broader Token God Mode (TGM) suite, which covers flows, holders, transfers, PnL leaderboards, OHLCV, and more across 24+ chains including Ethereum, Solana, Base, BNB, Arbitrum, and others. It is payable via the x402 protocol at $0.01 per request (fixed pricing). Alternatively, it costs 10 credits on the free tier or 1 credit on the pro tier. The API uses an OpenAPI 3.1 schema, returns JSON, and requires either an API key or x402 payment signature. Rate limits are enforced per-second and per-minute, reported via response headers.
Capabilities
Use cases
- —Track individual DEX trades for a specific token to monitor real-time buying/selling activity
- —Filter trades by smart money labels to see what whales, funds, and public figures are trading
- —Analyze trade-by-trade data for a token launch to identify early accumulation patterns
- —Build trading signals by monitoring large-value DEX swaps on specific tokens
- —Audit wallet trading behavior by filtering trades for a specific trader address
Fit
Best for
- —Crypto researchers analyzing on-chain DEX activity for specific tokens
- —Trading bots that need granular trade-level data with smart money context
- —Portfolio managers tracking smart money and whale trading patterns
- —DeFi analysts investigating token distribution and trading dynamics
Not for
- —Aggregated market-level volume data (use token screener or flow endpoints instead)
- —Historical price charting (use the token-ohlcv endpoint instead)
- —Non-blockchain or traditional finance trade data
Quick start
curl -X POST https://api.nansen.ai/api/v1/tgm/dex-trades \
-H 'Content-Type: application/json' \
-H 'apiKey: YOUR_API_KEY' \
-d '{
"chain": "ethereum",
"token_address": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
"date": {"from": "2025-01-01T00:00:00Z", "to": "2025-01-02T23:59:59Z"},
"pagination": {"page": 1, "per_page": 10}
}'Example
Request
{
"date": {
"to": "2025-01-02T23:59:59Z",
"from": "2025-01-01T00:00:00Z"
},
"chain": "ethereum",
"filters": {
"estimated_value_usd": {
"min": 1000
}
},
"pagination": {
"page": 1,
"per_page": 10
},
"token_address": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
"only_smart_money": false
}Response
{
"data": [
{
"action": "BUY",
"token_name": "PEPE",
"token_amount": 50000000,
"token_address": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
"trader_address": "0x28c6c06298d514db089934071355e5743bf21d60",
"block_timestamp": "2025-01-01T12:00:00Z",
"transaction_hash": "0x61adb6da30853c5988f0204dd9f6e4abbc878e02c34030a4f707cf4ec3124bcb",
"traded_token_name": "WETH",
"estimated_value_usd": 1500.5,
"traded_token_amount": 0.5,
"traded_token_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"trader_address_label": "High Gas Consumer",
"estimated_swap_price_usd": 0.0000123
}
],
"pagination": {
"page": 1,
"per_page": 10,
"is_last_page": false
}
}Endpoint
Quality
Full OpenAPI 3.1 schema with detailed request/response models, clear x402 pricing ($0.01/call), live 402 challenge confirmed, and comprehensive endpoint documentation including filters, sort fields, and smart money label enums. Minor gap: no actual response sample was captured from a live call, but the schema is complete enough to infer response structure confidently.
Citations
- —The /api/v1/tgm/dex-trades endpoint costs $0.01 per request via x402 protocol (fixed pricing), or 10 credits (free) / 1 credit (pro).https://api.nansen.ai
- —The endpoint supports 24+ chains including ethereum, solana, base, bnb, arbitrum, and others.https://api.nansen.ai
- —The endpoint returns individual DEX trading transactions for a specific token with trader labels, amounts, and prices.https://api.nansen.ai
- —The x402 payment challenge was confirmed live with HTTP 402 response.https://api.nansen.ai/api/v1/tgm/dex-trades