GET /v2/balance

Current account balance (free)

curl --request GET \
  --url https://api.aegis-kyt.com/v2/balance \
  --header 'Authorization: Bearer <token>'

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));

{}

GET

balance

Current account balance (free)

curl --request GET \
  --url https://api.aegis-kyt.com/v2/balance \
  --header 'Authorization: Bearer <token>'

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

Read-only snapshot of the money side of your API key. Free by design — the point is to check what you have before firing a paid call, and a probe that costs money defeats that. Use this endpoint to:

Render “$X remaining” in your own dashboard.
Stop a batch job before it hits a 402 insufficient_funds mid-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"

No parameters.

Response 200

{
  "currency": "USD",
  "balance_usd": 42.5,
  "monthly_spent_usd": 7.5,
  "monthly_cap_usd": 100.0
}

Field	Type	Notes
`currency`	string	Always `USD`
`balance_usd`	number	What is left to spend right now
`monthly_spent_usd`	number	Month-to-date spend, resets on the 1st
`monthly_cap_usd`	number \| null	Optional ceiling set by the operator. `null` means no cap — not zero

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.

Same numbers appear in the billing block of GET /v2/me/usage — one source, two shapes. Use /v2/balance when you only need the money and not the call history.

Authorizations

Authorization

string

header

required

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.

Get started

Authentication

x402 Endpoints (USDC pay-per-call)

V2 Public API

Webhooks (push events)

Methodology

Reference

Other

Request

Response 200

Authorizations

Response

​Request

​Response 200

Authorizations

Response

Request

Response 200