{"uid":"cap_TQfPgazvhOMR6VqkQTAGi","slug":"api-nansen-ai-3e9ac65e","name":"Nansen Address Transactions","description":"Get Address Transactions Data","url":"https://api.nansen.ai/api/v1/profiler/address/transactions","method":"GET","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","avalanche","base","bitcoin","bnb","ethereum","injective","iotaevm","linea","mantle","mantra","monad","near","optimism","plasma","polygon","ronin","scroll","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":"SortOrder[ProfilerAddressTransactionsSortField]","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 (max 100 for performance)"}},"description":"Pagination parameters for profiler endpoints with performance constraints."},"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":{"request":{"date":{"to":"2025-01-31","from":"2025-01-01"},"chain":"ethereum","address":"0x28c6c06298d514db089934071355e5743bf21d60","pagination":{"page":1,"per_page":10}},"response":{"data":[{"chain":"ethereum","method":"transfer(address,uint256)","volume_usd":9999.498588372586,"source_type":"transfer","tokens_sent":[{"chain":"ethereum","price_usd":null,"value_usd":null,"to_address":"0x96bd2db3a7d3d7c67aeb806bbdd4b67f310300c1","from_address":"0x28c6c06298d514db089934071355e5743bf21d60","token_amount":-10000,"token_symbol":"USDT","token_address":"0xdac17f958d2ee523a2206206994597c13d831ec7","to_address_label":"🏦 OKX: Deposit [0x96bd2d]","from_address_label":"🏦 Binance 14 [0x28c6c0]"}],"block_timestamp":"2025-01-31T23:59:35","tokens_received":[],"transaction_hash":"0x54c33d470c1213292950b67ab18fc513dd3f8dabe6186c7398416728fe673e5a"},{"chain":"ethereum","method":"sent","volume_usd":32.925181889582326,"source_type":"transfer","tokens_sent":[{"chain":"ethereum","price_usd":null,"value_usd":null,"to_address":"0x20b8f587e84b8a8cde1225b68c642d796fef2305","from_address":"0x28c6c06298d514db089934071355e5743bf21d60","token_amount":-0.01,"token_symbol":"ETH","token_address":"0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee","to_address_label":"[0x20b8f5]","from_address_label":"🏦 Binance 14 [0x28c6c0]"}],"block_timestamp":"2025-01-31T23:59:35","tokens_received":[],"transaction_hash":"0xd62739c29f2baabcd15cbf6b9df24608cc7d1518f6ec3f7708c4b4801ec2ba9f"},{"chain":"ethereum","method":"transfer(address,uint256)","volume_usd":451.994120571004,"source_type":"transfer","tokens_sent":[{"chain":"ethereum","price_usd":null,"value_usd":null,"to_address":"0x92ec22eb4ac94f7263028acd442d01655b5aee5a","from_address":"0x28c6c06298d514db089934071355e5743bf21d60","token_amount":-433.74572698,"token_symbol":"FET","token_address":"0xaea46a60368a7bd060eec7df8cba43b7ef41ad85","to_address_label":"🏦 Binance: Deposit [0x92ec22]","from_address_label":"🏦 Binance 14 [0x28c6c0]"}],"block_timestamp":"2025-01-31T23:58:47","tokens_received":[],"transaction_hash":"0x76eae288ee67dab9444843ae65c1ed3fa5f699363e935ccbe2f9d58995d7199b"},{"chain":"ethereum","method":"transfer(address,uint256)","volume_usd":6920.528011746963,"source_type":"transfer","tokens_sent":[{"chain":"ethereum","price_usd":null,"value_usd":null,"to_address":"0x1c3b06999ef509316d777b7826966faddeb241de","from_address":"0x28c6c06298d514db089934071355e5743bf21d60","token_amount":-6920.5,"token_symbol":"USDC","token_address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","to_address_label":"[0x1c3b06]","from_address_label":"🏦 Binance 14 [0x28c6c0]"}],"block_timestamp":"2025-01-31T23:58:23","tokens_received":[],"transaction_hash":"0x82deae000a367bbee986d2113d2f1734ea90b872fdc889058d61e2f3b0ad20d2"},{"chain":"ethereum","method":"transfer(address,uint256)","volume_usd":1353.2948583339983,"source_type":"transfer","tokens_sent":[{"chain":"ethereum","price_usd":null,"value_usd":null,"to_address":"0xbb0e863c33d4396ea185a79f70f617714a8abdfe","from_address":"0x28c6c06298d514db089934071355e5743bf21d60","token_amount":-1756.25045041,"token_symbol":"ENA","token_address":"0x57e114b691db790c35207b2e685d4a43181e6061","to_address_label":"🏦 MEXC: Deposit [0xbb0e86]","from_address_label":"🏦 Binance 14 [0x28c6c0]"}],"block_timestamp":"2025-01-31T23:58:23","tokens_received":[],"transaction_hash":"0xefe026b210e6b0a6cf993bb4ad7e09b1dd36b9c915951bec492a686f551a720f"},{"chain":"ethereum","method":"transfer(address,uint256)","volume_usd":392658.64933750563,"source_type":"transfer","tokens_sent":[{"chain":"ethereum","price_usd":null,"value_usd":null,"to_address":"0xeff6cb8b614999d130e537751ee99724d01aa167","from_address":"0x28c6c06298d514db089934071355e5743bf21d60","token_amount":-392657.06,"token_symbol":"USDC","token_address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","to_address_label":"🤖 MEV: Bot [0xeff6cb]","from_address_label":"🏦 Binance 14 [0x28c6c0]"}],"block_timestamp":"2025-01-31T23:57:35","tokens_received":[],"transaction_hash":"0x168a0487aea426d7253bd4bf2564701f8e0345fd7a450d8e092917ce4a09a2e0"},{"chain":"ethereum","method":"sent","volume_usd":195.8907402651661,"source_type":"transfer","tokens_sent":[{"chain":"ethereum","price_usd":null,"value_usd":null,"to_address":"0x106396abcb83a1c05179618042a726e2321e0603","from_address":"0x28c6c06298d514db089934071355e5743bf21d60","token_amount":-0.05949572,"token_symbol":"ETH","token_address":"0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee","to_address_label":"stake.com: Deposit [0x106396]","from_address_label":"🏦 Binance 14 [0x28c6c0]"}],"block_timestamp":"2025-01-31T23:57:23","tokens_received":[],"transaction_hash":"0xe8da5ac3ce84b09712588be797996d57d13fa6de1d6fe74fcbf40f4d660a1390"},{"chain":"ethereum","method":"transfer(address,uint256)","volume_usd":142411.89372819487,"source_type":"transfer","tokens_sent":[{"chain":"ethereum","price_usd":null,"value_usd":null,"to_address":"0x51c72848c68a965f66fa7a88855f9f7784502a7f","from_address":"0x28c6c06298d514db089934071355e5743bf21d60","token_amount":-438,"token_symbol":"AAVE","token_address":"0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9","to_address_label":"🤖 Wintermute Market Making [0x51c728]","from_address_label":"🏦 Binance 14 [0x28c6c0]"}],"block_timestamp":"2025-01-31T23:57:11","tokens_received":[],"transaction_hash":"0xd7a2e471c8bf3ec6c70d21a6dcb43b931f93c83e3b1cb3071ab15a46a77ad03a"},{"chain":"ethereum","method":"transfer(address,uint256)","volume_usd":1994.9866339706798,"source_type":"transfer","tokens_sent":[{"chain":"ethereum","price_usd":null,"value_usd":null,"to_address":"0xd24db7f63b727ec4d1f2cefeab790e18ec94e335","from_address":"0x28c6c06298d514db089934071355e5743bf21d60","token_amount":-1994.978559,"token_symbol":"USDC","token_address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","to_address_label":"🤖 🏦 Bitstamp: Deposit [0xd24db7]","from_address_label":"🏦 Binance 14 [0x28c6c0]"}],"block_timestamp":"2025-01-31T23:56:59","tokens_received":[],"transaction_hash":"0x52d2ba6b929c77db70b48aea3b4c9e4d2aec4045e75014d04c2df009fe8f95ac"},{"chain":"ethereum","method":"transfer(address,uint256)","volume_usd":101.53537215533834,"source_type":"transfer","tokens_sent":[{"chain":"ethereum","price_usd":null,"value_usd":null,"to_address":"0xe28acfe93046340fdfb18966c816991a52ea4634","from_address":"0x28c6c06298d514db089934071355e5743bf21d60","token_amount":-0.00097789,"token_symbol":"BBTC","token_address":"0x9be89d2a4cd102d8fecc6bf9da793be995c22541","to_address_label":"[0xe28acf]","from_address_label":"🏦 Binance 14 [0x28c6c0]"}],"block_timestamp":"2025-01-31T23:56:59","tokens_received":[],"transaction_hash":"0x8c3de2a506efc86cc70960f09a87ea79be8db712f9ae524eea5a9c21278ff3c9"}],"pagination":{"page":1,"per_page":10,"is_last_page":false}}},"exampleRequest":{"date":{"to":"2025-01-31","from":"2025-01-01"},"chain":"ethereum","address":"0x28c6c06298d514db089934071355e5743bf21d60","pagination":{"page":1,"per_page":10}},"tags":["x402"],"displayCostAmount":"0.01","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.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"},{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_EdRJUcvAW_yjizA-LC4ue","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_0heQZOr9a6ZdBO65d7hh2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves on-chain transaction history and activity data for a specific blockchain address using Nansen's wallet intelligence platform.","exampleAgentPrompt":"Pull the full on-chain transaction history for the wallet address 0x3f5CE5FBFe3E9af3971dD833D26bA9b5C936f0bE using Nansen — I want to see all its recent transactions.","exampleUseCases":null,"resultDescription":"Returns a list of on-chain transactions associated with the queried address, including transaction hashes, timestamps, counterparties, values, and other relevant transaction metadata as enriched by Nansen's wallet labeling and smart money intelligence.","failureModes":["Invalid or malformed wallet address returns 400 error","Address not found or no transaction history returns empty result set","Rate limiting or quota exceeded returns 429 error","Payment failure (x402) if USDC not provided or insufficient balance","Network/chain not supported returns error","Upstream blockchain data unavailable causes timeout or 503"],"whenToPreferThis":"Use this endpoint when you need comprehensive on-chain transaction history for a specific address enriched with Nansen's wallet labels and smart money context. Prefer this over raw blockchain RPC calls when you want labeled, analytics-ready transaction data. Choose this over the 'Transaction With Token Transfer Lookup' endpoint when you need broad address-level history rather than details on a specific transaction hash.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:58:31.441Z","isFirstParty":false}