Clawrouter

GEThttps://your-instance.com/api/usage/token/

Send the API key whose balance you want to read as a bearer token. This is a read-only endpoint: it does not create a model request or consume quota.

curl

curl https://your-instance.com/api/usage/token/ \
  -H "Authorization: Bearer $CLAWROUTER_API_KEY"

200 OK

{
  "code": true,
  "message": "ok",
  "data": {
    "object": "token_usage",
    "name": "my-key",
    "total_granted": 500000000,
    "total_used": 32571583,
    "total_available": 467428417,
    "unlimited_quota": false,
    "model_limits": {},
    "model_limits_enabled": false,
    "expires_at": 0
  }
}

Quota units

total_granted, total_used and total_available are internal quota units, not US dollars. Divide a quota value by 500000 to get its USD equivalent. For example, total_available of 467428417 equals $934.856834; total_granted of 500000000 equals $1000.

Conversion

USD = quota / 500000