Retrieve individual DEX trades for any token with trader labels, amounts, and prices via Nansen's Token God Mode API.
What it does
This endpoint returns individual DEX trading transactions for a specific token on a given chain. Each trade record includes the trader's 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. The endpoint supports filtering by date range, trader address, smart money labels, trade value, and more. It also supports pagination and custom sort ordering.
The endpoint is part of Nansen's Token God Mode (TGM) suite, which provides deep token-level analytics across 24+ chains including Ethereum, Solana, Base, Arbitrum, BNB, Polygon, and others. You can optionally restrict results to smart-money wallets only via the `only_smart_money` flag. The request is a POST with a JSON body specifying chain, token_address, date range, and optional filters/pagination. Pricing is $0.01 per call via x402 protocol, or 10 credits (free tier) / 1 credit (pro tier) via API key. Rate limits are exposed via response headers (per-second and per-minute windows).
Capabilities
Use cases
- —Analyze all DEX buy/sell activity for a specific token over a date range
- —Filter DEX trades to only smart money wallets to track sophisticated trader behavior
- —Build trade-level datasets for backtesting or alpha research on any supported chain
- —Monitor large trades or whale activity for a token in real time
- —Identify which tokens smart money is buying or selling on DEXes
Fit
Best for
- —Crypto researchers needing granular trade-by-trade DEX data with labeled wallets
- —Trading bots or agents that need programmatic access to on-chain DEX trade feeds
- —Portfolio analytics tools integrating Nansen's smart money labels
- —DeFi protocol teams monitoring trading activity on their token
Not for
- —CEX (centralized exchange) trade data — this covers DEX only
- —Historical order book or limit order data — this is filled trades only
- —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",
"pagination": {
"page": 1,
"per_page": 10
},
"token_address": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
"only_smart_money": false
}Response
{
"data": [
{
"action": "BUY",
"token_name": "PEPE",
"token_amount": 1000000,
"token_address": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
"trader_address": "0x28c6c06298d514db089934071355e5743bf21d60",
"block_timestamp": "2025-01-01T12:00:00Z",
"transaction_hash": "0x61adb6da30853c5988f0204dd9f6e4abbc878e02c34030a4f707cf4ec3124bcb",
"traded_token_name": "WETH",
"estimated_value_usd": 12500,
"traded_token_amount": 0.5,
"traded_token_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"trader_address_label": "High Gas Consumer",
"estimated_swap_price_usd": 0.0000125
}
],
"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/call via x402), and the endpoint returned 402 confirming it is live. Docs are embedded in the OpenAPI spec rather than a separate docs site, but are comprehensive. No crawled external documentation was available beyond the API root health check.
Warnings
- —No separate human-readable documentation site was found; all docs are derived from the OpenAPI spec.
- —The specific TGMDexTradesRequest and TGMDexTradesResponse schemas reference $ref components not fully expanded in the probe, but field descriptions are present in the OpenAPI.
Citations
- —Endpoint path is POST /api/v1/tgm/dex-trades with x402 payment at $0.01 per callhttps://api.nansen.ai
- —Credit cost is 10 (free tier) or 1 (pro tier) per callhttps://api.nansen.ai
- —Endpoint returned HTTP 402 confirming it is live via MPP challengehttps://api.nansen.ai/api/v1/tgm/dex-trades
- —Supports 24+ chains including ethereum, solana, base, arbitrum, bnb, polygon, etc.https://api.nansen.ai
- —Description: Access individual DEX trading transactions for a specific token with trader labels, amounts, and priceshttps://api.nansen.ai