Hunt Townh402
Catalog
CryptoPOSTlive

Wallet transactions

Get the transaction history for a wallet address over a date range, with optional spam-token filtering.

$0.01
per call
Success
100%
p50 latency
3.45s
p95 latency
4.55s
Calls (30d)
14

Provider contract

Call path
/routes/
nansendefault
/crypto/wallet-transactions
Method
POST
Selected provider
nansendefault
Provider price
$0.01
Settlement
Base USDC · x402 · 5% h402 fee

Quickstart

Both commands call the selected provider directly.

cURL
curl -X POST '/routes/nansen/crypto/wallet-transactions' \
  -H 'content-type: application/json' \
  -d '{"address":"0x28c6c06298d514db089934071355e5743bf21d60","chain":"ethereum","date":{"from":"2026-05-15T00:00:00Z","to":"2026-05-21T23:59:59Z"},"hide_spam_token":true}'
CLI
h402 call 'crypto/wallet-transactions' --provider 'nansen' --method POST --json '{"address":"0x28c6c06298d514db089934071355e5743bf21d60","chain":"ethereum","date":{"from":"2026-05-15T00:00:00Z","to":"2026-05-21T23:59:59Z"},"hide_spam_token":true}'

Parameters & live test

pays real USDC
nansendefault$0.010/call

Fill the request fields, quote the exact per-call total, then choose x402 or eligible bonus credit explicitly before sending. Only the selected provider's listed parameters are accepted.

addressstringrequired

Wallet address to get transactions for.

e.g.
chainstringrequired

Nansen chain slug for the transactions. Use 'all' to span every supported chain.

One of
dateobjectrequired

ISO 8601 date-time range for the transactions, with from and to fields.

date.fromstringrequired

Inclusive range start.

e.g.
date.tostringrequired

Inclusive range end.

e.g.
hide_spam_tokenbooleanoptionaldefault true

Remove suspicious/spam tokens from the transaction list. Defaults to true.

paginationobjectoptional

Optional pagination, e.g. { "page": 1, "perPage": 10 }.

pagination.pageintegeroptional≥ 1

1-based page number.

pagination.per_pageintegeroptional1–100

Results per page (max 100).

POST/routes/nansen/crypto/wallet-transactions
Request body
{
  "address": "0x28c6c06298d514db089934071355e5743bf21d60",
  "chain": "ethereum",
  "date": {
    "from": "2026-05-15T00:00:00Z",
    "to": "2026-05-21T23:59:59Z"
  },
  "hide_spam_token": true
}

ResponseExample response
{
  "data": {
    "pagination": {
      "page": 1,
      "per_page": 20,
      "is_last_page": false
    },
    "data": [
      {
        "chain": "ethereum",
        "method": "transfer(address,uint256)",
        "tokens_sent": [
          {
            "token_symbol": "USDT",
            "token_amount": -498.89,
            "price_usd": null,
            "value_usd": null,
            "token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
            "chain": "ethereum",
            "from_address": "0x28c6c06298d514db089934071355e5743bf21d60",
            "to_address": "0x9db7c3231f49c57799e29ccb717c59f750ad37b6",
            "from_address_label": "🏦 Binance 14 [0x28c6c0]",
            "to_address_label": "🏦 Gate: Deposit [0x9db7c3]"
          }
        ],
        "tokens_received": [],
        "volume_usd": 498.38297264589573,
        "block_timestamp": "2026-05-21T23:59:47",
        "transaction_hash": "0xc4a76108e991e00b6df8563dab2458d66fee954fa95a785f6802bc4f7fac2ff9",
        "source_type": "transfer"
      },
      {
        "chain": "ethereum",
        "method": "sent",
        "tokens_sent": [
          {
            "token_symbol": "ETH",
            "token_amount": -0.01398,
            "price_usd": null,
            "value_usd": null,
            "token_address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
            "chain": "ethereum",
            "from_address": "0x28c6c06298d514db089934071355e5743bf21d60",
            "to_address": "0x57225b27021f452ca958a6894a0ab3aa819f79b0",
            "from_address_label": "🏦 Binance 14 [0x28c6c0]",
            "to_address_label": "stake.com: Deposit [0x57225b]"
          }
        ],
        "tokens_received": [],
        "volume_usd": 29.81877242881284,
        "block_timestamp": "2026-05-21T23:59:47",
        "transaction_hash": "0xc7a00ae23fa8b1bfc8a7945a8e128713c8156da45e100bad0093f7ee113a9d9a",
        "source_type": "transfer"
      },
      {
        "chain": "ethereum",
        "method": "transfer(address,uint256)",
        "tokens_sent": [
          {
            "token_symbol": "SAHARA",
            "token_amount": -27047.999999999996,
            "price_usd": null,
            "value_usd": null,
            "token_address": "0xfdffb411c4a70aa7c95d5c981a6fb4da867e1111",
            "chain": "ethereum",
            "from_address": "0x28c6c06298d514db089934071355e5743bf21d60",
            "to_address": "0x6920322e30e8ab3684bf018b379e455e46a7557b",
            "from_address_label": "🏦 Binance 14 [0x28c6c0]",
            "to_address_label": "High Activity [0x692032]"
          }
        ],
        "tokens_received": [],
        "volume_usd": 967.4172409053637,
        "block_timestamp": "2026-05-21T23:59:23",
        "transaction_hash": "0x689beaf15a1c9743ce0788bbc9f9a58bb77a204bcb449e36848e3630343f35d2",
        "source_type": "transfer"
      }
    ]
  },
  "h402": {
    "routeId": "crypto/wallet-transactions",
    "provider": "nansen",
    "selectedCandidateId": "crypto/wallet-transactions/nansen",
    "routing": "manual",
    "paidBy": "x402-exact"
  }
}

Providers

Choose a provider for this task. The catalog recommends the current default from quality, reliability, and price; your selected provider stays pinned. Listed prices are provider prices; settlement adds a 5% h402 fee.

nansendefaultcheapest
x402
100
Success
100%
p50
3.49s
Calls
7
100%
$0.01$0.010/call
allium
x402mpp
100
Success
100%
p50
3.45s
Calls
7
100%
$0.03$0.030/call
Last successful call: 27d ago· Aggregated by h402 — not the source provider