Look up blockchain transactions with token and NFT transfer details via Nansen's on-chain analytics API.
What it does
This endpoint retrieves comprehensive information about a specific blockchain transaction, including native cryptocurrency movements, ERC-20 token transfers, and NFT transfers with both historical and current USD valuations. It is part of Nansen's broader API suite for blockchain analytics and smart money intelligence.
The endpoint accepts a POST request with a chain identifier, transaction hash, and block timestamp. It returns detailed data including sender/receiver addresses with Nansen labels, native value transferred with dated and current USD prices, token transfer arrays with per-token USD values, and NFT transfer arrays with collection metadata. Supported chains include Ethereum, Base, Arbitrum, Solana, Polygon, BNB, and many others (24+ chains total).
Pricing is $0.01 per call via the x402 protocol, or 10 credits (free tier) / 1 credit (pro tier) when using a Nansen API key. The endpoint returns standard rate-limit headers and credits-remaining headers. Authentication is via API key or x402 payment signature. The API is documented with a full OpenAPI 3.1.0 schema.
Capabilities
Use cases
- —Retrieve full details of a blockchain transaction including all token and NFT transfers
- —Identify labeled addresses (exchanges, smart money, etc.) involved in a specific transaction
- —Get historical and current USD valuations for token transfers in a transaction
- —Audit or verify on-chain activity for compliance or research purposes
- —Build transaction explorers or notification systems with enriched Nansen label data
Fit
Best for
- —Agents needing enriched transaction data with Nansen address labels
- —On-chain forensics and wallet investigation workflows
- —Building transaction detail views in portfolio or analytics dashboards
Not for
- —Streaming real-time transaction feeds (this is a single-tx lookup)
- —Bulk historical transaction scanning (use profiler/address/transactions for that)
- —Price feeds or market data (use token-ohlcv or token-screener instead)
Quick start
curl -X POST https://api.nansen.ai/api/v1/transaction-with-token-transfer-lookup \
-H 'Content-Type: application/json' \
-H 'apiKey: YOUR_API_KEY' \
-d '{
"chain": "ethereum",
"transaction_hash": "0xf16f93cb53f4f977d45b1b08af7b66e1939d0fe69d669012458239b23797e492",
"block_timestamp": "2025-08-06 01:47:11"
}'Example
Request
{
"chain": "ethereum",
"block_timestamp": "2025-08-06 01:47:11",
"transaction_hash": "0xf16f93cb53f4f977d45b1b08af7b66e1939d0fe69d669012458239b23797e492"
}Response
{
"data": [
{
"chain": "ethereum",
"to_address": "0x742d35cc6634c0532925a3b8d4c9db96c4b4d8b6",
"from_address": "0x28c6c06298d514db089934071355e5743bf21d60",
"native_value": 1.5,
"receipt_status": 1,
"block_timestamp": "2025-08-06 01:47:11",
"to_address_label": "High Balance",
"transaction_hash": "0xf16f93cb53f4f977d45b1b08af7b66e1939d0fe69d669012458239b23797e492",
"dated_native_price": 3200.5,
"from_address_label": "Binance 14",
"nft_transfer_array": [],
"current_native_price": 3300,
"token_transfer_array": [],
"dated_native_value_usd": 4800.75,
"current_native_value_usd": 4950
}
]
}Endpoint
Quality
Full OpenAPI 3.1.0 schema with detailed request/response models, clear pricing ($0.01/call via x402), endpoint confirmed live via 402 MPP challenge, and 24+ supported chains documented. Minor deduction: no crawled documentation pages beyond the API root, and response schema references are not fully resolved in the probe.
Warnings
- —No external documentation pages were successfully crawled; docs endpoint returned 404
- —Response schema uses $ref to TransactionLookupListResponse which is defined in components but example response is inferred from schema, not from a live call
Citations
- —Endpoint is POST /api/v1/transaction-with-token-transfer-lookup under the Profiler taghttps://api.nansen.ai
- —Price is $0.01 per call via x402 protocol, or 10 credits (free) / 1 credit (pro)https://api.nansen.ai
- —Supported chains include ethereum, base, arbitrum, bitcoin, bnb, solana, polygon, and 17+ othershttps://api.nansen.ai
- —Endpoint returns token_transfer_array and nft_transfer_array with USD valuationshttps://api.nansen.ai
- —Endpoint is live, returning HTTP 402 on HEAD probe (MPP challenge)https://api.nansen.ai/api/v1/transaction-with-token-transfer-lookup