Parameters2
| Parameter | Type | Default | Example |
|---|---|---|---|
conversation_id | string | null | conv_abc123 |
text | string | null | Which tokens are whales accumulating on Ethereum this week? |
Service overview
Wallet labels + smart money flows + analytics
Level up your agent by giving it access to thousands of services. All payable per-request via x402. No API keys, no accounts.
Paste into your agentic chat and let your agent guide you.
npx awal x402 pay "https://api.nansen.ai/api/v1/agent/fast" \
--method POST \
--data '{
"conversation_id": "{conversation_id}",
"text": "{text}"
}'{
"endpoint": "POST /api/v1/agent/fast",
"paid": true,
"query": "best x402 data APIs",
"result": [
{
"snippet": "Compact result summary.",
"title": "Example result",
"url": "https://example.com"
}
]
}API surface
59 crawlable routes
| Parameter | Type | Default | Example |
|---|---|---|---|
conversation_id | string | null | conv_abc123 |
text | string | null | Which tokens are whales accumulating on Ethereum this week? |
| Parameter | Type | Default | Example |
|---|---|---|---|
chain_type | string | null | all |
time_frame | number | null | 7 |
| Parameter | Type | Default | Example |
|---|---|---|---|
limit | number | null | 25 |
market_cap_group | string | null | largecap |
| Parameter | Type | Default | Example |
|---|---|---|---|
date | object | null | null |
filters | object | null | null |
order_by | array | null | [] |
| Parameter | Type | Default | Example |
|---|---|---|---|
address | string | null | 0x1234567890abcdef1234567890abcdef12345678 |
| Parameter | Type | Default | Example |
|---|---|---|---|
pagination | object | null | null |
| Parameter | Type | Default | Example |
|---|---|---|---|
end_date_after | string | null | 2025-01-01T00:00:00Z |
end_date_before | string | null | 2025-12-31T23:59:59Z |
order_by | array | null | [] |
query | string | null | bitcoin |
status | string | null | active |
tags | array | null | [] |
| Parameter | Type | Default | Example |
|---|---|---|---|
end_date_after | string | null | 2025-01-01T00:00:00Z |
end_date_before | string | null | 2025-12-31T23:59:59Z |
order_by | array | null | [] |
query | string | null | bitcoin |
status | string | null | active |
tags | array | null | [] |
| Parameter | Type | Default | Example |
|---|---|---|---|
date | object | null | null |
market_id | string | null | 654412 |
order_by | array | null | [] |
| Parameter | Type | Default | Example |
|---|---|---|---|
market_id | string | null | 654412 |
| Parameter | Type | Default | Example |
|---|---|---|---|
address | string | null | 0x1234567890abcdef1234567890abcdef12345678 |
order_by | array | null | [] |
| Parameter | Type | Default | Example |
|---|---|---|---|
market_id | string | null | 654412 |
order_by | array | null | [] |
| Parameter | Type | Default | Example |
|---|---|---|---|
market_id | string | null | 654412 |
| Parameter | Type | Default | Example |
|---|---|---|---|
market_id | string | null | 654412 |
order_by | array | null | [] |
| Parameter | Type | Default | Example |
|---|---|---|---|
address | string | null | 0x1234567890abcdef1234567890abcdef12345678 |
date | object | null | null |
order_by | array | null | [] |
| Parameter | Type | Default | Example |
|---|---|---|---|
address | string | null | 0x28c6c06298d514db089934071355e5743bf21d60 |
chain | string | null | ethereum |
date | object | null | null |
group_by | string | null | wallet |
pagination | object | null | null |
source_input | string | null | Combined |
| Parameter | Type | Default | Example |
|---|---|---|---|
address | string | null | 0x28c6c06298d514db089934071355e5743bf21d60 |
chain | string | null | ethereum |
hide_spam_token | boolean | null | true |
pagination | object | null | null |
| Parameter | Type | Default | Example |
|---|---|---|---|
address | string | null | 0x28c6c06298d514db089934071355e5743bf21d60 |
chain | string | null | all |
| Parameter | Type | Default | Example |
|---|---|---|---|
address | string | null | 0x28c6c06298d514db089934071355e5743bf21d60 |
chain | string | null | ethereum |
date | object | null | null |
pagination | object | null | null |
| Parameter | Type | Default | Example |
|---|---|---|---|
address | string | null | 0x39d52da6beec991f075eebe577474fd105c5caec |
chain | string | null | ethereum |
date | object | null | null |
pagination | object | null | null |
| Parameter | Type | Default | Example |
|---|---|---|---|
address | string | null | 0x39d52da6beec991f075eebe577474fd105c5caec |
chain | string | null | ethereum |
date | object | null | null |
| Parameter | Type | Default | Example |
|---|---|---|---|
address | string | null | 0x28c6c06298d514db089934071355e5743bf21d60 |
chain | string | null | ethereum |
| Parameter | Type | Default | Example |
|---|---|---|---|
address | string | null | 0x28c6c06298d514db089934071355e5743bf21d60 |
chain | string | null | ethereum |
date | object | null | null |
filters | object | null | null |
hide_spam_token | boolean | null | true |
| Parameter | Type | Default | Example |
|---|---|---|---|
address | string | null | 0x45d26f28196d226497130c4bac709d808fed4029 |
date | object | null | null |
filters | object | null | null |
order_by | array | null | [] |
| Parameter | Type | Default | Example |
|---|---|---|---|
filters | object | null | null |
| Parameter | Type | Default | Example |
|---|---|---|---|
chains | array | null | [] |
filters | object | null | null |
| Parameter | Type | Default | Example |
|---|---|---|---|
chains | array | null | [] |
date_range | object | null | null |
filters | object | null | null |
| Parameter | Type | Default | Example |
|---|---|---|---|
chains | array | null | [] |
filters | object | null | null |
| Parameter | Type | Default | Example |
|---|---|---|---|
chains | array | null | [] |
filters | object | null | null |
order_by | array | null | [] |
| Parameter | Type | Default | Example |
|---|---|---|---|
filters | object | null | null |
only_new_positions | boolean | null | true |
| Parameter | Type | Default | Example |
|---|---|---|---|
chains | array | null | [] |
filters | object | null | null |
order_by | array | null | [] |
timeframe | number | null | 7 |
| Parameter | Type | Default | Example |
|---|---|---|---|
chain | string | null | solana |
date | object | null | null |
filters | object | null | null |
only_smart_money | boolean | null | false |
token_address | string | null | 2zMMhcVQEXDtdE6vsFS7S7D5oUodfJHE8vd1gnBouauv |
| Parameter | Type | Default | Example |
|---|---|---|---|
chain | string | null | ethereum |
filters | object | null | null |
token_address | string | null | 0x6982508145454ce325ddbe47a25d4ec3d2311933 |
| Parameter | Type | Default | Example |
|---|---|---|---|
chain | string | null | solana |
date | object | null | null |
filters | object | null | null |
label | string | null | smart_money |
token_address | string | null | 2zMMhcVQEXDtdE6vsFS7S7D5oUodfJHE8vd1gnBouauv |
| Parameter | Type | Default | Example |
|---|---|---|---|
aggregate_by_entity | boolean | null | false |
chain | string | null | solana |
filters | object | null | null |
label_type | string | null | all_holders |
token_address | string | null | 2zMMhcVQEXDtdE6vsFS7S7D5oUodfJHE8vd1gnBouauv |
| Parameter | Type | Default | Example |
|---|---|---|---|
chain | string | null | ethereum |
token_address | string | null | 0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9 |
| Parameter | Type | Default | Example |
|---|---|---|---|
filters | object | null | null |
token_address | string | null | 2zMMhcVQEXDtdE6vsFS7S7D5oUodfJHE8vd1gnBouauv |
| Parameter | Type | Default | Example |
|---|---|---|---|
date | object | null | null |
filters | object | null | null |
token_symbol | string | null | BTC |
| Parameter | Type | Default | Example |
|---|---|---|---|
filters | object | null | null |
label_type | string | null | all_traders |
token_symbol | string | null | BTC |
| Parameter | Type | Default | Example |
|---|---|---|---|
date | object | null | null |
filters | object | null | null |
token_symbol | string | null | BTC |
| Parameter | Type | Default | Example |
|---|---|---|---|
chain | string | null | ethereum |
date | object | null | null |
filters | object | null | null |
token_address | string | null | 0x6982508145454ce325ddbe47a25d4ec3d2311933 |
| Parameter | Type | Default | Example |
|---|---|---|---|
chain | string | null | ethereum |
timeframe | string | null | 1d |
token_address | string | null | 0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9 |
| Parameter | Type | Default | Example |
|---|---|---|---|
chain | string | null | ethereum |
timeframe | string | null | 1h |
token_address | string | null | 0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9 |
token_addresses | array | null | [] |
| Parameter | Type | Default | Example |
|---|---|---|---|
chain | string | null | solana |
date | object | null | null |
filters | object | null | null |
token_address | string | null | 2zMMhcVQEXDtdE6vsFS7S7D5oUodfJHE8vd1gnBouauv |
| Parameter | Type | Default | Example |
|---|---|---|---|
chains | array | null | [] |
date | object | null | null |
filters | object | null | null |
timeframe | string | null | 24h |
| Parameter | Type | Default | Example |
|---|---|---|---|
block_timestamp | string | null | 2025-08-06 01:47:11 |
chain | string | null | ethereum |
transaction_hash | string | null | 0xf16f93cb53f4f977d45b1b08af7b66e1939d0fe69d669012458239b23797e492 |
| Parameter | Type | Default | Example |
|---|---|---|---|
address | string | null | 0xd8da6bf26964af9d7eed9e03e53415d37aa96045 |
apply_blacklist_filter | boolean | null | true |
as_of_date | string | null | 2025-06-15 |
chain | string | null | ethereum |
hide_spam_token | boolean | null | true |
| Parameter | Type | Default | Example |
|---|---|---|---|
apply_blacklist_filter | boolean | null | true |
as_of_date | string | null | 2025-06-15 |
block_timestamp | string | null | 2025-01-15 00:00:11 |
chain | string | null | ethereum |
transaction_hash | string | null | 0x13c97b56d431cb0de39086ab493530068d01acf227d80c00d447b577ae2e9db4 |
| Parameter | Type | Default | Example |
|---|---|---|---|
apply_blacklist_filter | boolean | null | true |
chain | string | null | ethereum |
date_range | object | null | null |
token_address | string | null | 0x6982508145454ce325ddbe47a25d4ec3d2311933 |
| Parameter | Type | Default | Example |
|---|---|---|---|
apply_blacklist_filter | boolean | null | true |
chain | string | null | ethereum |
date_range | object | null | null |
token_address | string | null | 0x6982508145454ce325ddbe47a25d4ec3d2311933 |
| Parameter | Type | Default | Example |
|---|---|---|---|
apply_blacklist_filter | boolean | null | true |
chain | string | null | ethereum |
date_range | object | null | null |
token_address | string | null | 0x6982508145454ce325ddbe47a25d4ec3d2311933 |
| Parameter | Type | Default | Example |
|---|---|---|---|
apply_blacklist_filter | boolean | null | true |
as_of_date | string | null | 2025-06-07T23:59:59Z |
as_of_ts | string | null | 2026-03-30T12:02:17.123456Z |
chain | string | null | ethereum |
date_from | string | null | 2025-06-01T00:00:00Z |
timeframe | string | null | 1d |
token_address | string | null | 0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9 |
| Parameter | Type | Default | Example |
|---|---|---|---|
as_of_date | string | null | 2025-06-01 |
chain | string | null | ethereum |
token_address | string | null | 0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9 |
FAQ
Data
Travel content API — access detailed location data, traveler photos, and reviews for hotels, restaurants, and attractions worldwide.
Data
Indexing protocol for querying blockchain data with subgraphs
Data
Crypto prices, rankings, and market data