{"uid":"cap_jsW8RogFAug6ayBhjsQ2x","slug":"nansen-transactions-90969bef","name":"Nansen Address Transactions","description":"Retrieve recent blockchain transactions for an address including token transfers, native currency movements, and contract interactions.","url":"https://api.nansen.ai/api/v1/profiler/address/transactions?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","title":"ProfilerAddressTransactionsRequest","required":["address","chain","date"],"properties":{"date":{"type":"object","title":"DateRange","properties":{"to":{"anyOf":[{"type":"string"}],"title":"To","examples":["2025-01-31T23:59:59Z"],"description":"End date in ISO 8601 format (e.g., 2025-01-31T23:59:59Z or 2025-01-31)"},"from":{"anyOf":[{"type":"string"}],"title":"From","examples":["2025-01-01T00:00:00Z"],"description":"Start date in ISO 8601 format (e.g., 2025-01-01T00:00:00Z or 2025-01-01)"}},"description":"Date range model matching the API schema."},"chain":{"enum":["all","arbitrum","arc","avalanche","base","bitcoin","bnb","ethereum","injective","iotaevm","linea","mantle","mantra","monad","near","optimism","plasma","polygon","robinhood","sei","solana","sonic","starknet","sui","ton","tron"],"type":"string","title":"ProfilerTransactionsChain","description":"Chains supported in profiler transactions analysis."},"address":{"type":"string","title":"Address","examples":["0x28c6c06298d514db089934071355e5743bf21d60","8zFZHuSRuDpuAR7J6FzwyF3vKNx4CVW3DFHJerQhc7Zd"],"description":"Address to get transactions for"},"filters":{"anyOf":[{"type":"object","title":"ProfilerAddressTransactionsFilters","properties":{"method":{"anyOf":[{"type":"string"}],"title":"Method","examples":["sent","received"],"description":"Transaction method filter"},"volume_usd":{"anyOf":[{"type":"object","title":"NumericRangeFilter","properties":{"max":{"anyOf":[{"type":"number"}],"title":"Max","examples":[50000,10000000,100],"description":"Maximum value (inclusive)"},"min":{"anyOf":[{"type":"number"}],"title":"Min","examples":[1000,1000000,-50,0],"description":"Minimum value (inclusive)"}},"description":"Filter for numeric values (floats) with optional min/max bounds.\nUse for prices, volumes, ratios, and other decimal values. - Values between -10.5 and 100.75"}],"examples":[{"max":10000,"min":100}],"description":"Transaction volume range filter in USD"},"source_type":{"anyOf":[{"type":"string"}],"title":"Source Type","examples":["dex","transfer"],"description":"Transaction source type filter"},"token_symbol":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Token Symbol","examples":["USDC","%ETH%"],"description":"Token symbol filter"},"token_address":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Token Address","examples":["0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"],"description":"Token address filter"},"counterparty_name":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Counterparty Name","examples":["Uniswap","%DEX%"],"description":"Counterparty name filter"},"counterparty_address":{"anyOf":[{"type":"string"}],"title":"Counterparty Address","examples":["0x7a250d5630b4cf539739df2c5dacb4c659f2488d"],"description":"Counterparty address filter"}},"description":"Filters for profiler address transactions endpoint.\n\nThese filters control which transactions are included\nin the wallet transaction history.","additionalProperties":false}],"examples":[{"volume_usd":{"min":100}}],"description":"Additional filters to apply. Only filters for columns that are being selected will be applied."},"order_by":{"anyOf":[{"type":"array","items":{"type":"object","title":"ProfilerAddressTransactionsSortOrder","required":["field","direction"],"properties":{"field":{"enum":["block_timestamp"],"type":"string","title":"ProfilerAddressTransactionsSortField","description":"Enum for sortable fields in smart money inflows."},"direction":{"enum":["ASC","DESC"],"type":"string","title":"SortDirection","description":"Enum for sort directions."}}}}],"title":"Order By","description":"Custom sort order to override the endpoint's default ordering"},"pagination":{"type":"object","title":"ProfilerPaginationRequest","properties":{"page":{"type":"integer","title":"Page","default":1,"minimum":1,"description":"Page number (1-based)"},"per_page":{"type":"integer","title":"Per Page","default":20,"maximum":100,"minimum":1,"description":"Number of records per page. This endpoint caps page size at 100, lower than the API-wide maximum of 1000, to keep response times predictable for address transaction history. Values above 100 are rejected with a validation error."}},"description":"Pagination parameters for address transaction history.\n\nThis endpoint allows at most 100 records per page, lower than the API-wide\nmaximum of 1000, and returns 20 records per page by default."},"hide_spam_token":{"type":"boolean","title":"Hide Spam Token","default":true,"examples":[true],"description":"Removes suspicious tokens from the transaction list"}},"description":"","additionalProperties":false},"responseSchema":{"type":"object","title":"ProfilerAddressTransactionsResponse","required":["pagination","data"],"properties":{"data":{"type":"array","items":{"type":"object","title":"ProfilerTransaction","required":["chain","method","block_timestamp","transaction_hash","source_type"],"properties":{"chain":{"type":"string","title":"Chain","description":"Blockchain chain"},"method":{"type":"string","title":"Method","description":"Transaction method (sent/received)"},"volume_usd":{"anyOf":[{"type":"number"}],"title":"Volume Usd","description":"Transaction volume in USD"},"source_type":{"type":"string","title":"Source Type","description":"Transaction source type"},"tokens_sent":{"anyOf":[{"type":"array","items":{"type":"object","title":"ProfilerTokenInfo","required":["token_symbol","token_amount","token_address","chain","from_address","to_address"],"properties":{"chain":{"type":"string","title":"Chain","description":"Blockchain chain"},"price_usd":{"anyOf":[{"type":"number"}],"title":"Price Usd","description":"Token price in USD"},"value_usd":{"anyOf":[{"type":"number"}],"title":"Value Usd","description":"Token value in USD"},"to_address":{"type":"string","title":"To Address","description":"Destination address"},"from_address":{"type":"string","title":"From Address","description":"Source address"},"token_amount":{"type":"number","title":"Token Amount","description":"Token amount"},"token_symbol":{"type":"string","title":"Token Symbol","description":"Token symbol"},"token_address":{"type":"string","title":"Token Address","description":"Token contract address"},"to_address_label":{"anyOf":[{"type":"string"}],"title":"To Address Label","description":"Destination address label"},"from_address_label":{"anyOf":[{"type":"string"}],"title":"From Address Label","description":"Source address label"}},"description":"Token information for profiler transactions.\n\nRepresents detailed information about a token in a transaction."}}],"title":"Tokens Sent","description":"Tokens sent in the transaction"},"block_timestamp":{"type":"string","title":"Block Timestamp","description":"Block timestamp in ISO format"},"tokens_received":{"anyOf":[{"type":"array","items":{"type":"object","title":"ProfilerTokenInfo","required":["token_symbol","token_amount","token_address","chain","from_address","to_address"],"properties":{"chain":{"type":"string","title":"Chain","description":"Blockchain chain"},"price_usd":{"anyOf":[{"type":"number"}],"title":"Price Usd","description":"Token price in USD"},"value_usd":{"anyOf":[{"type":"number"}],"title":"Value Usd","description":"Token value in USD"},"to_address":{"type":"string","title":"To Address","description":"Destination address"},"from_address":{"type":"string","title":"From Address","description":"Source address"},"token_amount":{"type":"number","title":"Token Amount","description":"Token amount"},"token_symbol":{"type":"string","title":"Token Symbol","description":"Token symbol"},"token_address":{"type":"string","title":"Token Address","description":"Token contract address"},"to_address_label":{"anyOf":[{"type":"string"}],"title":"To Address Label","description":"Destination address label"},"from_address_label":{"anyOf":[{"type":"string"}],"title":"From Address Label","description":"Source address label"}},"description":"Token information for profiler transactions.\n\nRepresents detailed information about a token in a transaction."}}],"title":"Tokens Received","description":"Tokens received in the transaction"},"transaction_hash":{"type":"string","title":"Transaction Hash","description":"Transaction hash in hex format"}},"description":"Individual profiler transaction record.\n\nRepresents a single transaction from the wallet profiler."},"title":"Data","description":"List of transaction records"},"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 profiler address transactions endpoint.\n\nContains the filtered transaction data with metadata."},"example":null,"exampleRequest":null,"tags":["blockchain","smart-money","wallet","tokens","defi","analytics","profiler","dex","pnl","onchain","prediction-market","data"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_cM0VSo88rYTZWO_gT9A6U","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"Nansen","brandSlug":"nansen","brandBaseUrl":"https://nansen.ai","brandDocsUrl":"https://docs.nansen.ai","whatItDoes":"Retrieve recent blockchain transactions for a wallet address including token transfers, native currency movements, and contract interactions across multiple chains.","exampleAgentPrompt":"Pull all blockchain transactions for wallet 0x28c6c06298d514db089934071355e5743bf21d60 on Ethereum between 2025-01-01 and 2025-01-31, and filter for transactions with a USD volume of at least $1,000.","exampleUseCases":null,"resultDescription":"Returns a paginated list of transactions for the queried address, each including the transaction hash, block timestamp, chain, method (sent/received), source type, USD volume, tokens sent with amounts and USD values, tokens received, and labeled from/to addresses where available.","failureModes":["Invalid or unsupported chain enum returns validation error","Malformed address format causes rejection","Date range with invalid ISO 8601 format returns parse error","Address with no transactions in the given range returns empty data array","Unsupported chain for the given address type (e.g. EVM address on Solana) may return no results","Payment not provided or insufficient balance returns 402"],"whenToPreferThis":"Use this endpoint when you need detailed per-transaction history for a specific wallet address, including token-level transfer data, USD volumes, and labeled counterparties. Prefer over summary endpoints when you need raw transaction-level detail or want to filter by method, volume, or source type. Best for auditing wallet activity, tracing fund flows, or building transaction timelines.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T18:41:27.949Z","isFirstParty":false,"canonicalSlug":"api-nansen-ai-3e9ac65e"}