Hyperliquid MCP Server
The Bitquery MCP server gives an AI client 18 tools for Hyperliquid data. You ask a question in Claude, ChatGPT, Cursor, VS Code or Codex, the agent picks a tool, and rows come back from Bitquery's index of the exchange's own blocks: perpetuals, spot pairs, markets listed by third parties, and outcome markets.
It reads data only. It cannot place, change or cancel an order, and it never touches a key. To trade, use Hyperliquid's own API; to research markets and wallets, use this.
claude mcp add --transport http bitquery https://mcp.bitquery.io
Other clients take the same URL. Steps for each are in the MCP server install guide.
A 38-second demo, Polymarket and Hyperliquid data in ChatGPT and Claude, shows the server answering questions like the ones below.
Every figure on this page came from a call to the production server on 21 September 2026, between 10:21 and 10:25 UTC, on a morning when Bitcoin had risen 5.4% in a day. Your numbers will differ.
What can I ask?
What is trading most on Hyperliquid?
"What are the five most traded Hyperliquid markets in the last 24 hours?"
The agent calls hyperliquid_markets.
| Market | Last price | 24h change | 24h volume | Wallets |
|---|---|---|---|---|
| BTC | 84,666 | +5.39% | $2,872,395,664 | 22,251 |
| ETH | 2,719.7 | +5.66% | $1,776,080,523 | 10,550 |
| ZEC | 1,517.4 | +5.46% | $600,636,368 | 7,799 |
| HYPE | 95.244 | +4.96% | $430,607,975 | 7,935 |
| NEAR | 4.2931 | +21.45% | $356,057,954 | 7,430 |
BTC alone had 375,429 trades. Volume counts each fill once. The Market column is the id that every other tool takes, which matters because a ticker is not unique: BTC exists as the native perpetual and again on third-party venues.
Where are the big positions, and who is paying for them?
"Show open interest, the long and short split, and funding for the biggest Hyperliquid perpetuals."
hyperliquid_open_interest, from the 10:00 UTC hourly settlement:
| Market | Open interest | Long | Short | Funding per year |
|---|---|---|---|---|
| BTC | $1,865,713,119 | 21,904 | 11,693 | 78.64% |
| ETH | $1,540,615,295 | 13,476 | 5,128 | 18.81% |
| HYPE | $1,042,186,424 | 13,035 | 4,566 | 42.40% |
| ZEC | $398,747,943 | 6,733 | 3,395 | 10.95% |
| SOL | $351,305,718 | 9,886 | 2,885 | 10.95% |
Long and Short are counts of accounts.
On a perpetual the size held long always equals the size held short, so the crowd shows up in the count of accounts. On BTC 65% of accounts were long, and they were paying shorts at a rate worth 78.64% per year, $167,486 in that one hour. Funding is paid every hour; the yearly figure is the hourly rate times 24 times 365.
How did funding get there?
"How has BTC funding moved over the last 24 hours?"
hyperliquid_funding_rates returns one row per hourly settlement.
| Hour (UTC) | Funding per year | Accounts short | Paid in that hour | Price |
|---|---|---|---|---|
| 20 Sep, 11:00 | 10.95% | 14,990 | $20,212 | 80,314 |
| 21 Sep, 08:00 | 10.95% | 14,486 | $22,221 | 81,706 |
| 21 Sep, 09:00 | 24.91% | 12,137 | $52,981 | 83,768 |
| 21 Sep, 10:00 | 78.64% | 11,693 | $167,486 | 84,651 |
For the first 22 hours of that window the rate sat at the same 10.95%. Then the price moved $2,945 in two hours, the count of short accounts fell by 2,793, and the hourly bill for longs went up more than seven times.
Who was liquidated?
"Which Hyperliquid markets had the most value liquidated in the last 24 hours, and on which side?"
hyperliquid_liquidations, grouped by market:
| Market | Liquidations | Longs | Shorts | Value |
|---|---|---|---|---|
| BTC | 9,334 | 69 | 9,265 | $92,691,944 |
| ETH | 2,234 | 24 | 2,210 | $25,332,321 |
| NEAR | 1,299 | 103 | 1,196 | $2,863,062 |
| xyz:CL | 316 | 212 | 104 | $2,403,537 |
| XRP | 513 | 1 | 512 | $2,322,937 |
The liquidation table tells the same story from the other side. On BTC 99.3% of forced closes were shorts. None of the five markets needed the exchange's backstop, which is the tool's sign of real stress.
Without the grouping, the same tool lists single liquidations, newest first. With a $100,000 floor, the newest rows were a run on a third-party market, xyz:CL: one account lost four long positions in three seconds at 10:17 UTC, worth $802,815 together.
Who made the most on BTC?
"Who made the most money trading BTC on Hyperliquid in the last 24 hours?"
hyperliquid_top_traders with the market set to BTC:
| Account | Net result | Volume | Fills | Share as taker |
|---|---|---|---|---|
0xb1ec7feb...e86a | $857,387 | $11,676,991 | 385 | 49.9% |
0xe77cdee1...15db | $819,890 | $38,134,857 | 1,066 | 10.6% |
0x4044570e...794c | $361,813 | $5,814,128 | 266 | 10.2% |
0xe60dcdf2...7738 | $296,546 | $9,082,225 | 216 | 100% |
0xb5a6924d...2f82 | $258,300 | $24,013,654 | 1,292 | 100% |
Net result is closed profit plus funding minus fees. It leaves out open positions, so a wallet can rank high here and be deep under water on a trade it has not closed. Check the next tool before calling anyone a winner.
What is the top wallet holding now?
"What positions does 0xb1ec7febea4f841d525785955b7fe0e812d6e86a hold?"
hyperliquid_trader_positions, positions above $1 million:
| Market | Side | Exposure | Position vs margin |
|---|---|---|---|
| BTC | Long 47.23 BTC | $3,998,475 | 40x |
| HYPE | Long 21,298 HYPE | $2,023,857 | 10x |
| xyz:SPCX | Short 12,887 | $1,990,058 | not observed |
| LINK | Long 104,855 LINK | $1,357,129 | 10x |
The day's best BTC account is still long $4.0 million of BTC, a position 40 times its margin. The tool returned no entry price or open profit for these rows, and said why: every position was opened before the month of history it can rebuild from, so it reports the size as exact and leaves the rest empty.
All 18 Hyperliquid tools
| Tool | Use it for |
|---|---|
hyperliquid_markets | List and rank markets, and turn a ticker into a market id |
hyperliquid_price | Current price of one market, with the source it came from |
hyperliquid_candles | Price bars of 1, 5, 15 or 60 minutes for one market |
hyperliquid_recent_trades | The latest fills on a market |
hyperliquid_open_interest | Open interest, account split and current funding across perpetuals |
hyperliquid_funding_rates | Hourly funding and open interest history of one perpetual |
hyperliquid_liquidations | Forced closes, one by one or totalled per market or account |
hyperliquid_twaps | Large orders being worked in slices, and how far along they are |
hyperliquid_top_traders | Accounts ranked by net result, volume or fills |
hyperliquid_trader_summary | One account's scorecard: profit, funding, fees, win rate |
hyperliquid_trader_positions | What an account holds now |
hyperliquid_trader_fills | An account's fill history with profit and fee per fill |
hyperliquid_linked_accounts | Accounts tied together by a shared signing wallet |
hyperliquid_book_makers | Which accounts post the resting orders on a market |
hyperliquid_order_flow | Orders placed, filled, cancelled and rejected, with the reason |
hyperliquid_action_rejections | Rejected account actions such as margin settings and transfers |
hyperliquid_builders | Volume and fees of the apps that route orders, and of third-party venues |
hyperliquid_raw_sql | Your own SQL over the Hyperliquid tables |
What to know before you rely on it
- Read-only. No order placement and no live order book depth.
- About a month of history. Most tools look back up to 720 hours. Price bars reach back about three weeks. Order and book events are kept for two days.
- Rankings leave out open positions. Read
hyperliquid_trader_positionsnext to any profit ranking. - Entry price can be empty. A position opened before the history window has an exact size and no entry price or open profit.
- Funding and open interest are hourly. They come from the hourly settlement, so they can be up to an hour old.
- Pin a market by its id. Third-party markets carry a prefix such as
xyz:, spot pairs start with@and outcome markets with#. - No transfer tracing. The general token, price and wallet-tracing tools do not cover Hyperliquid. It has its own set.
MCP, GraphQL or the official API?
| You want to | Use |
|---|---|
| Place or cancel orders, read the live book | Hyperliquid's own API |
| Ask questions in a chat, or let an agent research markets and wallets | This MCP server |
| Build a dashboard, alert or bot in code | The Bitquery Hyperliquid API, with WebSocket and Kafka streams |
| Load full history into a warehouse | Hyperliquid Parquet exports |
Plans and the trial are on the Bitquery MCP server page.
Frequently Asked Questions
Is there an MCP server for Hyperliquid?
Yes. The hosted Bitquery MCP server at https://mcp.bitquery.io includes 18 Hyperliquid tools covering markets, prices, funding, open interest, liquidations, TWAP orders, wallet rankings, positions and fills. It connects to Claude, ChatGPT, Cursor, VS Code and Codex over Streamable HTTP with an OAuth login.
Can the Hyperliquid MCP server place trades?
No. It is read-only and holds no keys. To place or cancel orders use Hyperliquid's own API.
Can I track a Hyperliquid wallet with it?
Yes. hyperliquid_trader_positions shows what an account holds now, hyperliquid_trader_fills lists its fills, and hyperliquid_trader_summary gives profit, funding, fees and win rate for a period.
Does it cover HIP-3 and spot markets?
Yes. hyperliquid_markets lists native perpetuals, third-party HIP-3 perpetuals, spot pairs and outcome markets, and returns the id that the other tools take.
How far back does the data go?
About a month for trades, funding, liquidations and wallet results, and about three weeks for price bars. Order and order book events are kept for two days.
Do I need an API key?
No. You add the server URL to your client and sign in once with a Bitquery account in the browser.
Ready to run this in production?
Get an API key and run these queries in minutes, or talk to us about plans and enterprise delivery.