Address DEX Trades

Get Wallet DEX Trades

post

Get DEX trade history for a wallet address on a specific chain. Each record includes the bought/sold tokens, amounts, symbols, token age, market cap, FDV, and the USD value of the trade.

What it helps to answer:

1. What DEX trades has this wallet executed on a chain within a date range?

2. Which tokens are being bought and sold, and at what sizes?

3. What is the USD value of each trade, and what was the token's market cap and FDV at trade time?

Authorizations

ApiKeyAuth

apiKeystringRequired

API key for authentication

Body

application/json

Request model for the Profiler DEX Trades endpoint.

addressstringRequired

Trader address

Example: 0x28c6c06298d514db089934071355e5743bf21d60

chainstring · enumRequired

Chain to query

Example: ethereumPossible values:

filtersany ofOptional

Additional filters for the trades

order_byany ofOptional

Sort order for the trades

Responses

200

DEX trade history for the address

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

post/api/v1/profiler/dex-trades

HTTPcURLJavaScriptPython

POST /api/v1/profiler/dex-trades HTTP/1.1
Host: api.nansen.ai
apiKey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 744

{
  "address": "0x28c6c06298d514db089934071355e5743bf21d60",
  "chain": "ethereum",
  "date": {
    "from": "2024-01-01",
    "to": "2024-01-31"
  },
  "filters": {
    "token_bought_address": "text",
    "token_sold_address": "text",
    "token_bought_symbol": "text",
    "token_sold_symbol": "text",
    "token_bought_amount": {
      "min": 1000,
      "max": 50000
    },
    "token_sold_amount": {
      "min": 1000,
      "max": 50000
    },
    "token_bought_age_days": {
      "min": 10,
      "max": 100
    },
    "token_sold_age_days": {
      "min": 10,
      "max": 100
    },
    "token_bought_market_cap": {
      "min": 1000,
      "max": 50000
    },
    "token_sold_market_cap": {
      "min": 1000,
      "max": 50000
    },
    "token_bought_fdv": {
      "min": 1000,
      "max": 50000
    },
    "token_sold_fdv": {
      "min": 1000,
      "max": 50000
    },
    "trade_value_usd": {
      "min": 1000,
      "max": 50000
    }
  },
  "pagination": {
    "page": 1,
    "per_page": 10
  },
  "order_by": [
    {
      "field": "chain",
      "direction": "ASC"
    }
  ]
}

{
  "pagination": {
    "page": 1,
    "per_page": 10,
    "is_last_page": true
  },
  "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
    }
  ]
}