Loading capabilities…
Loading capability…
Get the perpetual futures trade history for a Hyperliquid wallet address over a date range.
Both commands call the selected provider directly.
curl -X POST '/routes/nansen/crypto/wallet-perp-trades' \
-H 'content-type: application/json' \
-d '{"address":"0x45d26f28196d226497130c4bac709d808fed4029","pagination":{"page":1,"per_page":10}}'h402 call 'crypto/wallet-perp-trades' --provider 'nansen' --method POST --json '{"address":"0x45d26f28196d226497130c4bac709d808fed4029","pagination":{"page":1,"per_page":10}}'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.
addressstringrequired42–42 charsHyperliquid wallet address in 42-character hexadecimal format.
dateobjectrequiredTrade-history window; either or both ISO 8601 date/date-time bounds may be supplied.
date.fromstringoptional10–35 charsOptional inclusive start in ISO 8601 date or date-time format.
date.tostringoptional10–35 charsOptional inclusive end in ISO 8601 date or date-time format.
filtersobjectoptionalOptional Nansen perpetual-trade filters.
filters.token_symbolstringoptionalToken symbol to match.
filters.sidestringoptionalTrade side.
filters.actionstringoptionalTrade action.
filters.crossedbooleanoptionalWhether the trade crossed the spread.
filters.sizeobjectoptionalTrade-size range.
Nested fields
minnumberMinimum value (inclusive).
maxnumberMaximum value (inclusive).
filters.start_positionobjectoptionalStarting-position range.
Nested fields
minnumberMinimum value (inclusive).
maxnumberMaximum value (inclusive).
filters.closed_pnlobjectoptionalClosed-PnL range in USD.
Nested fields
minnumberMinimum value (inclusive).
maxnumberMaximum value (inclusive).
filters.fee_usdobjectoptionalFee range in USD.
Nested fields
minnumberMinimum value (inclusive).
maxnumberMaximum value (inclusive).
filters.fee_token_symbolstringoptionalFee token symbol.
filters.priceobjectoptionalExecution-price range in USD.
Nested fields
minnumberMinimum value (inclusive).
maxnumberMaximum value (inclusive).
filters.value_usdobjectoptionalTrade-value range in USD.
Nested fields
minnumberMinimum value (inclusive).
maxnumberMaximum value (inclusive).
filters.oidobjectoptionalOrder ID range.
Nested fields
minintegerMinimum value (inclusive).
maxintegerMaximum value (inclusive).
paginationobjectoptionalOptional Nansen pagination using page and per_page.
pagination.pageintegeroptional≥ 1default 11-based page number.
pagination.per_pageintegeroptional1–1000default 10Results per page (max 1000).
order_byarrayoptionalOptional trade sort clauses.
Nested fields
fieldstringrequiredOne of timestamp, size, fee_usd, closed_pnl, price, value_usdField to sort by.
directionstringrequiredOne of ASC, DESCSort direction.
{
"address": "0x45d26f28196d226497130c4bac709d808fed4029",
"pagination": {
"page": 1,
"per_page": 10
}
}{ "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" } }
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.