get
https://trade-hk.oslsandbox.com/api/3/wallet
Retrieve a list of external personal wallet addresses added to the client's user profile, along with associated details such as wallet name aliases, addresses, verification statuses, and more.
In May 2026 OSL deployed the One-Coin / Multi-Chain project (see announcement), and this endpoint has been updated to support this.
Two new string fields have been added that will be included on Response Parameters:
networkhas been added that serves as the chain network identifier, e.g.ETHEREUM,TRON, etc.coinis the virtual asset currency as a consolidated asset that is transferable across chains (e.g. USDT).
To identify which networks are available for a given currency, you can use the new Get Supported Transfer Network endpoint.
Code Table for status
status| Code | Description |
|---|---|
| MICROPAYMENT_PENDING | micropayment verification that's pending |
| MICROPAYMENT_REJECTED | micropayment verification that's rejected |
| MICROPAYMENT_VERIFIED | micropayment verification that's successful |
| UNVERIFIED | an wallet address that's not have any verification request pending. e.g. when a wallet address is newly added and doesn't have any micro payment verification request submitted. Or signing challenge verification that's not successful and within the maximum allowed attempts (i.e. signing challenge failed for 1st and 2nd time) |
| SIGNING_CHALLENGE_VERIFIED | signing challenge verification that's successful |
| SIGNING_CHALLENGE_REJECTED | signing challenge verification that's rejected (i.e. signing challenge failed for 3rd time |
| VERIFICATION_EXPIRED | the verification has expired |
| MANUAL_VERIFIED | wallet address has been manually verified by OSL operator |