Skip to main content

​
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.
  • 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 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 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): Full API access with generous rate limits for prototyping and iteration.
  • 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.

​
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. Your API key stays the same, so no code changes are needed.

​
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?

See all available streams on the Streaming API Overview.