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

apiKeystringRequired

API key for authentication

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

/api/v1/profiler/address/transactions

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

apiKeystringRequired

API key for authentication

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

/api/v1/transaction-with-token-transfer-lookup

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"
        }
      ]
    }
  ]
}