REST API/credits
GET

/credits

free

Free, unmetered. Returns this key's credit balance (free + paid), its USD value, and the top-up URL. Use it to self-monitor before and after spending. Checking your balance never costs credits.

Request#

bash
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://arkolith.com/api/v1/credits"

Parameters#

No parameters.

Example response#

json
{
  "data": {
    "credits": { "free": 940, "paid": 0, "total": 940 },
    "usd_value": 9.4,
    "credit_to_usd": 0.01,
    "topup_url": "https://arkolith.com/account/credits"
  }
}

MCP equivalent: account.balance. The full agent surface lives on the MCP server.