Address Transactions

Get Address Transactions Data

post

Retrieve recent blockchain transactions for an address including token transfers, native currency movements, and contract interactions.

Authorizations

ApiKeyAuth

Body

application/json

addressstringRequired

Address to get transactions for

Example: 0x28c6c06298d514db089934071355e5743bf21d60

chainstring · enumRequired

Blockchain chain for the transactions

Example: ethereumPossible values:

hide_spam_tokenbooleanOptional

Removes suspicious tokens from the transaction list

Default: trueExample: true

filtersany ofOptional

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

Example: {"volume_usd":{"min":100}}

order_byany ofOptional

Custom sort order to override the endpoint's default ordering

Responses

200

Address transaction 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

HTTPcURLJavaScriptPython

POST /api/v1/profiler/address/transactions HTTP/1.1
Host: api.nansen.ai
apiKey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 299

{
  "address": "0x28c6c06298d514db089934071355e5743bf21d60",
  "chain": "ethereum",
  "date": {
    "from": "2025-08-01T00:00:00Z",
    "to": "2025-08-10T23:59:59Z"
  },
  "hide_spam_token": true,
  "filters": {
    "volume_usd": {
      "min": 100
    }
  },
  "pagination": {
    "page": 1,
    "per_page": 20
  },
  "order_by": [
    {
      "field": "block_timestamp",
      "direction": "ASC"
    }
  ]
}

{
  "pagination": {
    "page": 1,
    "per_page": 10,
    "is_last_page": true
  },
  "data": [
    {
      "chain": "text",
      "method": "text",
      "tokens_sent": [
        {
          "token_symbol": "text",
          "token_amount": 1,
          "price_usd": 1,
          "value_usd": 1,
          "token_address": "text",
          "chain": "text",
          "from_address": "text",
          "to_address": "text",
          "from_address_label": "text",
          "to_address_label": "text"
        }
      ],
      "tokens_received": [
        {
          "token_symbol": "text",
          "token_amount": 1,
          "price_usd": 1,
          "value_usd": 1,
          "token_address": "text",
          "chain": "text",
          "from_address": "text",
          "to_address": "text",
          "from_address_label": "text",
          "to_address_label": "text"
        }
      ],
      "volume_usd": 1,
      "block_timestamp": "text",
      "transaction_hash": "text",
      "source_type": "text"
    }
  ]
}

Get Transaction with Token Transfer Lookup Data

post

Get comprehensive transaction information including token transfers and NFT transfers. This endpoint provides detailed information about a specific transaction including native cryptocurrency movements, token transfers, and NFT transfers with USD values.

Authorizations

ApiKeyAuth

Body

application/json

chainstring · enumRequired

Blockchain chain for the transaction lookup

Example: ethereumPossible values:

transaction_hashstringRequired

Transaction hash to lookup

Example: 0xf16f93cb53f4f977d45b1b08af7b66e1939d0fe69d669012458239b23797e492

block_timestampstringRequired

Timestamp of the transaction

Example: 2025-08-06 01:47:11

Responses

200

Transaction lookup data with token and NFT transfer information

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

HTTPcURLJavaScriptPython

POST /api/v1/transaction-with-token-transfer-lookup HTTP/1.1
Host: api.nansen.ai
apiKey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 148

{
  "chain": "ethereum",
  "transaction_hash": "0xf16f93cb53f4f977d45b1b08af7b66e1939d0fe69d669012458239b23797e492",
  "block_timestamp": "2025-08-06 01:47:11"
}

{
  "data": [
    {
      "chain": "text",
      "transaction_hash": "text",
      "from_address": "text",
      "from_address_label": "text",
      "to_address": "text",
      "to_address_label": "text",
      "native_value": 1,
      "dated_native_price": 1,
      "dated_native_value_usd": 1,
      "current_native_price": 1,
      "current_native_value_usd": 1,
      "receipt_status": 1,
      "block_timestamp": "text",
      "token_transfer_array": [
        {
          "from_address": "text",
          "from_address_label": "text",
          "to_address": "text",
          "to_address_label": "text",
          "token_address": "text",
          "token_symbol": "text",
          "token_amount": 1,
          "dated_price_usd": 1,
          "dated_value_usd": 1,
          "current_price_usd": 1,
          "current_value_usd": 1,
          "transfer_id": "text"
        }
      ],
      "nft_transfer_array": [
        {
          "from_address": "text",
          "from_address_label": "text",
          "to_address": "text",
          "to_address_label": "text",
          "project_id": "text",
          "collection_name": "text",
          "nft_id": "text"
        }
      ]
    }
  ]
}