HyperX Data API

Base URL: https://data-api.hyperx.trade

Hyperliquid on-chain analytics API — wallet PnL, market positions, crypto Twitter, news feeds.

Authentication

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

Each endpoint has a weight (1–5). Each call costs weight from your budget.

Endpoints

Wallet Analysis

Market Analysis

All weight 1, no auth required.

Time Distribution

All weight 1, auth optional.

Twitter (FREE)

All weight 1, no auth required.

GET /twitter params:

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.

BTC Mining

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.