Ledger

GET /api/v1/wallet/ledger wallet:read

Append-only ledger of every credit movement for the end-user. Entry types: DEPOSIT_CREDIT, HOLD, HOLD_RELEASE, HOLD_SETTLE, BUYBACK_CREDIT, REFUND_CREDIT, ADJUSTMENT.

Try it GET /api/v1/wallet/ledger?external_user_id=demo-explorer&limit=10

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

response
401 26ms 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/ledger?external_user_id=demo-explorer&limit=10' \
  -H 'X-API-Key: rip_v1_…'

Request fields

FieldTypeRequiredDescription
external_user_id / wallet_addressquery stringyesEnd-user identity (at least one)
limit / offsetquery int—Pagination

Response fields (data)

FieldDescription
entries[].entry_typeOne of the ledger entry types above
entries[].amount / amount_usdcSigned movement (micros string + decimal)
entries[].balance_after / reserved_afterRunning balances after the entry
entries[].source / source_id / descriptionWhat caused the entry (e.g. purchase + tx hash)