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"}'
- metaAndAssetCtxs returns every perp market with its max leverage, mark price, funding, open interest and 24 h volume.
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"}'
- clearinghouseState: account value, margin used, and each open position with size, entry price, leverage and liquidation price.
- userFills: the latest fills with coin, price, size, side, direction and closed pnl.
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
- the file is large and can take a while to download. fetch it once and work on the copy.
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_traders | window 24h, 7d, 30d or all; sort pnl or roi | ranked traders with account value, pnl, roi, volume, win rate, style, drawdown, top coins |
|---|---|---|
| hl_get_trader | address | one trader: metrics, pnl per window, open positions, latest fills |
| hl_get_markets | optional category | live markets: price, 24 h change, volume, open interest, hourly funding, max leverage |
| hl_get_market_read | coin | one market: technicals, funding against its history, open interest changes, what top traders hold, nearby liquidations |
| hl_get_calls | coin | x analysts ranked by the track record of their calls on one market |
how the copy.top API works
- one endpoint: POST https://copy.top/mcp, JSON-RPC 2.0. use copy.top without www.
- the answer is in result.content[0].text, as a JSON string. the body can arrive as an event stream: read the first line that starts with "data: ".
- no key is needed for the public tools. the limit is about 20 calls a minute per address.
- a free key raises the limits and opens the Hyperliquid tools. create it at copy.top/account#api and send it as Authorization: Bearer <key>.
- the same tools work as an MCP server in Claude, ChatGPT, Cursor and other agents, and from the terminal with npm i -g copytop.
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.