curl https://api.stablegenius.co/v1/merchants/mer_abc123/balance \
-H "Authorization: Bearer sk_test_abc123"
{
"object": "balance",
"merchant_id": "mer_abc123",
"available": 142.55,
"pending_settlement": 0.00,
"currency": "usd",
"payment_address": "0x1a2b3c4d5e6f7890abcdef1234567890abcdef12",
"chain": "base",
"last_updated": "2026-04-01T20:15:00Z"
}
Merchants
Get Merchant Balance
Retrieve a merchant’s current on-chain USDC balance
GET
/
v1
/
merchants
/
{id}
/
balance
curl https://api.stablegenius.co/v1/merchants/mer_abc123/balance \
-H "Authorization: Bearer sk_test_abc123"
{
"object": "balance",
"merchant_id": "mer_abc123",
"available": 142.55,
"pending_settlement": 0.00,
"currency": "usd",
"payment_address": "0x1a2b3c4d5e6f7890abcdef1234567890abcdef12",
"chain": "base",
"last_updated": "2026-04-01T20:15:00Z"
}
Get Merchant Balance
Returns the merchant’s current USDC balance in their on-chain proxy contract. This is the amount available for withdrawal or settlement.Path Parameters
string
required
The merchant ID (format:
mer_*).curl https://api.stablegenius.co/v1/merchants/mer_abc123/balance \
-H "Authorization: Bearer sk_test_abc123"
{
"object": "balance",
"merchant_id": "mer_abc123",
"available": 142.55,
"pending_settlement": 0.00,
"currency": "usd",
"payment_address": "0x1a2b3c4d5e6f7890abcdef1234567890abcdef12",
"chain": "base",
"last_updated": "2026-04-01T20:15:00Z"
}
The
available balance reflects confirmed on-chain USDC. It updates within seconds of a payment being confirmed. The pending_settlement amount represents funds that are in the process of being withdrawn to the merchant’s bank account.