GET
https://api.stableyard.fi
/
sdk
/
v1
/
get-balances
curl -X GET "https://api.stableyard.fi/sdk/v1/get-balances?userAddress=0x1234..." \
  -H "x-sdk-key: YOUR_API_KEY"
{
  "success": true,
  "data": {
    "address": "0x1234567890abcdef1234567890abcdef12345678",
    "addressType": "vault",
    "balances": [
      {
        "chainId": 8453,
        "chainName": "Base",
        "token": "USDC",
        "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "balance": "500.00",
        "balanceRaw": "500000000",
        "decimals": 6,
        "usdValue": 500.00
      },
      {
        "chainId": 137,
        "chainName": "Polygon",
        "token": "USDC",
        "tokenAddress": "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174",
        "balance": "750.50",
        "balanceRaw": "750500000",
        "decimals": 6,
        "usdValue": 750.50
      }
    ],
    "totalUsdValue": 1250.50
  },
  "requestId": "req_xyz789"
}
Retrieve a user’s stablecoin balances across all supported chains in a single call.

Authentication

x-sdk-key
string
required
Your API authentication key

Query Parameters

userAddress
string
required
Vault or wallet address to query balances for
amount
number
default:"0"
Minimum balance filter — only return chains with balance above this amount

Response

success
boolean
Indicates if the request was successful
data
object
Balance data across chains
curl -X GET "https://api.stableyard.fi/sdk/v1/get-balances?userAddress=0x1234..." \
  -H "x-sdk-key: YOUR_API_KEY"
{
  "success": true,
  "data": {
    "address": "0x1234567890abcdef1234567890abcdef12345678",
    "addressType": "vault",
    "balances": [
      {
        "chainId": 8453,
        "chainName": "Base",
        "token": "USDC",
        "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "balance": "500.00",
        "balanceRaw": "500000000",
        "decimals": 6,
        "usdValue": 500.00
      },
      {
        "chainId": 137,
        "chainName": "Polygon",
        "token": "USDC",
        "tokenAddress": "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174",
        "balance": "750.50",
        "balanceRaw": "750500000",
        "decimals": 6,
        "usdValue": 750.50
      }
    ],
    "totalUsdValue": 1250.50
  },
  "requestId": "req_xyz789"
}

Supported Chains

ChainChain ID
Ethereum1
Base8453
Polygon137
Arbitrum42161
Optimism10