> ## Documentation Index
> Fetch the complete documentation index at: https://goldrush.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Frequently Asked Questions

> Common questions about GoldRush APIs, authentication, pricing, rate limits, and supported chains.

## General Questions

### What is the GoldRush API?

GoldRush offers the most comprehensive Blockchain Data API suite for developers, analysts, and enterprises.

### What can I do with the GoldRush API?

The GoldRush API provides fast, accurate, and developer-friendly access to the essential onchain data for building DeFi dashboards, wallets, trading bots, AI Agents, tax and compliance platforms.

### Do I need API keys to use GoldRush?

Yes. The credential you need depends on the product:

* **API key** (read-only) - covers the Foundational API, CLI, and x402.

It's available on the [GoldRush platform](/docs/platform) once you sign up.

### If a client asks how to verify that GoldRush API is real-time or low-latency, how can we demonstrate or prove that?

You can demonstrate real-time or low-latency capabilities through:

* Timestamp validation: Pull `/v1/{chain_id}/block_v2/latest/` and compare the block timestamp with the current time (should be sub-second to a few seconds behind depending on chain).
* Latency benchmarks: Use tools like curl or Postman to measure API response time.

### Besides the common 401, 402, and 429 error codes, are there any other error responses we should be aware of?

Yes. Additional error codes include:

* `400 Bad Request` – Invalid parameters or malformed request.
* `402 Payment Required` – Alloted credits exceeded and need to enable Flex Credits or upgrade subscription tier.
* `403 Forbidden` – API key is valid but not authorized for the resource.
* `404 Not Found` – Endpoint or data not available (e.g. unsupported chain).
* `500 Internal Server Error` – Unexpected failure on GoldRush's side.
* `503 Service Unavailable` – Maintenance or backend issue.

Each error includes a descriptive JSON body for debugging. For a complete guide to error codes, retry strategies, and debugging tips, see [Error Handling & Troubleshooting](/docs/error-handling).

## Foundational API Questions

### What is the rate limit for API calls?

The GoldRush Foundational API enforces rate limits based on the user's plan:

* 14-day Free Trial: 4 requests per second (RPS), 25,000 API credits.
* Vibe Coding Plan (\$10/mo): 4 RPS, 10,000 API credits.
* Professional Plan (\$250/mo): 50 RPS, 300,000 API credits.
* Inner Circle: Custom limits, typically up to 100 RPS or higher, based on SLAs.

Rate limits are enforced per API key and IP, and requests exceeding limits receive a `429 Too Many Requests` error. For a complete guide to error codes, retry strategies, and debugging tips, see [Error Handling & Troubleshooting](/docs/error-handling).

### Which plan is right for me?

**Vibe Coding Plan (\$10/mo)** is built for:

* Solo founders and indie hackers shipping fast
* Hackathon teams and weekend projects
* AI-native builders using Cursor, Windsurf, or Claude
* Prototyping and validating ideas before scaling

**Professional Plan (\$250/mo)** is built for:

* Teams building production applications
* Apps that need higher rate limits (50 RPS)
* Projects requiring priority support
* Companies with compliance or reliability requirements

You can start with Vibe Coding and upgrade to Professional as your project scales.

### Can I upgrade from Vibe Coding to Professional?

Yes. You can upgrade at any time from the [GoldRush platform](https://goldrush.dev/platform). Your API key stays the same, so no code changes are needed.

### Does GoldRush support Hyperliquid?

Yes. GoldRush supports Hyperliquid's native chain (HyperCore) with zero rate limits. You can stream real-time fills, liquidations, funding rates, vault actions, delegations, deposits, withdrawals, and OHLCV pricing data for all Hyperliquid markets - including data not available through the public Hyperliquid API.

GoldRush runs dedicated Hyperliquid nodes in Tokyo with a private backbone for low-latency data ingestion. See the [HyperCore chain page](/docs/chains/hypercore) for full details and code examples.

### What are Redstone Bolt price feeds?

Redstone Bolt provides ultra-low-latency CEX price data for 9 major tokens on MegaETH, including BTC, ETH, SOL, BNB, XRP, ADA, DOGE, USDT, and USDC. Prices are updated every **2.4 ms** (\~400 updates/sec), sourced from Binance, Coinbase, OKX, Bitget, and Kraken via Bolt nodes co-located with MegaETH sequencer infrastructure. Bolt-powered feeds use the `REDSTONE-` prefix (e.g. `REDSTONE-BTC`, `REDSTONE-ETH`).

***

## Not finding answers?

* **[Error Handling & Troubleshooting](/docs/error-handling)** — Debug issues and retry strategies
* **[What is GoldRush](/docs/overview)** — Understand the core platform
* **[GoldRush SDKs & CLI](/docs/goldrush-sdks)** — Get started with code
* **[Powered by GoldRush](/docs/powered-by-goldrush)** — See real-world examples