DEX Trades

Data Freshness & Historical Coverage

For data freshness and historical coverage, see Data Coverage by Chain; this endpoint follows it except where noted below.

• Only the trailing 24 hours of DEX trades is queryable — far shorter than the chain-level history — and there is no date-range parameter.

Get Smart Money DEX Trades Data

post

Access real-time DEX trading activity from smart traders and funds over the last 24 hours. This endpoint provides granular transaction-level data showing exactly what sophisticated traders are buying and selling on decentralized exchanges.

Authorizations

apikeystringRequired

API key for authentication

Body

filtersany ofOptional

Additional filters to apply. Only filters for columns that are being selected will be applied.

Example: {"exclude_smart_money_labels":["30D Smart Trader"],"include_smart_money_labels":["Fund","Smart Trader"],"token_bought_age_days":{"max":30,"min":1},"trade_value_usd":{"max":10000,"min":1000}}

order_byany ofOptional

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

Examples:

• [{"field": "trade_value_in_usd", "direction": "DESC"}] - Sort by trade value descending
• [{"field": "block_timestamp", "direction": "ASC"}] - Sort by timestamp ascending
• [{"field": "token_bought_amount", "direction": "DESC"}, {"field": "block_timestamp", "direction": "ASC"}] - Sort by bought amount descending, then timestamp ascending

Responses

200

Smart money DEX trades data

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

402

Payment Required

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

502

Bad Gateway

application/json

503

Service Unavailable

application/json

504

Gateway Timeout

application/json

post/api/v1/smart-money/dex-trades

POST /api/v1/smart-money/dex-trades HTTP/1.1
Host: api.nansen.ai
apikey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 320

{
  "chains": [
    "ethereum",
    "solana"
  ],
  "filters": {
    "exclude_smart_money_labels": [
      "30D Smart Trader"
    ],
    "include_smart_money_labels": [
      "Fund",
      "Smart Trader"
    ],
    "token_bought_age_days": {
      "max": 30,
      "min": 1
    },
    "trade_value_usd": {
      "max": 10000,
      "min": 1000
    }
  },
  "pagination": {
    "page": 1,
    "per_page": 10
  },
  "order_by": [
    {
      "field": "chain",
      "direction": "ASC"
    }
  ]
}

{
  "data": [
    {
      "chain": "text",
      "block_timestamp": "text",
      "transaction_hash": "text",
      "trader_address": "text",
      "trader_address_label": "text",
      "token_bought_address": "text",
      "token_sold_address": "text",
      "token_bought_amount": 1,
      "token_sold_amount": 1,
      "token_bought_symbol": "text",
      "token_sold_symbol": "text",
      "token_bought_age_days": 1,
      "token_sold_age_days": 1,
      "token_bought_market_cap": 1,
      "token_sold_market_cap": 1,
      "token_bought_fdv": 1,
      "token_sold_fdv": 1,
      "trade_value_usd": 1
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 10,
    "is_last_page": true
  }
}