Introduction

Getting Started

Welcome to the developer documentation.

Instruction For Calling Endpoints

developers can choose their own way to query the market, trade or withdraw according to their usage scenarios and preferences.

Contact Us

Join our Telegram API Group

Product Dictionary

Trade

Contract

Order and Trade ID

Time

The time returned by the system is all in the form of time pinches.

Standard Rules

This chapter is mainly divided into the following three aspects for the details of standard specifications:

Numbers ID

Numbers

To maintain the integrity and accuracy across platforms, decimal numbers are returned as strings. It is recommended that you also convert numbers to strings when making requests to avoid truncation and precision errors.

Integers (such as transaction ID and order) are not quoted.

ID

Unless otherwise stated, most identifiers are UUIDs. When making a request that requires a UUID, the following two formats (with and without dashes) are accepted.

132fb6ae-456b-4654-b4e0-d681ac05cea1 or 132fb6ae456b4654b4e0d681ac05cea1

Update Plan

Change Log

2023-03-03

• Update endpoints for Account
  • /spot/v1/user_feeAdd new field taker_fee_rate_C and maker_fee_rate_C

2022-12-22

• Update endpoints for Spot
  • WebSocket Subscription-【Private】Order Progress add new order status 12 = Partially filled and canceled

2022-11-03

• Update endpoints for Spot / Margin trading
  • /spot/v3/orders /spot/v2/tradesadd start_time and end_time field for flexible querying
  • add new order status 11 = Partially filled and canceled

2022-11-01

• Update endpoints for Account
  • /account/v1/currenciesAdd new field contract_address,withdraw_minsize and withdraw_minfee

2022-10-11

• The new version of market data-relateded endpoints
  • /spot/v2/ticker
  • /spot/v1/ticker_detail

2022-09-29

• New spot trading endpoints
  • /spot/v2/submit_order
  • /spot/v2/batch_orders
  • /spot/v3/cancel_order
  • /spot/v2/order_detail
  • /spot/v3/orders
  • /spot/v2/trades

2022-08-16

• New Endpoint for Trade Fee
  • /spot/v1/trade_fee
• New Endpoint for Basic Fee
  • /spot/v1/user_fee

2022-07-07

• New endpoints for the margin loan
  • /spot/v1/margin/isolated/borrow
  • /spot/v1/margin/isolated/repay
  • /spot/v1/margin/isolated/borrow_record
  • /spot/v1/margin/isolated/repay_record
  • /spot/v1/margin/isolated/pairs
• New endpoint for margin trading
  • /spot/v1/margin/submit_order
• New endpoints for margin accounts
  • /spot/v1/margin/isolated/account
  • /spot/v1/margin/isolated/transfer
• Update endpoints for Spot / Margin trading
  • A new "order_mode" field has been added to the following endpoints to distinguish whether the order originates from a spot or margin trade
  • /spot/v1/order_detail
  • /spot/v2/orders
  • /spot/v1/trades

2022-05-24

• Update endpoints for Spot
  • /spot/v2/ordersAdd new field clientOrderId
  • /spot/v1/tradesAdd new field clientOrderId
  • /spot/v1/order_detailAdd new field clientOrderId

2022-04-19

• New sub-account endpoints
  • /sub-account/main/v1/sub-to-main
  • /sub-account/sub/v1/sub-to-main
  • /sub-account/main/v1/main-to-sub
  • /sub-account/sub/v1/sub-to-sub
  • /sub-account/main/v1/sub-to-sub
  • /sub-account/main/v1/transfer-list
  • /sub-account/v1/transfer-history
  • /sub-account/main/v1/wallet
  • /sub-account/main/v1/subaccount-list
• Update WebSocket Order Progress channel
  • Add new field client_order_id
  • Add new field detail_id

2022-03-29

• WebSocket subscription, 【private】 order channel renamed to 【private】 order progress
• New parameter exec_type is added to 【Private】 order progress channel, which indicates liquidity type

2022-03-08

• Improvement of Websocket connection holding
• Catalog level repair to enhance readability

2022-03-01

• support user to create , request and cancel order through client-defined OrderId

2022-02-15

• increase the maximum rate limit based on users' feedback
• improve UI of the document

2022-01-20

• Update endpoints for Spot
  • /spot/v1/symbols/detailsAdd a new respond parameter trade_status, to show the trading status of a trading pair symbol.

2022-01-18

• websocket public channel addresswss://ws-manager-compress.bitmart.com?protocol=1.1will be taken down on 2022-02-28 UTC time,The new address iswss://ws-manager-compress.bitmart.com/api?protocol=1.1

2021-11-24

• New endpoints for Spot
  • /spot/v2/ordersGet User Order History V2
  • /spot/v1/batch_ordersBatch Order
• Update endpoints for Spot
  • /spot/v1/symbols/klineAdd new field 'quote_volume'
  • /spot/v1/symbols/tradesAdd optional parameter N to return the number of items, the default is up to 50 items
  • /spot/v1/order_detailAdd new field 'unfilled_volume'
  • /spot/v1/submit_orderThe request parameter type added limit_maker and ioc order types
• New endpoints for Account
  • /account/v2/deposit-withdraw/historyGet Deposit And Withdraw History V2
• Update endpoints for Account
  • /account/v1/walletRemove the account_type,Only respond to currency accounts; you can bring currency parameters (optional)

2021-11-06

• Update endpoints for Spot WebSocket
  • Public-Depth Channel:
  • spot/depth50 50 Level Depth Channel
  • spot/depth100 100 Level Depth Channel
  • User-Trade Channel:
  • Eligible pushes add new orders successfully

2021-01-19

• New endpoints for Spot WebSocket
  • Public - ticket channels
  • Public - K channel
  • Public - trading channels
  • Public - depth channels
  • Login
  • User - Trading Channel

2020-07-15

• New endpoints for Spot
  • /spot/v2/cancel_orderCancel an outstanding order，V2

2020-06-29

• New endpoints for Account
  • /account/v1/currenciesGet Currency
    
  • /account/v1/walletGet Account Balance
    
  • /account/v1/deposit/addressDeposit Address
    
  • /account/v1/withdraw/chargeWithdraw Quota
    
  • /account/v1/withdraw/applyWithdraw
    
  • /account/v1/recharge-withdraw/historyGet Deposit And Withdraw History
  • /account/v1/recharge-withdraw/detailGet A Deposit Or Withdraw Detail

2020-05-14

• New endpoints for Spot
  • /spot/v1/currenciesGet a list of all cryptocurrencies on the platform
  • /spot/v1/symbolsGet a list of all trading pairs on the platform
  • /spot/v1/symbols/detailsGet a detailed list of all trading pairs on the platform
  • /spot/v1/tickerGet ticker
  • /spot/v1/stepsGet K-Line steps
  • /spot/v1/symbols/klineGet k-Line
  • /spot/v1/symbols/bookGet orderbook
  • /spot/v1/symbols/tradesGet trades
  • /spot/v1/walletGet user wallet
  • /spot/v1/submit_orderPlace order
  • /spot/v1/cancel_orderCancel order
  • /spot/v1/cancel_ordersCancel all outstanding orders in the specified direction for the specified trading pair
  • /spot/v1/order_detailGet order details
  • /spot/v1/ordersGet user recent orders
  • /spot/v1/tradesGet user trade history

Basic Information

API Basic Information

1. The interface may require the user's API Key. For how to create an API-KEY, please refer to here API KEY Interface Authentication.
2. RESTful API URL: https://api-cloud.bitmart.com
3. The responses of all interfaces are in JSON format.

HTTP Response Codes

• HTTP 4XX Error codes are used to indicate wrong request content, behavior, and format. The problem is from the request sender.
• HTTP 403 The error code indicates a violation of the restriction (prohibited call).
• HTTP 429 The error code indicates that the access frequency is overrun and the IP will be blocked.
• HTTP 418 The error code indicates that the IP has been blocked after error code 429.
• HTTP 5XX Error codes are used to indicate problems with BitMart server.

API Returned Codes

When using the interface, HTTP 200 means that the client has submitted a request to the business core through the gateway and it has returned information, but it does not mean that the business request is successful. It may have been executed, or the execution may fail, and further confirmation is required at this time. Please pay attention to the code field in the returned data.

For details, please refer to Error Code List

Authentication and Signature

In order to facilitate access, we provide SDK in some languages for reference
* bitmart-go-sdk-api
* bitmart-python-sdk-api
* bitmart-java-sdk-api
* bitmart-php-sdk-api

This chapter mainly divides the verification details into the following four aspects:

• Generate API Key
• Make a request
• Signature
• Timestamp

1. Generate API Key

Before signing any request, you must create an API Key through the BitMart website. After creating the API Key, you will get 3 pieces of information you must remember:

• Access Key
  
• Secret Key
  
• Memo
  

Access Key and Secret Key will be randomly generated and provided by BitMart, and Memo will be provided by you to ensure the security of API access. BitMart will store the encrypted hash value of the Secret Key for verification, but if you forget the Secret Key, it cannot be recovered. Please regenerate the new API Key through the BitMart website.

Example

Login Bitmart website and enter the account page

Click the API Settings button to enter the CREATE API page

2. Make a Request

The request contains two parts, one is header and the other is queryString

Interface Header Parameters

All REST request headers must include the following:

• X-BM-KEY: Access Key of type string.

• X-BM-SIGN: Use HmacSHA256 signature (see Signature).

• X-BM-TIMESTAMP: The timestamp of the request. (UTC0 time zone timestamp, accurate to milliseconds)

Interface Content Type

Request Example: GET/DELETE

curl {{host}}/v1/goto?symbol=BMXBTC&side=BUY

# queryString: symbol=BMXBTC&side=BUY

• For interfaces using the GET and DELETE methods, the content can be sent in two forms: application/json or application/x-www-form-urlencoded. The parameter must be sent in the query string. (The order of the parameters is not required.)

Request Example: POST/PUT

curl -X POST {{host}}/v1/goto -H "Content-type: application/json" -d '{"symbol":"BMX","side":"BUY"}'

# queryString: {"symbol":"BMX","side":"BUY"}

• For interfaces using the POST and PUT methods, the content can be sent in application/json form. (The order of the parameters is not required.)

Special Note: In the example on the right,

The request method of GET/DELETE, the query string is the form type of key1=value2&key2=value2

The request method of POST/PUT, the query string is the json type of {"symbol":"BMX","side":"BUY"}

3.Signature

Signature Algorithm Example: In the example below, param variable message=timestamp + "#" + memo + "#" + queryString

// javascript language
sign=CryptoJS.HmacSHA256(message, YourSecretKey)

// python language
def sign(message, your_secret_key):
    mac = hmac.new(bytes(your_secret_key, encoding='utf8'), bytes(message, encoding='utf-8'), digestmod='sha256')
    return mac.hexdigest()

// java language
import org.apache.commons.codec.binary.Hex;
import javax.crypto.Mac;
import javax.crypto.spec.SecretKeySpec;

public final class CloudSignature {
    static final String HMAC_SHA256 = "HmacSHA256";
    static String createSha256Signature(String yourSecretKey, String message) {
        try {
            Mac sha256 = Mac.getInstance(HMAC_SHA256);
            SecretKeySpec secretKeySpec = new SecretKeySpec(yourSecretKey.getBytes(), HMAC_SHA256);
            sha256.init(secretKeySpec);
            return Hex.encodeHexString(sha256.doFinal(message.getBytes()));
        } catch (Exception ex) {
            ex.printStackTrace();
        }
        return null;
    }
}

// go language
import (
    "crypto/hmac"
    "crypto/sha256"
    "encoding/hex"
)
func HmacSha256Base64Signer(message string, yourSecretKey string) (string, error) {
    mac := hmac.New(sha256.New, []byte(yourSecretKey))
    _, err := mac.Write([]byte(message))
    if err != nil {
        return "", err
    }
    return hex.EncodeToString(mac.Sum(nil)), nil
}

The request header of X-BM-SIGN is signed by the HMAC SHA256 algorithm and converted to lowercase hexadecimal (toHexString) encoding. Among them, the key of the algorithm is your api secret key, and the signed content is timestamp + "#" + memo + "#" + queryString.

Among them, the value of timestamp is the same as the X-BM-TIMESTAMP in request header.

Note: If the length of your sign is not equal to 64, or if the sign is uppercase, it is wrong.

4.Timestamp

Unix timestamps accurate to milliseconds using UTC0 time zone

Example: If the current time: 2020-04-28 09:21:30.000, then timestamp=1588065690000

Example

The keys are as follows: Note that the following two interfaces are deployed in the production environment, and users can directly test and call after replacing with their own KEY.

Example: /spot/v1/test-get

echo -n "1589793795969#test001#symbol=BTC_USDT" | openssl dgst -sha256 -hmac "6c6c98544461bbe71db2bca4c6d7fd0021e0ba9efc215f9c6ad41852df9d9df9"
    (stdin)= 118eb558afa7d84e8710004f8416ddb771f50718c85f60a45069d0ccbe6ee1e0

curl --location --request GET 'localhost:8080/spot/v1/test-get?symbol=BTC_USDT'
--header 'Content-Type: application/json'
--header 'X-BM-KEY: 80618e45710812162b04892c7ee5ead4a3cc3e56'
--header 'X-BM-SIGN: 118eb558afa7d84e8710004f8416ddb771f50718c85f60a45069d0ccbe6ee1e0'
--header 'X-BM-TIMESTAMP: 1589793795969'

{"message":"OK","code":1000,"trace":"17105b32-cc5b-406a-ab6e-6d9ed0fa4fd8","data":{}}

Request interface: /spot/v1/test-get

Request method: GET

Current timestamp: timestamp=1589793795969

Returned data: The request is a success if code=1000 in returned data.

Example: /spot/v1/test-post

echo -n '1589793796145#test001#{"symbol":"BTC_USDT","price":"8600","count":"100"}' | openssl dgst -sha256 -hmac "6c6c98544461bbe71db2bca4c6d7fd0021e0ba9efc215f9c6ad41852df9d9df9"
    (stdin)= c31dc326bf87f38bfb49a3f8494961abfa291bd549d0d98d9578e87516cee46d

    curl --location --request POST 'localhost:8080/spot/v1/test-post'
    --header 'Content-Type: application/json'
    --header 'X-BM-KEY: 80618e45710812162b04892c7ee5ead4a3cc3e56'
    --header 'X-BM-SIGN: c31dc326bf87f38bfb49a3f8494961abfa291bd549d0d98d9578e87516cee46d'
    --header 'X-BM-TIMESTAMP: 1589793796145'
    --d '{"symbol":"BTC_USDT","price":"8600","count":"100"}'

{"message":"OK","code":1000,"trace":"17105b32-cc5b-406a-ab6e-6d9ed0fa4fd8","data":{}}

Request interface: /spot/v1/test-post

Request method: POST

Current timestamp: timestamp=1589793796145

Returned data: The request is a success if code=1000 in returned data.

RequestFormat

This article mainly describes some specifications of the interface from the following two aspects. * Request standard * Authentication type

Request Standard

1.Rest Interface

1.1 Request parameter and format

GET/DELETE

curl https://api-cloud.bitmart.com/contract/v1/ifcontract/contracts?contractID=1

For interfaces using GET, DELETE methods, the parameters should be sent via query string.

POST/PUT

curl https://api-cloud.bitmart.com/contract/v1/ifcontract/submitOrder
body: {"contract_id":1,"category":1,"way":1,"open_type":1,"leverage":10,"custom_id":1,"price":5000,"vol":10,"nonce":1589266686}

For interfaces using POST, PUT methods, the parameters should be sent in the request body for concent type of application/json.

1.2 Reponse

Response:

{
  "code": 1000,
  "trace":"886fb6ae-456b-4654-b4e0-d681ac05cea1",
  "message": "OK",
  "data": [
    {
      "low": "130",
      "high": "130",
      "open": "130",
      "close": "130",
      "last_price": "130",
      "avg_price": "130",
      "volume": "0",
      "timestamp": 1532610000,
      "rise_fall_rate": "0",
      "rise_fall_value": "0"
    }
  ]
}

The server response data format is JSON.

2.WebSocket Interface

No description.

Authentication Type

This chapter is mainly divided into the following two aspects of interface type details:

• Public interface
• Private interface

1. Public Interface

The public interface can be used to obtain configuration information and market data. Public requests can be called without authentication.

2. Private Interface

The private interface can be used for order and account management. Each private request must be signed using a standardized authentication method. The private interface needs to be verified with your API key.

Interface Permission

Whether you have permission to call the interface requires attention to the following two aspects:
* Interface authentication
* API Permission

Interface authentication

When the user calls, APIKEY and verification parameters need to be passed in the way specified by the interface. The first line of each interface will have a description of what authentication the interface needs.

Simply put, the interface authentication is divided into the following three cases:

API KEY Permission

Refers to the user specified authorization to the API when applying for the API. That is, when users apply for API KEY on the BitMart website page, they can check API permissions, such as: trading permissions (including contract transactions and spot transactions). (Default: read-only permission).

Details:

Rate Limit

When the requests exceed the rate limit, the 429 status will be returned: the request is too frequent.

REST API

If a valid API key is passed in, the user id will be used to limit the rate; if not, the public IP will be used to limit the rate.

Rate limit rules: There is a separate description on each interface. If there is not, the rate limit is 25 times/5 sec in general.

Each call to the interface will return 3 Response Headers with limit tags, as shown below:

Example:

X-BM-RateLimit-Remaining: 10
X-BM-RateLimit-Limit: 600
X-BM-RateLimit-Reset: 60
The above setting means that it can be called 600 times within 60 seconds, and currently has been called 10 times

The specific interface limits are as follows:

System Status

Get System Time

Get system time (Authentication type:NONE, See Interface Permission)

Request Format

GET https://api-cloud.bitmart.com/system/time

Request Limit

See Detailed Rate Limit

Request Parameter

Request

curl https://api-cloud.bitmart.com/system/time

None

Response Data

Response

{
  "code": 1000,
  "trace":"886fb6ae-456b-4654-b4e0-d681ac05cea1",
  "message": "OK",
  "data": {
    "server_time": 1527777538000
  }
}

Get System Service Status

Get system service status (Authentication type:NONE, See Interface Permission)

Request Format

GET https://api-cloud.bitmart.com/system/service

Request Limit

See Detailed Rate Limit

Request Parameter

Request

curl https://api-cloud.bitmart.com/system/service

None

Response Data

Response

{
  "code": 1000,
  "trace":"886fb6ae-456b-4654-b4e0-d681ac05cea1",
  "message": "OK",
  "data": {
    "serivce":[
      {
         "title": "Spot API Stop",
         "service_type": "spot",
         "status": "2",
         "start_time": 1527777538000,
         "end_time": 1527777538000
     },
     {
        "title": "Contract API Stop",
        "service_type": "contract",
        "status": "2",
        "start_time": 1527777538000,
        "end_time": 1527777538000
    }
   ]
  }
}

Restful Public Market Data

Get Currency List

Get a list of all cryptocurrencies on the platform (Authentication type:NONE, See Interface Permission)

Request Format

GET https://api-cloud.bitmart.com/spot/v1/currencies

Request Limit

See Detailed Rate Limit

Request Parameter

Request

curl https://api-cloud.bitmart.com/spot/v1/currencies

None

Response Data

Response

{
  "code": 1000,
  "trace":"886fb6ae-456b-4654-b4e0-d681ac05cea1",
  "message": "OK",
  "data": {
    "currencies": [
      {
        "id": "BTC",
        "name": "Bitcoin",
        "withdraw_enabled": true,
        "deposit_enabled": true
      },
      {
        "id": "ETH",
        "name": "Ethereum",
        "withdraw_enabled": true,
        "deposit_enabled": true
      }
    ]
  }
}

Get List of Trading Pairs

Get a list of all trading pairs on the platform (Authentication type:NONE, See Interface Permission)

Request Format

GET https://api-cloud.bitmart.com/spot/v1/symbols

Request Limit

See Detailed Rate Limit

Request Parameter

Request

curl https://api-cloud.bitmart.com/spot/v1/symbols

None

Response Data

Response

{
  "code": 1000,
  "trace":"886fb6ae-456b-4654-b4e0-d681ac05cea1",
  "message": "OK",
  "data": {
    "symbols": [
       "BMX_ETH",
       "XLM_ETH",
       "MOBI_ETH",
       ...
    ]
  }
}

Get List of Trading Pair Details

Get a detailed list of all trading pairs on the platform (Authentication type:NONE, See Interface Permission)

Request Format

GET https://api-cloud.bitmart.com/spot/v1/symbols/details

Request Limit

See Detailed Rate Limit

Request Parameter

Request

curl https://api-cloud.bitmart.com/spot/v1/symbols/details

None

Response Data

Response

{
  "code": 1000,
  "trace":"886fb6ae-456b-4654-b4e0-d681ac05cea1",
  "message": "OK",
  "data": {
    "symbols": [
        {
            "symbol":"GXC_BTC",
             "symbol_id":1024,
             "base_currency":"GXC",
             "quote_currency":"BTC",
             "quote_increment":"1.00000000",
             "base_min_size":"1.00000000",
             "price_min_precision":6,
             "price_max_precision":8,
             "expiration":"NA",
             "min_buy_amount":"0.00010000",
             "min_sell_amount":"0.00010000",
             "trade_status":"trading"
        },
        ...
    ]
  }
}

Instruction

Description of the trading pair details field:

Get Ticker of All Pairs

Ticker is an overview of the market status of a trading pair, including the latest trade price, top bid and ask prices and 24-hour trading volume (Authentication type:NONE, See Interface Permission)

Request Format

GET https://api-cloud.bitmart.com/spot/v1/ticker

Request Limit

See Detailed Rate Limit

Request Parameter

Request

curl https://api-cloud.bitmart.com/spot/v1/ticker?symbol=BTC_USDT

Response Data

Response

{
    "message":"OK",
    "code":1000,
    "trace":"6e42c7c9-fdc5-461b-8fd1-b4e2e1b9ed57",
    "data":{
        "tickers":[
            {
                "symbol":"BTC_USDT",
                "last_price":"1.00",
                "quote_volume_24h":"201477650.88000",
                "base_volume_24h":"25186.48000",
                "high_24h":"8800.00",
                "low_24h":"1.00",
                "open_24h":"8800.00",
                "close_24h":"1.00",
                "best_ask":"0.00",
                "best_ask_size":"0.00000",
                "best_bid":"0.00",
                "best_bid_size":"0.00000",
                "fluctuation":"-0.9999",
                "url":"https://www.bitmart.com/trade?symbol=BTC_USDT"
            }
        ]
    }
}

Get Ticker of All Pairs (V2)

Applicable to query the latest ticker of all trading pairs, please note that the endpoint returns more data, please reduce the frequency of calls (Authentication type:NONE, See Interface Permission)

Request Format

GET https://api-cloud.bitmart.com/spot/v2/ticker

Request Limit

See Detailed Rate Limit

Request Parameter

Request

curl https://api-cloud.bitmart.com/spot/v2/ticker

None

Response Data

Response

{
    "message":"OK",
    "code":1000,
    "trace":"6e42c7c9-fdc5-461b-8fd1-b4e2e1b9ed57",
    "data":{
        "tickers":[
            {
                "symbol":"BTC_USDT",
                "last_price":"1.00",
                "quote_volume_24h":"201477650.88000",
                "base_volume_24h":"25186.48000",
                "high_24h":"8800.00",
                "low_24h":"1.00",
                "open_24h":"8800.00",
                "close_24h":"1.00",
                "best_ask":"0.00",
                "best_ask_size":"0.00000",
                "best_bid":"0.00",
                "best_bid_size":"0.00000",
                "fluctuation":"-0.9999",
                "url":"https://www.bitmart.com/trade?symbol=BTC_USDT",
                "timestamp":1665200293
            }
        ]
    }
}

Get Ticker of a Trading Pair

Applicable for querying aggregated tickers of a particular trading pair (Authentication type:NONE, See Interface Permission)

Request Format

GET https://api-cloud.bitmart.com/spot/v1/ticker_detail

Request Limit

See Detailed Rate Limit

Request Parameter

Request

curl https://api-cloud.bitmart.com/spot/v1/ticker_detail?symbol=BTC_USDT

Response Data

Response

{
  "message":"OK",
  "code":1000,
  "trace":"7d3a7e589cad4d578e17a6bdea8e4d09.65.16687519530806699",
  "data":{
    "symbol":"BTC_USDT",
    "last_price":"16795.11",
    "quote_volume_24h":"71784875.05",
    "base_volume_24h":"4306.22738",
    "high_24h":"16995.94",
    "low_24h":"16434.08",
    "open_24h":"16583.37",
    "close_24h":"16795.11",
    "best_ask":"16792.26",
    "best_ask_size":"0.02377",
    "best_bid":"16792.23",
    "best_bid_size":"0.00640",
    "fluctuation":"+0.0128",
    "timestamp":1668751802882,
    "url":"https://www.bitmart.com/trade?symbol=BTC_USDT"
  }
}

Get K-Line Step

Get all k-line steps supported by the platform, expressed in minutes, minimum 1 minute. (Authentication type:NONE, See Interface Permission)

Request Format

GET https://api-cloud.bitmart.com/spot/v1/steps

Request Limit

See Detailed Rate Limit

Request Parameter

Request

curl https://api-cloud.bitmart.com/spot/v1/steps

None

Response Data

Response

{
  "code": 1000,
  "trace":"886fb6ae-456b-4654-b4e0-d681ac05cea1",
  "message": "OK",
  "data": {
    "steps": [1, 3, 5, 15, 30, 45, 60, 120, 180, 240, 1440, 10080, 43200]
  }
}

Get K-Line

Get k-line data within a specified time range of a specified trading pair (Authentication type:NONE, See Interface Permission)

Request Format

GET https://api-cloud.bitmart.com/spot/v1/symbols/kline

Request Limit

See Detailed Rate Limit

Request Parameter

Request

curl https://api-cloud.bitmart.com/spot/v1/symbols/kline?symbol=BMX_ETH&step=15&from=1525760116&to=1525769116

Response Data

Response

{
    "message":"OK",
    "code":1000,
    "trace":"ae7ede4c-04a3-4004-bd8b-022a12d17e45",
    "data":{
        "klines":[
            {
                "timestamp":1590969600,
                "open":"1.2400000000",
                "high":"1.2400000000",
                "low":"1.2000000000",
                "close":"1.2000000000",
                "last_price":"1.2000000000",
                "volume":"4.9000000000",
                "quote_volume":"0.000000"
            }
        ]
    }
}

Description of k-line details field:

Get Depth

Get full depth of trading pairs. (Authentication type:NONE, See Interface Permission)

Request Format

GET https://api-cloud.bitmart.com/spot/v1/symbols/book

Request Limit

See Detailed Rate Limit

Request Parameter

Request

curl https://api-cloud.bitmart.com/spot/v1/symbols/book?symbol=BMX_ETH&precision=6

Instruction

1. precision is optional. If not passed, the default is to use price_max_precision returned by symbols details.

2. If the size is left blank, default 50 of data will be returned. If size is larger than '50', error code will be returned.

Response Data

Response

{
  "code": 1000,
  "trace":"886fb6ae-456b-4654-b4e0-d681ac05cea1",
  "message": "OK",
  "data": {
       "timestamp": 1527777538000,
       "buys":[
          {
             "amount":"4800.00",
             "total":"4800.00",
             "price":"0.000767",
             "count":"1"
          },
          {
             "amount":"99996475.79",
             "total":"100001275.79",
             "price":"0.000201",
             "count":"1"
          },
          ...
       ],
       "sells":[
          {
             "amount":"100.00",
             "total":"100.00",
             "price":"0.007000",
             "count":"1"
          },
          {
             "amount":"6997.00",
             "total":"7097.00",
             "price":"1.000000",
             "count":"1"
          },
          ...
       ]
  }
}

Market depth details：

Get Recent Trades

Get the latest trade records of the specified trading pair (Authentication type:NONE, See Interface Permission)

Request Format

GET https://api-cloud.bitmart.com/spot/v1/symbols/trades

Request Limit

See Detailed Rate Limit

Request Parameter

Request

curl https://api-cloud.bitmart.com/spot/v1/symbols/trades?symbol=BMX_ETH

Response Data

Response

{
  "code": 1000,
  "trace":"886fb6ae-456b-4654-b4e0-d681ac05cea1",
  "message": "OK",
  "data": {
    "trades": [
       {
          "amount":"0.05768509",
          "order_time":1527057452000,
          "price":"0.004811",
          "count":"11.99",
          "type":"buy"
       },
       ...
    ]
  }
}

Depth data details field description:

Sub-Account Endpoints

Sub-Account Spot Asset Transfer (For Main Account)

Sub-Account Spot Asset Transfer (For Main Account) (Authentication type:SIGNED, See Interface Permission)

Request Format

POST https://api-cloud.bitmart.com/account/sub-account/main/v1/sub-to-main

Request Limit

See Detailed Rate Limit

Request Parameter

Request

curl https://api-cloud.bitmart.com/account/sub-account/main/v1/sub-to-main

{
  "requestNo":"4e2adcff-2122-1ce7-2557-4f65d2ce1ca2",
  "amount":"1",
  "currency":"BTC",
  "subAccount":"[email protected]"
}

Response Data

Response

{
  "code": 1000,
  "trace":"886fb6ae-456b-4654-b4e0-d681ac05cea1",
  "message": "OK",
  "data": {
  }
}

If code value is 1000,it means the transfer is successful.

Sub-Account Spot Asset Transfer (For Sub-Account)

Sub-Account Spot Asset Transfer (For Sub-Account) (Authentication type:SIGNED, See Interface Permission)

Request Format

POST https://api-cloud.bitmart.com/account/sub-account/sub/v1/sub-to-main

Request Limit

See Detailed Rate Limit

Request Parameter

Request

curl https://api-cloud.bitmart.com/account/sub-account/sub/v1/sub-to-main

{
  "requestNo":"4e2adcff-2122-1ce7-2557-4f65d2ce1ca2",
  "amount":"1",
  "currency":"BTC"
}

Response Data

Response

{
  "code": 1000,
  "trace":"886fb6ae-456b-4654-b4e0-d681ac05cea1",
  "message": "OK",
  "data": {
  }
}

If code value is 1000,it means the transfer is successful.

Main Account Spot Asset Transfer (For Main Account)

Main Account Spot Asset Transfer (For Main Account) (Authentication type:SIGNED, See Interface Permission)

Request Format

POST https://api-cloud.bitmart.com/account/sub-account/main/v1/main-to-sub

Request Limit

See Detailed Rate Limit

Request Parameter

Request

curl https://api-cloud.bitmart.com/account/sub-account/main/v1/main-to-sub

{
  "requestNo":"4e2adcff-2122-1ce7-2557-4f65d2ce1ca2",
  "amount":"1",
  "currency":"BTC",
  "subAccount":"[email protected]"
}

Response Data

Response

{
  "code": 1000,
  "trace":"886fb6ae-456b-4654-b4e0-d681ac05cea1",
  "message": "OK",
  "data": {
  }
}

If code value is 1000,it means the transfer is successful.

Sub-Account to Sub-Account Spot Asset Transfer (For Sub-Account)

Sub-Account to Sub-Account Spot Asset Transfer (For Sub-Account) (Authentication type:SIGNED, See Interface Permission)

Request Format

POST https://api-cloud.bitmart.com/account/sub-account/sub/v1/sub-to-sub

Request Limit

See Detailed Rate Limit

Request Parameter

Request

curl https://api-cloud.bitmart.com/account/sub-account/sub/v1/sub-to-sub

{
  "requestNo":"4e2adcff-2122-1ce7-2557-4f65d2ce1ca2",
  "amount":"1",
  "currency":"BTC",
  "subAccount":"[email protected]"
}

Response Data

Response

{
  "code": 1000,
  "trace":"886fb6ae-456b-4654-b4e0-d681ac05cea1",
  "message": "OK",
  "data": {
  }
}

If code value is 1000,it means the transfer is successful.

Sub-Account to Sub-Account Spot Asset Transfer (For Main Account)

Sub-Account to Sub-Account Spot Asset Transfer (For Main Account) (Authentication type:SIGNED, See Interface Permission)

Request Format

POST https://api-cloud.bitmart.com/account/sub-account/main/v1/sub-to-sub

Request Limit

See Detailed Rate Limit

Request Parameter

Request

curl https://api-cloud.bitmart.com/account/sub-account/main/v1/sub-to-sub

{
  "requestNo":"4e2adcff-2122-1ce7-2557-4f65d2ce1ca2",
  "amount":"1",
  "currency":"BTC",
  "fromAccount":"[email protected]",
  "toAccount":"[email protected]"
}

Response Data

Response

{
  "code": 1000,
  "trace":"886fb6ae-456b-4654-b4e0-d681ac05cea1",
  "message": "OK",
  "data": {
  }
}

If code value is 1000,it means the transfer is successful.

Query Sub-Account Spot Asset Transfer History (For Main Account)

Query Sub-Account Spot Asset Transfer History (For Main Account) (Authentication type:KEYED, See Interface Permission)

Request Format

GET https://api-cloud.bitmart.com/account/sub-account/main/v1/transfer-list

Request Limit

See Detailed Rate Limit

Request Parameter

Request

curl https://api-cloud.bitmart.com/account/sub-account/main/v1/transfer-list?moveType=spot to spot

Response Data

Response

{
  "message": "OK",
  "code": 1000,
  "trace": "282fd16e-73ee-464f-adb7-7241345929f6",
  "data": {
    "total": 2,
    "historyList": [
      {
        "fromAccount": "[email protected]",
        "fromWalletType": "spot",
        "toAccount": "[email protected]",
        "toWalletType": "spot",
        "currency": "BTC",
        "amount": "1",
        "submissionTime": 1648471522
      },
      {
        "fromAccount": "[email protected]",
        "fromWalletType": "spot",
        "toAccount": "[email protected]",
        "toWalletType": "spot",
        "currency": "BTC",
        "amount": "30",
        "submissionTime": 1648466178
      }
    ]
  }
}

Get Account Spot Asset Transfer History

Get Account Spot Asset Transfer History (Authentication type:KEYED, See Interface Permission)

Request Format

GET https://api-cloud.bitmart.com/account/sub-account/v1/transfer-history

Request Limit

See Detailed Rate Limit

Request Parameter

Request

curl https://api-cloud.bitmart.com/account/sub-account/v1/transfer-history?moveType=spot to spot

Response Data

Response

{
  "message": "OK",
  "code": 1000,
  "trace": "282fd16e-73ee-464f-adb7-7241345929f6",
  "data": {
    "total": 2,
    "historyList": [
      {
        "fromAccount": "[email protected]",
        "fromWalletType": "spot",
        "toAccount": "[email protected]",
        "toWalletType": "spot",
        "currency": "BTC",
        "amount": "1",
        "submissionTime": 1648471522
      },
      {
        "fromAccount": "[email protected]",
        "fromWalletType": "spot",
        "toAccount": "[email protected]",
        "toWalletType": "spot",
        "currency": "BTC",
        "amount": "30",
        "submissionTime": 1648466178
      }
    ]
  }
}

Get Sub-Account Spot Wallet Balance (For Main Account)

Get Sub-Account Spot Wallet Balance (For Main Account) (Authentication type:KEYED, See Interface Permission)

Request Format

GET https://api-cloud.bitmart.com/account/sub-account/main/v1/wallet

Request Limit

See Detailed Rate Limit

Request Parameter

Request

curl https://api-cloud.bitmart.com/account/sub-account/main/v1/wallet?subAccount=[email protected]

Response Data

Response

{
    "message":"OK",
    "code":1000,
    "trace":"ef834248-51d3-4223-9481-f862aa9dd39f",
    "data":{
        "wallet":[
            {
                "currency":"USDT",
                "name":"Tether USD",
                "available":"1000.00000000",
                "frozen":"0.00000000"
            },
            {
                "currency":"BTC",
                "name":"Bitcoin",
                "available":"10000.00000000",
                "frozen":"10.00000000"
            }
        ]
    }
}

Get Sub-account List (For Main Account)

Get Sub-account List (For Main Account) (Authentication type:KEYED, See Interface Permission)

Request Format

GET https://api-cloud.bitmart.com/account/sub-account/main/v1/subaccount-list

Request Limit

See Detailed Rate Limit

Request Parameter

Request

curl https://api-cloud.bitmart.com/account/sub-account/main/v1/subaccount-list

Response Data

Response

{
  "message": "OK",
  "code": 1000,
  "trace": "c03c22c3-75db-4aaa-9500-6dcd63dd9ccf",
  "data": {
    "subAccountList": [
      {
        "accountName": "[email protected]",
        "status": 1
      },
      {
        "accountName": "[email protected]",
        "status": 1
      }
    ]
  }
}

Funding Account

Get Account Balance

Gets Account Balance (Authentication type:KEYED, See Interface Permission)

Request Format

GET https://api-cloud.bitmart.com/account/v1/wallet

Request Limit

See Detailed Rate Limit

Request Parameter

Request

curl https://api-cloud.bitmart.com/account/v1/wallet

Response Data

Response

{
    "message":"OK",
    "code":1000,
    "trace":"ef834248-51d3-4223-9481-f862aa9dd39f",
    "data":{
        "wallet":[
            {
                "currency":"USDT",
                "name":"Tether USD",
                "available":"1000.00000000",
                "frozen":"0.00000000"
            },
            {
                "currency":"BTC",
                "name":"Bitcoin",
                "available":"10000.00000000",
                "frozen":"10.00000000"
            }
        ]
    }
}

Get Currencies

Gets the currency of the asset for withdrawal (Authentication type:None, See Interface Permission)

Request Format

GET https://api-cloud.bitmart.com/account/v1/currencies

Request Limit

See Detailed Rate Limit

Request Parameter

Request

curl https://api-cloud.bitmart.com/account/v1/currencies

None

Response Data

Response

{
  "code": 1000,
  "trace":"886fb6ae-456b-4654-b4e0-d681ac05cea1",
  "message": "OK",
  "data": {
    "currencies": [
      {
        "currency": "USDT",
        "name": "Tether USD",
        "contract_address": null,
        "network": "OMNI",
        "withdraw_enabled": false,
        "deposit_enabled": false,
        "withdraw_minsize": null,
        "withdraw_minfee": null
      },
      {
        "currency": "USDT-TRC20",
        "name": "USDT-TRC20",
        "contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
        "network": "TRC20",
        "withdraw_enabled": true,
        "deposit_enabled": true,
        "withdraw_minsize": "10",
        "withdraw_minfee": "1"
      },
      {
        "currency": "USDT-ERC20",
        "name": "USDT-ERC20",
        "contract_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
        "network": "ERC20",
        "withdraw_enabled": true,
        "deposit_enabled": true,
        "withdraw_minsize": "26",
        "withdraw_minfee": "13"
      },
      {
        "currency": "USDT-BSC",
        "name": "USDT-BSC",
        "contract_address": "0x55d398326f99059fF775485246999027B3197955",
        "network": "BEP20(BSC)",
        "withdraw_enabled": true,
        "deposit_enabled": true,
        "withdraw_minsize": "2",
        "withdraw_minfee": "1"
      }
    ]
  }
}

Get Spot Wallet Balance

Get the user's wallet balance for all currencies (Authentication type:NONE, See Interface Permission)

Request Format

GET https://api-cloud.bitmart.com/spot/v1/wallet

Request Limit

See Detailed Rate Limit

Request Parameter

Request

curl https://api-cloud.bitmart.com/spot/v1/wallet

None

Response Data

Response

{
  "code": 1000,
  "trace":"886fb6ae-456b-4654-b4e0-d681ac05cea1",
  "message": "OK",
  "data": {
    "wallet": [
         {
              "id": "BTC",
              "available": "10.000000",
              "name": "Bitcoin",
              "frozen": "10.000000",
          },
          ...
    ]
  }
}

Deposit Address

Gets Deposit Address (Authentication type:KEYED, See Interface Permission)

Request Format

GET https://api-cloud.bitmart.com/account/v1/deposit/address

Request Format

See Detailed Rate Limit

Request Parameter

Request

curl https://api-cloud.bitmart.com/account/v1/deposit/address?currency=USDT-TRC20

Instruction

Response Data

Response

{
    "message":"OK",
    "code":1000,
    "trace":"0e6edd79-f77f-4251-abe5-83ba75d06c1a",
    "data":{
        "currency":"USDT-TRC20",
        "chain":"USDT-TRC20",
        "address":"TGR3ghy2b5VLbyAYrmiE15jasR6aPHTvC5",
        "address_memo":""
    }
}

Forgot to write Memo/Wrote a wrong Memo?

Withdraw Quota

Query withdraw quota for currencies (Authentication type:KEYED, See Interface Permission)

Request Format

GET https://api-cloud.bitmart.com/account/v1/withdraw/charge

Request Limit

See Detailed Rate Limit

Request Parameter

Request

curl https://api-cloud.bitmart.com/account/v1/withdraw/charge?currency=BTC

Response Data

Response

{
    "message":"OK",
    "code":1000,
    "trace":"62a80bde-0cb4-4bf1-b8e5-5ad2c71463e7",
    "data":{
        "today_available_withdraw_BTC":"100.0000",
        "min_withdraw":"0.00000000",
        "withdraw_precision":8,
        "withdraw_fee":"0.00000000"
    }
}

Withdraw

Creates a withdraw request from spot account to an external address (Authentication type:SIGNED, See Interface Permission)

Request Format

POST https://api-cloud.bitmart.com/account/v1/withdraw/apply

Request Limit

See Detailed Rate Limit

Request Parameter

Request

curl https://api-cloud.bitmart.com/account/v1/withdraw/apply

{
    "currency": "USDT",
    "amount": "100.000",
    "destination": "To Digital Address",
    "address": "0x1EE6FA5A3803608fc22a1f3F76ea9447D2E8b335",
    "address_memo": ""
}

Response Data

Response

{
  "code": 1000,
  "trace":"886fb6ae-456b-4654-b4e0-d681ac05cea1",
  "message": "OK",
  "data": {
    "withdraw_id": "121212"
  }
}

Get Deposit And Withdraw History

The original /account/v1/deposit-withdraw/history interface, the old interface is no longer supported, please switch to the new interface as soon as possible

Search for all existed withdraws and deposits and return their latest status. (Authentication type:KEYED, See Interface Permission)

Request Format

GET https://api-cloud.bitmart.com/account/v2/deposit-withdraw/history

Request Limit

See Detailed Rate Limit

Request Parameter

Request

curl https://api-cloud.bitmart.com/account/v2/deposit-withdraw/history?N=100&operation_type=withdraw

Response Data

Response

{
  "message":"OK",
  "code":1000,
  "trace":"142bf92a-fc50-4689-92b6-590886f90b97",
  "data":{
    "records":[
      {
        "withdraw_id":"1679952",
        "deposit_id":"",
        "operation_type":"withdraw",
        "currency":"BMX",
        "apply_time":1588867374000,
        "arrival_amount":"59.000000000000",
        "fee":"1.000000000000",
        "status":0,
        "address":"0xe57b69a8776b37860407965B73cdFFBDFe668Bb5",
        "address_memo":"",
        "tx_id":""
      },
      ...
    ]
  }
}

Get A Deposit Or Withdraw Detail

Query a single charge record (Authentication type:KEYED, See Interface Permission)

Request Format

GET https://api-cloud.bitmart.com/account/v1/deposit-withdraw/detail

Request Limit

See Detailed Rate Limit

Request Parameter

Request

curl https://api-cloud.bitmart.com/account/v1/deposit-withdraw/detail?id=1679952

Response Data

Response

{
    "message":"OK",
    "code":1000,
    "trace":"f7f74924-14da-42a6-b7f2-d3799dd9a612",
    "data":{
        "record":{
            "withdraw_id":"1679952",
            "deposit_id":"",
            "operation_type":"withdraw",
            "currency":"BMX",
            "apply_time":1588867374000,
            "arrival_amount":"59.000000000000",
            "fee":"1.000000000000",
            "status":0,
            "address":"0xe57b69a8776b37860407965B73cdFFBDFe668Bb5",
            "address_memo":"",
            "tx_id":""
        }
    }
}

Get Margin Account Details(Isolated)

Applicable for isolated margin account inquiries (Authentication type:KEYED, See Interface Permission)

Request Format

GET https://api-cloud.bitmart.com/spot/v1/margin/isolated/account

Request Limit

See Detailed Rate Limit

Request Parameter

Request

curl https://api-cloud.bitmart.com/spot/v1/margin/isolated/account

Response Data

Response

{
    "message":"OK",
    "code":1000,
    "trace":"f7f74924-14da-42a6-b7f2-d3799dd9a612",
    "data":{
      "symbols":[
        {
          "symbol": "BTC_USDT",
          "risk_rate": "18.77",
          "risk_level": "1",
          "buy_enabled": true,
          "sell_enabled": true,
          "liquidate_price": "-0.09408905",
          "liquidate_rate": "1.1",
          "base": {
            "currency": "BTC",
            "borrow_enabled": false,
            "borrowed": "2.00000000",
            "borrow_unpaid": "0.84478234",
            "interest_unpaid": "0.01385763",
            "available": "112.89603334",
            "frozen": "0.00000000",
            "net_asset": "110.89603334",
            "net_assetBTC": "0.00000000",
            "total_asset": "112.89603334"
          },
          "quote": {
            "currency": "USDT",
            "borrow_enabled": true,
            "borrowed": "0.00000000",
            "borrow_unpaid": "0.84478234",
            "interest_unpaid": "0.01385763",
            "available": "10.00000000",
            "frozen": "0.00000000",
            "net_asset": "10.00000000",
            "net_assetBTC": "0.00000000",
            "total_asset": "10.00000000"
          }
        },
        ...
      ]
    }
}

Margin Asset Transfer

For fund transfers between a margin account and spot account (Authentication type:SIGNED, See Interface Permission)

Request Format

POST https://api-cloud.bitmart.com/spot/v1/margin/isolated/transfer

Request Limit

See Detailed Rate Limit

Request Parameter

Request

curl https://api-cloud.bitmart.com/spot/v1/margin/isolated/transfer

{
    "symbol":"BTC_USDT",
    "currency":"BTC",
    "amount":"1",
    "side":"in"
}

Response Data

Response

{
    "message":"OK",
    "code":1000,
    "trace":"f7f74924-14da-42a6-b7f2-d3799dd9a612",
    "data":{
      "transfer_id":"124532"
    }
}

Get Basic Fee Rate

For querying the base rate of the current user (Authentication type:KEYED, See Interface Permission)

Request Format

GET https://api-cloud.bitmart.com/spot/v1/user_fee

Request Limit

See Detailed Rate Limit

Request Parameter

Request

curl https://api-cloud.bitmart.com/spot/v1/user_fee

Response Data

Response

{
  "message":"OK",
  "code":1000,
  "trace":"0187ba0c876e4236ac191d9848a0f719.94.16778301620100121",
  "data":{
    "user_rate_type":0,
    "level":"LV1",
    "taker_fee_rate_A":"0.001",
    "maker_fee_rate_A":"0.001",
    "taker_fee_rate_B":"0.0025",
    "maker_fee_rate_B":"0.0025",
    "taker_fee_rate_C":"0.004",
    "maker_fee_rate_C":"0.004"
  }
}

Get Actual Trade Fee Rate

For the actual fee rate of the trading pairs (Authentication type:KEYED, See Interface Permission)

Request Format

GET https://api-cloud.bitmart.com/spot/v1/trade_fee

Request Limit

See Detailed Rate Limit

Request Parameter

Request

curl https://api-cloud.bitmart.com/spot/v1/trade_fee?symbol=BTC_USDT

Response Data

Response

{
  "message": "OK",
  "code": 1000,
  "trace": "87614aa8-5327-4fe2-aafc-02e2ddca7210",
  "data": {
    "symbol": "BTC_USDT",
    "buy_taker_fee_rate": "0.0008",
    "sell_taker_fee_rate": "0.0008",
    "buy_maker_fee_rate": "0.0006",
    "sell_maker_fee_rate": "0.0006"
  }
}

Spot / Margin Trading

Place Spot Order

Applicable for spot order placement (Authentication type:SIGNED, See Interface Permission)

Request Format

POST https://api-cloud.bitmart.com/spot/v1/submit_order

Request Limit

See Detailed Rate Limit

Request Parameter

Request

curl https://api-cloud.bitmart.com/spot/v1/submit_order

{
    "symbol":"BTC_USDT",
    "side":"buy",
    "type":"limit",
    "size":"10",
    "price":"7000"
}

Special Parameters for Limit Orders/PostOnly Orders/IOC Orders (type=limit/limit_maker/ioc)

Special Parameters for Market Orders (type=market)

Instruction

Buy-limit-maker

• When "order price">="market lowest selling price", the system will refuse to accept the order after the order is submitted

• When the "order price" <"the lowest selling price in the market", the order will be accepted by the system after the submission is successful

Sell-limit-maker

• When "order price" <= "market highest bid price", after the order is submitted, the system will refuse to accept the order

• When "order price"> "market highest bid price", the order will be accepted by the system after the submission is successful

Buy-ioc,Sell-ioc

• After the order is placed, all orders that cannot be filled immediately are cancelled immediately

Response Data

Response

{
  "code": 1000,
  "trace":"886fb6ae-456b-4654-b4e0-d681ac05cea1",
  "message": "OK",
  "data": {
    "order_id":1223181
  }
}

Place Spot Order (V2)

Applicable for spot order placement (Authentication type:SIGNED, See Interface Permission)

Request Format

POST https://api-cloud.bitmart.com/spot/v2/submit_order

Request Limit

See Detailed Rate Limit

Request Parameter

Request

curl https://api-cloud.bitmart.com/spot/v2/submit_order

{
    "symbol":"BTC_USDT",
    "side":"buy",
    "type":"limit",
    "size":"10",
    "price":"7000"
}

Special Parameters for Limit Orders/PostOnly Orders/IOC Orders (type=limit/limit_maker/ioc)

Special Parameters for Market Orders (type=market)

Instruction

Buy-limit-maker

• When "order price">="market lowest selling price", the system will refuse to accept the order after the order is submitted

• When the "order price" <"the lowest selling price in the market", the order will be accepted by the system after the submission is successful

• When "order price"*"order size"<minimum deal amount in the market, the system will refuse to accept the order after the order is submitted.

Sell-limit-maker

• When "order price" <= "market highest bid price", after the order is submitted, the system will refuse to accept the order

• When "order price"> "market highest bid price", the order will be accepted by the system after the submission is successful

• When "order price"*"order size"<minimum deal amount in the market, the system will refuse to accept the order after the order is submitted.