Get deposit address

POST /api/v1/wallet/deposit-address wallet:deposit

Where an end-user sends USDC (on Base) to fund custodial purchases. Returns a dedicated per-user address when one is provisioned (dedicated: true, credited automatically), otherwise the shared deposit address with dedicated: false and a note — attribute shared-address deposits per its instructions.

Try it POST /api/v1/wallet/deposit-address write

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

request body
object · 1 keys
{
  "external_user_id": "demo-explorer"
}
response

Not run yet. Press Run to make a live call against https://service.rip.fun (through this demo's server-side proxy; the API key never reaches the browser).

tracks the inputs above
curl -X POST 'https://service.rip.fun/api/v1/wallet/deposit-address' \
  -H 'X-API-Key: rip_…' \
  -H 'Content-Type: application/json' \
  -d '{"external_user_id":"demo-explorer"}'

Request fields

FieldTypeRequiredDescription
external_user_id / wallet_addressstringyesWhich end-user the deposit credits

Response fields (data)

FieldDescription
chain / address / currencyWhere to send funds — currency is always "USDC"
dedicatedtrue = per-user address, credited automatically; false = shared fallback address (see note)

Errors

StatusCodeWhen
400missing_user_identifierneither identifier given

See Errors for the response envelope and the full code list.