POST
https://api.stableyard.fi
/
sdk
/
v1
/
get-balance
curl -X POST https://api.stableyard.fi/sdk/v1/get-balance \
  -H "x-sdk-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "user_abc123def456"
  }'

{
  "success": true,
  "data": {
    "balance": "1250.50",
    "balanceRaw": "1250500000",
    "decimals": 6
  },
  "requestId": "req_xyz789"
}
Retrieve a user’s stablecoin balance. By default returns Polygon USDC balance.

​
Authentication

​
x-sdk-key
string
required
Your API authentication key

​
Body Parameters

​
userId
string
User’s unique identifier. One of userId, paymentAddress, or address is required.
​
paymentAddress
string
User’s payment address (e.g., alice@stableyard)
​
address
string
Wallet or vault address
​
chainType
string
Chain identifier (default: Polygon)

​
Response

​
success
boolean
Indicates if the request was successful
​
data
object
Balance data
curl -X POST https://api.stableyard.fi/sdk/v1/get-balance \
  -H "x-sdk-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "user_abc123def456"
  }'

{
  "success": true,
  "data": {
    "balance": "1250.50",
    "balanceRaw": "1250500000",
    "decimals": 6
  },
  "requestId": "req_xyz789"
}