Who Bought/Sold

Get TGM Who Bought/Sold Data

post

This endpoint provides an aggregated summary of trade volumes in USD for addresses. It can be used to identify addresses that are net buyers or sellers of a token within a time period.

Authorizations

ApiKeyAuth

apiKeystringRequired

API key for authentication

Body

application/json

Request model for TGM who bought/sold endpoint.

This endpoint provides an aggregated summary of trade volumes in USD for addresses involved in DEX (Decentralized Exchange) trades for a specific token.

chainstring · enumRequired

Blockchain chain

Example: solanaPossible values:

token_addressstringRequired

Address of token

Example: 2zMMhcVQEXDtdE6vsFS7S7D5oUodfJHE8vd1gnBouauv

buy_or_sellstring · enumOptional

Are we checking buys or sells

Default: BUYPossible values:

filtersany ofOptional

Additional filters to apply to the query.

Example: {"include_smart_money_labels":["Whale","Smart Trader"],"trade_volume_usd":{"min":1}}

order_byany ofOptional

Custom sort order to override the endpoint's default ordering.

Examples:

• [{"field": "bought_volume_usd", "direction": "DESC"}] - Sort by bought volume descending
• [{"field": "sold_volume_usd", "direction": "ASC"}] - Sort by sold volume ascending

Responses

200

TGM who bought/sold data

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

422

Unprocessable Content

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

post

/api/v1/tgm/who-bought-sold

HTTPcURLJavaScriptPython

POST /api/v1/tgm/who-bought-sold HTTP/1.1
Host: api.nansen.ai
apiKey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 342

{
  "chain": "solana",
  "token_address": "2zMMhcVQEXDtdE6vsFS7S7D5oUodfJHE8vd1gnBouauv",
  "buy_or_sell": "BUY",
  "date": {
    "from": "2025-05-01",
    "to": "2025-05-03"
  },
  "pagination": {
    "page": 1,
    "per_page": 10
  },
  "filters": {
    "include_smart_money_labels": [
      "Whale",
      "Smart Trader"
    ],
    "trade_volume_usd": {
      "min": 1
    }
  },
  "order_by": [
    {
      "field": "bought_volume_usd",
      "direction": "ASC"
    }
  ]
}

{
  "data": [
    {
      "address": "0x1234567890123456789012345678901234567890",
      "address_label": "High Gas Consumer",
      "bought_token_volume": 1000.5,
      "sold_token_volume": 500.25,
      "token_trade_volume": 500.25,
      "bought_volume_usd": 25000,
      "sold_volume_usd": 12500,
      "trade_volume_usd": 12500
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 10,
    "is_last_page": true
  }
}