Retrieve recent blockchain transactions for any wallet address via Nansen's profiler API.
What it does
This 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 Profiler suite, which provides wallet-level analytics across 25+ chains including Ethereum, Solana, Base, Bitcoin, Arbitrum, and more.
The endpoint accepts a POST request with the wallet address, chain, date range, and optional filters (token symbol, counterparty, volume, method, source type). It supports pagination (max 100 per page) and sorting by block timestamp. Responses include detailed transaction records with tokens sent/received, USD volume, counterparty labels, and source type (e.g., DEX, transfer). The API uses a credit-based system (10 credits on free tier, 1 on pro) and also supports pay-per-request via x402 at $0.01 per call. Rate limits are enforced per-second and per-minute, reported via response headers.
Nansen labels addresses with behavioral, DeFi, CEX, ENS, and smart money tags, enriching transaction data beyond raw on-chain records. The endpoint can filter by spam tokens by default. It sits alongside related profiler endpoints for balances, PnL, counterparties, historical balances, related wallets, and labels.
Capabilities
Use cases
- —Retrieve recent token transfers and native currency movements for a specific wallet address
- —Monitor wallet activity across multiple blockchains for compliance or research
- —Filter transactions by token, counterparty, or USD volume for forensic analysis
- —Build wallet activity feeds in portfolio trackers or dashboards
- —Identify DEX trades vs. direct transfers for a given address
Fit
Best for
- —Blockchain researchers needing labeled, multi-chain wallet transaction data
- —Portfolio and compliance tools requiring enriched on-chain transaction feeds
- —Agents that need to look up recent activity for any EVM or Solana address
Not for
- —Real-time streaming of transactions (this is a polling/query API)
- —Historical data beyond the supported date ranges or chains not listed in the schema
Quick start
curl -X POST https://api.nansen.ai/api/v1/profiler/address/transactions \
-H 'Content-Type: application/json' \
-H 'apiKey: YOUR_API_KEY' \
-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": "Binance 14"
}
],
"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 pricing ($0.01 via x402, 1 credit on pro), multi-chain support documented, and the endpoint returned 402 confirming it is live. Slightly below 0.9 because no crawled documentation pages were available (all returned route-not-found) and no actual 200 response example was captured.
Warnings
- —No external documentation pages were reachable (all returned 'no Route matched'); schema is the sole source of truth.
- —Response schema references ProfilerAddressTransactionsResponse but full field-level detail for ProfilerTransaction relies on the OpenAPI $ref chain which was provided.
Citations
- —Endpoint is POST /api/v1/profiler/address/transactions with operationId get_profiler_address_transactions_api_v1_profiler_address_transactions_posthttps://api.nansen.ai
- —Credit cost is 10 (free) / 1 (pro) and x402 price is $0.01 per callhttps://api.nansen.ai
- —Supports 25+ chains including ethereum, solana, base, bitcoin, arbitrum, etc.https://api.nansen.ai
- —Pagination max is 100 per page for this profiler endpointhttps://api.nansen.ai
- —Endpoint returned HTTP 402 on HEAD probe confirming it is live via MPP protocolhttps://api.nansen.ai/api/v1/profiler/address/transactions