Add New Wallet Address

post

https://trade-hk.oslsandbox.com/api/3/wallet

Submit a new personal wallet address to link with the account owner's user profile and receive instructions on verifying the submitted personal wallet address.

⚠️
In May 2026 OSL deployed the One-Coin / Multi-Chain project (see announcement), and this endpoint has been updated to support this.

One new string fields has been added that will be included on Request Parameters:

networkhas been added that serves as the chain network identifier, e.g. ETHEREUM, TRON, etc.

Note that the currencyType field is used to pass the currency, e.g. BTC, ETH etc.

To identify which networks are available for a given currency, you can use the new Get Supported Transfer Network endpoint.

ℹ️
Wallets can only be added to the Default account UUID.

`verificationAmount`

This is the required deposit amount for users opting to verify the wallet address via micropayment

`verificationPhrase`

This is the phrase that's required to be signed for users opting to verify the wallet address via signing challenge.

Body Params

tonce

int64

The current Unix time in microseconds

walletName

string

required

Alias assigned to the newly submitted external wallet

walletAddress

string

required

Valid wallet address for the newly submitted external wallet

currencyType

string

enum

required

Type of token for the newly submitted external wallet

Allowed:

accountGroupUuid

string

required

Specifies the owner of the account group to which the wallet address should be added, identified by the account group uuid.

authenticationType

string

enum

required

2FA verification method - currently only supports "otp"

Allowed:

otp

string

required

A valid "One-Time-Password" code to authenticate this new submission

network

string

Blockchain network identifier, e.g. ETHEREUM, TRON, etc. (use Get Supported Transfer Network for valid values).

Responses

verificationAmount

verificationPhrase

200200

400400

`verificationAmount`

`verificationPhrase`