{"uid":"cap_Fro5WO_Wdw_q4WONXhVzX","slug":"nansen-ai-address-historical-transactions-007e5af7","name":"Nansen AI - Address Historical Transactions","description":"Get Historical Transactions for an Address (Beta)","url":"https://api.nansen.ai/api/v1beta1/profiler/address/historical-transactions","method":"GET","headers":{},"bodySchema":{"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},"responseSchema":{"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 hex on EVM, base58 on Solana)"}},"description":"Single historical transaction record for a wallet address.\n\nEach row is one transaction (grouped by transaction_hash) containing arrays\nof received and sent token transfers with temporally-correct counterparty\nlabels resolved as of `as_of_date`."},"title":"Data","description":"List of historical transaction records ordered by block_timestamp DESC."},"pagination":{"type":"object","title":"PaginationInfo","properties":{"page":{"type":"integer","title":"Page","default":1,"minimum":1,"description":"Current page number"},"per_page":{"type":"integer","title":"Per Page","default":10,"maximum":1000,"minimum":1,"description":"Number of records per page"},"is_last_page":{"type":"boolean","title":"Is Last Page","default":true,"description":"Whether this is the last page"}},"description":"Pagination information for API responses."}},"description":"Response model for the profiler historical address transactions endpoint."},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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_by08Hpd3GPsv2c5VKSI9U","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":"Retrieves the historical on-chain transaction history for a given blockchain address, enriched with Nansen's Smart Money labels and analytics.","exampleAgentPrompt":"Pull the historical on-chain transactions for wallet address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 using Nansen — I want to see its full trading history with Smart Money labels.","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:31:45.811Z","isFirstParty":false}