Skip to main content
GET
This endpoint provides real-time balance information with multi-chain support and historical querying capabilities.

ssUSD Balance API

Query StateSet USD (ssUSD) balances with comprehensive filtering, multi-chain aggregation, and real-time updates.

🔑 Authentication

JS/Python SDK support for this resource has not shipped yet.

📋 Path Parameters

string
required
The blockchain address to query. Supports multiple formats:
  • StateSet: stateset1qypqxpq9qcrsszg2pvxq6rs0zqg3yyc5lzv7xu
  • Ethereum/Base: 0x742d35Cc6634C0532925a3b844Bc9e7595f6E321
  • Solana: DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263

🔍 Query Parameters

array
Filter by specific chains or query all chainsOptions: ["stateset", "base", "solana", "cosmos"]Default: All chains where address has balance
boolean
default:false
Include pending transactions in balance calculationUseful for showing “available” vs “total” balance
boolean
default:true
Include locked/vesting balances in response
integer
Query historical balance at specific block heightExample: 1542389
string
Query historical balance at specific timeFormat: ISO 8601 (e.g., 2024-06-25T12:00:00Z)
string
Convert balance to another currencyOptions: USD, EUR, GBP, JPY, etc.

📤 Response

string
The queried blockchain address
object
Balance breakdown by type and chain
array
Balance breakdown by blockchain
object
Balance in other currencies (if requested)
object
Additional account information

Errors

Succeeds with 200. Failures return 400, 401, 403, 404 or 429 with an error body, per the platform status-code contract.

💡 Common Use Cases

Treasury Dashboard

Payment Processing

Multi-Signature Wallet

🔔 Webhooks

Subscribe to balance change events:
Webhook payload

🚨 Error Handling

Transfer ssUSD

Send ssUSD to another address

Transaction History

View transaction history

Analytics

Balance analytics and insights

Reserves

View backing reserves
Last modified on August 31, 2026