copy open copy.top
copy.top / developers / Hyperliquid api

hyperliquid api: how to read the leaderboard, top traders and their positions

Hyperliquid has a public API that needs no key for reading. this guide shows the calls that work today, tested on November 16, 2026, and where copy.top adds ranked trader data on top. no hyperliquid scraper needed.

the info endpoint

almost everything is one POST to https://api.hyperliquid.xyz/info with a type in the body.

curl -s https://api.hyperliquid.xyz/info \
  -H 'content-type: application/json' \
  -d '{"type":"metaAndAssetCtxs"}'

a trader's positions and fills

curl -s https://api.hyperliquid.xyz/info -H 'content-type: application/json' \
  -d '{"type":"clearinghouseState","user":"0xADDRESS"}'

curl -s https://api.hyperliquid.xyz/info -H 'content-type: application/json' \
  -d '{"type":"userFills","user":"0xADDRESS"}'

hyperliquid leaderboard api

the leaderboard shown on the Hyperliquid site is served as one large file. it lists thousands of accounts with account value, pnl, roi and volume per window.

curl -s https://stats-data.hyperliquid.xyz/Mainnet/leaderboard -o leaderboard.json

ranked traders through copy.top

the raw leaderboard is a list of addresses. copy.top adds what you need to choose one: win rate, profit factor, max drawdown over 30 days, usual leverage, trading style and top coins. these tools need a free key.

curl -s https://copy.top/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"hl_get_traders","arguments":{"window":"30d","sort":"pnl","limit":10}}}' \
  -H 'authorization: Bearer YOUR_KEY'
hl_get_traderswindow 24h, 7d, 30d or all; sort pnl or roiranked traders with account value, pnl, roi, volume, win rate, style, drawdown, top coins
hl_get_traderaddressone trader: metrics, pnl per window, open positions, latest fills
hl_get_marketsoptional categorylive markets: price, 24 h change, volume, open interest, hourly funding, max leverage
hl_get_market_readcoinone market: technicals, funding against its history, open interest changes, what top traders hold, nearby liquidations
hl_get_callscoinx analysts ranked by the track record of their calls on one market

how the copy.top API works

faq

is the Hyperliquid API free?

yes for reading: markets, positions and fills are public and need no key. placing orders needs a signature from your own wallet.

is there a Hyperliquid leaderboard API?

the leaderboard is published as one file at stats-data.hyperliquid.xyz/Mainnet/leaderboard. for ranked traders with win rate, drawdown and style, use copy.top's hl_get_traders tool.

how do I track a Hyperliquid whale?

call clearinghouseState with the address to read open positions, and userFills for the latest fills. copy.top's hl_get_trader returns both with the trader's metrics in one call.

do I need a Hyperliquid scraper?

no. everything on the site comes from public endpoints, and reading them directly is faster and more stable than scraping pages.

is copy.top affiliated with Hyperliquid?

no. copy.top is independent.

other guides

examples tested on November 16, 2026. copy.top is independent: it is not affiliated with fomo, pump.fun, Hyperliquid or Polymarket. the copy.top API is read-only: nothing here places an order. figures are data, not advice. trading crypto is risky and past performance does not predict results.