Ledger

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

A running history 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
200 139ms preloaded server-side with the default context
object · 3 keys 
{
  "success": true,
  "data": {
    "entries": []
  },
  "pagination": {
    "limit": 10,
    "offset": 0,
    "has_more": false
  }
}
curl (tracks the inputs above) 
curl -X GET 'https://service.rip.fun/api/v1/wallet/ledger?external_user_id=demo-explorer&limit=10' \
  -H 'X-API-Key: rip_…'

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)