# Nansen Token God Mode DEX Trades

> Nansen Token God Mode DEX Trades is a paid API for AI agents from api.nansen.ai, paid per call via MPP or x402, $0.01/call, status unknown (last checked 2026-09-13).

Retrieves DEX (decentralized exchange) trade data for a specific token using Nansen's Token God Mode analytics, with optional smart money filtering

## Facts

- Endpoint: GET https://api.nansen.ai/api/v1/tgm/dex-trades
- Price: $0.01/call
- Payment: MPP, x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-nansen-ai-04e4e036
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FqwfQ4OqHNPHz67Gx_HSJ

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability api-nansen-ai-04e4e036
```

Example prompt: Pull the Nansen Token God Mode DEX trades for token address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum for the past 7 days, and only show me trades made by smart money wallets.

## When to prefer this

Use this endpoint when you need granular on-chain DEX trade data for a specific token and want Nansen's smart money labeling to filter or contextualize trades. Ideal for DeFi research, alpha hunting, or tracking institutional-grade wallet activity on decentralized exchanges. Prefer over generic on-chain data providers when smart money segmentation is needed.

## Known failure modes

- Invalid or unsupported token address returns empty results or 400 error
- Unsupported chain value returns validation error
- Date range too broad may be rejected or paginated
- Missing required token_address field returns 400
- Payment not included or insufficient returns 402 Payment Required
- Rate limiting or quota exceeded returns 429

## How this service works

Get "Token God Mode" (TGM) DEX trades data

## Output

A list of DEX trade records for the specified token, including swap details, wallet addresses, chains, and trade timestamps. When only_smart_money is enabled, results are filtered to trades made by wallets labeled as smart money by Nansen.

## Example request

```json
{
 "date": {
  "to": "2025-01-07T23:59:59Z",
  "from": "2025-01-01T00:00:00Z"
 },
 "chain": "ethereum",
 "pagination": {
  "page": 1,
  "per_page": 10
 },
 "token_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
 "only_smart_money": false
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "title": "TGMDexTradesRequest",
 "required": [
  "chain",
  "token_address",
  "date"
 ],
 "properties": {
  "date": {
   "type": "object",
   "title": "DateRange",
   "properties": {
    "to": {
     "anyOf": [
      {
       "type": "string"
      }
     ],
     "title": "To",
     "examples": [
      "2025-01-31T23:59:59Z"
     ],
     "description": "End date in ISO 8601 format (e.g., 2025-01-31T23:59:59Z or 2025-01-31)"
    },
    "from": {
     "anyOf": [
      {
       "type": "string"
      }
     ],
     "title": "From",
     "examples": [
      "2025-01-01T00:00:00Z"
     ],
     "description": "Start date in ISO 8601 format (e.g., 2025-01-01T00:00:00Z or 2025-01-01)"
    }
   },
   "description": "Date range model matching the API schema."
  },
  "chain": {
   "enum": [
    "arbitrum",
    "avalanche",
    "base",
    "bnb",
    "ethereum",
    "hyperevm",
    "injective",
    "iotaevm",
    "linea",
    "mantle",
    "mantra",
    "monad",
    "near",
    "optimism",
    "plasma",
    "polygon",
    "ronin",
    "scroll",
    "sei",
    "solana",
    "sonic",
    "starknet",
    "sui",
    "ton",
    "tron"
   ],
   "type": "string",
   "title": "TGMChain",
   "description": "Chains supported in TGM (Token God Mode) endpoints."
  },
  "filters": {
   "anyOf": [
    {
     "type": "object",
     "title": "TGMDexTradesFilters",
     "properties": {
      "action": {
       "anyOf": [
        {
         "enum": [
          "BUY",
          "SELL"
         ],
         "type": "string",
         "title": "TGMWhoBoughtSoldType",
         "description": "TGM who bought/sold type."
        }
       ],
       "examples": [
        "BUY",
        "SELL"
       ],
       "description": "Action filter (BUY/SELL)"
      },
      "token_name": {
       "anyOf": [
        {
         "type": "string"
        }
       ],
       "title": "Token Name",
       "examples": [
        "USDC",
        "%Uniswap%"
       ],
       "description": "Token name filter"
      },
      "token_amount": {
       "anyOf": [
        {
         "type": "object",
         "title": "NumericRangeFilter",
         "properties": {
          "max": {
           "anyOf": [
            {
             "type": "number"
            }
           ],
           "title": "Max",
           "examples": [
            50000,
            10000000,
            100
           ],
           "description": "Maximum value (inclusive)"
          },
          "min": {
           "anyO
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "TGMDexTradesResponse",
 "required": [
  "data",
  "pagination"
 ],
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "title": "TGMDexTrade",
    "required": [
     "block_timestamp",
     "transaction_hash",
     "trader_address",
     "action",
     "token_address",
     "token_name",
     "token_amount",
     "traded_token_address",
     "traded_token_name",
     "traded_token_amount",
     "estimated_swap_price_usd",
     "estimated_value_usd"
    ],
    "properties": {
     "action": {
      "enum": [
       "BUY",
       "SELL"
      ],
      "type": "string",
      "title": "TGMWhoBoughtSoldType",
      "description": "TGM who bought/sold type."
     },
     "token_name": {
      "type": "string",
      "title": "Token Name",
      "examples": [
       "USDC"
      ],
      "description": "The name of the token"
     },
     "token_amount": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "Token Amount",
      "examples": [
       1000
      ],
      "description": "The amount of the specified token traded"
     },
     "token_address": {
      "type": "string",
      "title": "Token Address",
      "examples": [
       "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
      ],
      "description": "Address of token"
     },
     "trader_address": {
      "type": "string",
      "title": "Trader Address",
      "examples": [
       "0x28c6c06298d514db089934071355e5743bf21d60"
      ],
      "description": "Trader's address"
     },
     "block_timestamp": {
      "type": "string",
      "title": "Block Timestamp",
      "examples": [
       "2025-05-01T12:00:00Z"
      ],
      "description": "Block timestamp of the trade"
     },
     "transaction_hash": {
      "type": "string",
      "title": "Transaction Hash",
      "examples": [
       "0x61adb6da30853c5988f0204dd9f6e4abbc878e02c34030a4f707cf4ec3124bcb"
      ],
      "description": "Transaction hash"
     },
     "traded_token_name": {
      "type": "string",
      "title": "Traded Token Name",
      "examples": [
       "DAI"
      ],
      "description": "The name of the token traded for the specified token"
     },
     "estimated_value_usd": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "Estimated Value Usd",
      "examples": [
       1500.5
      ],
      "description": "The estimated value of the trade in USD"
     },
     "traded_token_amount": 
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-nansen-ai-04e4e036/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.nansen.ai](https://www.zero.xyz/host/api.nansen.ai/llms.txt)