app.hyperliquid.xyz APIapp.hyperliquid.xyz ↗
Access Hyperliquid leaderboard, perpetual and spot market data, live order books, trader positions, and delta-neutral strategy detection via a single API.
curl -X GET 'https://api.parse.bot/scraper/29f3831a-dcb7-4687-b5e3-b564048f842c/get_leaderboard?window=allTime&min_value=0' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetch the full leaderboard dataset including all traders with their account values and performance across time windows (day, week, month, allTime). Returns up to ~12000 rows due to response size limits.
| Param | Type | Description |
|---|---|---|
| window | string | Time window filter: allTime, 30d, 7d, 24h |
| min_value | number | Minimum account value filter |
{
"type": "object",
"fields": {
"leaderboardRows": "array of trader objects with ethAddress, accountValue, windowPerformances, displayName, prize"
},
"sample": {
"data": {
"leaderboardRows": [
{
"prize": 0,
"ethAddress": "0x85ecf584f25db6f146718b86d493e33c5af72052",
"displayName": null,
"accountValue": "44112588.8588719964",
"windowPerformances": [
[
"day",
{
"pnl": "-1091056.7594539998",
"roi": "-0.0241584711",
"vlm": "1133296907.2800002098"
}
],
[
"week",
{
"pnl": "-329772.6874760001",
"roi": "-0.0069435938",
"vlm": "6290274900.4399995804"
}
],
[
"month",
{
"pnl": "-448710.9471900003",
"roi": "-0.0076790482",
"vlm": "24266309761.7599945068"
}
]
]
}
]
},
"status": "success"
}
}About the app.hyperliquid.xyz API
This API exposes 7 endpoints covering Hyperliquid DEX trading data: leaderboard rankings for up to ~12,000 traders, live perpetual and spot market feeds, 20-level order books, and open position data by wallet address. The identify_delta_neutral_traders endpoint goes further by analyzing top-volume traders for offsetting spot and perp positions, returning hedge ratios and net delta per asset.
Leaderboard and Trader Rankings
The get_leaderboard endpoint returns the full Hyperliquid trader ranking set — up to ~12,000 rows — with each row containing ethAddress, accountValue, displayName, and windowPerformances across four time windows: allTime, 30d, 7d, and 24h. Use the min_value parameter to filter out low-capital accounts. get_top_traders slices the same dataset by PNL rank, returning pnl, roi, and vlm strings for any specified window alongside wallet address and display name.
Market Data — Perps and Spot
get_all_perp_markets returns live data for every listed perpetual futures symbol: markPx, midPx, funding (current funding rate), dayNtlVlm (24-hour notional volume), openInterest, prevDayPx, maxLeverage, and szDecimals. No symbol parameter is needed — it returns the full universe in one call. get_all_spot_markets covers the spot side, returning a tokens array with metadata (name, szDecimals, weiDecimals, tokenId, isCanonical) and a universe array of trading pair definitions.
Order Books and Open Positions
get_order_book requires a symbol string (e.g., BTC, ETH) and returns 20 levels of bids and asks via the levels field — two arrays each containing objects with px (price), sz (size), and n (number of orders). Timestamps are provided in milliseconds. get_trader_open_positions takes an Ethereum wallet address and returns assetPositions, marginSummary, crossMarginSummary, and withdrawable USD — giving a full margin account snapshot for any on-chain address.
Delta-Neutral Strategy Detection
identify_delta_neutral_traders analyzes the top 3 traders by volume for a given time window, cross-referencing their perpetual and spot holdings to find offsetting positions. Results include an offsets array per trader, where each entry specifies coin, perp_size, spot_size, net_delta, and hedge_ratio. Only positions with a hedge ratio above 20% are flagged. The endpoint may return an empty array if no qualifying delta-neutral setups are found among the analyzed accounts.
- Track top trader PNL and ROI across different time windows to build a copy-trading signal feed.
- Monitor live funding rates and open interest across all perp markets to detect funding arbitrage opportunities.
- Pull 20-level order book depth for a specific symbol to feed into a market microstructure analysis tool.
- Retrieve open positions for a wallet address to audit a portfolio's margin utilization and cross-margin exposure.
- Identify delta-neutral traders by hedge ratio to study hedging strategies used by high-volume accounts.
- Build a leaderboard dashboard filtered by minimum account value using the
min_valueparameter. - Compare spot token metadata against perp market listings to detect newly listed or delisted assets.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Hyperliquid have an official public developer API?+
How does the leaderboard endpoint handle large result sets?+
get_leaderboard endpoint returns up to approximately 12,000 trader rows in a single response — the cap reflects response size constraints. There is no cursor-based pagination; if you need a smaller set ranked by PNL, use get_top_traders with the limit parameter and your chosen window.What does the delta-neutral detection actually analyze?+
identify_delta_neutral_traders endpoint examines the top 3 traders by volume for the specified window and looks for the same asset held in both a perpetual position and a spot position where the two sides partially or fully offset each other. The offsets array returns perp_size, spot_size, net_delta, and hedge_ratio per coin. Only traders with at least one asset exceeding a 20% hedge ratio appear in results.Does the API cover historical trade history or OHLCV candle data for specific symbols?+
Are isolated-margin positions returned separately from cross-margin positions?+
get_trader_open_positions endpoint returns both a marginSummary (portfolio-wide) and a crossMarginSummary object, along with an assetPositions array. Isolated margin details are reflected within the assetPositions entries, but the endpoint does not currently break out a dedicated isolated-margin summary object. You can fork this API on Parse and revise the endpoint to surface isolated margin fields separately if your use case requires it.