Current account balance (free)
curl --request GET \
--url https://api.aegis-kyt.com/v2/balance \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aegis-kyt.com/v2/balance"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aegis-kyt.com/v2/balance', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{}V2 Public API
GET /v2/balance
Remaining credit balance, month-to-date spend and monthly cap for the authenticated key.
GET
/
balance
Current account balance (free)
curl --request GET \
--url https://api.aegis-kyt.com/v2/balance \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aegis-kyt.com/v2/balance"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aegis-kyt.com/v2/balance', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{}Auth: Required · Cost: Free (no charge) · Use case: show a client
their remaining grant without spending it
- Render “X credits remaining” in your own dashboard.
- Stop a batch job before it hits a
402 insufficient_fundsmid-run. - Detect that a monthly cap is about to bite, while you can still raise it.
Request
curl -H "Authorization: Bearer aeg_YOUR_KEY_HERE" \
"https://api.aegis-kyt.com/v2/balance"
Response 200
{
"currency": "USD",
"balance_usd": 42.5,
"monthly_spent_usd": 7.5,
"monthly_cap_usd": 100.0,
"unit": "credits",
"balance_credits": 42.5,
"monthly_spent_credits": 7.5,
"monthly_cap_credits": 100.0
}
| Field | Type | Notes |
|---|---|---|
currency | string | Always USD (legacy; kept for compatibility) |
balance_usd | number | What is left to spend right now, in credits |
monthly_spent_usd | number | Month-to-date spend in credits, resets on the 1st |
monthly_cap_usd | number | null | Optional ceiling set by the operator, in credits. null means no cap — not zero |
unit | string | Always credits |
balance_credits | number | Same value as balance_usd |
monthly_spent_credits | number | Same value as monthly_spent_usd |
monthly_cap_credits | number | null | Same value as monthly_cap_usd |
Two independent limits, and either one can produce a
402: an empty
balance_usd gives insufficient_funds, and hitting monthly_cap_usd gives
monthly_cap_exceeded. A healthy balance does not guarantee the next call
goes through if the cap is close.billing block of
GET /v2/me/usage — one source, two shapes.
Use /v2/balance when you only need the balance and not the call history.Authorizations
Your aeg_… API key from the dashboard (Account → API tab).
Response
200 - application/json
Successful Response
The response is of type Response Get Account Balance Balance Get · object.