Register a withdrawal address
Creates the address in pending_partner_approval and emails a 6-digit code to a registered administrator. The address is not usable until your administrator confirms the code and OnLink approves it. Re-registering the same address is idempotent: the existing registration is returned and no second row is created. If that registration is still awaiting your administrator and its code is no longer usable (expired, or cancelled after too many incorrect attempts), re-registering re-issues a fresh code — this is how you recover such an address. A code that is still live is never replaced, and no code is issued once the address has moved past your administrator’s approval.
Authorization
partner-key In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/wallets" \ -H "Content-Type: application/json" \ -d '{ "chain": "tron", "asset": "USDT", "address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t" }'{ "walletId": "b8e4d1c7-2f39-4a05-8d6b-1c2e3f4a5b60", "chain": "tron", "asset": "USDT", "address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", "label": "Settlement wallet — Tron", "status": "pending_partner_approval", "screeningStatus": "pending", "createdAt": "2026-08-31T09:30:00.000Z", "approvalSentTo": "o•••@yourcompany.com", "nextStep": "A 6-digit approval code was emailed to a registered administrator. Confirm with POST /v1/wallets/{id}/confirm. The address is NOT usable until OnLink also approves it."}Your KES payout destinations GET
The destinations a sell order may name in payoutAccountId. Read-only: destinations are registered by OnLink, not through this API, so your API credential cannot add a place for money to go. Only active destinations are listed. Account numbers are returned as the last four digits only — you select a destination by id and never type its number.
Confirm a withdrawal address with your administrator’s code POST
Moves the address to pending_onlink_approval — not to active. OnLink approves every withdrawal address as well, so a correct code alone does not make an address usable.