Balance

GET /api/v1/wallet/balance wallet:read

Returns the custodial USDC credit balance rip.fun holds for one end-user. Identify the user with external_user_id (your id) and/or wallet_address — the user is auto-provisioned on first reference. Amounts are integer micros as strings plus *_usdc decimal strings; available = balance − reserved.

Try it GET /api/v1/wallet/balance?external_user_id=demo-explorer

These inputs are shared across all docs pages — an id entered here carries over.

response
401 25ms preloaded server-side with the default context
object · 3 keys 
{
  "success": false,
  "message": "Invalid API key",
  "error": "API key not found or inactive"
}
curl (tracks the inputs above) 
curl -X GET 'https://staging-service.rip.fun/api/v1/wallet/balance?external_user_id=demo-explorer' \
  -H 'X-API-Key: rip_v1_…'

Request fields

FieldTypeRequiredDescription
external_user_idquery string—Your id for the end-user (≤255 chars). At least one identifier required.
wallet_addressquery string—End-user Base wallet address

Response fields (data)

FieldDescription
end_userResolved end-user (id, external_user_id, wallet_address)
wallet.available / reserved / balanceUSDC micros as strings ("12500000" = 12.5 USDC)
wallet.*_usdcDecimal display strings of the same values