Balance

Credits left on a key, its auto-reload settings and the average credits used per day. Free to call.

GET/v1/balance

Credits: 0

Credits left on a key, its auto-reload settings and the average credits used per day over the last 7 days. The key goes in a header only; ?key= is not accepted, so keys never reach access logs. MCP tool: contextfetch_balance.

Parameters

Name	In	Type	Required	Description
Authorization / x-api-key	header	string	yes	The key to check.

Example request

curl -s https://api.contextfetch.dev/v1/balance -H "Authorization: Bearer YOUR_API_KEY"

Example response

{
  "credits": 14873,
  "auto_reload": {
    "enabled": true,
    "threshold": 1000,
    "pack": "builder",
    "monthly_max_usd": 500,
    "spent_this_month_usd": 50,
    "last_error": null
  },
  "burn_rate_per_day": 412
}

Errors

Status	Body	When
401	`{"error": "invalid_api_key"}`	The key is unknown.