Historical Address Transactions

Get Historical Transactions for an Address (Beta)

post

Beta — subject to breaking changes.

Returns the 20 most recent token transfer transactions for a wallet address as of a historical snapshot date, with temporally-correct counterparty labels.

Key differences from /profiler/address/transactions:

• Accepts an explicit as_of_date (no rolling default)

• Counterparty labels resolved from label history at as_of_date (no forward-looking bias)

• Limited to ethereum, base, bnb, and solana

• Capped at 20 results per query

Authorizations

ApiKeyAuth

apiKeystringRequired

API key for authentication

Body

application/json

Request model for the profiler historical address transactions endpoint.

Returns the 20 most recent token transfer transactions for a wallet address as of a given historical date, with temporally-correct counterparty labels.

addressstringRequired

Wallet address (EVM hex or Solana base58)

Example: 0xd8da6bf26964af9d7eed9e03e53415d37aa96045

chainstring · enumRequired

Blockchain chain

Example: ethereumPossible values:

as_of_datestring · dateRequired

Historical snapshot date — only transactions on or before this date are returned, with labels resolved as of this date.

Example: 2025-06-15

hide_spam_tokenbooleanOptional

Filter out tokens flagged as spam by Nansen

Default: trueExample: true

apply_blacklist_filterbooleanOptional

When True, exclude blacklisted addresses from the results. Defaults to True.

Default: trueExample: true

Responses

200

Historical address transaction 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

post

/api/v1beta1/profiler/address/historical-transactions

HTTPcURLJavaScriptPython

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

{
  "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
  "chain": "ethereum",
  "as_of_date": "2025-06-15",
  "hide_spam_token": true,
  "pagination": {
    "page": 1,
    "per_page": 10
  },
  "apply_blacklist_filter": true
}

{
  "pagination": {
    "page": 1,
    "per_page": 10,
    "is_last_page": true
  },
  "data": [
    {
      "source_type": "transfer",
      "method": "transfer",
      "transaction_hash": "0x61adb6da30853c5988f0204dd9f6e4abbc878e02c34030a4f707cf4ec3124bcb",
      "tokens_received": [],
      "tokens_sent": [],
      "volume_usd": 12345.67,
      "block_timestamp": "2025-06-14T12:00:00",
      "chain": "ethereum"
    }
  ]
}

Get Historical (Time-Travel) Transaction Lookup Data (Beta)

post

Beta — subject to breaking changes.

Time-travel-aware variant of /transaction-with-token-transfer-lookup.

Returns transaction details (sender/receiver, native value, token transfers) with temporally-correct labels and dual pricing (dated price at the transaction's block_timestamp + as-of-date price). Labels are resolved at as_of_date to avoid forward-looking bias; entity labels are available from 2025-03-11 onward.

Performance

This endpoint executes two queries sequentially:

1. Hash -> timestamp resolution — can take 60-170 seconds for unknown hashes. Pass block_timestamp in the request to skip this step entirely.

2. Data lookup — <1 second once the timestamp is known.

Authorizations

ApiKeyAuth

apiKeystringRequired

API key for authentication

Body

application/json

Request model for the profiler historical transaction lookup endpoint.

chainstring · enumRequired

Blockchain chain for the historical transaction lookup

Example: ethereumPossible values:

transaction_hashstringRequired

Transaction hash to lookup (0x-prefixed, 66 chars)

Example: 0x13c97b56d431cb0de39086ab493530068d01acf227d80c00d447b577ae2e9db4

as_of_datestring · dateRequired

Reference date for temporal label resolution and as-of-date pricing. Must be on/after the transaction's block_timestamp. Entity labels are available from 2025-03-11 onward.

Example: 2025-06-15

block_timestampany ofOptional

Optional block timestamp in 'YYYY-MM-DD HH:MM:SS' format. When provided, skips the slow (60-170s) hash-to-timestamp resolution step. Strongly recommended.

Example: 2025-01-15 00:00:11

stringOptional

apply_blacklist_filterbooleanOptional

When True, exclude blacklisted addresses from the results. Defaults to True.

Default: trueExample: true

Responses

200

Historical transaction lookup data with temporally-correct labels and dual pricing

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/v1beta1/profiler/historical-transaction-lookup

HTTPcURLJavaScriptPython

POST /api/v1beta1/profiler/historical-transaction-lookup HTTP/1.1
Host: api.nansen.ai
apiKey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 204

{
  "chain": "ethereum",
  "transaction_hash": "0x13c97b56d431cb0de39086ab493530068d01acf227d80c00d447b577ae2e9db4",
  "as_of_date": "2025-06-15",
  "block_timestamp": "2025-01-15 00:00:11",
  "apply_blacklist_filter": true
}

{
  "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,
      "as_of_date_native_price": 1,
      "as_of_date_native_value_usd": 1,
      "receipt_status": 1,
      "block_timestamp": "text",
      "as_of_date": "text",
      "method": "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,
          "as_of_date_price_usd": 1,
          "as_of_date_value_usd": 1,
          "transfer_id": "text"
        }
      ]
    }
  ]
}