Skip to content
Trading Password and Unlock

Submit Authenticator Code for Trade Unlock

Completes second-factor verification for trade unlock with a code generated by the third-party authenticator (TOTP) app bound by the Client. Call it for the same account after Verify Trade Password returns need_totp_two_factors: true. The request does not carry the trade password. On success, returns the trade token: data.token.token maps to tradeToken and data.token.refresh_token maps to tradeRefreshToken of updateTradeToken.

If the code is wrong or expired, show message and let the Client enter a new code.

This operation obtains the trade token, so do not set requiresTradeToken to true when you call it through WhaleCore requestService().

POSThttps://api.lbkrs.com/v1/member/trade/totp/auth_two_factors

Request body application/json

verify_codestringrequired

Current 6-digit code shown in the authenticator app

Responses

HTTP 200The request succeeded. The response body contains the result of the “Submit Authenticator Code for Trade Unlock” operation.
Standard response envelopecodemessagedata
dataobjectdata structure
tokenobject

Trade token and its refresh token, issued per account

Child attributes
tokenstring

Trade token. Pass it as tradeToken to WhaleCoreService.updateTradeToken(...)

refresh_tokenstring

Refresh token. Pass it as tradeRefreshToken to updateTradeToken; it is also the input of POST /v1/member/trade/refresh_token

refresh_token_expiresinteger

Lifetime of the refresh token, in seconds, counted from issuance

Whale Docs