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 provdes 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, you need an API key to access the GoldRush API. Your API Key is available on the GoldRush platform when you sign up for an account.

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.
  • 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 Covalent’s side.
  • 503 Service Unavailable – Maintenance or backend issue.
Each error includes a descriptive JSON body for debugging.

Foundational API Questions

What is the rate limit for API calls?

The Foundational GoldRush API enforces rate limits based on the user’s plan:
  • Free plan: 4 requests per second (RPS), 100,000 requests per month.
  • Professional plan: 50 RPS.
  • Inner Circle plan: Custom limits, typically up to 100 RPS or higher, based on SLAs.
Rate limits are enforced per API key and IP, and responses exceeding limits return a 429 Too Many Requests.

Streaming API Questions

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 types of events can I subscribe to?

You can subscribe to five streams: Token Balances Stream, OHLCV Tokens Stream, OHLCV Pairs Stream, New DEX Pairs Stream, Wallet Activity Stream to get real-time balances, OHLCV candle stick data, new pairs and track wallet activity.