delimiter
DASHBOARD / SPEND

Spend

The Spend page shows balance and spend data from two sources: SDK response headers and connected provider billing APIs.

SDK Spend Data#

For providers that include credit information in response headers (e.g., OpenRouter), the SDK automatically parses and reports:

  • Credits Remaining — Current balance
  • Credits Limit — Total credit limit
  • Request Cost — Cost of the last API call
  • 24h Spend — Total spend over the last 24 hours
  • Burn Rate — Dollars per hour based on recent usage
  • Projected Depletion — Estimated time until credits hit zero at the current burn rate

Each provider gets a health ring showing balance usage percentage: green (under 50%), yellow (50–80%), red (above 80%).

Connected Provider Balances#

When you connect provider accounts via the Connections page, the Credits page also shows billing API data:

  • Balance — Current credit balance from the provider's billing API
  • Period Spend — How much has been spent in the current billing period
  • BLACKOUT RISK badge — Appears when balance is at or near zero
  • LOW badge — Appears when 80%+ of credits are consumed

Connected provider data is polled every 15–30 minutes, compared to the SDK's real-time header data.

Alerts#

Credit balance alerts use the same threshold system as rate limits:

  • Warning at 70% of credits consumed
  • Critical at 90% of credits consumed

These thresholds are configurable in your project settings.