Retrieve recent blockchain transactions for any address via Nansen's on-chain analytics API.
What it does
The Nansen Profiler Address Transactions endpoint returns recent blockchain transactions for a given wallet address, including token transfers, native currency movements, and contract interactions. It is part of Nansen's broader API (v1) which covers smart money tracking, token analytics (Token God Mode), wallet profiling, prediction markets, and more.
This specific endpoint accepts a POST request with an address, chain, date range, and optional filters (token symbol, counterparty, volume, method, source type). It supports pagination (max 100 per page), sorting by block timestamp, and a spam-token filter. The response includes detailed transaction records with tokens sent/received, USD volume, counterparty labels, and transaction hashes. Supported chains include Ethereum, Solana, Base, Arbitrum, Polygon, BNB, and 20+ others.
Pricing via x402 is $0.01 per request (fixed). Alternatively, Nansen credit costs are 10 credits (free tier) or 1 credit (pro tier) per call. Rate limits are exposed via response headers (per-second and per-minute). The endpoint is live and returns a 402 x402 payment challenge when called without authentication.
Capabilities
Use cases
- —Retrieve recent token transfers and native movements for a specific wallet address
- —Monitor wallet activity across 25+ blockchains with date-range and token filters
- —Build wallet profiling dashboards showing inflows, outflows, and counterparty labels
- —Automate compliance or investigation workflows by querying address transaction histories
- —Feed on-chain transaction data into AI agents for portfolio or risk analysis
Fit
Best for
- —Agents needing per-address blockchain transaction history across many chains
- —Wallet profiling and counterparty analysis applications
- —On-chain investigation and compliance tooling
Not for
- —Bulk historical block-level data ingestion (use a dedicated indexer)
- —Real-time mempool or pending transaction monitoring
- —Free-tier heavy usage (10 credits per call on free plan adds up quickly)
Quick start
curl -X POST https://api.nansen.ai/api/v1/profiler/address/transactions \
-H 'Content-Type: application/json' \
-d '{
"address": "0x28c6c06298d514db089934071355e5743bf21d60",
"chain": "ethereum",
"date": {"from": "2025-01-01T00:00:00Z", "to": "2025-01-07T23:59:59Z"},
"pagination": {"page": 1, "per_page": 10}
}'Example
Request
{
"date": {
"to": "2025-01-07T23:59:59Z",
"from": "2025-01-01T00:00:00Z"
},
"chain": "ethereum",
"address": "0x28c6c06298d514db089934071355e5743bf21d60",
"filters": {
"volume_usd": {
"min": 100
}
},
"pagination": {
"page": 1,
"per_page": 10
},
"hide_spam_token": true
}Response
{
"data": [
{
"chain": "ethereum",
"method": "sent",
"volume_usd": 5000,
"source_type": "transfer",
"tokens_sent": [
{
"chain": "ethereum",
"price_usd": 1,
"value_usd": 5000,
"to_address": "0x742d35cc6634c0532925a3b8d4c9db96c4b4d8b6",
"from_address": "0x28c6c06298d514db089934071355e5743bf21d60",
"token_amount": 5000,
"token_symbol": "USDC",
"token_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"to_address_label": null,
"from_address_label": null
}
],
"block_timestamp": "2025-01-02T14:30:00Z",
"tokens_received": null,
"transaction_hash": "0xabc123..."
}
],
"pagination": {
"page": 1,
"per_page": 10,
"is_last_page": false
}
}Endpoint
Quality
Full OpenAPI 3.1 schema with detailed request/response models, clear x402 pricing ($0.01/call), live 402 challenge confirmed, and comprehensive endpoint documentation. Minor gap: no crawled human-readable docs page (returns 404), but the OpenAPI spec is thorough.
Warnings
- —No human-readable documentation page found at api.nansen.ai/docs (returns 404); rely on OpenAPI spec only.
- —Pagination capped at 100 per page for this profiler endpoint (unlike 1000 for other Nansen endpoints).
Citations
- —Endpoint price is $0.01 per request via x402 protocolhttps://api.nansen.ai
- —Credit cost is 10 (free) / 1 (pro) per callhttps://api.nansen.ai
- —Endpoint supports 25+ chains including ethereum, solana, base, arbitrum, polygon, bnb, bitcoin, etc.https://api.nansen.ai
- —Endpoint returns 402 x402 payment challenge when called without authenticationhttps://api.nansen.ai