# Nansen Token God Mode - Who Bought/Sold

> Nansen Token God Mode - Who Bought/Sold is a paid API for AI agents from api.nansen.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-13).

Returns on-chain data about which wallets bought or sold a specific token, filterable by chain, date range, and smart money labels

## Facts

- Endpoint: GET https://api.nansen.ai/api/v1/tgm/who-bought-sold?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-nansen-ai-e3f2f74a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jjJRuNmqvA_hxq60qF0dg

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-e3f2f74a
```

Example prompt: Using Nansen Token God Mode, show me who bought the token at address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum over the past 7 days — filter for buy transactions and sort by largest volume first.

## When to prefer this

Use this endpoint when you need to identify specific wallets that bought or sold a token — especially for smart money tracking, whale watching, or detecting accumulation/distribution patterns. Prefer this over general token screeners when the focus is WHO traded (wallet-level), not just price or volume metrics.

## Known failure modes

- Invalid token address returns empty results or 400 error
- Unsupported chain identifier causes validation error
- Date range too wide may result in pagination limits or timeouts
- Missing required parameters (token_address, buy_or_sell) return 422 validation error
- Payment failure returns 402 when USDC balance is insufficient
- Chain not supported by TGM endpoints returns error

## How this service works

Get "Token God Mode" (TGM) who bought/sold data

## Output

A list of wallet addresses and associated transaction data showing which addresses bought or sold the specified token on the given chain within the date range, potentially including smart money labels, trade sizes, and timestamps.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "title": "TGMWhoBoughtSoldRequest",
 "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": "TGMWhoBoughtSoldFilters",
     "properties": {
      "address": {
       "anyOf": [
        {
         "type": "string"
        },
        {
         "type": "array",
         "items": {
          "type": "string"
         }
        },
        {
         "type": "null"
        }
       ],
       "title": "Address",
       "examples": [
        "0x28c6c06298d514db089934071355e5743bf21d60"
       ],
       "description": "Trader address filter"
      },
      "address_label": {
       "anyOf": [
        {
         "type": "string"
        },
        {
         "type": "array",
         "items": {
          "type": "string"
         }
        },
        {
         "type": "null"
        }
       ],
       "title": "Address Label",
       "examples": [
        "High Gas Consumer"
       ],
       "description": "Trader label filter"
      },
      "sold_volume_usd": {
       "anyOf": [
        {
         "type": "object",
         "title": "NumericRangeFilter",
         "properties": {
          "max": {
           "anyOf": [
            {
             "type": "number"
            }
           ],
           "title": "Max",
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "TGMWhoBoughtSoldResponse",
 "required": [
  "data",
  "pagination"
 ],
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "title": "TGMWhoBoughtSold",
    "required": [
     "address"
    ],
    "properties": {
     "address": {
      "type": "string",
      "title": "Address",
      "examples": [
       "0x1234567890123456789012345678901234567890"
      ],
      "description": "The address that did the trades"
     },
     "address_label": {
      "anyOf": [
       {
        "type": "string"
       }
      ],
      "title": "Address Label",
      "examples": [
       "High Gas Consumer"
      ],
      "description": "Label associated with the address"
     },
     "sold_volume_usd": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "Sold Volume Usd",
      "examples": [
       12500
      ],
      "description": "The aggregate sold volume in USD for the address"
     },
     "trade_volume_usd": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "Trade Volume Usd",
      "examples": [
       12500
      ],
      "description": "The net trade volume in USD for the address"
     },
     "bought_volume_usd": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "Bought Volume Usd",
      "examples": [
       25000
      ],
      "description": "The aggregate bought volume in USD for the address"
     },
     "sold_token_volume": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "Sold Token Volume",
      "examples": [
       500.25
      ],
      "description": "The aggregate sold token volume for the address"
     },
     "token_trade_volume": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "Token Trade Volume",
      "examples": [
       500.25
      ],
      "description": "The net token trade volume for the address"
     },
     "bought_token_volume": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "Bought Token Volume",
      "examples": [
       1000.5
      ],
      "description": "The aggregate bought token volume for the address"
     }
    },
    "description": "Individual TGM who bought/sold record.\n\nRepresents a single address with aggregated trade volumes."
   },
   "title": "Data",
   "description": "List of TGM who bought/sold records"
  },
  "pagination": {
   "
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-nansen-ai-e3f2f74a/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)