Introduction

Welcome to the LBANK API! You can use our API to access all market data, trading, and account management endpoints.The version of the document is V2,and it will continuously update.

LBANK offers powerful APIs for you to integrate into your applications. They are divided into three categories: account, trading, and market trends.

The account and trading APIs require authentication with an API key which allows you to create order、cancel order、query order and account info.

The market data API is publicly accessible and provides market data such as:historical price of trading pairs.

Process

To access the API, create an API key via this link API Key. Follow the instructions in setting up access.

Please remember below information after creation:

API Key is used in API request
Secret Key is used to generate the signature(only visible once after creation)

LBank support both RSA and HmacSHA256 signature.

RSA scheme is a digital signature scheme based on hardness of problem in math. It is a asymmetric cryptographic scheme. Sender obtains the signature data after encoding and computation of message and private key. Receiver checks the role of sender and the integrity of message according to the signature and the public key registered. Relatively, it is no need of private key in the validation of RSA scheme. It is ensured that only the user can send the valid message
HMAC is message authentication scheme based on hash function. It is a symmetric cryptographic scheme. Sender obtains the message authentication codes (MAC) after encoding and computation of message and shared key. Receiver checks the role of sender and the integrity of message. The scheme is effective and of high level security due to the security of hash function

SDK

Developers can use the LBank API in a way that suits them based on their preferences and usage scenarios. We currently provide in different language versions. Each SDK include full function interface in example file for directly using or testing. If you want to implement the SDK based on other language such as C#, the existing SDKs could be your best reference.

Endpoints Configurations

We offers REST and WebSocket APIs. Both support market data, trading, and withdrawals.

REST API

REST (Representational State Transfer) is the most popular internet software architecture nowadays. It is clear in structure, easy to understand, and convenient to expand. More and more companies therefore apply the structures in their websites. It has following advantages:

1.In a RESTful architecture, each URL represents a resource
2.Between the client and the server, a certain presentation layer of such resources passed
3.The client uses the four HTTP commands to operate on the server-side resources to achieve “state transition of the presentation layer.”

We suggested that user should use the REST API for trading and/or asset operations (such as deposite and withdrawals)

WebSocket API

WebSocket protocol which achieves full-duplex communications over a single TCP connection between client and server is based on a new network protocol of the TCP. Server sends information to client, reducing unnecessary overhead such as frequent authentication. It greatest advantage includes that：

1.Request header is small in size (2 Bytes) .
2. The server no longer passively responses after receiving the client's request, but actively pushes the new data to the client.
3. There is no need to establish and close TCP connection repeatedly, so it saves bandwidth and server resources.

Changelog

Live Date Time(UTC+8)	API	Type	Description
2019.10.24 19:00			Init new version
2019.11.30 19:00	API	Add	Add /v2/cancel_clientOrders.do
2019.12.09 19:00	API	Add	Add HmacSHA256
2019.12.16 19:00	Echostr	Update	Update echostr param
2020.2.24 19:00	/v2/batch_create_order.do	Add	Add new API
2020.3.04 19:00	WebSocket	Add	Asset & Order add customerID return message
2020.06.10 19:00	/v2/create_order.do	Update	type add buy_maker, sell_maker, buy_ioc, sell_ioc, buy_fok, sell_fok
2020.07.07 19:00	/v2/get_deposit_address.do	Add	add get_deposit_address endpoint
2020.07.07 19:00	/v2/deposit_history.do	Add	add deposit_history endpoint
2021.06.28 19:00	WebSocket	Add	`orderUpdate` add orderPrice,orderAmt,avgPrice,accAmt,remainAmt
2021.07.13 19:00	API	Add	Added `GET /v2/ticker/24hr.do` currency market interface, it is recommended to replace `GET /v2/ticker.do`
2021.07.27 19:00	WebSocket	Add	Add `assetUpdate`
2022.02.14 19:00	/v2/supplement/system_status.do	Added	Get system status.
2022.02.14 19:00	/v2/supplement/user_info.do	Added	Get all the currency information for users (LBK supports deposit and withdrawal operations).
2022.02.14 19:00	/v2/supplement/withdraw.do	Added	User withdrawal (multi-chain support)
2022.02.14 19:00	/v2/supplement/deposit_history.do	Added	User gets deposit history Optimize return field
2022.02.14 19:00	/v2/supplement/withdraws.do	Added	User acquisition history optimization
2022.02.14 19:00	/v2/supplement/get_deposit_address.do	Added	User gets deposit address (supports multiple chains)
2022.02.14 19:00	/v2/supplement/asset_detail.do	Added	Asset details listed
2022.02.14 19:00	/v2/supplement/customer_trade_fee.do	Added	User transaction fee rate query
2022.02.14 19:00	/v2/supplement/api_Restrictions.do	Added	Query user API Key permissions
2022.02.14 19:00	/v2/supplement/system_ping.do	Added	Test server connectivity
2022.02.14 19:00	/v2/supplement/trades.do	Added	List of recent deals Optimize fields
2022.02.14 19:00	/v2/supplement/ticker/price.do	Addition	Get latest price of trading pair
2022.02.14 19:00	/v2/supplement/ticker/bookTicker.do	Add	Current optimal pending order
2022.02.14 19:00	/v2/supplement/create_order_test.do	Add	Test order
2022.02.14 19:00	/v2/supplement/create_order.do	Add	Order Optimization field
2022.02.14 19:00	/v2/supplement/cancel_order.do	Add	Cancel order Optimize fields
2022.02.14 19:00	/v2/supplement/cancel_order_by_symbol.do	Add	Cancel all pending orders for a single trading pair
2022.02.14 19:00	/v2/supplement/orders_info.do	Add	Query order optimization field
2022.02.14 19:00	/v2/supplement/orders_info_no_deal.do	Add	Current pending orders Optimization field
2022.02.14 19:00	/v2/supplement/orders_info_history.do	Add	Query all orders Optimize fields
2022.02.14 19:00	/v2/supplement/user_info_account.do	Add	Account Information
2022.02.14 19:00	/v2/supplement/transaction_history.do	Added	Historical transaction details
2022.11.03 18:00	/v2/create_order.do	Update	Increase the order expiration time
2022.11.03 18:00	/v2/batch_create_order.do	Update	Increase the order expiration time
2022.11.03 18:00	/v2/supplement/create_order.do	Update	Increase the order expiration time
2022.11.03 18:00	/v2/ticker/24hr.do	Update	Exclude ETF trading data
2022.11.03 18:00	/v2/ticker.do	Update	Exclude ETF trading data
2022.11.03 18:00	/v2/etfTicker/24hr.do	Added	Obtain ETF trading performance data
2022.12.16 18:00	/v2/transaction_history.do	Update	The query time is in seconds
2022.12.16 18:00	/v2/supplement/transaction_history.do	Update	The query time is in seconds
2023.02.23 18:00	/v2/order_transaction_detail.do	Update	New return field isMaker whether to mount unilateral
2024.06.06 18:00	REST API	Update	New global return field `msg` (detailed description of error code)
2026.03.18 18:00	REST API	Update	Additional error codes and detailed descriptions. Additional interface field descriptions and return examples. Error corrections for the transaction cancellation order interface (`POST /v2/supplement/cancel_order.do`) return example.

Interaction Introduction

URL

REST API

https://www.lbkex.net/

https://api.lbkex.com/

https://api.lbank.info/

Websocket

wss://www.lbkex.net/ws/V2/

Endpoint Rate Limit

Create order and cancel order Request 500/10s

The other Request 200/10s

Authentication

To protect API communication from unauthorized change, all non-public API calls are required to be signed.

Request Header Setting

You should put the following parameters in every http requests

contentType:'application/x-www-form-urlencoded'

timestamp: millisecond of current time (1567833674095). It's strongly recommended that you get it from /v2/timestamp.do

signature_method: RSA/HmacSHA256.

echostr: the param is digit or letter，length is from 30 to 40. You can directly use echostr of SDK, it's safe.

Signature Process (how to generate the 'sign' parameter)

1. Get parameter String(need to be signed):

Each required parameter of API, exclude sign, add three additional parameters(signature_method, timestamp, echostr) , then we get the parameter string which need to be signed. The parameter string should be ordered according to the parameter name (first compares the first letter of all parameter names, in alphabet order, if you encounter the same first letter, then look at the second letter, and so on). For example, if we use user_info API, the parameter string is like

string parameters="api_key=c821db84-6fbd-11e4-a9e3-c86000d26d7c&echostr=P3LHfw6tUIYWc8R2VQNy0ilKmdg5pjhbxC7&signature_method=RSA&timestamp=1585119477235"

2. Turn parameters into MD5 digest：

The MD5 digest should be Hex encoded and all letters are uppercase.

string preparedStr = DigestUtils.md5Hex(parameters).toUpperCase()

3. Signature:

Users could use their secret key to perform a signature operation (Base64 coded) by RSA or HmacSHA256.

RSA method(signature_method = RSA):

use secret key of your api_key，sign the preparedStr(Base64 encode)，then we get the parameter sign.

    public static String RSA_Sign(String preparedStr, String secretKey) {
        try {
            PrivateKey priKey = getPrivateKey(secretKey);
            Signature signature = Signature.getInstance("SHA256WithRSA");
            signature.initSign(priKey);
            signature.update(content.getBytes(CharEncoding.UTF_8));
            byte[] signed = signature.sign();
            return new String(Base64.getEncoder().encode(signed));
        } catch (Exception e) {
            e.printStackTrace();
        }
        return null;
    }

    private static PrivateKey getPrivateKey(String key) {
        PKCS8EncodedKeySpec keySpec = new PKCS8EncodedKeySpec(Base64.getDecoder().decode(key));
        PrivateKey privateKey = null;
        try {
            KeyFactory keyFactory = KeyFactory.getInstance(RSA);
            privateKey = keyFactory.generatePrivate(keySpec);
        } catch (NoSuchAlgorithmException | InvalidKeySpecException e) {
            e.printStackTrace();
        }
        return privateKey;
    }

HmacSHA256 method(signature_method = HmacSHA256):

use secret key of your api_key，make the hash operation of preparedStr，then we get the parameter sign.

    public static String HmacSHA256_Sign(String preparedStr, String secretKey) {
        String hash = "";
        try {
            Mac sha256_HMAC = Mac.getInstance("HmacSHA256");
            SecretKeySpec secret_key = new SecretKeySpec(secretKey.getBytes(), "HmacSHA256");
            sha256_HMAC.init(secret_key);
            byte[] bytes = sha256_HMAC.doFinal(message.getBytes());
            hash = byteArrayToHexString(bytes);
        } catch (Exception e) {
            e.printStackTrace();
        }
        return hash;
    }

Submit：

After we get the parameter 'sign', put it together with all required parameters of endpoint, then submit as 'application/x-www-form-urlencoded'. As user_info endpoint, we should summit the following parameters:

api_key=6a8d4f1a-b040-4ac4-9bda-534d71f4cb28

sign=e73f3b77895d3df27c79481d878a517edd674e8496ed3051b6e70b6d0b1e47bc

Request Format

All request are GET or POST.

Content-Type:application/x-www-form-urlencoded、timestamp:1567427936729、signature_method:RSA、echostr:3d47056c0bf0429c81afc8c3de7b0f94。

Response Format

Parameter	Type	Description
result	String	API return，true/false
error_code	Integer	return error_code
ts	Long	return timestamp
data	Object	return body
msg	String	return message

Error code

REST API code

Error code	Description
0	success
10000	Internal error
10001	Parameter can not be null
10002	Validation Failed
10003	Invalid parameter
10004	Request too frequent
10005	Secret key does not exist
10006	User does not exist
10007	Invalid signature
10008	Currency pair nonsupport
10009	Limit orders cannot lack the order price and order quantity
10010	The order price or order quantity must be greater than the minimum value
10011	Buy at market price, price field must be passed
10012	Sell at market price, amount field must be passed
10013	Order quantity is lower than the minimum transaction quantity
10014	Currency is not enough
10015	Invalid order type
10016	Currency is not enough
10017	Server exception
10018	Page size should be between 1 and 50
10019	Cancel NO more than 3 orders in one request
10020	The market order amount is less than the minimum transaction amount
10021	Limit order price is less than the minimum price accuracy
10022	API Key permission denied, Invalid IP or permissions
10023	Not support market trade
10024	User cannot trade on this pair
10025	Order has been filled
10026	Order has been cancelld
10027	Order is cancelling
10028	Wrong query time
10029	from is not within the query time range
10030	Inconsistent transaction type between from and queried
10031	echostr is a legal string with a length between 30 and 40, consisting of numbers and letters
10032	Order number does not exist
10033	Failed to create order
10034	The currency cannot be withdrawn
10035	Withdrawal address is abnormal, unable to withdraw
10036	Duplicate custom_id
10037	The order has been cancelled or completed
10038	Order cancellation exception
10039	Order timeout cancellation
10066	Please check the chain name
10067	Current account does not have permission
10100	Permission denied for withdraw
10101	Invalid fee rate to withdraw
10102	Withdrawal amount is less than the minimum withdrawal amount
10103	Withdrawal limit exceeded daily limit
10104	The order has been processed and cannot be cancelled
10105	The order is canceled
10106	Non-trading time cannot be traded
10107	Opening price data is abnormal
10108	The order cannot be placed because the order price exceeds the fluctuation range.
10109	The digital asset wallet address is not correct
10110	Transfer fees do not match
10111	The withdrawal amount must be greater than 0
10112	The fee is too low and will be rejected by the blockchain network. Please submit again
10113	The transfer fee interval is empty
10114	Withdrawal quantity accuracy is incorrect
10116	Upgrading, please try again later
10117	Internal account transfer turns off
10118	According to the policy requirements of your region, please go to the WEB end to initiate a withdrawal request
10119	Interface upgrade, please use:`/v2/spot/wallet/withdraw.do` for off-site withdrawal
10120	Less than the minimum transaction amount
10121	Order failed, the order amount exceeded the maximum single transaction limit
10122	Order failed, price exceeded upper limit
10123	Order failed, price below lower limit
10125	Order failure, high market price volatility, may lead to order price deviation
10132	According to the policy requirements in your region, please fill in the user type and recipient information correctly
10200	broker information error
10201	Parameters such as api_key and sign can not be null
10202	Parameters such as timestamp、signature_method and echostr can not be null
10203	Wrong signature method
10205	Due to the compliance requirements of your country/region, LBank is temporarily unable to provide services. To avoid potential losses, please cancel the entrusted transaction or withdraw the funds as soon as possible
10600	Request timeout, please check the difference between timestamp and server time
10601	Interface closed unavailable
10606	The maximum time range supported for queries is 7 days
10607	Only supports querying data from the past 90 days
10701	Invalid Asset Code
10702	Deposit is not open for the time being
10801	Withdrawal address whitelist verify failed

Common Endpoints

Available trading pairs

curl "https://api.lbkex.com/v2/currencyPairs.do"

{
  "msg": "Success",
  "result": "true",
  "data": [
    "btc_usdt",
    "eth_usdt",
    "bnb_usdt",
    "sol_usdt",
    "xrp_usdt"
  ],
  "error_code": 0,
  "ts": 1772335196000
}

HTTP Request

GET /v2/currencyPairs.do

Paramters

none

Returns

Parameter	Type	Required	Note
data	object	Yes	pair info

Trading pairs

Acquiring the basic information of all trading pairs

curl "https://api.lbkex.com/v2/accuracy.do?symbol=btc_usdt"

{
  "msg": "Success",
  "result": "true",
  "data": [
    {
      "symbol": "btc_usdt",
      "quantityAccuracy": "5",
      "minTranQua": "0.00001",
      "priceAccuracy": "2"
    }
  ],
  "error_code": 0,
  "ts": 1772335196000
}

HTTP Request

GET /v2/accuracy.do

Parameters

Parameter	Type	Required	Note
symbol	string	No	Trading Pair

Returns

Parameter	Type	Required	Note
minTranQua	string	Yes	Min TranQua
symbol	string	Yes	Trading Pair
quantityAccuracy	string	Yes	Quantity Accuracy
priceAccuracy	string	Yes	Price Accuracy

Coin information

Get coin information (deposit and withdrawal).

curl "https://api.lbkex.com/v2/assetConfigs.do?assetCode=btc"

  {
  "result": "true",
  "data": [
    {
      "assetCode": "btc",
      "chainName": "btc",
      "canDraw": true,
      "canStationDraw": true,
      "canDeposit": true,
      "hasMemo": false,
      "assetFee": {
        "type": 1,
        "feeCode": "btc",
        "scale": 4,
        "minAmt": "0.001",
        "feeAmt": "0.0002",
        "feeRate": "0",
        "stationFeeAmt": "0",
        "stationScale": 4,
        "stationMinAmt": "0.0001",
        "minDepositAmt": "0.00001",
        "depositFee": "0"
      }
    },
    {
      "assetCode": "btc",
      "chainName": "trc20",
      "canDraw": true,
      "canStationDraw": true,
      "canDeposit": true,
      "hasMemo": false,
      "assetFee": {
        "type": 1,
        "feeCode": "btc",
        "scale": 4,
        "minAmt": "0.001",
        "feeAmt": "0.0001",
        "feeRate": "0",
        "stationFeeAmt": "0",
        "stationScale": 4,
        "stationMinAmt": "0.0001",
        "minDepositAmt": "0.0001",
        "depositFee": "0"
      }
    }
  ]
}

HTTP Request

GET /v2/assetConfigs.do

Parameters

Parameter	Type	Required	Note
assetCode	string	Yes	Code of token

Returns

Parameter	Type	Required	Note
assetCode	string	Yes	Code of token
chainName	string	Yes	Chain name
canDraw	boolean	Yes	Can withdraw
canStationDraw	boolean	Yes	Can transfer
canDeposit	boolean	Yes	Can Deposit
hasMemo	boolean	Yes	has memo
type	int	Yes	1:fixed fee, 2:rate fee, 3: fixed fee + rate fee
feeCode	string	Yes	fee Code
scale	int	Yes	Withdrawal quantity accuracy
minAmt	string	Yes	Minimum withdrawal quantity
feeAmt	string	Yes	Number of fees
feeRate	string	Yes	fee rate
stationFeeAmt	string	Yes	Number of transfer fees
stationScale	int	Yes	Transfer quantity accuracy
stationMinAmt	string	Yes	Minimum transfer quantity
minDepositAmt	string	Yes	Minimum deposit quantity
depositFee	string	Yes	Number of deposit fees

Get timestamp

curl "https://api.lbkex.com/v2/timestamp.do"

{
  "result": "true",
  "msg": "Success",
  "data": 1772335196000,
  "error_code": 0,
  "ts": 1772335196000
}

HTTP Request

GET /v2/timestamp.do

Parameters

none

Returns

Parameter	Type	Required	Note
data	long	Yes	timestamp

Wallet Endpoints

System status

Get system status.

{
  "result": "true",
  "data": {
    "status": "1"
  },
  "error_code": 0,
  "ts": 1772335196000
}

HTTP request

POST /v2/supplement/system_status.do

request parameters

This interface does not accept any parameters

Return parameters

parameter name	parameter type	required	description
status	string	yes	system status: 0 system maintenance, 1 normal

Get all coins information

Get all the currency information for the user (LBK supports deposit and withdrawal operations).

{
  "result": "true",
  "data": [
    {
      "usableAmt": "4302.693",
      "assetAmt": "4302.693",
      "networkList": [
        {
          "isDefault": true,
          "withdrawFeeRate": "0",
          "name": "bep20(bsc)",
          "withdrawMin": "10",
          "minLimit": "0.0001",
          "minDeposit": "0.0001",
          "feeAssetCode": "doge",
          "withdrawFee": "9.7059",
          "type": 1,
          "coin": "doge",
          "network": "bsc"
        },
        {
          "isDefault": false,
          "withdrawFeeRate": "0",
          "name": "dogecoin",
          "withdrawMin": "10",
          "minLimit": "0.0001",
          "minDeposit": "10",
          "feeAssetCode": "doge",
          "withdrawFee": "9.7059",
          "type": 1,
          "coin": "doge",
          "network": "dogecoin"
        }
      ],
      "freezeAmt": "0",
      "coin": "doge"
    }
  ],
  "code": 0
}

HTTP request

POST /v2/supplement/user_info.do

request parameters

Parameter name	Parameter type	Required	Description
api_key	string	Yes	The `api_key` applied by the user
sign	string	Yes	signature of request parameter

Return parameters

Parameter name	Parameter type	Required	Description
coin	string	Yes	asset name
assetAmt	string	Yes	asset balance
usableAmt	string	Yes	usableAmt
freezeAmt	string	Yes	FreezeAsset
networkList	[]	Yes	Multi-chain information
isDefault	boolean	Yes	default chain
withdrawFeeRate	string	Yes	withdrawal rate
name	string	Yes	chain name
withdrawMin	BigDecimal	Yes	Single Minimum Withdrawal
minLimit	BigDecimal	Yes	Minimum single transfer in the station
minDeposit	BigDecimal	Yes	Minimum Deposit
feeAssetCode	string	Yes	Delisted currency withdrawal fee currency
withdrawFee	string	Yes	Withdrawal Fee
type	int	Yes	fee type, 1 fixed, 2 percent, 3 fixed plus percent
coin	string	Yes	currency
network	string	Yes	mainnet

Withdrawal

User withdrawal

{
  "fee": 2,
  "withdrawId": 93182
}

HTTP request

POST /v2/spot/wallet/withdraw.do

request parameters

Parameter name	Parameter type	Required	Description
api_key	string	is	The `api_key` applied by the user
sign	string	is	signature of request parameter
address	string	is	withdrawal address, when type=1, it is the transfer account
networkName	string	No	Chain name, get it through the Get All Coin Information interface
coin	string	is	currency
amount	string	is	withdrawal amount
memo	string	No	memo: memo word of bts and dct
mark	string	No	Withdrawal Notes
fee	string	is	fee
name	string	No	Remarks of the address. After filling in this parameter, it will be added to the withdrawal address book of the currency.
withdrawOrderId	string	No	Custom withdrawal id
type	string	No	type=1 is for intra-site transfer

Return parameters

Parameter name	Parameter type	Required	Description
fee	BigDecimal	Yes	Fees
withdrawId	int	is	withdrawal id

Get recharge history

User access to recharge history

[
  {
    "insertTime": 1644378926000,
    "amount": 443,
    "address": "QiEik5W3szxqtjJnzp14apfrY7McUdX9sa",
    "networkName": "lbk20",
    "txId": "0x4baf730c242fe6d85559edb40399daaf8dca16255382a5ce36934f0ff964a776",
    "coin": "lbk",
    "status": "2"
  }
]

HTTP request

POST /v2/spot/wallet/deposit_history.do

request parameters

Parameter name	Parameter type	Required	Description
api_key	string	is	The `api_key` applied by the user
sign	string	is	signature of request parameter
status	string	No	Recharge status: ("1","Applying"),("2","Recharge successful"),("3","Recharge failed"),("4","Already Cancel"), ("5", "Transfer")
coin	string	no	currency
startTime	string	No	Start time, timestamp in milliseconds, default 90 days ago
endTime	string	no	end time, timestamp in milliseconds, default day

Return parameters

Parameter name	Parameter type	Required	Description
insertTime	timestamp	Yes	InsertTime
amount	BigDecimal	Yes	Amount of deposit
address	String	is	quantity
networkName	string	no	chain name
txId	string	is	transaction hash
coin	string	is	currency
status	string	is	status

Get withdrawal history

User's coin withdrawal history

 [
  {
    "amount": 234,//amount
    "coid": "lbk",//currency
    "address": "34252342",//Withdrawal address
    "withdrawOrderId": "werqwerq123425353",//Withdraw customer custom id
    "fee": 2,//fee
    "networkName": "lbk30",//chain name
    "transferType": "Digital Asset Withdrawal",//Withdrawal type
    "txId": "",
    "feeAssetCode": "",//The currency of the fee, the currency of the delisting will be displayed
    "id": 93182,//Reminder id
    "applyTime": 1644476930000,//time
    "status": "1"//("1","Applying"),("2","Cancelled"),("3","Withdrawal failed"),("4","Withdrawal completed ")
  }
]

HTTP request

POST /v2/spot/wallet/withdraws.do

request parameters

Parameter name	Parameter type	Required	Description
api_key	string	is	The `api_key` applied by the user
sign	string	is	signature of request parameter
status	string	No	status: ("1","Applying"),("2","Cancelled"),("3","Withdrawal failed"),("4","Withdrawal complete")
coin	string	no	currency
withdrawOrderId	string	No	Custom withdrawal id
startTime	string	No	Start time, timestamp in milliseconds, default 90 days ago
endTime	string	no	end time, timestamp in milliseconds, default day

The user obtains the deposit address

The user obtains the recharge address

{
  "address": "0x1ccbf66250c9a665710e56e00b3a1502495dd269", //address
  "memo": null,
  "coin": "lbk" //currency
}

HTTP request

POST /v2/supplement/get_deposit_address.do

request parameters

Parameter name	Parameter type	Required	Description
api_key	string	is	The `api_key` applied by the user
sign	string	is	signature of request parameter
networkName	string	no	chain name
coin	string	is	currency

List asset details

Listing Asset Details

{
  "htmoon": {
    "minWithdrawAmount": 0,
    "stationDrawStatus": true, //Whether it can be transferred within the station
    "depositStatus": false, //Whether it can be recharged
    "withdrawFee": 0, //withdrawal fee
    "withdrawStatus": false //Whether it can be withdrawn
  },
  "phx": {
    "minWithdrawAmount": 0,
    "stationDrawStatus": true,
    "depositStatus": true,
    "withdrawFee": 0,
    "withdrawStatus": true
  }
}

HTTP request

POST /v2/supplement/asset_detail.do

request parameters

Parameter name	Parameter type	Required	Description
api_key	string	is	The `api_key` applied by the user
sign	string	is	signature of request parameter
coin	string	no	currency

Transaction fee rate query

User transaction fee rate query

[
  {
    "symbol": "lbk_usdt",
    "makerCommission": "0.10",
    "takerCommission": "10.00"
  }
]

HTTP request

POST /v2/supplement/customer_trade_fee.do

request parameters

Parameter name	Parameter type	Required	Description
api_key	string	is	The `api_key` applied by the user
sign	string	is	signature of request parameter
category	string	No	Trading pair, eg: lbk_usdt

Query user API Key permissions

{
  "enableSpotTrading": true, //trading
  "createTime": 1643091005000,
  "enableReading": true, //read only
  "ipRestrict": true, //whether to restrict ip
  "enableWithdrawals": true //Withdrawal
}

HTTP request

POST /v2/supplement/api_Restrictions.do

request parameters

Parameter name	Parameter type	Required	Description
api_key	string	is	The `api_key` applied by the user
sign	string	is	signature of request parameter

Market Data Endpoints

Test server connectivity

Test whether the Rest API can be connected.

   curl -X POST "https://api.lbkex.com/v2/supplement/system_ping.do"

{
  "result": "true",
  "data": {
  },
  "error_code": 0,
  "ts": 1772335196000
}

HTTP request

POST /v2/supplement/system_ping.do

request parameters

This interface does not accept any parameters

Depth information

Get depth information

   curl "https://api.lbkex.com/v2/depth.do?symbol=btc_usdt&size=5"

{
  "result": "true",
  "msg": "Success",
  "data": {
    "asks": [
      [
        "73914.36",
        "3.0319"
      ],
      [
        "73914.38",
        "0.00019"
      ],
      [
        "73917.1",
        "0.00008"
      ],
      [
        "73917.57",
        "0.14328"
      ],
      [
        "73917.58",
        "0.00028"
      ]
    ],
    "bids": [
      [
        "73914.35",
        "2.03807"
      ],
      [
        "73914.27",
        "0.00011"
      ],
      [
        "73913.86",
        "0.01169"
      ],
      [
        "73913.52",
        "0.00008"
      ],
      [
        "73913.38",
        "0.00192"
      ]
    ],
    "timestamp": 1772335196000
  },
  "error_code": 0,
  "ts": 1772335196000
}

HTTP request

GET /v2/depth.do

request parameters

Parameter name	Parameter type	Required	Description
symbol	String	Yes	Trading Pair.
size	Integer	Yes	The count of returned items.(1-200)

returns

Parameter name	Description
asks	Depth of asks (Sellers'), [[price, qty]]
bids	Depth of bids (Buyers'), [[price, qty]]

Get the latest price of the trading pair

Get the latest price of a trading pair

   curl "https://api.lbkex.com/v2/supplement/ticker/price.do?symbol=btc_usdt"

{
  "result": true,
  "data": [
    {
      "symbol": "btc_usdt",
      "price": "73966.75"
    }
  ],
  "error_code": 0,
  "ts": 1772335196000
}

HTTP request

GET /v2/supplement/ticker/price.do

request parameters

Parameter name	Parameter type	Required	Description
symbol	string	No	Pair

Symbol Order Book Ticker

The current optimal pending order

   curl "https://api.lbkex.com/v2/supplement/ticker/bookTicker.do?symbol=btc_usdt"

{
  "result": "true",
  "msg": "Success",
  "data": {
    "symbol": "btc_usdt",
    "askPrice": "74054.58",
    "askQty": "1.48603",
    "bidQty": "0.399",
    "bidPrice": "74054.57"
  },
  "error_code": 0,
  "ts": 1772335196000
}

HTTP request

GET /v2/supplement/ticker/bookTicker.do

request parameters

Parameter name	Parameter type	Required	Description
symbol	string	Yes	coin pair

24hr Ticker

GET the LBank coin quote data, excluding Leveraged Tokens trading pairs (get Leveraged Tokens trading pairs GET /v2/etfTicker/24hr.do)

   curl "https://api.lbkex.com/v2/ticker/24hr.do?symbol=btc_usdt"

{
  "msg": "Success",
  "result": "true",
  "data": [
    {
      "symbol": "btc_usdt",
      "ticker": {
        "high": "76000.38",
        "vol": "12976.9135",
        "low": "73281.22",
        "change": "1.13",
        "turnover": "966280941.61",
        "latest": "74116.9"
      },
      "timestamp": 1772335196000
    }
  ],
  "error_code": 0,
  "ts": 1772335196000
}

HTTP Request

GET /v2/ticker/24hr.do

Parameters

Parameter	Type	Required	Note
symbol	String	Yes	Pair Such as: `btc_usdt`、`eth_usdt`、 `all`

Returns

Parameter	Note
symbol	Pair
vol	24 hr trading volume
high	24 hr highest price
low	24 hr lowest price
change	Fluctuation (%) in 24 hr
turnover	Total Turn over in 24 hr
latest	Latest Price
timestamp	Timestamp of latest transaction

Leveraged Tokens 24hr Ticker

Get LBank Leveraged Tokens market data

   curl "https://api.lbkex.com/v2/etfTicker/24hr.do?symbol=btc3l_usdt"

{
  "msg": "Success",
  "result": "true",
  "data": [
    {
      "symbol": "btc3l_usdt",
      "ticker": {
        "high": "0.000929",
        "vol": "311471225.9",
        "low": "0.000817",
        "change": "-0.12",
        "turnover": "268768.0977",
        "latest": "0.000841"
      },
      "timestamp": 1772335196000
    }
  ],
  "error_code": 0,
  "ts": 1772335196000
}

HTTP Request

GET /v2/etfTicker/24hr.do

Parameters

Parameter	Type	Required	Note
symbol	String	Yes	Pair Such as: `btc3l_usdt`、`all`

Returns

Parameter	Note
symbol	Pair
vol	24 hr trading volume
high	24 hr highest price
low	24 hr lowest price
change	Fluctuation (%) in 24 hr
turnover	Total Turn over in 24 hr
latest	Latest Price
timestamp	Timestamp of latest transaction

Recent transactions list

List of recent transactions

   curl "https://api.lbkex.com/v2/supplement/trades.do?symbol=btc_usdt&size=3&time=1772334000000"

{
  "msg": "Success",
  "result": "true",
  "data": [
    {
      "quoteQty": 1250.2534918,
      "price": 67617.82,
      "qty": 0.01849,
      "id": "3f860a598f654e829c18e5bd783c9efb",
      "time": 1772334000388,
      "isBuyerMaker": true
    },
    {
      "quoteQty": 98.7154326,
      "price": 67613.31,
      "qty": 0.00146,
      "id": "c737190226524851864efcbf4af7eaab",
      "time": 1772334000648,
      "isBuyerMaker": false
    },
    {
      "quoteQty": 176.4707391,
      "price": 67613.31,
      "qty": 0.00261,
      "id": "596aaa9f4ab648bc84befc3b687ddc99",
      "time": 1772334000956,
      "isBuyerMaker": false
    }
  ],
  "error_code": 0,
  "ts": 1772335196000
}

HTTP request

GET /v2/supplement/trades.do

request parameters

Parameter name	Parameter type	Required	Description
symbol	string	Yes	coin pair
size	string	Yes	Returns size (1-500)
time	string	No	Returns size pieces of data after the timestamp, if empty, returns the latest size pieces of data

returns parameters

Parameter name	Parameter type	Description
quoteQty	decimel	Transaction amount
price	decimel	Transaction price
qty	decimel	Transaction quantity
id	string	Transaction ID
time	long	Transaction time
isBuyerMaker	boolean	Was the buyer the maker

Query K Bar Data

   curl "https://api.lbkex.com/v2/kline.do?symbol=btc_usdt&size=3&type=day1&time=1769914800"

{
  "msg": "Success",
  "result": "true",
  "data": [
    [
      1769875200,
      81300.5,
      82110.88,
      75855.7,
      77594.65,
      16848.64871
    ],
    [
      1769961600,
      77594.65,
      79326.72,
      74609.01,
      78849.22,
      19966.48606
    ],
    [
      1770048000,
      78849.22,
      79289.37,
      77053.36,
      78132,
      12151.23631
    ]
  ],
  "error_code": 0,
  "ts": 1772335196000
}

HTTP Request

GET /v2/kline.do

Parameters

Name	Type	Required	Description
symbol	String	Yes	Trading Pair `eth_btc`
size	Integer	Yes	Count of the bars (1-2000)
type	String	Yes	`minute1`：1 minute `minute5`：5 minutes `minute15`：15minutes `minute30`：30 minutes `hour1`：1 hour `hour4`：4 hours `hour8`：8 hours `hour12`：12 hours `day1`：1 day `week1`：1 week `month1`：1 month
time	String	Yes	Timestamp (of Seconds)

Returns

Parameter	Note
data	[[Timestamp,Open Price,Highest Price,Lowest Price,Close Price,Trading Volume]]

Spot Trading Endpoints

Test order

test order

{
  "msg": "Success",
  "result": true,
  "data": {
    "symbol": "eth_usdt",
    "order_id": "91dd58c4-370f-461d-0000-8cc3e83ddad3",
    "custom_id": "8241275e-8666-4ab8-a84d-2e87f82e12ff"
  },
  "error_code": 0,
  "ts": 1772335196000
}

HTTP request

POST /v2/supplement/create_order_test.do

request parameters

Parameter name	Parameter type	Required	Description
api_key	String	Yes	the `api_key` applied by the user
sign	String	Yes	signature of request parameter
symbol	String	Yes	Transaction pair `btc_usdt` `eth_usdt`
type	String	Yes	The type of the order, including `buy, sell, buy_market, sell_market, buy_maker, sell_maker, buy_ioc, sell_ioc, buy_fok, sell_fok`
price	String	Reference description	Order price, Except for market sell orders `sell_market`, all other order types must be passed; Market buy orders type=`buy_market`, price is the purchase amount.
amount	String	Reference description	Order Quantity, Except for market buy orders `buy_market`, all other order types must be passed; Market sell orders type=`sell_market`, amount is the quantity to sell.
custom_id	String	No	User-defined ID, do not repeat by yourself
window	Long	No	Expiration time of order, milliseconds, The request is automatically cancelled if it times out before being submitted for matching. (considering the public network time, it is recommended not to exceed 5s)

returns parameters

Parameter name	Parameter type	Description
symbol	String	Transaction pair
order_id	String	Order ID
custom_id	String	User-defined ID

Place an order

place an order

{
  "msg": "Success",
  "result": true,
  "data": {
    "symbol": "eth_usdt",
    "order_id": "91dd58c4-370f-461d-0000-8cc3e83ddad3",
    "custom_id": "8241275e-8666-4ab8-a84d-2e87f82e12ff"
  },
  "error_code": 0,
  "ts": 1772335196000
}

HTTP request

POST /v2/supplement/create_order.do

request parameters

Parameter name	Parameter type	Required	Description
api_key	String	Yes	the `api_key` applied by the user
sign	String	Yes	signature of request parameter
symbol	String	Yes	Transaction pair `btc_usdt` `eth_usdt`
type	String	Yes	The type of the order, including `buy, sell, buy_market, sell_market, buy_maker, sell_maker, buy_ioc, sell_ioc, buy_fok, sell_fok`
price	String	Reference description	Order price, Except for market sell orders `sell_market`, all other order types must be passed; Market buy orders type=`buy_market`, price is the purchase amount.
amount	String	Reference description	Order Quantity, Except for market buy orders `buy_market`, all other order types must be passed; Market sell orders type=`sell_market`, amount is the quantity to sell.
custom_id	String	No	User-defined ID, do not repeat by yourself
window	Long	No	Expiration time of order, milliseconds, The request is automatically cancelled if it times out before being submitted for matching. (considering the public network time, it is recommended not to exceed 5s)

buy, sell

Limit order

buy_market, sell_market

Market order
buy_market: price must be passed, quoted asset quantity;
sell_market: amount must be passed, basic asset quantity;

buy_maker

Maker (Post only) order
If the order price is greater than or equal to the lowest selling price in the market, the order will be rejected;
If the order price is less than the lowest selling price in the market, the order will be accepted.

sell_maker

Maker (Post only) order
If the order price is less than or equal to the highest buy price in the market, the order will be rejected;
If the order price is greater than the highest buy price in the market, the order will be accepted.

buy_ioc, sell_ioc

Immediate or Cancel order, IOC is an order to buy or sell that attempts to execute all or part immediately and then cancels any unfilled portion of the order

buy_fok, sell_fok

Fill or Kill order, FOK is a type of time-in-force designation used in trading that instructs a brokerage to execute a transaction immediately and completely or not at all.

window

Time synchronization security All signature interfaces need to pass timestamp parameters. When receiving a request, the server will determine the timestamp in the request. If the request is sent earlier than 5000 ms, the request will be considered invalid. This time window value can be customized by sending the optional parameter window. In addition, if the server calculates that the client timestamp is more than one second in the 'future' of the server's time, the request will also be rejected. The state of the Internet is not 100% reliable and cannot be completely relied upon, so the delay between your application and the LBank server will be jitter. This is the purpose of setting the window. If you are engaged in high-frequency trading and have high requirements on the trading timeliness, you can flexibly set the window to meet your requirements.

returns parameters

Parameter name	Parameter type	Description
symbol	String	Transaction pair
order_id	String	Order ID
custom_id	String	User-defined ID

Cancel order

{
  "msg": "Success",
  "result": true,
  "data": {
    "executedQty": 0.0,
    "price": 2200.0,
    "origQty": 0.01,
    "tradeType": "buy",
    "status": 0
  },
  "error_code": 0,
  "ts": 1772335196000
}

HTTP request

POST /v2/supplement/cancel_order.do

request parameters

Parameter name	Parameter type	Required	Description
api_key	String	Yes	the `api_key` applied by the user
sign	String	Yes	signature of request parameter
symbol	string	Yes	coin pair
orderId	string	Reference description	orderid, User-defined id and order id must be passed
origClientOrderId	string	Reference description	User-defined id and order id must be passed

returns parameters

Parameter name	Parameter type	Description
executedQty	decimel	Executed order quantity
price	decimel	Order price
origQty	decimel	Order quantity
tradeType	String	Order type
status	int	Order status

Cancel all pending orders for a single trading pair

{
  "result": "true",
  "data": [
    {
      "origClientOrderId": "4b11c4ac-d54a-4bb5-86f9-06322174a036",
      "executedQty": 0.00000000000000000000,
      "orderId": "fc2e51b9-2e6e-4949-a5f3-35a4f10c0554",
      "price": 2200.00000000000000000000,
      "origQty": 0.01000000000000000000,
      "tradeType": "buy",
      "status": 0
    },
    {
      "origClientOrderId": "d6f6dc30-5de9-4fe9-ba70-ce6e173e114e",
      "executedQty": 0.00000000000000000000,
      "orderId": "2539cee7-a0de-4caa-bbbe-993d39bc8efb",
      "price": 2210.00000000000000000000,
      "origQty": 0.01000000000000000000,
      "tradeType": "buy",
      "status": 0
    }
  ],
  "error_code": 0,
  "ts": 1772335196000
}

HTTP request

POST /v2/supplement/cancel_order_by_symbol.do

request parameters

Parameter name	Parameter type	Required	Description
api_key	String	Yes	the `api_key` applied by the user
sign	String	Yes	signature of request parameter
symbol	String	Yes	coin pair

returns parameters

Parameter name	Parameter type	Description
origClientOrderId	String	User-defined ID
executedQty	decimel	Executed order quantity
orderId	String	Order ID
price	decimel	Order price
origQty	decimel	Order quantity
tradeType	String	Order type
status	int	Order status

Query order

checking order

{
  "result": "true",
  "msg": "Success",
  "data": {
    "cummulativeQuoteQty": 0,  // Cumulative transaction amount
    "symbol": "eth_usdt",  // coin pair
    "executedQty": 0,  // Executed order quantity
    "orderId": "fc2e51b9-2e6e-4949-a5f3-35a4f10c0554",  // Order ID
    "origQty": 0.01, // Original order quantity
    "price": 2200,  // Order price
    "clientOrderId": "4b11c4ac-d54a-4bb5-86f9-06322174a036",  // User-defined Order ID
    "origQuoteOrderQty": 22, // Original order amount
    "updateTime": 1772335196000, // Last update time
    "time": 1772335196000,  // Order time
    "type": "buy", // Order type
    "status": -1 // Order status -1: Cancelled 0: Unfilled 1: Partially filled 2: Completely filled 3: Partially filled has been cancelled 4: Cancellation is being processed
  },
  "error_code": 0,
  "ts": 1772335196000
}

HTTP request

POST /v2/spot/trade/orders_info.do

request parameters

Parameter name	Parameter type	Required	Description
api_key	String	Yes	the `api_key` applied by the user
sign	String	Yes	signature of request parameter
symbol	string	Yes	coin pair
orderId	string	Reference description	orderid, User-defined id and order id must be passed
origClientOrderId	string	Reference description	User-defined id and order id must be passed

returns parameters

Parameter name	Parameter type	Description
cummulativeQuoteQty	decimel	Cumulative transaction amount
symbol	String	coin pair
executedQty	decimel	Executed order quantity
orderId	String	Order ID
origQty	decimel	Original order quantity
price	decimel	Order price
clientOrderId	String	User-defined Order ID
origQuoteOrderQty	decimel	Original order amount
updateTime	Long	Last update time
time	Long	Order time
type	String	Order type
status	int	Order status -1: Cancelled 0: Unfilled 1: Partially filled 2: Completely filled 3: Partially filled has been cancelled 4: Cancellation is being processed

Current pending order

current pending order

{
  "msg": "Success",
  "result": true,
  "data": {
    "total": 1, // Total number of pages
    "page_length": 10, // Number of items per page
    "orders": [
      {
        "cummulativeQuoteQty": 0,  // Cumulative transaction amount
        "symbol": "eth_usdt", // coin pair
        "executedQty": 0, // Executed order quantity
        "orderId": "11f0e0a7-eac3-436b-b2d3-779c4f910e31", // Order ID
        "origQty": 0.01, // Original order quantity
        "price": 2200, // Order price
        "clientOrderId": "8e145780-033c-4f59-8cdc-c2e75856db65", // User-defined Order ID
        "origQuoteOrderQty": 22, // Original order amount
        "updateTime": 1772335196000, // Last update time
        "time": 1772335196000, // Order time
        "type": "buy", // Order type
        "status": 0 // Order status -1: Cancelled 0: Unfilled 1: Partially filled 2: Completely filled 3: Partially filled has been cancelled 4: Cancellation is being processed
      },
      {
        "cummulativeQuoteQty": 0,
        "symbol": "eth_usdt",
        "executedQty": 0,
        "orderId": "46e9dbe6-688b-4337-b7b8-e91cfb3e2cd5",
        "origQty": 0.01,
        "price": 2210,
        "clientOrderId": "f5009a0a-a598-4a1d-ac86-4e9f061f0018",
        "origQuoteOrderQty": 22.1,
        "updateTime": 1772335196000,
        "time": 1772335196000,
        "type": "buy",
        "status": 0
      }
    ],
    "current_page": 1 // Current page number
  },
  "error_code": 0,
  "ts": 1772335196000
}

HTTP request

POST /v2/supplement/orders_info_no_deal.do

request parameters

Parameter name	Parameter type	Required	Description
sign	string	Yes	signature of request parameter
api_key	string	Yes	The `api_key` applied by the user
symbol	string	Yes	Transaction pair
current_page	string	Yes	current page number
page_length	string	Yes	Number of data items per page (not less than 1, not more than 200)

returns parameters

Parameter name	Parameter type	Description
cummulativeQuoteQty	decimel	Cumulative transaction amount
symbol	String	coin pair
executedQty	decimel	Executed order quantity
orderId	String	Order ID
origQty	decimel	Original order quantity
price	decimel	Order price
clientOrderId	String	User-defined Order ID
origQuoteOrderQty	decimel	Original order amount
updateTime	Long	Last update time
time	Long	Order time
type	String	Order type
status	int	Order status -1: Cancelled 0: Unfilled 1: Partially filled 2: Completely filled 3: Partially filled has been cancelled 4: Cancellation is being processed

Query all orders

Check all orders(The default query is for orders placed within 24 hours. When the status is empty, the default query is for cancelled and completely filled orders)

{
  "msg": "Success",
  "result": "true",
  "data": {
    "total": 1, // Total number of pages
    "page_length": 10, // Number of items per page
    "orders": [
      {
        "cummulativeQuoteQty": 0, // Cumulative transaction amount
        "symbol": "eth_usdt", // coin pair
        "executedQty": 0, // Executed order quantity
        "orderId": "2539cee7-a0de-4caa-bbbe-993d39bc8efb", // Order ID
        "origQty": 0.01, // Original order quantity
        "price": 2210, // Order price
        "origQuoteOrderQty": 22.1, // Original order amount
        "updateTime": 1772335196000, // Last update time
        "time": 1772335196000, // Order time
        "type": "buy", // Order type
        "status": -1 // Order status -1: Cancelled 0: Unfilled 1: Partially filled 2: Completely filled 3: Partially filled has been cancelled 4: Cancellation is being processed
      },
      {
        "cummulativeQuoteQty": 0,
        "symbol": "eth_usdt",
        "executedQty": 0,
        "orderId": "fc2e51b9-2e6e-4949-a5f3-35a4f10c0554",
        "origQty": 0.01,
        "price": 2200,
        "origQuoteOrderQty": 22,
        "updateTime": 1772335196000,
        "time": 1772335196000,
        "type": "buy",
        "status": -1
      },
      {
        "cummulativeQuoteQty": 0,
        "symbol": "eth_usdt",
        "executedQty": 0,
        "orderId": "5ca490f9-eede-45c7-82fe-89b6beb3fd7b",
        "origQty": 0.01,
        "price": 2200,
        "origQuoteOrderQty": 22,
        "updateTime": 1772335196000,
        "time": 1772335196000,
        "type": "buy",
        "status": -1
      }
    ],
    "current_page": 1 // Current page number
  },
  "error_code": 0,
  "ts": 1772335196000
}

HTTP request

POST /v2/spot/trade/orders_info_history.do

request parameters

Parameter name	Parameter type	Required	Description
sign	string	Yes	signature of request parameter
api_key	string	Yes	The `api_key` applied by the user
symbol	string	Yes	Transaction pair
current_page	string	Yes	current page number
page_length	string	Yes	Number of data items per page (not less than 1, not more than 200)
status	string	No	Order Status

returns parameters

Parameter name	Parameter type	Description
cummulativeQuoteQty	decimel	Cumulative transaction amount
symbol	String	coin pair
executedQty	decimel	Executed order quantity
orderId	String	Order ID
origQty	decimel	Original order quantity
price	decimel	Order price
origQuoteOrderQty	decimel	Original order amount
updateTime	Long	Last update time
time	Long	Order time
type	String	Order type
status	int	Order status -1: Cancelled 0: Unfilled 1: Partially filled 2: Completely filled 3: Partially filled has been cancelled 4: Cancellation is being processed

Account information

account information

{
  "result": "true",
  "data": {
    "uid": "LBA0B12679", // Platform UID
    "balances": [
      {
        "asset": "usdt", // Coin
        "free": "1000", // Available Amount
        "locked": "0" // Locked Amount
      },
      {
        "asset": "btc",
        "free": "0.01",
        "locked": "0"
      },
      {
        "asset": "eth",
        "free": "0.1",
        "locked": "0"
      }
    ],
    "canWithdraw": true, // Is withdrawal possible
    "canDeposit": true, // Is deposit possible
    "canTrade": true // Is trading possible
  },
  "error_code": 0,
  "ts": 1772335196000
}

HTTP request

POST /v2/supplement/user_info_account.do

request parameters

Parameter name	Parameter type	Required	Description
sign	string	is	signature of request parameter
api_key	string	is	The `api_key` applied by the user

returns parameters

Parameter name	Parameter type	Description
uid	String	Platform UID
asset	String	Coin
free	decimel	Available Amount
locked	decimel	Locked Amount
canWithdraw	boolean	Is withdrawal possible
canDeposit	boolean	Is deposit possible
canTrade	boolean	Is trading possible

Historical transaction details

{
  "msg": "Success",
  "result": true,
  "data": [
    {
      "symbol": "eth_usdt", // trading pair
      "quoteQty": 23.19370000000000000000, // Transaction amount
      "orderId": "cd58b6a0-7afa-47ae-9bbb-3a212bdab3bb", // Order ID
      "price": 2319.37000000000000000000, // Transaction price
      "qty": 0.01000000000000000000, // Transaction quantity
      "commission": 0.00051000000000000000, // Transaction Fees, The billing unit for buy orders is the transaction currency
      "id": "da612956ee81297529d695683559516b20fdeba1", // Transaction ID
      "time": 1772335196000, // Transaction time
      "isMaker": false, // is the maker
      "isBuyer": true // is the buyer
    },
    {
      "symbol": "eth_usdt",
      "quoteQty": 23.19960000000000000000,
      "orderId": "a4cd386d-6d8b-47fa-9a45-daa10c6dab7a",
      "price": 2319.96000000000000000000,
      "qty": 0.01000000000000000000,
      "commission": 1.18318000000000000000, // Transaction Fees，The billing unit for sell orders is the transaction currency
      "id": "ada27f3c83ebffb7defd7a1699dd2f4d281fc033",
      "time": 1772335196000,
      "isMaker": false,
      "isBuyer": false
    }
  ],
  "error_code": 0,
  "ts": 1772335196000
}

HTTP request

POST /v2/supplement/transaction_history.do

request parameters

Parameter name	Parameter type	Required	Description
sign	string	is	signature of request parameter
api_key	string	is	The `api_key` applied by the user
symbol	string	Yes	Transaction pair `eth_btc`, `btc_usdt`, `eth_usdt`;
startTime	string	No	Start time yyyy-MM-dd or yyyy-MM-dd HH:mm:ss (UTC+8), the maximum value is today, the default is yesterday
endTime	string	No	End time yyyy-MM-dd or yyyy-MM-dd HH:mm:ss (UTC+8), the maximum value is today, the default is today The query window for the start and end time is up to 2 days
fromId	string	No	The starting transaction ID of the query
limit	string	No	Number of queries, default 100, [1-100]

returns parameters

Parameter name	Parameter type	Description
symbol	String	trading pair
quoteQty	decimel	Transaction amount
orderId	String	Order ID
price	decimel	Transaction price
qty	decimel	Transaction quantity
commission	decimel	Transaction Fees, The billing unit for buy orders is the transaction currency, The billing unit for sell orders is the transaction currency
id	String	Transaction ID
time	Long	Transaction time
isMaker	boolean	is the maker
isBuyer	boolean	is the buyer

WebSocket API (Market Data)

Request & subscription instruction

URL: wss://www.lbkex.net/ws/V2/
Hearbeat（ping/pong）

To prevent botch links and reduce server load, server will send a "Ping" message periodically to client connections. When client recieves the "Ping" message, it should response immediately. If a client responds nothing to macth the "Ping" message in one minute, server will close the connection to the client. Meanwhile client can also send a "Ping" message to server to check whether the connection is working. After server recieves the "Ping" message, it should response with a "Pong" message to match the "Ping". Eg:
ping { "action":"ping", "ping":"0ca8f854-7ba7-4341-9d86-d3327e52804e" }

pong { "action":"pong", "pong":"0ca8f854-7ba7-4341-9d86-d3327e52804e" }

where the value of the key "pong" in the "Pong" message should equal to the value of the key "ping" in correspond "Ping" message.
Subscription/Unsubscription

Each subscribed data should include one subscribed field at least which specifies the data type of the subscription. Data types that can be subscribed now includes：kbar, tick, depth, trade. Each subscription needs a pair field to specify the trading pair subscribed, which is concatenated with a underline (_). After successful subscription Websocket client receives the updated message sent from server as soon as the subscribed data is updated.
Request data One-time request data is supported by Websocket server.

1.One-time request to get k-line needs extra parameters defined in following

Parameters	Parameters Type	Required	Description
start	String	fasle	Start time. Accept 2 formats, such as `2018-08-03T17:32:00` (beijing time), another timestamp, such as `1533288720` (Accurate to second)
end	String	false	Deadline
size	String	false	Number of kbars

One-time request to get trade records needs extra parameters defined in following

Parameters	Parameters Type	Required	Description
size	String	Y	Number of trades

     # Get k-line data Request
    {
        "action":"request",
        "request":"kbar",
        "kbar":"5min",
        "pair":"eth_btc",
        "start":"2018-08-03T17:32:00",
        "end":"2018-08-05T17:32:00",
        "size":"576"
    }
     # Get depth data Request
    {
        "action":"request",
        "request":"depth",
        "depth":"100",
        "pair":"eth_btc"
    }
     # Get transaction data Request
    {
        "action":"request",
        "request":"trade",
        "pair":"eth_btc",
        "size":"100"
    }
     # Get market data Request
    {
        "action":"request",
        "request":"tick",
        "pair":"eth_btc"
    }

Subscription of K-line Data

    {
        "action":"subscribe",
        "subscribe":"kbar",
        "kbar":"5min",
        "pair":"eth_btc"
    }

 {
        "kbar":{
            "a":64.32991311,
            "c":0.02590293,
            "t":"2019-06-28T17:45:00.000",
            "v":2481.1912,
            "h":0.02601247,
            "slot":"5min",
            "l":0.02587925,
            "n":272,
            "o":0.02595196
        },
        "type":"kbar",
        "pair":"eth_btc",
        "SERVER":"V2",
        "TS":"2019-06-28T17:49:22.722"
    }

Parameters

Parameter	Parameter Type	Required	Description
action	String	Y	Action requested: `subscribe` or `unsubscribe`
subscribe	String	Y	`kbar`
kbar	String	Y	To subscribe to k-line types `1min`: 1 minute `5min`: 5 minutes `15min`: 15 minutes `30min`: 30 minutes `1hr`: 1 hour `4hr`: 4 hours `day`: 1 day `week`: 1 week `month`: 1 month `year`: 1 year
pair	String	Y	Trading pair:`eth_btc`

Return

Parameters	Parameters Type	Description
t	String	K-line updates the time
o	BigDecimal	Open price
h	BigDecimal	Highest price
l	BigDecimal	Lowest price
c	BigDecimal	Close price
v	BigDecimal	Trading volume
a	BigDecimal	Aggregated turnover (summation of price times volume for each trade)
n	BigDecimal	Number of trades
slot	String	K-line type

Market Depth

    {
        "action":"subscribe",
        "subscribe":"depth",
        "depth":"100",
        "pair":"eth_btc"
    }

 {
         "depth":{
             "asks":[
                 [
                     0.0252,
                     0.5833
                 ],
                 [
                     0.025215,
                     4.377
                 ],
                 ...
             ],
             "bids":[
                 [
                     0.025135,
                     3.962
                 ],
                 [
                     0.025134,
                     3.46
                 ],
                 ...
             ]
         },
         "count":100,
         "type":"depth",
         "pair":"eth_btc",
         "SERVER":"V2",
         "TS":"2019-06-28T17:49:22.722"
     }

Parameters

Parameters	Parameters Type	Required	Description
action	String	Y	Type of action requested:`subscribe`,`unsubscribe`
subscribe	String	Y	`depth`
depth	String	Y	Pro-choise:10/50/100
pair	String	Y	Trading pair:`eth_btc`

Return

Parameters	Parameters Type	Description
asks	List	Selling side: list.get(0): delegated price, list.get(1): delegated quantity
bids	List	Buying side

//: # ()

Trade record

    {
        "action":"subscribe",
        "subscribe":"trade",
        "pair":"eth_btc"
    }

 {
         "trade":{
             "volume":6.3607,
             "amount":77148.9303,
             "price":12129,
             "direction":"sell",
             "TS":"2019-06-28T19:55:49.460"
         },
         "type":"trade",
         "pair":"btc_usdt",
         "SERVER":"V2",
         "TS":"2019-06-28T19:55:49.466"
     }

Parameters

Parameters	Parameters Type	Required	Description
action	String	Y	Action requested: `subscribe` or `unsubscribe`
subscribe	String	Y	`trade`
pair	String	Y	Trading pair:`eth_btc`

Return

Parameters	Parameters Type	Description
amount	String	Recent trading volume
price	Integer	Trade price
volumePrice	String	Aggregated turnover
direction	String	`sell`,`buy`
TS	String	Deal time

Market

    {
        "action":"subscribe",
        "subscribe":"tick",
        "pair":"eth_btc"
    }

 {
         "tick":{
             "to_cny":76643.5,
             "high":0.02719761,
             "vol":497529.7686,
             "low":0.02603071,
             "change":2.54,
             "usd":299.12,
             "to_usd":11083.66,
             "dir":"sell",
             "turnover":13224.0186,
             "latest":0.02698749,
             "cny":2068.41
         },
         "type":"tick",
         "pair":"eth_btc",
         "SERVER":"V2",
         "TS":"2019-07-01T11:33:55.188"
     }

Parameters

Parameters	Parameters Type	Required	Description
action	String	Y	Action requested:`subscribe`,`unsubscribe`
subscribe	String	Y	`tick`
pair	String	Y	Trading pair:`eth_btc`

Return

Parameters	Parameters Type	Description
high	BigDecimal	Highest price in last 24 hours
low	BigDecimal	Lowest price in last 24 hours
latest	BigDecimal	Lastest traded price
vol	BigDecimal	Trading volume
turnover	BigDecimal	Aggregated turnover (summation of price times volume for each trade)
to_cny	BigDecimal	Such as `eth_btc`, convert btc into cny
to_usd	BigDecimal	Such as `eth_btc`, convert btc into usd
cny	BigDecimal	Such as `eth_btc`, convert eth into cny
usd	BigDecimal	Such as `eth_btc`, convert eth into usd
dir	String	`sell`, `buy`
change	BigDecimal	Price limit in last 24 hours

WebSocket API（Asset & Order）

Create subscribeKey

The key is valid in 60 minutes from creation.

curl "https://api.lbkex.com/v2/subscribe/get_key.do"

 {
    "key":"9301ef1ca6cafbef2df4a1430dc8b53879ea68c595a142eac311d8d590fbd60a"
  }

HTTP Request

POST /v2/subscribe/get_key.do

Parameters

Parameter	Type	Required	Note
api_key	string	Yes	User's `api_key`
sign	string	Yes	signature of the request

Response

Parameter	Type	Required	Note
data	string	Yes	subscribeKey

Extend the validity of subscribeKey

The key is valid in 60 minutes from this call.

curl "https://api.lbkex.com/v2/subscribe/refresh_key.do"

{"result":"true"}

HTTP Request

POST /v2/subscribe/refresh_key.do

Parameters

Parameter	Type	Required	Description
api_key	String	Y	API key requested by user
sign	String	Y	Signature of parameter in request
subscribeKey	String	Y	`subscribeKey`

Response

Parameter	Type	Required	Description
result	boolean	Yes	true or false

Close subscribeKey

Close the data stream for an account.

curl "https://api.lbkex.com/v2/subscribe/destroy_key.do"

{"result":"true"}

HTTP Request

POST /v2/subscribe/destroy_key.do

Parameters

Parameter	Type	Required	Description
api_key	String	Y	API key requested by user
sign	String	Y	Signature of parameter in request
subscribeKey	String	Y	`subscribeKey`

Response

Parameter	Type	Required	Description
result	boolean	Yes	true or false

Update subscribed orders

Such events will be pushed when there are new orders created, new orders dealed or new status changes of the account.

    {
      "action": "subscribe",
      "subscribe": "orderUpdate",
      "subscribeKey": "24d87a4xxxxxd04b78713f42643xxxxf4b6f6378xxxxx35836260",
      "pair": "all",
    }

 {
      "orderUpdate":{
          "accAmt": "0.003",
          "amount":"0.003",
          "avgPrice": "0.02455211",
          "symbol":"eth_btc",
          "type":"buy",
          "orderAmt": "0.003",
          "orderStatus":2,
          "orderPrice": "0.02455211",
          "price":"0.02455211",
          "role":"maker",
          "remainAmt":"0",
          "updateTime":1561704577786,
          "uuid":"d0db191d-xxxxx-4418-xxxxx-fbb1xxxx2ea9",
          "txUuid":"da88f354d5xxxxxxa12128aa5bdcb3",
          "volumePrice":"0.00007365633"
      },
      "pair":"eth_btc", 
      "type":"orderUpdate",
      "SERVER":"V2",
      "TS":"2019-06-28T14:49:37.816"
  }

Parameters

Parameters	Parameters Type	Required	Description
action	String	Y	Action requested: `subscribe`
subscribe	String	Y	`orderUpdate`
subscribeKey	String	Y	Obtained through the REST interface of the `/v2/subscribe/refresh_key.do`
pair	String	Y	Trading pair :`eth_btc`. Support matching all: `all`

Return

Parameters	Parameters Type	Description
uuid	String	Order ID
customerID	String	Order customer ID
symbol	String	Trading pair
type	String	buy or sell
txUuid	String	Trading record ID
amount	String	Trading volume
volumePrice	String	Aggregated trading value
role	Long	`maker`,`taker`
price	String	Last price(When the order status is' 1 'or' 2 ' ，it is the transaction price, and the others are the Delegat price)
orderPrice	String	Order price
orderAmt	String	Order amount
avgPrice	String	Average strike price
accAmt	String	Accumulative amount
remainAmt	String	Remaining amount(sell order it's remaining amount, buy order it's remaining trading value)
orderStatus	Integer	Order status `-1`：Withdrawn `0`：Unsettled `1`： Partial sale `2`：Close the deal `4`：Withdrawing
updateTime	Long	Updating time of order

Update subscribed asset

Such events will be pushed when the balance of assets under the account changes (increase, deduction, available freeze, freeze release).

    {
      "action": "subscribe",
      "subscribe": "assetUpdate",
      "subscribeKey": "24d87a4xxxxxd04b78713f42643xxxxf4b6f6378xxxxx35836260"
    }

 {
     "data": {
         "asset": "114548.31881315",
         "assetCode": "usdt",
         "free": "97430.6739041",
         "freeze": "17117.64490905",
         "time": 1627300043270,
         "type": "ORDER_CREATE"
     },
     "SERVER": "V2",
     "type": "assetUpdate",
     "TS": "2021-07-26T19:48:03.548"
 }

Parameters

Parameters	Parameters Type	Required	Description
action	String	Y	Action requested: `subscribe`
subscribe	String	Y	`assetUpdate`
subscribeKey	String	Y	Obtained through the REST interface of the `/v2/subscribe/refresh_key.do`

Return

Parameters	Parameters Type	Description
asset	String	Total balance of the asset
assetCode	String	Asset Code
free	String	Available balance of the asset
freeze	String	Frozen balance of the asset
time	Long	Update time
type	String	Update type

type Update type：

Update type	Description
DEPOSIT	Deposit
WITHDRAW	Withdraw
ORDER_CREATE	Order create
ORDER_DEAL	Order deal
ORDER_CANCEL	Order cancel

Abandoned Endpoints

Withdrawal configurations (offline soon)

Not recommended for use, it will be taken down later

Recommended use: Coin information (GET /v2/assetConfigs.do)

curl "https://api.lbkex.com/v2/withdrawConfigs.do?assetCode=btc"

    { 
        "amountScale":4,
        "transferAmtScale":4,
        "assetCode":"eth", 
        "canWithDraw":"true", 
        "fee":0.01,
        "type":1, 
        "min":0.01,
        "minTransfer":0.01,
        "chain":1
       }

HTTP Request

GET /v2/withdrawConfigs.do

Parameters

Parameter	Type	Required	Note
assetCode	String	No	Code of the asset

Returns

Parameter	Type	Required	Note
assetCode	string	Yes	Code of token
min	double	Yes	Minimum amount to withdraw for out-exchange
minTransfer	double	Yes	Minimum amount to withdraw for in-exchange
canWithDraw	boolean	Yes	Whether the currency can be withdrawn
fee	double	Yes	Charged fee for withdrawal（amount)
amountScale	int	Yes	amount scale for out-exchange
transferAmtScale	int	Yes	amount scale for in-exchange
type	int	Yes	1:fixed fee，2:rate fee
chain	string	no	chain for usdt:OMNI or ERC20

Withdrawal (offline soon)

User withdrawal

{
  "fee": 2,
  "withdrawId": 93182
}

HTTP request

POST /v2/supplement/withdraw.do

request parameters

Parameter name	Parameter type	Required	Description
api_key	string	is	The `api_key` applied by the user
sign	string	is	signature of request parameter
address	string	is	withdrawal address, when type=1, it is the transfer account
networkName	string	No	Chain name, get it through the Get All Coin Information interface
coin	string	is	currency
amount	string	is	withdrawal amount
memo	string	No	memo: memo word of bts and dct
mark	string	No	Withdrawal Notes
fee	string	is	fee
name	string	No	Remarks of the address. After filling in this parameter, it will be added to the withdrawal address book of the currency.
withdrawOrderId	string	No	Custom withdrawal id
type	string	No	type=1 is for intra-site transfer

Return parameters

Parameter name	Parameter type	Required	Description
fee	BigDecimal	Yes	Fees
withdrawId	int	is	withdrawal id

Get recharge history (offline soon)

User access to recharge history

[
  {
    "insertTime": 1644378926000,
    "amount": 443,
    "address": "QiEik5W3szxqtjJnzp14apfrY7McUdX9sa",
    "networkName": "lbk20",
    "txId": "0x4baf730c242fe6d85559edb40399daaf8dca16255382a5ce36934f0ff964a776",
    "coin": "lbk",
    "status": "2"
  }
]

HTTP request

POST /v2/supplement/deposit_history.do

request parameters

Parameter name	Parameter type	Required	Description
api_key	string	is	The `api_key` applied by the user
sign	string	is	signature of request parameter
status	string	No	Recharge status: ("1","Applying"),("2","Recharge successful"),("3","Recharge failed"),("4","Already Cancel"), ("5", "Transfer")
coin	string	no	currency
startTime	string	No	Start time, timestamp in milliseconds, default 90 days ago
endTime	string	no	end time, timestamp in milliseconds, default day

Return parameters

Parameter name	Parameter type	Required	Description
insertTime	timestamp	Yes	InsertTime
amount	BigDecimal	Yes	Amount of deposit
address	String	is	quantity
networkName	string	no	chain name
txId	string	is	transaction hash
coin	string	is	currency
status	string	is	status

Get withdrawal history (offline soon)

User's coin withdrawal history

 [
  {
    "amount": 234,//amount
    "coid": "lbk",//currency
    "address": "34252342",//Withdrawal address
    "withdrawOrderId": "werqwerq123425353",//Withdraw customer custom id
    "fee": 2,//fee
    "networkName": "lbk30",//chain name
    "transferType": "Digital Asset Withdrawal",//Withdrawal type
    "txId": "",
    "feeAssetCode": "",//The currency of the fee, the currency of the delisting will be displayed
    "id": 93182,//Reminder id
    "applyTime": 1644476930000,//time
    "status": "1"//("1","Applying"),("2","Cancelled"),("3","Withdrawal failed"),("4","Withdrawal completed ")
  }
]

HTTP request

POST /v2/supplement/withdraws.do

request parameters

Parameter name	Parameter type	Required	Description
api_key	string	is	The `api_key` applied by the user
sign	string	is	signature of request parameter
status	string	No	status: ("1","Applying"),("2","Cancelled"),("3","Withdrawal failed"),("4","Withdrawal complete")
coin	string	no	currency
withdrawOrderId	string	No	Custom withdrawal id
startTime	string	No	Start time, timestamp in milliseconds, default 90 days ago
endTime	string	no	end time, timestamp in milliseconds, default day

Query order (offline soon)

checking order

{
  "symbol": "lbk_usdt", // trading pair
  "orderId": "10e71fd6-99ab-425e-939d-1447dfbe594e", // order ID of the system
  "clientOrderId": "46a1e423-be95-4ded-8887-a489d38577a8", // ID set by the client
  "price": "0.1", // order price
  "origQty": "1.0", // The original order quantity set by the user
  "executedQty": "0.0", // number of orders to trade
  "cummulativeQuoteQty": "0.0", // Cumulative transaction amount
  "status": "3", // Order status -1: Cancelled 0: Unfilled 1: Partially filled 2: Completely filled 3: Partially filled has been cancelled 4: Cancellation is being processed
  "type": "buy", // order type, such as market order, spot order, etc.
  "time": 1499827319559, // order time
  "updateTime": 1499827319559, // last update time
  "origQuoteOrderQty": "0.000000" // original transaction amount
}

HTTP request

POST /v2/supplement/orders_info.do

request parameters

Parameter name	Parameter type	Required	Description
api_key	String	is	the `api_key` applied by the user
sign	String	is	signature of request parameter
symbol	string	is	coin pair
orderId	string	no	orderid, User-defined id and order id must be passed
origClientOrderId	string	No	User-defined id and order id must be passed

Query all orders (offline soon)

Check all orders(The default query is for orders placed within 24 hours. When the status is empty, the default query is for cancelled and completely filled orders)

[
  {
    "symbol": "lbk_usdt", // trading pair
    "orderId": "5ca3ced8-74ea-46eb-9365-ad78c2c6f606", // order ID of the system
    "clientOrderId": "10e71fd6-99ab-425e-939d-1447dfbe594e", // ID set by the client
    "price": "0.1", // order price
    "origQty": "1.0", // The original order quantity set by the user
    "executedQty": "0.0", // number of orders to trade
    "cummulativeQuoteQty": "0.0", // Cumulative transaction amount
    "status": "3", // Order status -1: Cancelled 0: Unfilled 1: Partially filled 2: Completely filled 3: Partially filled has been cancelled 4: Cancellation is being processed
    "type": "buy", // order type, such as market order, spot order, etc.
    "time": 1499827319559, // order time
    "updateTime": 1499827319559, // last update time
    "origQuoteOrderQty": "0.000000" // original transaction amount
  }
]

HTTP request

POST /v2/supplement/orders_info_history.do

request parameters

Parameter name	Parameter type	Required	Description
sign	string	is	signature of request parameter
api_key	string	is	The `api_key` applied by the user
symbol	string	Yes	Transaction pair `eth_btc`: Ethereum; `zec_btc`: Zerocoin
current_page	string	is	current page number
page_length	string	Yes	Number of data items per page (not less than 1, not more than 200)
status	string	No	Order Status