How do I use hyperliquid-info?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@hyperliquid-info Get the L2 order book for BTC" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

hyperliquid-info

by wtfsayo

Overview Schema Source Related Servers Discussions Admin

JavaScript

Remote

hyperliquid-info

Cursor / Agent Plugin wrapping Hyperliquid’s public Info API (POST /info).

Read-only. No /exchange, no private keys, no order placement.

Docs: Info endpoint · Perpetuals · Spot

Domain types

Type	Meaning
`MidMap`	coin → mid price string
`L2Book`	`{ coin, time, levels: [bids, asks] }`
`RecentTrade`	`{ coin, side, px, sz, time, tid, users }`
`AssetMeta` / `SpotMeta`	universe + margin / tokens + spot pairs
`AssetCtx` / `SpotAssetCtx`	mark / oracle / funding / OI / day volume
`ClearinghouseState`	margin + positions for a user
`SpotClearinghouseState`	spot balances (`balances[]`)
`OpenOrder` / `FrontendOpenOrder` / `UserFill` / `Candle` / `FundingRate`	as named
`Portfolio`	day/week/month/allTime (+ perp*) PnL & accountValue histories
`UserFees`	fee schedule + user rates + staking/referral discounts
`VaultDetails` / `UserVaultEquity`	vault APR, followers, equity
`DelegatorSummary` / `ValidatorSummary`	staking state
`BorrowLendReserveState`	supply/borrow rates & utilization
`OutcomeMeta` / `SettledOutcome`	HIP-4 outcome markets

Related MCP server: hyperliquid-mcp

Install (Cursor IDE)

Clone this repo (or copy the folder).
Copy into a real directory: ~/.cursor/plugins/local/hyperliquid-info
Reload Window / enable local plugins if your org gates imports.

MCP tools (61)

Market / meta

Tool	Returns
`get_all_mids`	`MidMap`
`get_l2_book`	`L2Book` (`coin`)
`get_recent_trades`	`RecentTrade[]` (`coin`)
`get_meta`	perp universe + margin tables
`get_meta_and_asset_ctxs`	`[meta, AssetCtx[]]`
`get_all_perp_metas`	metas across all perp dexs (HIP-3)
`get_perp_dexs`	builder-deployed dex list
`get_perp_dex_limits`	OI / transfer caps (`dex` required)
`get_perp_dex_status`	net deposits etc.
`get_perps_at_open_interest_cap`	coins at OI cap
`get_perp_deploy_auction_status`	perp deploy auction
`get_perp_annotation`	category/description (`coin`)
`get_perp_categories`	`[[coin, category], …]`
`get_perp_concise_annotations`	concise annotations
`get_margin_table`	margin tiers by `id`
`get_candles`	OHLCV (`coin`, `interval`, `startTime`)
`get_funding_history`	historical funding (`coin`, `startTime`)
`get_predicted_fundings`	cross-venue predicted funding
`get_exchange_status`	specialStatuses + time
`get_liquidatable`	liquidatable set (may be empty)

Spot / outcomes / borrow-lend

Tool	Returns
`get_spot_meta`	`SpotMeta`
`get_spot_meta_and_asset_ctxs`	`[SpotMeta, SpotAssetCtx[]]`
`get_token_details`	supply / mid / mark (`tokenId`)
`get_spot_pair_deploy_auction_status`	spot pair auction
`get_spot_deploy_state`	deployer auction state (`user`)
`get_spot_clearinghouse_state`	spot balances (`user`)
`get_outcome_meta`	HIP-4 outcomes
`get_settled_outcome`	settled outcome (`outcome`)
`get_all_borrow_lend_reserve_states`	all reserve states
`get_borrow_lend_reserve_state`	one token (`token`)
`get_borrow_lend_user_state`	user borrow/lend (`user`)

User

Tool	Returns
`get_clearinghouse_state`	perp account (`user`)
`get_open_orders`	resting orders (`user`)
`get_frontend_open_orders`	orders + trigger/TP-SL fields
`get_historical_orders`	recent historical orders
`get_user_fills`	recent fills
`get_user_fills_by_time`	fills by time range
`get_user_funding`	funding payments ledger
`get_user_non_funding_ledger_updates`	deposits/transfers/withdrawals
`get_user_twap_slice_fills`	TWAP slice fills
`get_order_status`	status by `oid` / cloid
`get_active_asset_data`	leverage / trade sizes (`user`, `coin`)
`get_user_rate_limit`	request / volume caps
`get_user_role`	user / agent / vault / subAccount
`get_user_fees`	fees + schedule
`get_portfolio`	portfolio histories
`get_sub_accounts`	sub-accounts
`get_extra_agents`	named API agents
`get_referral`	referral / rewards
`get_user_abstraction`	abstraction mode
`get_user_dex_abstraction`	HIP-3 dex abstraction flag
`get_approved_builders`	approved builders
`get_max_builder_fee`	max fee (`user`, `builder`)

Vault / staking

Tool	Returns
`get_vault_details`	vault APR / followers (`vaultAddress`)
`get_user_vault_equities`	vault equities for user
`get_vault_summaries`	vault list (may be empty)
`get_delegations`	staking delegations
`get_delegator_summary`	delegated / pending
`get_delegator_history`	stake events
`get_delegator_rewards`	rewards
`get_validator_summaries`	validators

Pass the master/sub-account address for user queries — not an agent wallet.

Network

Default: https://api.hyperliquid.xyz

Testnet: set env HYPERLIQUID_API_URL=https://api.hyperliquid-testnet.xyz (see mcp.json).

Skill

skills/hyperliquid-info/SKILL.md — when to call which tool. Never invent prices.

Prove

See PROVE.md for local schema + live MCP verification notes. Probe artifacts live under _probe/ (gitignored).

License

MIT

Repository

https://github.com/wtfsayo/hyperliquid-plugin

This server cannot be deployed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityMaintained

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

VaultVision Hyperliquid Vault Research A
io.github.0xkayser
Read-only Hyperliquid vault search, risk, drawdown, rankings, TVL, alerts, and comparisons.
Cryptocurrency Blockchain Finance
91
Hyperliquid Market Data — OHLCV, Funding Rates & Positioning (Tessera Analytics)A
dev.tesseralytics
Hosted Hyperliquid MCP server: query OHLCV, funding and positioning data in plain language with a free API key.
Blockchain Cryptocurrency Finance
52
whale-insights A
com.cryptowhaleinsights
Free read-only crypto whale-tracking & market-data MCP tools across 14 chains. No auth.
Cryptocurrency Blockchain
562
0xArchive Market DataOAuth
io.0xarchive
Real-time & historical Hyperliquid/Lighter: L4/L2/L3, fills, funding, OI, liquidations, candles
Cryptocurrency Finance
2

Related MCP Servers

hl-read
Cryptocurrency Blockchain Finance
akagifreeez
A
license
Not graded
quality
C
maintenance
A read-only MCP server for Hyperliquid that provides public market data (prices, order books, funding) and any wallet's positions, orders, and fills via MCP tools, without requiring a private key.
Updated 21 days ago (2026-08-23 04:51 UTC)
MIT
hyperliquid-mcp
kitsune-de
A
license
A
quality
B
maintenance
A read-only MCP server for querying Hyperliquid perp markets, funding rates, order books, candles, and account positions/fills/funding for any address, without needing API keys or wallets.
Updated 2 months ago (2026-07-18 02:00 UTC)
8
55
1
MIT
market-depth-lab-mcp
Finance Cryptocurrency
derkcc
A
license
A
quality
B
maintenance
Read-only Hyperliquid and cross-exchange market research for AI agents, providing structured tools for live market data without requiring authentication.
Updated a month ago (2026-07-28 13:12 UTC)
9
28
MIT
hyperliquid-agent-gateway
Cryptocurrency Blockchain
alekskram
A
license
A
quality
A
maintenance
Provides AI agents read-only, keyless access to Hyperliquid market data, funding rates, account risk, and HyperEVM token transfers through MCP tools, with caching and rate limiting to protect upstream APIs.
Updated 4 days ago (2026-09-08 19:50 UTC)
12
1
MIT

hyperliquid-info

Domain types

Install (Cursor IDE)

MCP tools (61)

Market / meta

Spot / outcomes / borrow-lend

User

Vault / staking

Network

Skill

Prove

License

Repository

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

hl-read

hyperliquid-mcp

market-depth-lab-mcp

hyperliquid-agent-gateway