Skip to main content
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

​
id
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.