# Nansen AI - Historical Transaction Lookup

> Nansen AI - Historical Transaction Lookup is a paid API for AI agents from api.nansen.ai, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-13).

Looks up historical onchain transactions for a given address using Nansen's 500M+ labeled address database to surface smart money activity and wallet behavior.

## Facts

- Endpoint: GET https://api.nansen.ai/api/v1beta1/profiler/historical-transaction-lookup
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nansen-ai-historical-transaction-lookup-767fe9df
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GyisFLMSDnx_zknPUcxC5

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability nansen-ai-historical-transaction-lookup-767fe9df
```

Example prompt: Pull the historical transaction history for wallet 0x3f5CE5FBFe3E9af3971dD833D26bA9b5C936f0bE using Nansen so I can see what smart money trades they've made onchain.

## When to prefer this

Use this endpoint when you need deep historical transaction data for a specific wallet address enriched with Nansen's smart money labels. Prefer this over generic blockchain explorers when you need to understand whether an address is a known smart money wallet, fund, or labeled entity. Ideal for wallet profiling, due diligence, and behavioral analysis of DeFi participants.

## Known failure modes

- Invalid or malformed wallet address returns 400 error
- Address with no transaction history returns empty result set
- Unsupported blockchain/network returns 422 or empty response
- Payment failure due to insufficient USDC balance returns 402
- Rate limit exceeded returns 429
- API key invalid or expired returns 401

## How this service works

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

## Output

Returns a list of historical onchain transactions for the specified address, enriched with Nansen's labeled address data including counterparty labels, token transfers, trade details, timestamps, and smart money classifications.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "title": "ProfilerHistoricalTransactionLookupRequest",
 "required": [
  "chain",
  "transaction_hash",
  "as_of_date"
 ],
 "properties": {
  "chain": {
   "enum": [
    "base",
    "bnb",
    "ethereum"
   ],
   "type": "string",
   "title": "ProfilerHistoricalTransactionLookupChain",
   "description": "Chains supported by the historical transaction lookup endpoint."
  },
  "as_of_date": {
   "type": "string",
   "title": "As Of Date",
   "format": "date",
   "examples": [
    "2025-06-15"
   ],
   "description": "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."
  },
  "block_timestamp": {
   "anyOf": [
    {
     "type": "string"
    }
   ],
   "title": "Block Timestamp",
   "examples": [
    "2025-01-15 00:00:11"
   ],
   "description": "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."
  },
  "transaction_hash": {
   "type": "string",
   "title": "Transaction Hash",
   "examples": [
    "0x13c97b56d431cb0de39086ab493530068d01acf227d80c00d447b577ae2e9db4"
   ],
   "description": "Transaction hash to lookup (0x-prefixed, 66 chars)"
  },
  "apply_blacklist_filter": {
   "type": "boolean",
   "title": "Apply Blacklist Filter",
   "default": true,
   "examples": [
    true
   ],
   "description": "When True, exclude blacklisted addresses from the results. Defaults to True."
  }
 },
 "description": "Request model for the profiler historical transaction lookup endpoint.",
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "ProfilerHistoricalTransactionLookupListResponse",
 "required": [
  "data"
 ],
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "title": "ProfilerHistoricalTransactionLookupResponse",
    "required": [
     "chain",
     "transaction_hash",
     "from_address",
     "from_address_label",
     "to_address",
     "to_address_label",
     "native_value",
     "dated_native_price",
     "dated_native_value_usd",
     "as_of_date_native_price",
     "as_of_date_native_value_usd",
     "receipt_status",
     "block_timestamp",
     "as_of_date",
     "method",
     "token_transfer_array"
    ],
    "properties": {
     "chain": {
      "type": "string",
      "title": "Chain",
      "description": "The blockchain network of the transaction"
     },
     "method": {
      "anyOf": [
       {
        "type": "string"
       }
      ],
      "title": "Method",
      "description": "Human-readable method signature resolved from the transaction's sig_hash. Empty string when no match is found."
     },
     "as_of_date": {
      "type": "string",
      "title": "As Of Date",
      "description": "The reference date used for label and pricing resolution"
     },
     "to_address": {
      "type": "string",
      "title": "To Address",
      "description": "The hexadecimal address of the recipient"
     },
     "from_address": {
      "type": "string",
      "title": "From Address",
      "description": "The hexadecimal address of the sender"
     },
     "native_value": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "Native Value",
      "description": "The amount of native cryptocurrency transferred"
     },
     "receipt_status": {
      "anyOf": [
       {
        "type": "integer"
       }
      ],
      "title": "Receipt Status",
      "description": "Transaction receipt status (1 for success, 0 for failure)"
     },
     "block_timestamp": {
      "type": "string",
      "title": "Block Timestamp",
      "description": "The timestamp of the block containing the transaction"
     },
     "to_address_label": {
      "anyOf": [
       {
        "type": "string"
       }
      ],
      "title": "To Address Label",
      "description": "Temporally-correct label of the recipient at as_of_date"
     },
     "transaction_hash": {
      "type": "string",
      "title": "Transaction Hash",
      "description": "The unique identifier of the transaction"
     },
    
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nansen-ai-historical-transaction-lookup-767fe9df/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.nansen.ai](https://www.zero.xyz/host/api.nansen.ai/llms.txt)