Read live Hyperliquid market data from the desk computer with curl or the Python SDK - mid, mark and oracle prices, order book depth, funding (current, predicted, historical), open interest, volume, candles, perp and spot metadata, margin tiers, and how to save datasets for the strategy lab. Read-only, no key. Use for any market brief, depth read, funding question or data pull.
Data & analysis
HyperX Data API
Try itUse when building apps with HyperX Data API — Hyperliquid wallet analytics, market data, Twitter/news feeds. Triggers on: "HyperX API", "data-api.hyperx.trade", "wallet analysis", "Hyperliquid data", "crypto Twitter API", "market positions", "fills API", "trading analytics".
What it does
Use when building apps with HyperX Data API — Hyperliquid wallet analytics, market data, Twitter/news feeds. Triggers on: "HyperX API", "data-api.hyperx.trade", "wallet analysis", "Hyperliquid data", "crypto Twitter API", "market positions", "fills API", "trading analytics".
The skill document
HyperX Data API
Base URL: https://data-api.hyperx.trade
Hyperliquid on-chain analytics API — wallet PnL, market positions, crypto Twitter, news feeds.
Authentication
| Method | Header / Field | How to get |
|---|---|---|
| API Token | X-API-Key: | Login at hyperx.trade → Settings → API Token |
| Cookie | HyperX session cookie | Login at hyperx.trade |
To get an API key: visit hyperx.trade/hyperliquid/settings, log in with your account, and generate a token in the API Token section. Free tier is available.
Twitter & News endpoints are free, no auth required.
Rate Limits
| Tier | Budget / min | Monthly | Price |
|---|---|---|---|
| Free | 30 | 10,000 | $0 |
| Pro | 300 | 500,000 | $99/mo |
| Ultra | 1,200 | 5,000,000 | $399/mo |
Each endpoint has a weight (1–5). Each call costs weight from your budget.
Endpoints
Wallet Analysis
| Method | Path | Weight | Auth | Description |
|---|---|---|---|---|
| POST | /wallet_analysis/{address} | 5 | optional | Full wallet PnL analysis with positions, trades, risk metrics |
| GET | /wallet_metrics/{address} | 2 | none | Pre-calculated wallet performance metrics (win rate, ROI, PnL) |
| POST | /wallet_metrics_query | 2 | optional | Batch query wallet metrics with filters and sorting |
| GET | /fills/{address} | 5 | optional | Trading history (fills) for a wallet address |
| WS | /fills/ws | 5/msg | optional | Real-time fills stream. Addr limits: free=1, pro=50, ultra=300 |
Market Analysis
All weight 1, no auth required.
| Method | Path | Description |
|---|---|---|
| GET | /market/coins | All tradable coins with metadata |
| GET | /market/snapshots | Market overview snapshots |
| GET | /market/overview | Aggregated market overview |
| GET | /market/aggregate-positions | Cross-asset aggregated position data |
| GET | /market/top-positions/{asset} | Top positions for a specific asset |
| GET | /market/leverage-distribution/{asset} | Leverage distribution |
| GET | /market/pnl-distribution/{asset} | PnL distribution |
| GET | /market/concentration/{asset} | Position concentration analysis |
| GET | /market/whale-changes/{asset} | Whale position changes tracking |
| GET | /market/entry-price/{asset} | Entry price distribution |
| GET | /market/high-leverage-whales/{asset} | High-leverage whale positions |
| GET | /market/top-losers/{asset} | Top losing positions |
| GET | /market/top-winners/{asset} | Top winning positions |
| GET | /market/liquidation-heatmap/{asset} | Liquidation price heatmap |
| GET | /market/liquidation-positions/{asset} | Positions near liquidation |
Time Distribution
All weight 1, auth optional.
| Method | Path | Description |
|---|---|---|
| GET | /wallet/time-distribution/{address}/hourly | Hourly trading activity |
| GET | /wallet/time-distribution/{address}/day-of-week | Day-of-week patterns |
| GET | /wallet/time-distribution/{address}/heatmap | Full activity heatmap (hour × day) |
| GET | /wallet/time-distribution/{address}/daily | Daily trading volume |
Twitter (FREE)
All weight 1, no auth required.
| Method | Path | Description |
|---|---|---|
| GET | /twitter | Twitter feed with filtering |
| GET | /twitter/authors | Active authors ranked by tweet count |
| WS | /twitter/ws | Real-time Twitter feed stream |
GET /twitter params:
| Param | Type | Description |
|---|---|---|
screen_name | string | Filter by author(s), comma-separated |
min_followers | int | Minimum follower count |
user_tags | string | Filter by tags: trader, kol, founder, featured |
tweet_type | string | reply, quote, retweet |
keyword | string | Content keyword search |
hours | int | Time range in hours (1–168, default 24) |
page / page_size | int | Pagination (max 100/page) |
Response fields:
{
"id": 12345,
"sfe_id": "a2552b68aad7c9fa",
"tweet_type": "reply",
"tweet_id": "2032041519130296698",
"tweet_time": "2026-03-12T10:30:26",
"content": "tweet text...",
"screen_name": "elonmusk",
"display_name": "Elon Musk",
"avatar_url": "https://pbs.twimg.com/...",
"follower_count": 694593,
"user_tags": ["founder", "featured"],
"tweet_interaction_type": "reply",
"media": [{"t": "image", "u": "https://..."}],
"source_tweet": {
"tweet_id": "...",
"content": "original tweet...",
"screen_name": "...",
"follower_count": 24977,
"media": []
}
}
WS /twitter/ws params: screen_names, min_followers, user_tags (same filters as REST). Messages are JSON objects with same fields as REST response items.
News (FREE)
All weight 1, no auth required.
| Method | Path | Description |
|---|---|---|
| GET | /news | Trading news from multiple sources |
| GET | /news/channels | Available news channel categories |
BTC Mining
| Method | Path | Weight | Auth | Description |
|---|---|---|---|---|
| GET | /btc-mining/shutdown-prices | 1 | none | BTC mining shutdown prices by miner model |
Quick Start
import requests
BASE = "https://data-api.hyperx.trade"
# No auth needed for Twitter
tweets = requests.get(f"{BASE}/twitter", params={"hours": 1, "min_followers": 10000}).json()
for t in tweets["items"]:
print(f"@{t['screen_name']}: {t['content']}")
# With API key for wallet analysis (get yours at hyperx.trade/hyperliquid/settings)
headers = {"X-API-Key": "your-api-key"}
pnl = requests.post(f"{BASE}/wallet_analysis/0x1234...", headers=headers).json()
# WebSocket — real-time Twitter stream
import asyncio, websockets, json
async def stream():
async with websockets.connect(f"wss://data-api.hyperx.trade/twitter/ws?min_followers=5000") as ws:
async for msg in ws:
tweet = json.loads(msg)
print(f"@{tweet['screen_name']}: {tweet.get('content', '')}")
asyncio.run(stream())
API Catalog Endpoint
GET /api-catalog — returns the full structured catalog as JSON with dynamic weights.
Related skills
Subscribe to live Hyperliquid data over WebSocket from the desk computer - mids, order book, trades, candles, best bid/offer, and per-account fills, order updates and events - with raw JSON, Python SDK and TypeScript examples, plus how to run a supervised watch that logs to a file and alerts. Read-only. Use for monitoring, fill notifications and any watch that polling would make expensive.
Read a Hyperliquid account from the desk computer - positions and margin, spot balances, open orders including trigger details, fills, funding paid, ledger updates, order status by oid or cloid, historical orders, portfolio history, fee tier and rate-limit budget - with curl and Python SDK examples. Read-only, needs only the account address. Use for sizing inputs, book checks, reconciliation and reviews.
Manage Hyperliquid perp positions and margin from the desk computer - read positions and margin, set leverage and cross/isolated mode, add isolated margin, understand margin tiers and liquidation price, close a position with a reduce-only IOC, and clean up orphaned orders. Write actions are Execution Trader only, on an approved ticket. Use for leverage changes, closes, protection checks and margin questions.
Compact reference for the Hyperliquid API as the desk uses it - endpoints and envelopes, every /info request type, every /exchange action with its signing scheme, order and status vocabularies, asset ids, tick and lot rules, rate limits, WebSocket subscription list, error strings, and where the official docs are. Use to look up an exact field, request type or limit before writing a call, and to map an error string to its cause.
Less common Hyperliquid actions and their rules - dead-man's switch (scheduleCancel), TWAP orders, spot orders, expiresAfter and nonces, API wallet approval from code, sub-account and vault addressing, HIP-3 dexs, and what the desk deliberately does not do (transfers, withdrawals, builder fees, staking). Write actions are Execution Trader only, on an approved ticket. Use when a ticket asks for one of these or when a user asks whether the desk can.