Hunt Townh402
Catalog
CryptoPOSTlive

Wallet perp trades

Get the perpetual futures trade history for a Hyperliquid wallet address over a date range.

$0.01
per call
Success
100%
p50 latency
1.78s
p95 latency
1.89s
Calls (30d)
3

Provider contract

Call path
/routes/nansen/crypto/wallet-perp-trades
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-perp-trades' \
  -H 'content-type: application/json' \
  -d '{"address":"0x45d26f28196d226497130c4bac709d808fed4029","date":{"from":"2026-05-15T00:00:00Z","to":"2026-05-21T23:59:59Z"}}'
CLI
h402 call 'crypto/wallet-perp-trades' --provider 'nansen' --method POST --json '{"address":"0x45d26f28196d226497130c4bac709d808fed4029","date":{"from":"2026-05-15T00:00:00Z","to":"2026-05-21T23:59:59Z"}}'

Parameters & live test

pays real USDC

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

Hyperliquid wallet address in 42-character hexadecimal format.

e.g.
dateobjectrequired

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

date.fromstringrequired

Inclusive range start.

e.g.
date.tostringrequired

Inclusive range end.

e.g.
paginationobjectoptional

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

pagination.pageintegeroptional≥ 1

1-based page number.

pagination.per_pageintegeroptional1–1000

Results per page (max 1000).

POST/routes/nansen/crypto/wallet-perp-trades
Request body
{
  "address": "0x45d26f28196d226497130c4bac709d808fed4029",
  "date": {
    "from": "2026-05-15T00:00:00Z",
    "to": "2026-05-21T23:59:59Z"
  }
}

ResponseExample response
{
  "data": {
    "pagination": {
      "page": 1,
      "per_page": 10,
      "is_last_page": false
    },
    "data": [
      {
        "timestamp": "2026-05-21T15:35:43.214000",
        "side": "Short",
        "action": "Close",
        "block_number": 1005164102,
        "token_symbol": "BLAST",
        "price": 0.000458,
        "size": 1000000,
        "value_usd": 458,
        "start_position": -1000000,
        "closed_pnl": 326,
        "crossed": true,
        "fee_usd": 0.128239,
        "fee_token_symbol": "USDC",
        "transaction_hash": "0x6d6267aad7b63d0b6edc043be9964602042d009072b95bdd112b12fd96ba16f6",
        "user": "0x45d26f28196d226497130c4bac709d808fed4029",
        "oid": 436204122034
      },
      {
        "timestamp": "2026-05-21T15:35:41.236000",
        "side": "Short",
        "action": "Reduce",
        "block_number": 1005164073,
        "token_symbol": "BLAST",
        "price": 0.000458,
        "size": 1000000,
        "value_usd": 458,
        "start_position": -2000000,
        "closed_pnl": 326,
        "crossed": true,
        "fee_usd": 0.128239,
        "fee_token_symbol": "USDC",
        "transaction_hash": "0x5222f24c0de92c30539c043be996290201d90031a8ec4b02f5eb9d9ecced061a",
        "user": "0x45d26f28196d226497130c4bac709d808fed4029",
        "oid": 436204091744
      },
      {
        "timestamp": "2026-05-21T15:35:39.462000",
        "side": "Short",
        "action": "Reduce",
        "block_number": 1005164047,
        "token_symbol": "BLAST",
        "price": 0.000457802669,
        "size": 1000000,
        "value_usd": 457.802669,
        "start_position": -3000000,
        "closed_pnl": 326.197331,
        "crossed": true,
        "fee_usd": 0.128184,
        "fee_token_symbol": "USDC",
        "transaction_hash": "0x04f9bae3e26e11360673043be9960f02046300c97d613008a8c26636a161eb20",
        "user": "0x45d26f28196d226497130c4bac709d808fed4029",
        "oid": 436204063717
      }
    ]
  },
  "h402": {
    "routeId": "crypto/wallet-perp-trades",
    "provider": "nansen",
    "selectedCandidateId": "crypto/wallet-perp-trades/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.

nansen
x402
100
Success
100%
p50
1.78s
Calls
3
100%
$0.01$0.010/call
Last successful call: 27d ago· Aggregated by h402 — not the source provider