Usage, Free Credits, and Quota Explained

CoinAPI users, especially new ones, often run into usage limits without knowing why. This guide helps you understand how usage is counted, how to activate your $25 free trial credits, and how to avoid hitting limits across both REST and WebSocket APIs.

If you’ve seen messages like:

  • HTTP 429: Too Many Requests
  • HTTP 403: Quota Exceeded
  • WebSocket: Insufficient Usage Credits

this guide will help you understand what each error means, how your credit consumption works, and the exact steps you can take to restore access or optimize your usage going forward.

CoinAPI uses a flexible credit-based billing system that spans across REST and WebSocket APIs. Each API call or message consumes a number of usage credits based on the resource cost of the request.

Credits are units of API resource usage. Every REST request, WebSocket message, or stream event consumes credits based on complexity and volume. For example:

ActionApproximate Credits
Simple REST request (no limit parameter)1 credit
High-frequency REST endpoint (e.g. trades, quotes, or w/ limit parameter)1–3 credits (or depends on the value of the limit parameter)
WebSocket subscription updateVariable, depends on volume, frequency, and symbol

Credits are consumed in real time and apply across your entire account.

Every new CoinAPI account is eligible for $25 in free usage credits, but activation requires a few steps:

  1. Sign up at https://www.coinapi.io
  2. Create an API key in the Console
  3. Add a verified payment method
    • ATTENTION: This step is required to get $25 free credits even if you don’t plan to make a purchase.
  4. Start using the API - credits are applied automatically after step 3.

Trial credits can be used with either REST or WebSocket. There’s no need to switch plans to test both.

Remember: The credits should reflect within a few minutes. You can check them under: Billing (left sidebar) → Overview → Total Credits → $25

Alternatively:

  • You can purchase credits directly (PAYG).
  • Or you can subscribe to a monthly plan if you expect consistent usage.

💡 Curious what your free credits actually cover? Read What You Get with a Free Crypto API from CoinAPI ($25 Credits) - it breaks down the free tier, what endpoints you can access, and how to maximize those credits without surprises.

Here’s what you may see when you hit your quota, and how to resolve it.

ErrorMeaningFix
HTTP 429 Too Many RequestsYou’ve exceeded your allowed request rate or credit quota.Wait until reset or purchase more credits
HTTP 403 Quota ExceededYour API key is out of credits or plan quota.Top up credits or upgrade your plan
ErrorMeaningFix
policy message: insufficient_usage_creditsReal-time stream couldn’t continue due to lack of creditsReduce subscriptions or purchase credits

Tip: The WebSocket stream will disconnect or deny subscriptions if you’re out of usage credits - this is expected behavior.

  • Navigate to the "Usage Explorer" tab in your account dashboard
  • Review your daily/weekly usage, broken down by:
    • Protocol (REST, WebSocket)
    • Operation (e.g., /trades, /quotes, etc.)
    • Data center or source

This gives you clear visibility into which endpoints or streams consume the most usage credits.

Best Practices to Reduce Credit Use

  1. Use pagination for bulk data (e.g., /trades or /quotes)
  2. Cache responses locally for non-real-time data (e.g., daily rates)
  3. Batch requests when possible (e.g., /exchangerate/{asset_id_base}?invert=true supports multiple conversions)

For WebSocket users: Limit subscriptions to only necessary symbols and intervals.

📈 Not sure what kind of data you can request? Check out What Kind of Crypto Data Can You Access Through API? - it explains the types of market data available (trades, quotes, OHLCV, order books) so you know exactly what’s eating into your credits.

CoinAPI allows you to configure notifications when you're approaching or exceeding credit and quota limits.

You can configure this in Notifications → My Settings

  • 75% Used Threshold Notifies you once per month when your subscription usage exceeds 75%
  • 100% Exceeded Threshold Notifies you when your quota is fully used and future usage will be blocked or charged
  • Credits Balance Low Notifies you when your credit balance falls below $10

For real-time debugging and low-level insights into API calls, use the Traces > Requests section in the Console.

This tool lets you:

  • View a timestamped log of recent REST requests
  • Inspect HTTP status codes (200, 403, 429, etc.)
  • See which path was accessed and how long it took
  • Filter by time window (last 5 mins to 24 hours) and HTTP status
  • Investigate high credit usage from specific endpoints (e.g., /quotes, /trades)
  • Spot unauthorized access or blocked requests (403, 429)
  • Correlate slow responses with request timing or volume
  • Export data for audit or usage analysis

Combine Usage Explorer (for high-level credit consumption trends) with Traces (for low-level, per-request analysis) for a complete view of your API behavior.

To prevent runaway usage or unexpected charges, you can enable Spend Management in your account settings.

This lets you:

  • Set a daily usage credit limit
  • Configure email and webhook alerts
  • Automatically block API access when your limit is reached
  • Gain full visibility into your budget and consumption

⚠️ Spend Management is disabled by default and must be turned on manually.

To enable it:

  1. Go to Billing → Spend Management in the left-hand menu
  2. Toggle Spend Management ON
  3. Click Save Changes

Once enabled, you can:

  • Set a specific credit limit per day
  • Configure notify vs hard stop thresholds
  • Link to services like PagerDuty, Slack, or internal alerting tools via webhook

This feature is essential for organizations that:

  • Operate in production environments
  • Share usage across teams
  • Want guardrails without micromanaging traffic
  • You’ve burned through the $25 trial
  • Your usage exceeds PAYG costs consistently
  • You need higher throughput or longer data history

If you prefer a prepaid credit model, you can manually add credits at any time:

  1. Go to Billing → Add Usage Credits
  2. Enter an amount between $5 and $5000
  3. Select or add a payment method
  4. Click "Add to my balance"

Adding a payment method is also required to unlock your $25 free trial if you haven’t done so yet.

Not sure how much to add? Check our pricing page to estimate based on your endpoint mix.

→ Thinking about performance too? See Why WebSocket Multiple Updates Beat REST APIs for Real-Time Crypto Trading. It explains how to optimize data delivery and reduce unnecessary REST calls, which also saves credits.

What You Learned Summary How credits work CoinAPI counts usage via credits (not raw requests) across REST/WebSocket How to start your trial API key + verified payment method = $25 credits unlocked How to avoid hitting limits Monitor usage, cache wisely, and batch smartly What to do if blocked Check Console > usage, reduce load, or buy more credits