Hunt Townh402
Catalog
CryptoPOSTlive

Wallet perp positions

Get open perpetual futures positions and margin summary for a Hyperliquid wallet address.

$0.01
per call
Success
100%
p50 latency
1.46s
p95 latency
1.65s
Calls (30d)
2

Provider contract

Call path
/routes/nansen/crypto/wallet-perp-positions
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-positions' \
  -H 'content-type: application/json' \
  -d '{"address":"0xa312114b5795dff9b8db50474dd57701aa78ad1e"}'
CLI
h402 call 'crypto/wallet-perp-positions' --provider 'nansen' --method POST --json '{"address":"0xa312114b5795dff9b8db50474dd57701aa78ad1e"}'

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.
POST/routes/nansen/crypto/wallet-perp-positions
Request body
{
  "address": "0xa312114b5795dff9b8db50474dd57701aa78ad1e"
}

ResponseExample response
{
  "data": {
    "data": {
      "asset_positions": [
        {
          "position": {
            "token_symbol": "HYPE",
            "size": "-174925.51",
            "position_value_usd": "10230675.8853089996",
            "entry_price_usd": "69.2059",
            "liquidation_price_usd": "102.0394764568",
            "leverage_value": 10,
            "leverage_type": "cross",
            "leverage_raw_usd": null,
            "margin_used_usd": "1023067.5885299999",
            "max_leverage_value": 10,
            "return_on_equity": "1.5490103308",
            "unrealized_pnl_usd": "1875215.0052700001",
            "cumulative_funding_all_time_usd": "-260495.635108",
            "cumulative_funding_since_change_usd": "-223.585023",
            "cumulative_funding_since_open_usd": "-260495.635108"
          },
          "position_type": "oneWay"
        },
        {
          "position": {
            "token_symbol": "ZEC",
            "size": "-3906.78",
            "position_value_usd": "2001795.0042000001",
            "entry_price_usd": "474.1423",
            "liquidation_price_usd": "2462.4950926936",
            "leverage_value": 5,
            "leverage_type": "cross",
            "leverage_raw_usd": null,
            "margin_used_usd": "400359.00084",
            "max_leverage_value": 10,
            "return_on_equity": "-0.4033347829",
            "unrealized_pnl_usd": "-149425.0469",
            "cumulative_funding_all_time_usd": "-143874.185456",
            "cumulative_funding_since_change_usd": "-4731.065259",
            "cumulative_funding_since_open_usd": "-11484.231067"
          },
          "position_type": "oneWay"
        },
        {
          "position": {
            "token_symbol": "ETH",
            "size": "-1029.1423",
            "position_value_usd": "1995095.26278",
            "entry_price_usd": "1763.17",
            "liquidation_price_usd": "9559.2263927438",
            "leverage_value": 20,
            "leverage_type": "cross",
            "leverage_raw_usd": null,
            "margin_used_usd": "99754.763139",
            "max_leverage_value": 25,
            "return_on_equity": "-1.9898928503",
            "unrealized_pnl_usd": "-180538.66047",
            "cumulative_funding_all_time_usd": "-10449.147308",
            "cumulative_funding_since_change_usd": "-10029.975683",
            "cumulative_funding_since_open_usd": "-10449.147308"
          },
          "position_type": "oneWay"
        }
      ],
      "cross_maintenance_margin_used_usd": "993908.90302",
      "cross_margin_summary_account_value_usd": "2327042.2094879998",
      "cross_margin_summary_total_margin_used_usd": "2227086.8008119999",
      "cross_margin_summary_total_net_liquidation_position_on_usd": "18666543.7900200002",
      "cross_margin_summary_total_raw_usd": "20993585.9995080009",
      "margin_summary_account_value_usd": "2836470.9737669998",
      "margin_summary_total_margin_used_usd": "2736515.5650909999",
      "margin_summary_total_net_liquidation_position_usd": "18782338.8244579993",
      "margin_summary_total_raw_usd": "21618809.7982250005",
      "timestamp": 1784732854843,
      "withdrawable_usd": "0.0"
    }
  },
  "h402": {
    "routeId": "crypto/wallet-perp-positions",
    "provider": "nansen",
    "selectedCandidateId": "crypto/wallet-perp-positions/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.46s
Calls
2
100%
$0.01$0.010/call
Last successful call: 27d ago· Aggregated by h402 — not the source provider