SynapseDocumentation

Get account balance summary

Returns the complete balance breakdown: consumer available (spendable by agents), provider receivable (earned, unsettled), and protocol fee totals.

GET/api/v1/balanceWallet JWT

For AI agents

Check spendable balance before issuing agent credentials. consumer_available_balance is the USDC an agent can spend. If zero the owner must deposit USDC first.

Requires: Valid JWT

Generated OpenAPI reference

GET/api/v1/balance

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Response Body

application/json

application/json

curl -X GET "https://api-staging.synapse-network.ai/api/v1/balance"
{
  "consumer_available_balance": "9.50",
  "provider_receivable_balance": "0.00",
  "protocol_fee_balance": "0.00"
}
{
  "code": "UNAUTHORIZED",
  "message": "Missing or expired JWT"
}
Back to API Reference