Ctrlk
x-twitteryoutube
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Historical Address Transactions

Note: This is a beta endpoint (/api/v1beta1/). Request shapes, response fields, and pricing may change as we iterate.

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
apikeystringRequired

API key for authentication

Body

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
post/api/v1beta1/profiler/address/historical-transactions
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
apikeystringRequired

API key for authentication

Body

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
post/api/v1beta1/profiler/historical-transaction-lookup
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"
        }
      ]
    }
  ]
}
PreviousHistorical Smart Money Perps Positions
NextHistorical Token Who Bought/Sold

Last updated

Was this helpful?