{"version":2,"name":"Pa1m Hyperliquid","description":"Hyperliquid DEX data: prices, order books, candles, funding rates, portfolios.","payTo":"0xE43b08f2031e3332ce97C0E0EA6E8bB00bd04fB4","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","endpoints":[{"path":"/prices","method":"GET","price":"0.001","description":"All ~170 Hyperliquid perpetual mid prices as a coin -> price map.","queryParams":{},"pathParams":{},"outputExample":{"BTC":"67234.5","ETH":"3456.7"}},{"path":"/meta","method":"GET","price":"0.001","description":"Perp asset universe with max leverage tiers and margin table IDs.","queryParams":{},"pathParams":{},"outputExample":{"universe":[{"name":"BTC","maxLeverage":40}]}},{"path":"/orderbook/{coin}","method":"GET","price":"0.001","description":"L2 order book snapshot for one coin, up to 20 levels per side.","queryParams":{},"pathParams":{"coin":{"type":"string","description":"Coin ticker, e.g. BTC","required":true,"sample":"BTC"}},"outputExample":{"coin":"BTC","levels":[[{"px":"67234.5","sz":"0.1"}],[]]}},{"path":"/candles/{coin}","method":"GET","price":"0.001","description":"OHLCV candles for one coin over a chosen interval and lookback.","queryParams":{"interval":{"type":"string","description":"1m, 5m, 15m, 1h, 4h or 1d","required":false,"sample":"1h"},"lookback":{"type":"integer","description":"Number of candles, max 5000","required":false,"sample":100}},"pathParams":{"coin":{"type":"string","description":"Coin ticker, e.g. ETH","required":true,"sample":"ETH"}},"outputExample":[{"t":1730000000000,"o":"3456.7","h":"3470.0","l":"3450.1","c":"3465.2","v":"1234.5"}]},{"path":"/funding","method":"GET","price":"0.003","description":"Current funding rates and open interest for every perp. Use before opening a position to price the carry.","queryParams":{},"pathParams":{},"outputExample":[{"coin":"BTC","funding":"0.0000125","openInterest":"12345.6"}]},{"path":"/predicted-funding","method":"GET","price":"0.005","description":"Predicted next-period funding rates for all perps. No other x402 agent exposes this feed — it is the only agent-payable source in the ecosystem. Use for funding arbitrage and carry positioning before the next settlement.","queryParams":{},"pathParams":{},"outputExample":[["BTC",[["HlPerp",{"fundingRate":"0.0000125"}]]]]},{"path":"/portfolio/{address}","method":"GET","price":"0.003","description":"Open perpetual positions and margin summary for a wallet address.","queryParams":{},"pathParams":{"address":{"type":"string","description":"EVM wallet address, 0x...","required":true,"sample":"0x0000000000000000000000000000000000000000"}},"outputExample":{"assetPositions":[],"marginSummary":{"accountValue":"0.0"}}},{"path":"/history/{address}","method":"GET","price":"0.003","description":"Up to 2000 most recent trade fills for a wallet address.","queryParams":{},"pathParams":{"address":{"type":"string","description":"EVM wallet address, 0x...","required":true,"sample":"0x0000000000000000000000000000000000000000"}},"outputExample":[{"coin":"BTC","px":"67234.5","sz":"0.01","side":"B","time":1730000000000}]},{"path":"/open-orders/{address}","method":"GET","price":"0.003","description":"All resting open orders for a wallet address.","queryParams":{},"pathParams":{"address":{"type":"string","description":"EVM wallet address, 0x...","required":true,"sample":"0x0000000000000000000000000000000000000000"}},"outputExample":[{"coin":"ETH","limitPx":"3400.0","sz":"1.0","side":"B","oid":123456}]},{"path":"/leaderboard","method":"GET","price":"0.003","description":"Top 100 Hyperliquid traders ranked by PnL over a chosen window.","queryParams":{"window":{"type":"string","description":"day, week, month or allTime","required":false,"sample":"allTime"}},"pathParams":{},"outputExample":[{"address":"0x...","pnl":"123456.7","volume":"9876543.2"}]},{"path":"/funding/arb","method":"GET","price":"0.005","description":"Derived analytics: raw hourly funding rates annualised to APR, ranked, and enriched with earnSide. The public API returns raw rates only — this layer does the math. Use for basis trades or carry-cost estimation.","queryParams":{},"pathParams":{},"outputExample":[{"coin":"BTC","hourlyRate":1.25e-05,"annualisedPct":10.95,"earnSide":"short"}]},{"path":"/risk/{address}","method":"GET","price":"0.005","description":"Derived analytics: distance-to-liquidation and risk tier (critical/high/medium/low) per position, computed from portfolio + margin data. Not available directly from the public API. Use for position monitoring and sizing.","queryParams":{},"pathParams":{"address":{"type":"string","description":"EVM wallet address, 0x...","required":true,"sample":"0x0000000000000000000000000000000000000000"}},"outputExample":{"positions":[{"coin":"BTC","distanceToLiquidationPct":22.4,"riskLevel":"medium"}]}},{"path":"/whales","method":"GET","price":"0.020","description":"Computed aggregate net long/short positioning by coin across top traders — not a raw API passthrough. Requires fetching leaderboard, resolving each wallet's positions, and aggregating. Use to read smart-money directional bias before entering a trade.","queryParams":{"top":{"type":"integer","description":"How many top traders to aggregate, default 50","required":false,"sample":50},"window":{"type":"string","description":"day, week, month or allTime, default allTime","required":false,"sample":"allTime"}},"pathParams":{},"outputExample":{"coins":[{"coin":"BTC","netUsd":1234567.8,"longs":12,"shorts":3}]}},{"path":"/top","method":"GET","price":"0","description":"Free: BTC/ETH/SOL/BNB/XRP mid prices. 20 req/min per IP."}],"openapi":"https://hyperliquid.hypa1m.xyz/openapi.json","llms_txt":"https://hyperliquid.hypa1m.xyz/llms.txt"}