OnLink
API reference

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.

POST
/v1/wallets

Authorization

partner-key
X-OnLink-Key<token>

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."}