{"uid":"cap_GyisFLMSDnx_zknPUcxC5","slug":"nansen-ai-historical-transaction-lookup-767fe9df","name":"Nansen AI - Historical Transaction Lookup","description":"Get Historical (Time-Travel) Transaction Lookup Data (Beta)","url":"https://api.nansen.ai/api/v1beta1/profiler/historical-transaction-lookup","method":"GET","headers":{},"bodySchema":{"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},"responseSchema":{"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"},"dated_native_price":{"anyOf":[{"type":"number"}],"title":"Dated Native Price","description":"Native cryptocurrency price at the transaction's block_timestamp date"},"from_address_label":{"anyOf":[{"type":"string"}],"title":"From Address Label","description":"Temporally-correct label of the sender at as_of_date"},"token_transfer_array":{"anyOf":[{"type":"array","items":{"type":"object","title":"HistoricalTokenTransfer","required":["from_address","from_address_label","to_address","to_address_label","token_address","token_symbol","token_amount","dated_price_usd","dated_value_usd","as_of_date_price_usd","as_of_date_value_usd","transfer_id"],"properties":{"to_address":{"type":"string","title":"To Address","description":"Receiver address (0x-prefixed lowercase hex)"},"transfer_id":{"type":"string","title":"Transfer Id","description":"Transfer ID (token-transfer-* or trace-*)"},"from_address":{"type":"string","title":"From Address","description":"Sender address (0x-prefixed lowercase hex)"},"token_amount":{"type":"number","title":"Token Amount","description":"Token amount transferred (decimal-adjusted)"},"token_symbol":{"type":"string","title":"Token Symbol","description":"Token symbol"},"token_address":{"type":"string","title":"Token Address","description":"Token contract address"},"dated_price_usd":{"anyOf":[{"type":"number"}],"title":"Dated Price Usd","description":"Token price in USD at the transaction's block_timestamp date"},"dated_value_usd":{"anyOf":[{"type":"number"}],"title":"Dated Value Usd","description":"USD value of the transfer at the transaction's block_timestamp date"},"to_address_label":{"type":"string","title":"To Address Label","description":"Temporally-correct label of the receiver at as_of_date"},"from_address_label":{"type":"string","title":"From Address Label","description":"Temporally-correct label of the sender at as_of_date"},"as_of_date_price_usd":{"anyOf":[{"type":"number"}],"title":"As Of Date Price Usd","description":"Token price in USD at as_of_date"},"as_of_date_value_usd":{"anyOf":[{"type":"number"}],"title":"As Of Date Value Usd","description":"USD value of the transfer at as_of_date"}},"description":"Single token transfer with temporally-correct labels and dual pricing."}}],"title":"Token Transfer Array","description":"Token transfers in this transaction (temporally-correct labels)"},"dated_native_value_usd":{"anyOf":[{"type":"number"}],"title":"Dated Native Value Usd","description":"USD value of native transfer at the transaction's block_timestamp date"},"as_of_date_native_price":{"anyOf":[{"type":"number"}],"title":"As Of Date Native Price","description":"Native cryptocurrency price at as_of_date"},"as_of_date_native_value_usd":{"anyOf":[{"type":"number"}],"title":"As Of Date Native Value Usd","description":"USD value of native transfer at as_of_date"}},"description":"Response row for the profiler historical transaction lookup endpoint.\n\nMirrors the /transaction-with-token-transfer-lookup response where\noverlapping. Differences:\n- Uses ``as_of_date_native_*`` instead of ``current_native_*`` (temporal pricing).\n- Adds ``method`` (resolved from sig_hash) and ``as_of_date`` fields.\n- No ``nft_transfer_array``."},"title":"Data","description":"List of historical transaction lookup results"}},"description":"Wrapper response for the profiler historical transaction lookup endpoint."},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_pkg9H5tCzO798GZ75aV4_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up historical onchain transactions for a given address using Nansen's 500M+ labeled address database to surface smart money activity and wallet behavior.","exampleAgentPrompt":"Pull the historical transaction history for wallet 0x3f5CE5FBFe3E9af3971dD833D26bA9b5C936f0bE using Nansen so I can see what smart money trades they've made onchain.","exampleUseCases":[{"title":"Due diligence on suspicious wallet","prompt":"Can you pull up the full historical transaction history for 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 using Nansen? I want to see all their past onchain activity and whether they're flagged as any known smart money entity or fund before I follow their trades."},{"title":"Audit DeFi whale trading behavior","prompt":"Look up all the historical onchain transactions for wallet 0xbebc44782c7db0a1a60cb6fe97d0b483032ff1c7 through Nansen — I'm trying to understand what DeFi protocols they've been using and what major trades they've made over time."},{"title":"Profile crypto address for research","prompt":"I'm researching this Ethereum address 0x28c6c06298d514db089934071355e5743bf21d60 — can you use Nansen to fetch its historical transaction history so I can see if it's linked to a known institution or smart money wallet and what it's been up to onchain?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:33:48.066Z","isFirstParty":false}