Query budget balances (Cycles v0.1.23)
GET
/v1/balances
See Cycles Protocol v0.1.23 specification.
GOVERNANCE INTEGRATION: - Returns full ledger state including debt, overdraft_limit, is_over_limit - Scoped to effective tenant - Supports scope filtering via query params
Authorizations
ApiKeyAuth
Tenant-scoped API key for runtime operations (consistent with Cycles Protocol)
Type
API Key (header: X-Cycles-API-Key)
Parameters
Query Parameters
tenant_id
Type
string
scope_prefix
Filter by scope prefix
Type
string
unit
Type
string
Valid values
"USD_MICROCENTS""TOKENS""CREDITS""RISK_POINTS"limit
Type
integer
Default
50Minimum
1Maximum
100cursor
Type
string
Responses
Balance data (see Cycles v0.1.23)