/api/v1/wallet/balance wallet:read The USDC balance backing custodial purchases for one end-user. available is what a new purchase can reserve; reserved is held by in-flight purchases and released on refund. Balances are integer micros as strings, with *_usdc decimal twins for display.
GET /api/v1/wallet/balance?external_user_id=demo-explorer These inputs are shared across all docs pages, so an id entered here carries over.
{
"success": false,
"message": "Mystery partner API key required",
"error": "This endpoint requires an API key linked to a mystery partner account"
}curl -X GET 'https://service.rip.fun/api/v1/wallet/balance?external_user_id=demo-explorer' \ -H 'X-API-Key: rip_…'
| Field | Type | Required | Description |
|---|---|---|---|
external_user_id / wallet_address | query string | yes | Which end-user (one of the two) |
data)| Field | Description |
|---|---|
end_user.id / external_user_id / wallet_address | The resolved end-user |
wallet.available / reserved / balance | USDC micros as strings |
wallet.available_usdc / reserved_usdc / balance_usdc | The same three as decimal strings |
| Status | Code | When |
|---|---|---|
| 400 | missing_user_identifier | neither identifier given |
See Errors for the response envelope and the full code list.