Skip to content
Crypto Deposits and Withdrawals

Submit Crypto Deposit Request

Submits a crypto deposit request for a token, network, and deposit method, and returns the receiving address of this account and the final quantity the Client must transfer. The Client must transfer exactly required_deposit_quantity from their own wallet to deposit_address; otherwise the deposit may fail.

The deposit method is set by business_type. When depositing from a new address (auth) or when the token requires a verification amount (trade_auth), the system generates a random verification amount, and the final quantity is the intended quantity plus the verification amount; show the receiving address after the Client confirms. After a deposit from a new address succeeds, the address is added to the Client whitelist automatically.

Side effects: creates a deposit request that appears in Query Crypto Deposit Records. While its status is pending_auth, it can be cancelled with POST /v1/atm/va/coin/deposit/cancel. If the Client changes the quantity and submits again, a new verification amount is generated. On failure, show message instead of resubmitting immediately.

When calling through WhaleCore requestService(), set requiresTradeToken to true.

A complete deposit flow runs in this order: get the token list (GET /v1/atm/va/query/all/coin/list) → confirm professional investor verification when required → check concentration (GET /v1/atm/va/coin/concentration/check) → select a network and query whitelisted addresses (POST /v1/atm/va/query/client/wallet/address/list) → check availability when an existing address is selected (GET /v1/atm/va/validate/client/wallet/available) → submit the deposit request → the Client transfers the returned quantity to the returned address → query deposit records.

POSThttps://api.lbkrs.com/v1/atm/va/deposit/coin/apply

Request body application/json

coinstringrequired

Token symbol, such as BTC, ETH, or USDT, taken from coin in Get Crypto Token List.

chain_typestringrequired

Network (chain) name, one of the values in the token chain_types.

business_typestringrequired

Deposit method:

  • normal - Deposit from a verified whitelisted address
  • trade_auth - Deposit from a whitelisted address for a token that requires a verification amount (deposit_need_micro_verification is yes)
  • auth - Deposit from a new address, with a verification amount to verify the address
Values
normal
trade_auth
auth
quantitystringrequired

Intended deposit quantity as a decimal string, not below the token min_per_deposit. Pass "0" when no quantity is entered.

wallet_idinteger

Whitelisted address id. Pass 0 or omit it when business_type is auth (new address).

Responses

HTTP 200The request succeeded. The response body contains the result of the “Submit Crypto Deposit Request” operation.
Standard response envelopecodemessagedata
dataobjectdata structure
deposit_addressstring

Receiving address of this account on the network. The Client must transfer to this address.

required_deposit_quantitystring

Final quantity the Client must transfer (intended quantity plus any verification amount). It must match exactly.

random_verify_quantitystring

Randomly generated verification amount. It can be empty when no verification is needed.

min_deposit_quantitystring

Minimum deposit quantity.

Whale Docs