Balance endpoints

ORYNX implements the two OpenAI dashboard endpoints that many chat apps call to show a balance. Both take the usual Authorization: Bearer header, and both also answer without the /v1 prefix.

Subscription

curl https://api.orynx.dev/v1/dashboard/billing/subscription \
  -H "Authorization: Bearer $ORYNX_API_KEY"

{
  "object": "billing_subscription",
  "hard_limit_usd": 20,
  "access_until": 1798761600
}

hard_limit_usd is the key's total credit in US dollars, and access_until is its expiry as a Unix timestamp. The response also has the other fields OpenAI clients read, such as soft_limit_usd and has_payment_method.

Usage

curl "https://api.orynx.dev/v1/dashboard/billing/usage?start_date=2026-09-01&end_date=2026-09-30" \
  -H "Authorization: Bearer $ORYNX_API_KEY"

{ "object": "list", "total_usage": 562.4, "daily_costs": [] }

total_usage is the key's total spend in cents, so 562.4 means $5.624. The start_date and end_date parameters are accepted but ignored. Remaining credit is hard_limit_usd - total_usage / 100.

An expired or disabled key gets 401 from both endpoints. For token totals and spend per model and per day, use Key lookup.