{"uid":"cap_H-a7rM2DOwHj0JN9Ss4Mo","slug":"nansen-transaction-with-token-transfer-lookup-623d0bb5","name":"Nansen Transaction With Token Transfer Lookup","description":"Get comprehensive transaction information including token transfers and NFT transfers.\n        This endpoint provides detailed information about a specific transaction including\n        native cryptocurrency movements, token transfers, and NFT transfers with USD values.","url":"https://api.nansen.ai/api/v1/transaction-with-token-transfer-lookup?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","title":"TransactionLookupRequest","required":["chain","transaction_hash"],"properties":{"chain":{"enum":["all","arbitrum","arc","avalanche","base","bitcoin","bnb","ethereum","hyperevm","injective","iotaevm","linea","mantle","mantra","monad","near","optimism","plasma","robinhood","sei","sonic","starknet","sui","ton","tron"],"type":"string","title":"TransactionLookupChain","description":"Blockchain chain for the transaction lookup."},"block_timestamp":{"anyOf":[{"type":"string"}],"title":"Block Timestamp","examples":["2025-08-06 01:47:11"],"description":"Timestamp of the transaction block (format: 'YYYY-MM-DD HH:MM:SS'). Optional for most EVM chains — resolved automatically when omitted. Required for non-EVM chains (bitcoin, tron, ton, starknet, sui)."},"transaction_hash":{"type":"string","title":"Transaction Hash","examples":["0xf16f93cb53f4f977d45b1b08af7b66e1939d0fe69d669012458239b23797e492"],"description":"Transaction hash to lookup"}},"description":"","additionalProperties":false},"responseSchema":{"type":"object","title":"TransactionLookupListResponse","required":["data"],"properties":{"data":{"type":"array","items":{"type":"object","title":"TransactionLookupResponse","required":["chain","transaction_hash","from_address","from_address_label","to_address","to_address_label","native_value","dated_native_price","dated_native_value_usd","current_native_price","current_native_value_usd","receipt_status","block_timestamp","token_transfer_array","nft_transfer_array"],"properties":{"chain":{"type":"string","title":"Chain","description":"The blockchain network of the transaction"},"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":"The status of the transaction receipt (1 for success, 0 for failure)"},"block_timestamp":{"type":"string","title":"Block Timestamp","description":"The timestamp of the block in which the transaction was included"},"to_address_label":{"anyOf":[{"type":"string"}],"title":"To Address Label","description":"The name or label associated with the recipient's address"},"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":"The price of the native cryptocurrency at the time of the transaction"},"from_address_label":{"anyOf":[{"type":"string"}],"title":"From Address Label","description":"The name or label associated with the sender's address"},"nft_transfer_array":{"anyOf":[{"type":"array","items":{"type":"object","title":"NFTTransfer","required":["from_address","from_address_label","to_address","to_address_label","project_id","collection_name","nft_id"],"properties":{"nft_id":{"type":"string","title":"Nft Id","description":"NFT ID"},"project_id":{"type":"string","title":"Project Id","description":"Project ID"},"to_address":{"type":"string","title":"To Address","description":"To address"},"from_address":{"type":"string","title":"From Address","description":"From address"},"collection_name":{"type":"string","title":"Collection Name","description":"Collection name"},"to_address_label":{"type":"string","title":"To Address Label","description":"To address label"},"from_address_label":{"type":"string","title":"From Address Label","description":"From address label"}},"description":"Model for NFT transfer information."}}],"title":"Nft Transfer Array","description":"Information about any NFT transfers associated with this transaction"},"current_native_price":{"anyOf":[{"type":"number"}],"title":"Current Native Price","description":"The current price of the native cryptocurrency"},"token_transfer_array":{"anyOf":[{"type":"array","items":{"type":"object","title":"TokenTransfer","required":["from_address","from_address_label","to_address","to_address_label","token_address","token_symbol","token_amount","dated_price_usd","dated_value_usd","current_price_usd","current_value_usd","transfer_id"],"properties":{"to_address":{"type":"string","title":"To Address","description":"To address"},"transfer_id":{"type":"string","title":"Transfer Id","description":"Transfer ID"},"from_address":{"type":"string","title":"From Address","description":"From address"},"token_amount":{"type":"number","title":"Token Amount","description":"Token amount transferred"},"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":"Price of the token in USD at the time of the transaction"},"dated_value_usd":{"anyOf":[{"type":"number"}],"title":"Dated Value Usd","description":"USD value of the token transferred at the time of the transaction"},"to_address_label":{"type":"string","title":"To Address Label","description":"To address label"},"current_price_usd":{"anyOf":[{"type":"number"}],"title":"Current Price Usd","description":"Current price of the token in USD"},"current_value_usd":{"anyOf":[{"type":"number"}],"title":"Current Value Usd","description":"Current USD value of the token transferred"},"from_address_label":{"type":"string","title":"From Address Label","description":"From address label"}},"description":"Model for token transfer information."}}],"title":"Token Transfer Array","description":"Information about any token transfers associated with this transaction"},"dated_native_value_usd":{"anyOf":[{"type":"number"}],"title":"Dated Native Value Usd","description":"The USD value of the native cryptocurrency transferred at the time of the transaction"},"current_native_value_usd":{"anyOf":[{"type":"number"}],"title":"Current Native Value Usd","description":"The current USD value of the native cryptocurrency transferred"}},"description":"Response model for transaction lookup endpoint.\n\nContains comprehensive transaction information including token transfers and NFT transfers."},"title":"Data","description":"List of transaction lookup results"}},"description":"Response model for transaction lookup endpoint returning a list of transactions."},"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_nOVpR3LifP-hBuXiRWjFj","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":"Retrieves comprehensive details for a specific blockchain transaction, including native crypto movements, token transfers, NFT transfers, and USD valuations.","exampleAgentPrompt":"Can you pull up all the details for Ethereum transaction 0xf16f93cb53f4f977d45b1b08af7b66e1939d0fe69d669012458239b23797e492 — I want to see the token transfers, NFT transfers, USD values, and who sent it?","exampleUseCases":null,"resultDescription":"Returns an array of transaction records each containing: sender and recipient addresses with human-readable labels, native cryptocurrency amount and its USD value (both at transaction time and current), transaction receipt status (success/failure), block timestamp, an array of all ERC-20/token transfers with amounts and USD values, and an array of all NFT transfers involved in the transaction.","failureModes":["Invalid or non-existent transaction hash returns empty data array","Non-EVM chains (bitcoin, tron, ton, starknet, sui) require block_timestamp — omitting it causes an error","Unsupported chain enum value returns validation error","Transaction hash on wrong chain returns no results","Network or rate-limit errors return HTTP 4xx/5xx"],"whenToPreferThis":"Use this endpoint when you need a complete, enriched view of a single transaction including all token and NFT transfer sub-events with USD pricing — especially when address labels (smart money tags) and historical USD valuations matter. Prefer this over generic RPC calls when you need Nansen's proprietary wallet labeling, multi-chain support, and NFT transfer decomposition in one call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T18:40:21.489Z","isFirstParty":false,"canonicalSlug":"nansen-transaction-with-token-transfer-lookup-623d0bb5"}