Balance (USDC)

Alpha Version

The Ostium Builder Service is in Alpha. API endpoints, specifications, and builder URLs may change without notice. Use with caution in production environments.

GET /v1/balance/usdc

Returns the trader's USDC balance on-chain.

Headers

Header	Required	Description
`X-Trader-Address`	Yes	Trader wallet address.

Response Body

Field	Type	Required	Description
`address`	`string`	Yes	Trader address.
`symbol`	`string`	Yes	`USDC`.
`decimals`	`number`	Yes	Token decimals (6).
`balance`	`string`	Yes	Raw balance in base units.
`balanceFormatted`	`string`	Yes	Human-readable balance with 6 decimals.

Example

curl https://builder.ostiscan.xyz/v1/balance/usdc \
  -H "X-Trader-Address: 0xYourWallet"

Example Response

{
  "address": "0xYourWallet",
  "symbol": "USDC",
  "decimals": 6,
  "balance": "250000000",
  "balanceFormatted": "250.000000"
}

Errors

See /docs/errors.