How to Use Hyperliquid REST API with Goldrush

How to Use Hyperliquid REST API with Goldrush

If you're building trading bots, dashboards, analytics tools, or portfolio trackers on Hyperliquid, you've probably used the official Info API (POST https://api.hyperliquid.xyz/info).
While it works, it has several limitations:

• Strict rate limits (1200 weight/min)
• Higher latency (~280ms)
• No batch queries for multiple wallets
• Limited historical data Goldrush Hyperliquid Info API solves all these problems. It is a byte-for-byte compatible drop-in replacement that is faster, has no rate limits, supports batch endpoints, and offers extended history. New endpoint: https://hypercore.goldrushdata.com/info

Why Use Goldrush Instead of the Official Hyperliquid API?

Goldrush (powered by Covalent) provides a high-performance data layer specifically optimized for Hyperliquid. Key advantages include:

• No rate limits
• Lower latency (<150ms p50)
• Batch queries (up to 50 wallets in one request)
• Extended historical data (fills, funding, etc.)
• Additional native endpoints (builder fills, batch states)
• Full compatibility with existing Hyperliquid SDKs

Prerequisites

1. Go to the https://goldrush.dev/ and sign up for free.
2. After logging in, navigate to API Keys and create a new key.
3. Copy your API key (you'll use it as Bearer YOUR_KEY).

How to Make Requests to Goldrush Hyperliquid Info API

All requests are POST requests to a single endpoint.
Endpoint:
POST https://hypercore.goldrushdata.com/info
Required Headers:

• Authorization: Bearer YOUR_GOLDRUSH_API_KEY
• Content-Type: application/json

Example Request Body:
{
"type": "metaAndAssetCtxs",
"dex": ""
}
_Important: These endpoints only accept POST requests. Opening the URL directly in your browser will not work.
_

Popular Endpoints with Examples

1. Get Market Metadata + Live Data (Most Used) Type: metaAndAssetCtxs Bash: curl -X POST https://hypercore.goldrushdata.com/info \ -H "Authorization: Bearer YOUR_GOLDRUSH_API_KEY" \ -H "Content-Type: application/json" \ -d '{"type": "metaAndAssetCtxs", "dex": ""}' Python Example: `import requests

url = "https://hypercore.goldrushdata.com/info"
headers = {
"Authorization": "Bearer YOUR_GOLDRUSH_API_KEY",
"Content-Type": "application/json"
}
payload = {"type": "metaAndAssetCtxs", "dex": ""}

response = requests.post(url, headers=headers, json=payload)
meta, asset_ctxs = response.json()`

1. Get User Account State (Positions & Margin) { "type": "clearinghouseState", "user": "0xYourWalletAddress" }
2. Get User Fills History { "type": "userFills", "user": "0xYourWalletAddress" }
3. Batch Queries (Goldrush Exclusive Advantage) Get states for up to 50 wallets in a single request: { "type": "batchClearinghouseState", "users": ["0xWallet1", "0xWallet2", "0xWallet3"] } Other useful types:

• spotMetaAndAssetCtxs
• l2Book
• candleSnapshot
• frontendOpenOrders
• userFillsByTime

Using Goldrush with Official Hyperliquid SDKs

You can use existing SDKs by simply changing the base URL.
Python SDK Example:
`from hyperliquid.info import Info

info = Info("https://hypercore.goldrushdata.com", skip_ws=True)
user_state = info.user_state("0xYourAddress")
fills = info.user_fills("0xYourAddress")`
The same override works with JavaScript/TypeScript SDKs.

Official Hyperliquid API vs Goldrush Comparison

Real-World Example: Hyperliquid Dashboards Built with Goldrush

Best Practices

• Even without rate limits, poll responsibly based on your use case.
• Use batch endpoints whenever querying multiple wallets.
• Handle errors properly: 401 Unauthorized → Invalid or missing API key 400 unsupported_type → Unknown type value
• Use userFillsByTime for historical data beyond the official limit.

Conclusion

Switching to Goldrush Hyperliquid Info API is one of the easiest and most impactful upgrades you can make when building on Hyperliquid.
With just two small changes (new URL + Authorization header), you get a significantly faster, more reliable, and more powerful API — completely free of rate limits.
Perfect for production-grade trading bots, dashboards, and analytics tools.

Ready to get started?
Sign up for your free Goldrush API key here: https://goldrush.dev/platform/auth/register/