> ## 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, Streaming API, CLI, and x402.
* **ServiceKey** - required for the [Pipeline REST API](/goldrush-pipeline-api/rest-api/overview) (CRUD on pipelines). See [Service Keys](/goldrush-pipeline-api/service-keys).

Both are available on the [GoldRush platform](/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. GoldRush's streaming endpoints often respond in under 400ms for supported chains.
* Streaming demos: If using the Streaming API, show live updates of token transfers or block finality in dev dashboards.

### 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](/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](/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.

## Streaming API Questions

### Does GoldRush support Hyperliquid?

Yes. GoldRush supports Hyperliquid's native chain (HyperCore) via the Streaming API 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](/chains/hypercore) for full details and code examples.

### How does the Streaming API work?

The Streaming API uses WebSocket connections to provide real-time updates about blockchain events. It maintains a persistent connection and pushes structured data to subscribed clients as events occur.

### 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`). You can consume these prices through the [OHLCV Tokens Stream](/api-reference/streaming-api/subscriptions/ohlcv-tokens-stream) on the `MEGAETH_MAINNET` chain - see that page for the full list of supported feeds.

### What types of events can I subscribe to?

See all available streams on the [Streaming API Overview](./goldrush-streaming-api/overview).

***

## Not finding answers?

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