# Nansen AI - Address Historical Transactions

> Nansen AI - Address Historical Transactions 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-14).

Retrieves the historical on-chain transaction history for a given blockchain address, enriched with Nansen's Smart Money labels and analytics.

## Facts

- Endpoint: GET https://api.nansen.ai/api/v1beta1/profiler/address/historical-transactions
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nansen-ai-address-historical-transactions-007e5af7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Fro5WO_Wdw_q4WONXhVzX

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-address-historical-transactions-007e5af7
```

Example prompt: Pull the historical on-chain transactions for wallet address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 using Nansen — I want to see its full trading history with Smart Money labels.

## When to prefer this

Choose this endpoint when you need enriched, labeled historical transaction data for a specific blockchain address and want Nansen's Smart Money intelligence layered on top — especially useful for tracking whale wallets, DeFi traders, or performing due diligence on a specific on-chain actor. Prefer this over generic block explorers when Smart Money labeling and Nansen's proprietary address classification are important.

## Known failure modes

- Invalid or malformed blockchain address returns 400 error
- Address not found or never transacted returns empty result set
- Rate limiting or quota exceeded returns 429 error
- Payment failure (x402) if USDC balance insufficient
- Unsupported chain or address type returns error
- Internal server error (500) if Nansen backend unavailable

## How this service works

Get Historical Transactions for an Address (Beta)

## Output

A list of historical on-chain transactions for the specified address, enriched with Nansen's 500M+ labeled address data including Smart Money tags, token transfer details, timestamps, counterparties, and transaction metadata.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "title": "ProfilerAddressHistoricalTransactionsRequest",
 "required": [
  "address",
  "chain",
  "as_of_date"
 ],
 "properties": {
  "chain": {
   "enum": [
    "all",
    "base",
    "bnb",
    "ethereum",
    "mantra",
    "solana"
   ],
   "type": "string",
   "title": "ProfilerHistoricalTokenBalancesChain",
   "description": "Chains supported for Profiler Historical Token Balances endpoint."
  },
  "address": {
   "type": "string",
   "title": "Address",
   "examples": [
    "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
   ],
   "description": "Wallet address (EVM hex or Solana base58)"
  },
  "as_of_date": {
   "type": "string",
   "title": "As Of Date",
   "format": "date",
   "examples": [
    "2025-06-15"
   ],
   "description": "Historical snapshot date — only transactions on or before this date are returned, with labels resolved as of this date."
  },
  "pagination": {
   "type": "object",
   "title": "PaginationRequest",
   "properties": {
    "page": {
     "type": "integer",
     "title": "Page",
     "default": 1,
     "minimum": 1,
     "description": "Page number (1-based)"
    },
    "per_page": {
     "type": "integer",
     "title": "Per Page",
     "default": 10,
     "maximum": 1000,
     "minimum": 1,
     "description": "Number of records per page (max 1000)"
    }
   },
   "description": "Pagination parameters for API requests."
  },
  "hide_spam_token": {
   "type": "boolean",
   "title": "Hide Spam Token",
   "default": true,
   "examples": [
    true
   ],
   "description": "Filter out tokens flagged as spam by Nansen"
  },
  "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 address transactions endpoint.\n\nReturns the 20 most recent token transfer transactions for a wallet address\nas of a given historical date, with temporally-correct counterparty labels.",
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "ProfilerAddressHistoricalTransactionsResponse",
 "required": [
  "pagination",
  "data"
 ],
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "title": "ProfilerAddressHistoricalTransactionsItem",
    "required": [
     "source_type",
     "method",
     "transaction_hash",
     "block_timestamp",
     "chain"
    ],
    "properties": {
     "chain": {
      "type": "string",
      "title": "Chain",
      "examples": [
       "ethereum"
      ],
      "description": "Blockchain identifier for this row."
     },
     "method": {
      "type": "string",
      "title": "Method",
      "examples": [
       "transfer"
      ],
      "description": "Transaction method name. Falls back to 'received'/'sent' for single-transfer transactions."
     },
     "volume_usd": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "Volume Usd",
      "examples": [
       12345.67
      ],
      "description": "Transaction volume in USD computed from historical prices."
     },
     "source_type": {
      "type": "string",
      "title": "Source Type",
      "examples": [
       "transfer"
      ],
      "description": "Always 'transfer'. Mirrors the production schema."
     },
     "tokens_sent": {
      "anyOf": [
       {
        "type": "array",
        "items": {}
       }
      ],
      "title": "Tokens Sent",
      "description": "Array of token transfers sent in this transaction. Same tuple shape as tokens_received with negative amounts."
     },
     "block_timestamp": {
      "type": "string",
      "title": "Block Timestamp",
      "examples": [
       "2025-06-14T12:00:00"
      ],
      "description": "Block timestamp of the transaction (ISO format)."
     },
     "tokens_received": {
      "anyOf": [
       {
        "type": "array",
        "items": {}
       }
      ],
      "title": "Tokens Received",
      "description": "Array of token transfers received in this transaction. Each entry is a tuple of (token_symbol, token_amount, token_price_usd, token_value_usd, token_address, chain, from_address, to_address, from_address_label, to_address_label). Labels are resolved as of as_of_date."
     },
     "transaction_hash": {
      "type": "string",
      "title": "Transaction Hash",
      "examples": [
       "0x61adb6da30853c5988f0204dd9f6e4abbc878e02c34030a4f707cf4ec3124bcb"
      ],
      "description": "Transaction hash in human-readable format (0x-prefixed 
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nansen-ai-address-historical-transactions-007e5af7/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)