Balance

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

The USDC credit balance rip.fun holds for one end-user. Identify them by external_user_id (your id) and/or wallet_address — new users are created on first use. available = balance − reserved; amounts come as micros strings plus *_usdc decimal strings.

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
200 42ms preloaded server-side with the default context
object · 2 keys 
{
  "success": true,
  "data": {
    "end_user": {
      "id": 2,
      "external_user_id": "demo-explorer",
      "wallet_address": null
    },
    "wallet": {
      "currency": "USDC",
      "available": "0",
      "reserved": "0",
      "balance": "0",
      "available_usdc": "0.000000",
      "reserved_usdc": "0.000000",
      "balance_usdc": "0.000000"
    }
  }
}
curl (tracks the inputs above) 
curl -X GET 'https://service.rip.fun/api/v1/wallet/balance?external_user_id=demo-explorer' \
  -H 'X-API-Key: rip_…'

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