English
NAV
console

Welcome

欢迎来到Bitget API文档!点击这里直接开始

更新日志

2024年8月15日

接口 原限频 新限频
/api/margin/v1/isolated/order/placeOrder 10次/秒/UID 5次/秒/UID
/api/margin/v1/isolated/order/batchPlaceOrder 10次/秒/UID 5次/秒/UID
/api/margin/v1/isolated/order/cancelOrder 10次/秒/UID 5次/秒/UID
/api/margin/v1/isolated/order/batchCancelOrder 10次/秒/UID 5次/秒/UID

2023年08月11日

2023年08月08日

2023年04月11日

2023年03月28日

简介

API 简介

欢迎使用Bitget开发者文档!

此文档是Bitget API的唯一官方文档,Bitget API提供的能力会在此持续更新,请大家及时关注。

你可以通过点击上方菜单来切换获取不同业务的API,还可通过点击右上方的语言按钮来切换文档语言。

文档右侧是针对请求参数以及响应结果的示例。

更新关注

关于API新增、更新、下线等信息Bitget会提前发布公告进行通知,建议您关注和订阅我们的公告,及时获取相关信息。

您可以点击 这里 订阅公告。

联系我们

使用过程中如有问题或者建议,您可选择以下方式联系我们:

快速入门

接入准备

如需使用API ,请先登录网页端,完成API key的申请和权限配置,再据此文档详情进行开发和交易。

您可以点击 这里 创建 API Key。

每个用户可创建10组Api Key,每个Api Key可对应设置读取、交易两种权限。

权限说明如下:

创建成功后请务必记住以下信息:

SDK/代码示例

SDK(推荐)

Java | Python | GoLang | NodeJs | PHP

PostMan 示例

PostMan

接口类型

本章节主要为接口类型分以下两个方面:

公共接口

公共接口可用于获取配置信息和行情数据。公共请求无需认证即可调用。

私有接口

私有接口可用于订单管理和账户管理。每个私有请求必须使用规范的验证形式进行签名。

私有接口需要使用您的APIKey进行验证。

访问限制

本章节主要为访问限制:

Rest API

如果传入有效的APIKey 用APIKey限速;如果没有则拿公网IP限速。

限速规则:各个接口上有单独的说明,如果没有一般接口限速为 10次/秒。

API域名

您可以自行使用Rest API接入方式进行操作。

域名 REST API 建议使用
域名1 https://api.bitget.com 主域名
域名2 https://capi.bitget.com 备用域名

API验证

发起请求

所有REST请求的header都必须包含以下key:

API公开参数

side(交易方向)

字段 说明
sell
buy
liquidation-buy 结算-买入
liquidation-sell 结算-卖出
systemRepay-buy 系统还款-买入
systemRepay-sell 系统还款-卖出

orderType(订单类型)

字段 说明
limit 限价
market 市价

loanType(杠杆订单类型)

字段 说明
normal 普通下单
autoLoan 自动借款下单
autoRepay 自动还款下单
autoLoanAndRepay 自动借款还款下单

force(订单类型)

字段 说明
gtc 不用特殊控制类型订单
post_only postOnly类型订单
fok 全部成交或立即取消(FOK)
ioc 立即成交并取消剩余(IOC)

status(订单状态)

字段 说明
init 初始化,插入DB
new 未成交,orderbook中等待撮合
partial_fill 部分成交
full_fill 全部成交
cancelled 已撤销

marginType

字段 说明
transfer_in 转入资产
transfer_out 转出资产
borrow 借款
repay 还款
liquidation_fee 强平清算费
compensate 风险基金穿仓补偿
deal_in 成交入账(买入)
deal_out 成交出账(卖出)
confiscated 穿仓扣除
exchange_in 兑换收入,由系统帐户支出
exchange_out 兑换支出,由系统帐户收入
sys_exchange_in 系统帐户兑换收入,与兑换支出同时出现
sys_exchange_out 系统帐户兑换支出,与兑换收入同时出现

source

字段 说明
WEB web客户端
IOS ios客户端
ANDROID android客户端
API api客户端
SYS 系统

Flash repay status (一键还款状态)

字段 说明
BEGIN 开始还款
REPAYING 还款中
FINISH 还款结束

签名

ACCESS-SIGN的请求头是对 timestamp + method.toUpperCase() + requestPath + "?" + queryString + body 字符串(+表示字符串连接)使用 HMAC SHA256 方法加密,通过BASE64 编码输出而得到的。

签名各字段说明

queryString为空时,签名格式

timestamp + method.toUpperCase() + requestPath + body

queryString不为空时,签名格式

timestamp + method.toUpperCase() + requestPath + "?" + queryString + body

举例说明

获取最大可转出金额,以 USDT 为例:

生成待签名的字符串:

'1591089508404GET/api/margin/v1/cross/account/maxTransferOutAmount?coin=USDT'

借款,以 USDT 为例:

生成待签名的字符串:

'1561022985382POST/api/margin/v1/cross/account/borrow{"coin":"USDT","borrowAmount":"1"}'

生成最终签名的步骤

HMAC

第1步,将待签名字符串使用私钥secretkey进行hmac sha256加密

Signature = hmac_sha256(secretkey, Message)

第2步,对于Signature进行base64编码

Signature = base64.encode(Signature)

RSA

第一步,使用RSA私钥privateKey对待签名字符串进行SHA-256签名。

第二步,对生成的签名字符串进行编码为 base64 string,得到签名字符串进行接口请求。

HMAC 加密示例

Java

public static String generate(String timestamp, String method, String requestPath,
                                  String queryString, String body, String secretKey)
            throws CloneNotSupportedException, InvalidKeyException, UnsupportedEncodingException {

        method = method.toUpperCase();
        body = StringUtils.defaultIfBlank(body, StringUtils.EMPTY);
        queryString = StringUtils.isBlank(queryString) ? StringUtils.EMPTY : "?" + queryString;

        String preHash = timestamp + method + requestPath + queryString + body;
        System.out.println(preHash);
        byte[] secretKeyBytes = secretKey.getBytes(SignatureUtils.CHARSET);
        SecretKeySpec secretKeySpec = new SecretKeySpec(secretKeyBytes, SignatureUtils.HMAC_SHA256);
        Mac mac = (Mac) SignatureUtils.MAC.clone();
        mac.init(secretKeySpec);
        return Base64.getEncoder().encodeToString(mac.doFinal(preHash.getBytes(SignatureUtils.CHARSET)));
    }


public static void main(String[] args) throws Exception {
      String msg=generate("1659927638003","POST","/api/margin/v1/cross/account/borrow" ,null,"{"coin":"USDT","borrowAmount":"1"}","");
      System.out.println(msg);
    }

Python

def sign(message, secret_key):
    mac = hmac.new(bytes(secret_key, encoding='utf8'), bytes(message, encoding='utf-8'), digestmod='sha256')
    d = mac.digest()
    return base64.b64encode(d)


def pre_hash(timestamp, method, request_path, body):
    return str(timestamp) + str.upper(method) + request_path + body



if __name__ == '__main__':
    signStr = sign(pre_hash('1659927638003', 'POST', '/api/margin/v1/cross/account/borrow', str('{"coin":"USDT","borrowAmount":"1"}')), '')
    print(signStr)

RSA 签名示例

Java

import lombok.extern.slf4j.Slf4j;
import org.apache.commons.lang3.StringUtils;
import javax.crypto.Mac;
import javax.crypto.spec.SecretKeySpec;
import javax.management.RuntimeErrorException;
import java.io.UnsupportedEncodingException;
import java.security.InvalidKeyException;
import java.security.NoSuchAlgorithmException;
import java.util.Base64;
import org.springframework.util.Base64Utils;

@Slf4j
public class CheckSign {

    public static void main(String[] args) throws Exception {
        //GET sign example
//        String timestamp = "1684814440729";
//        String queryString = "symbol=btcusdt_umcbl&marginCoin=usdt";
//        String signContent = timestamp + "GET" + "/api/mix/v1/account/account?" + queryString;
//        String sign = generate(signContent);
//        log.info("sign:{}",sign);


        //POST sign example
        String timestamp = "1684814440729";
        String preContent = timestamp + "POST" + "/api/spot/v1/trade/orders";
        String body = "{\"symbol\":\"btcusdt_spbl\",\"quantity\":\"8\",\"side\":\"buy\",\"price\":\"1\",\"orderType\":\"limit\",\"clientOrderId\":\"bitget1233456\"}";
        String signContent = preContent + body;
        String sign = generate(signContent);
        log.info("sign:{}",sign);
    }



  /**
   *
   * @param content: the string to be signed
   * @return
   */
  private String generate(String content) {
    String privateKey = "-----BEGIN PRIVATE KEY-----\n" +
            "xxxxxxxxxxxxxxxxxxxx9w0BAQEFAASCBKgwggSkAgEAAoIBAQD5C1iP01MC9fh5\n" +
            "43mGx8WgJRAp3Xz9Tcqfz6HzoSg+zd8HVxKXRTXBwMDBfLxfQXobptz1tDlPUs+g\n" +
            "YI38X8XEBZi5U4EBaZ5qHxArBTimyNXX6WNL6hTw0MI238cGKiW0WvWd9v6Z6/LX\n" +
            "i6uFUiUEsZiiuHXcO7EKGuvBrVIRl57FzvOPD5QKfhVxcHr63NfEViAEQfQH4IN2\n" +
            "+mu+L8epkWkmbua4jILUP+LXvHN7ZMiWP9bouw3r4l6v0NJ4XyucSYJL9fJ81rsI\n" +
            "iUoD1S7xlSboujR4RSsFZKFyurE1c8XiU2aZ2qq+6vjby0ncE4dKVu5x/iJZ4gsL\n" +
            "bneZujBLAgMBAAECggEAD6cF5uw6QGpjNo30emMd6aXKsUbpbyYvgQHUxPIxDFl2\n" +
            "FgkD8xv3d/j8ZGzJjhcYbJp9MrgkDfc/c23+HomKbXqIkcVMy2DvAu523q1SVTE0\n" +
            "N4DEq+XHcSc9vaMs6BdIDWDWJRp8AAKTXba6jgOOrg/Xbwq25aOeyerNPHv/N3m3\n" +
            "VImJZVV+ZcetUZ82UdX7NkvV4qmRi8se47OXUT9aypzpvGbSukkqXuE4GtKGoybR\n" +
            "R1sJtU10ap3QvyVNshn2QJnRd3GN2UENDvZS3ZvSY6f/Cq7K/EAmrsstOdUB2Ihn\n" +
            "POnI9/MrghWFq/n3ekuArWc54bDai0deKFl9KvI2oQKBgQD9ekRFMB6ueRCCeoyg\n" +
            "TOGvvW3d7X7G90XKL1xKhrg6mYh65hfQaxbihfOcrneFOoc3BgZwnbAZpF+hlq9J\n" +
            "klu69adhYlMxP2nF3PGj5vPln9/rd6/gcFFE9o7zZhI166PsmlxQ7/N0SCnlao7y\n" +
            "HZQoeeFJ1xuvCHVlNsTR+XZ88QKBgQD7hckVvGxIftcZsHChP8TFcDAn1IsaVbyt\n" +
            "i1UZ5JPznSLTcdb8YPtFr9afiCJ4b2NqRe8gCpUCUi+urnoMMsqMxTUMopiLPh2S\n" +
            "SYaBgpQYUIDLpt+Wx06krbOOyXVZ8RtgYLMpMhFCsRyzovqe8/LZQfQKWfQGTAXS\n" +
            "qL5vdyiw+wKBgQC7DMDYdbwOcFRYlOq1WEarExTCUoHdfZfIrc5jSKsmwynN14H3\n" +
            "US9gFg1BsBWPATPKzO1vqU3Mfln7umC73/9FJgZQfOh7TRpW4saGduXAq4voDTiC\n" +
            "XR/7zh6LSuVhWPRsozRAnfF/+8i+/TVjQaSVgetYPB63uXw4JoRzlq1zYQKBgQDJ\n" +
            "7ASb25G+vX1n1TsGaNBKhR9TypEFylDXreTbDaMtTzg3Mcwa/qyarGiL2Fl8AEh6\n" +
            "d7xaJ8SqgVpgTRgUFO6BBozpINt/5ZUN7NL7w92qi25qkAQt4sGi+QQOnHMGisak\n" +
            "n90VNGmg9dkJ6cxzsXqDqiwF52M9bui5zthbWfkj4wKBgEFVT+jf235aihaS88Oj\n" +
            "MbR078tvsFiRBICHlYCIef7/a+gt7N1u9sEGlPspY3HuPamA39201BuItD9X83VR\n" +
            "Vg+HjkeQIIrxmfvZn1O8/l+ItSNUzQhX6T0cSdCo6KtmZLBQ6Zaw7r63GcdvSdR2\n" +
            "xxxxxxxxxxxxxxxxxxxxxxx\n" +
            "-----END PRIVATE KEY-----\n";
    try {
      String parsedPem = privateKey.replace("\n", "").trim();
      parsedPem = parsedPem
              .replace("-----BEGIN PRIVATE KEY-----", "")
              .replace("-----END PRIVATE KEY-----", "");
      PKCS8EncodedKeySpec priPKCS8 = new PKCS8EncodedKeySpec(Base64Utils.decodeFromString(parsedPem));
      KeyFactory keyFactory = KeyFactory.getInstance("RSA");
      PrivateKey priKey = keyFactory.generatePrivate(priPKCS8);
      Signature signature = Signature.getInstance("SHA256WithRSA");
      signature.initSign(priKey);
      signature.update(content.getBytes(StandardCharsets.UTF_8));
      String sign = Base64Utils.encodeToString(signature.sign());
      return sign;
    } catch (Exception ex) {
      throw new RuntimeException("create sign  failed", ex);
    }
  }

}

Python

import base64
import json
import time
import base64
from Crypto.Hash import SHA256
from Crypto.Signature import PKCS1_v1_5
from Crypto.PublicKey import RSA



def get_timestamp():
    return int(time.time() * 1000)


def rsa_sign(message, private_key):
  pri_key = RSA.importKey(private_key)
  encoded_param = SHA256.new(bytes(message, encoding='utf-8'))
  sign_str = PKCS1_v1_5.new(pri_key).sign(encoded_param)
  return base64.b64encode(sign_str).decode()


def pre_hash(timestamp, method, request_path, body):
    return str(timestamp) + str.upper(method) + request_path + body


def parse_params_to_str(params):
    url = '?'
    for key, value in params.items():
        url = url + str(key) + '=' + str(value) + '&'

    return url[0:-1]


if __name__ == '__main__':
    private_key = '''-----BEGIN PRIVATE KEY-----
XXXXXXXXXXANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQCdTR5gmwGH77wE
e0ljABC58EVhiw7fPXWhMh7gZwurQQ8M/I9/VA8lDjwwoGuuJ6enurdfwhpZxeZH
P3wdmwvD7XLESEXVuxJv5hdpI9m6ydInK9SA8IbaF4yYWp0l4N2mA44MzadA7QZq
bQtQPlyPZHeia5q/NZHFWCrCbW2lGAAWwrhQq9LceVIW75e213xtnps0pGlII7Ye
xLkoazuhC1X8YNSxlCdLOiz1GvOeVSeiSZx31o/O+rj7tDFpSgZJEXRmtGRoJkJy
10EGSrvUMezCVSOcb1hCExg4osK6rBKnDjFjwQvwvNNZq0JG+CkfH8eHAa7gSK50
In51go29AgMBAAECggEAEvYk30hQGu7PH0stQX3UhlVsR6HXnRlvgIrmJe7F/VLO
WaZoNdUQLktU/heYY1nsX8+mIyjmvEOayqPgdkEmXevVlcuQf38Zbduynr3vlRCX
AJnL9+8GkmucSxFBODuu/EAZc3mm27C2wUV7w6SAy9g0g6Os97ehZsSGAwHl4aye
i6KtB07LAA10Eh5Ptq4YAfCYiUO7j10pQ+DJKqN9N1eyjyw5eixEgCpudcbpCc9X
+EK6zxk8Ynr0ANX8/LwvokqgYBK1UIL6ear0dtKmeFU+KwrmkKZfXk8/Amr/O8Ot
iHTTr1SLyQKRzq3La149LMmNkUYxaMSV/KGTEV7ukQKBgQDQl/fA3mxXtQg2IjTB
cvDBGhB4c3haECWcP7TQWJDb30vxOKeq1k9YPUfegZga5zlyV28PAZnb0m5x07+0
OY4862brT+pje9OhQxfkAY6AtJaiIqhCcw5ew8Go/Ja1ML0jZESWG1MWBJtCcFTm
d3+n9yU1fB1Ze0adilYmyu7zwwKBgQDBDPJZgSj7YssPyRmo3bO0MjknfYBqXvwi
6TxV11mJRe5BJ9Rc2WXGfEm3DEn7TO/Wv0t7Yqm6/sXg5HzriN/PHlaVtE6wlXe7
3gpYKjlm99KO7KKWYqP812mASl6ydLX9QWozlOXjVhWMuSGqMWjut4J3P8jlkOJ6
pNq9c8/gfwKBgQCxwvAl8ubNj78hsuDWgsddKIMkwvKrfdsvXrMOYouAdLjZJvjs
A5q2jfKzUil3s9km8g/479pYlOn+Iv/Z7Lqke8/HdOFASoQ9h1nSuujgEgXUwkg1
6Ks0Ywqkoi0k2BY3FPnGGh8iQma1pdkUVn35fAq/m7e/S+kP1JY6lPIx1QKBgQCS
jxul67KLNrNmpot+ceGt2bseSd8l4jqU3nDZ0oW8+4Qnnu9QFhN4Hn9wIjpAOGaU
p+HMKFknB6h+Vbior98JxMSDHsHmuXKPA8DishumGlqV+vxsIzLQD1Ge/dbqsERB
olnYEyB7+KyfiyUNqjk5kcPQeHIyJk5qQaF21udoTQKBgDOMbtM0Nq7cd/SAHISR
VYIGGXRFNqAjLJW7DRJGxw3AEwxKG+nxNLeG7GsQDyPCvZSKwRpdpXRTh+6mzXqe
pQ6+33v2gOtez8Cwo6tgyKRi6QPObQk00vbrKEBTihP30m81rwBPzjwj7iKXxWgA
DJoVsaqGOaIf4qXXXXXXXXXX
-----END PRIVATE KEY-----'''


    timestamp = get_timestamp()
    request_path = "/api/mix/v1/order/placeOrder"
    # POST
    params = {"symbol": "TRXUSDT_UMCBL", "marginCoin": "USDT", "price": 0.0555, "size": 551, "side": "open_long", "orderType": "limit", "timeInForceValue": "normal"}
    body = json.dumps(params)
    sign = rsa_sign(pre_hash(timestamp, "POST", request_path, str(body)), private_key)
    print(sign)


    # GET
    body = ""
    request_path = "/api/mix/v1/account/account"
    params = {"symbol": "TRXUSDT_UMCBL", "marginCoin": "USDT"}
    request_path = request_path + parse_params_to_str(params)
    sign = rsa_sign(pre_hash(timestamp, "GET", request_path, str(body)), private_key)
    print(sign)

NodeJs

export function sign() {

    const private_key = '-----BEGIN PRIVATE KEY-----\n' +
        'XXXXXXXXXXANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQCdTR5gmwGH77wE\n' +
        'e0ljABC58EVhiw7fPXWhMh7gZwurQQ8M/I9/VA8lDjwwoGuuJ6enurdfwhpZxeZH\n' +
        'P3wdmwvD7XLESEXVuxJv5hdpI9m6ydInK9SA8IbaF4yYWp0l4N2mA44MzadA7QZq\n' +
        'bQtQPlyPZHeia5q/NZHFWCrCbW2lGAAWwrhQq9LceVIW75e213xtnps0pGlII7Ye\n' +
        'xLkoazuhC1X8YNSxlCdLOiz1GvOeVSeiSZx31o/O+rj7tDFpSgZJEXRmtGRoJkJy\n' +
        '10EGSrvUMezCVSOcb1hCExg4osK6rBKnDjFjwQvwvNNZq0JG+CkfH8eHAa7gSK50\n' +
        'In51go29AgMBAAECggEAEvYk30hQGu7PH0stQX3UhlVsR6HXnRlvgIrmJe7F/VLO\n' +
        'WaZoNdUQLktU/heYY1nsX8+mIyjmvEOayqPgdkEmXevVlcuQf38Zbduynr3vlRCX\n' +
        'AJnL9+8GkmucSxFBODuu/EAZc3mm27C2wUV7w6SAy9g0g6Os97ehZsSGAwHl4aye\n' +
        'i6KtB07LAA10Eh5Ptq4YAfCYiUO7j10pQ+DJKqN9N1eyjyw5eixEgCpudcbpCc9X\n' +
        '+EK6zxk8Ynr0ANX8/LwvokqgYBK1UIL6ear0dtKmeFU+KwrmkKZfXk8/Amr/O8Ot\n' +
        'iHTTr1SLyQKRzq3La149LMmNkUYxaMSV/KGTEV7ukQKBgQDQl/fA3mxXtQg2IjTB\n' +
        'cvDBGhB4c3haECWcP7TQWJDb30vxOKeq1k9YPUfegZga5zlyV28PAZnb0m5x07+0\n' +
        'OY4862brT+pje9OhQxfkAY6AtJaiIqhCcw5ew8Go/Ja1ML0jZESWG1MWBJtCcFTm\n' +
        'd3+n9yU1fB1Ze0adilYmyu7zwwKBgQDBDPJZgSj7YssPyRmo3bO0MjknfYBqXvwi\n' +
        '6TxV11mJRe5BJ9Rc2WXGfEm3DEn7TO/Wv0t7Yqm6/sXg5HzriN/PHlaVtE6wlXe7\n' +
        '3gpYKjlm99KO7KKWYqP812mASl6ydLX9QWozlOXjVhWMuSGqMWjut4J3P8jlkOJ6\n' +
        'pNq9c8/gfwKBgQCxwvAl8ubNj78hsuDWgsddKIMkwvKrfdsvXrMOYouAdLjZJvjs\n' +
        'A5q2jfKzUil3s9km8g/479pYlOn+Iv/Z7Lqke8/HdOFASoQ9h1nSuujgEgXUwkg1\n' +
        '6Ks0Ywqkoi0k2BY3FPnGGh8iQma1pdkUVn35fAq/m7e/S+kP1JY6lPIx1QKBgQCS\n' +
        'jxul67KLNrNmpot+ceGt2bseSd8l4jqU3nDZ0oW8+4Qnnu9QFhN4Hn9wIjpAOGaU\n' +
        'p+HMKFknB6h+Vbior98JxMSDHsHmuXKPA8DishumGlqV+vxsIzLQD1Ge/dbqsERB\n' +
        'olnYEyB7+KyfiyUNqjk5kcPQeHIyJk5qQaF21udoTQKBgDOMbtM0Nq7cd/SAHISR\n' +
        'VYIGGXRFNqAjLJW7DRJGxw3AEwxKG+nxNLeG7GsQDyPCvZSKwRpdpXRTh+6mzXqe\n' +
        'pQ6+33v2gOtez8Cwo6tgyKRi6QPObQk00vbrKEBTihP30m81rwBPzjwj7iKXxWgA\n' +
        'DJoVsaqGOaIf4qXXXXXXXXXX\n' +
        '-----END PRIVATE KEY-----\n'

    const ts = Date.now();
    const NodeRSA = require('node-rsa')
    const pri_key = new NodeRSA(private_key)

    //GET
    const ts = Date.now();
    const params = 'coin=USDT&startTime=1687744761000&endTime=1690336761929'
    const endpoint = '/api/spot/v1/wallet/withdrawal-list'
    const method = "GET"
    const pre_hash = String(ts) + method + endpoint + '?' + params
    const sign = pri_key.sign(pre_hash, 'base64', 'UTF-8')

    //POST
    const endpoint_post = '/api/spot/v1/trade/open-orders'
    const params_post = '{"symbol": "BTCUSDT_SPBL"}'
    const method_post = "POST"
    const pre_hash_post = String(ts) + method_post + endpoint_post + params_post
    const sign_post = pri_key.sign(pre_hash_post, 'base64', 'UTF-8')

    return sign
}

请求交互

所有请求基于Https协议,请求头信息中Content-Type 需要统一设置为: 'application/json'。

请求交互说明

成功

HTTP状态码200表示成功响应,并可能包含内容。如果响应含有内容,则将显示在相应的返回内容里面。

常见错误码

标准规范

时间戳

请求签名中的ACCESS-TIMESTAMP的单位是毫秒。请求的时间戳必须在API服务时间的30秒内,否则请求将被视为过期并被拒绝。 如果本地服务器时间和API服务器时间之间存在较大的偏差,那么我们建议您使用通过查询API服务器时间来更新http header。

限频规则

如果请求过于频繁系统将自动限制请求,并在http header中返回429 too many requests状态码。

请求格式

目前只有两种格式的请求方法:GET和POST

RestAPI

公共接口

全仓利率与最大可借数量配置

限速规则:10次/1s (IP)

HTTP请求 全仓利率与最大可借数量配置

请求参数

参数名 参数类型 是否必须 描述
coin String 币种

请求示例

curl "https://api.bitget.com/api/margin/v1/cross/public/interestRateAndLimit?coin=USDT"

返回数据:

{
    "code": "00000",
    "msg": "success",
    "requestTime": 1679382680927,
    "data": [
        {
            "coin": "USDT",
            "leverage": "3.00000000",
            "transferInAble": true,
            "borrowAble": true,
            "dailyInterestRate": "2.00000000",
            "yearlyInterestRate": "730.00000000",
            "maxBorrowableAmount": "143000.00000000",
            "vips": [
                {
                    "level": "0",
                    "dailyInterestRate": "2.00000000",
                    "yearlyInterestRate": "730.00000000",
                    "discountRate": "1.00000000"
                },
                {
                    "level": "1",
                    "dailyInterestRate": "1.94000000",
                    "yearlyInterestRate": "708.10000000",
                    "discountRate": "0.97000000"
                }
            ]
        }
    ]
}

返回值说明

返回字段 字段说明
coin 币种
leverage 杠杆倍数 default 3
transferInAble 是否可转入
borrowAble 是否可借
dailyInterestRate 非VIP的日利率
yearlyInterestRate 非VIP的年利率
maxBorrowableAmount 最大可借
vips vip 等级对象
> level VIP 等级
> dailyInterestRate VIP 日利率
> yearlyInterestRate VIP 年利率
> discountRate VIP 折扣,1表示无折扣

逐仓利率与最大可借数量配置

限速规则:10次/1s (IP)

HTTP请求 逐仓利率与最大可借数量配置

请求参数

参数名 参数类型 是否必须 描述
symbol String 币对 (例如:BTCUSDT)

请求示例

curl "https://api.bitget.com/api/margin/v1/isolated/public/interestRateAndLimit?symbol=BTCUSDT"

返回数据:

{
    "code": "00000",
    "msg": "success",
    "requestTime": 1679383100800,
    "data": [
        {
            "symbol": "BTCUSDT",
            "leverage": "10.00000000",
            "baseCoin": "BTC",
            "baseTransferInAble": true,
            "baseBorrowAble": true,
            "baseDailyInterestRate": "0.00004900",
            "baseYearlyInterestRate": "0.01788500",
            "baseMaxBorrowableAmount": "35.00000000",
            "baseVips": [
                {
                    "level": "0",
                    "dailyInterestRate": "0.00004900",
                    "yearlyInterestRate": "0.01788500",
                    "discountRate": "1.00000000"
                }
            ],
            "quoteCoin": "USDT",
            "quoteTransferInAble": true,
            "quoteBorrowAble": true,
            "quoteDailyInterestRate": "0.00004900",
            "quoteYearlyInterestRate": "0.01788500",
            "quoteMaxBorrowableAmount": "200000.00000000",
            "quoteVips": [
                {
                    "level": "0",
                    "dailyInterestRate": "0.00004900",
                    "yearlyInterestRate": "0.01788500",
                    "discountRate": "1.00000000"
                }
            ]
        }
    ]
}

返回值说明

返回字段 字段说明
symbol 币对
baseCoin 基础币币种
leverage 杠杆倍数 default 10
baseTransferInAble 基础币是否可转入
baseBorrowAble 基础币是否可借
baseDailyInterestRate 基础币非VIP的日利率
baseYearlyInterestRate 基础币非VIP的年利率
baseMaxBorrowableAmount 基础币最大可借
baseVips 基础币vip
> level VIP 等级
> dailyInterestRate VIP 日利率
> yearlyInterestRate VIP 年利率
> discountRate VIP 折扣,1表示无折扣
quoteCoin 计价币币种
quoteTransferInAble 计价币是否可转入
quoteBorrowAble 计价币是否可借
quoteDailyInterestRate 计价币非VIP日利率
quoteYearlyInterestRate 计价币非VIP年利率
quoteMaxBorrowableAmount 计价币非VIP最大可借
quoteVips 计价币vip
> level VIP 等级
> dailyInterestRate VIP 日利率
> yearlyInterestRate VIP 年利率
> discountRate VIP 折扣,1表示无折扣

全仓档位梯度配置

限速规则:10次/1s (IP)

HTTP请求 全仓档位梯度配置

请求参数

参数名 参数类型 是否必须 描述
coin String 币种

请求示例

curl "https://api.bitget.com/api/margin/v1/cross/public/tierData?coin=USDT"

返回数据:

{
    "code": "00000",
    "msg": "success",
    "requestTime": 1679383262245,
    "data": [
        {
            "tier": "1",
            "leverage": "3.00000000",
            "coin": "USDT",
            "maxBorrowableAmount": "143000.00000000",
            "maintainMarginRate": "0.10000000"
        }
    ]
}

返回值说明

返回字段 字段说明
tier 档位
leverage 有效杠杆倍数,全局默认3倍
coin 币种
maxBorrowableAmount 最大可借
maintainMarginRate 维持保证金率

逐仓档位梯度配置

限速规则:10次/1s (IP)

HTTP请求 逐仓档位梯度配置

请求参数

参数名 参数类型 是否必须 描述
symbol String 币对 (例如:BTCUSDT)

请求示例

curl "https://api.bitget.com/api/margin/v1/isolated/public/tierData?symbol=BTCUSDT"

返回数据:

{
    "code": "00000",
    "msg": "success",
    "requestTime": 1679383385514,
    "data": [
        {
            "tier": "1",
            "symbol": "BTCUSDT",
            "leverage": "10.00000000",
            "baseCoin": "BTC",
            "quoteCoin": "USDT",
            "baseMaxBorrowableAmount": "3.00000000",
            "quoteMaxBorrowableAmount": "20000.00000000",
            "maintainMarginRate": "0.05000000",
            "initRate": "0.11110000"
        }
    ]
}

返回值说明

返回字段 字段说明
tier 档位
symbol 币对
leverage 有效杠杆倍数,全局默认10倍
baseCoin 基础币币种
quoteCoin 计价币币种
baseMaxBorrowableAmount 基础币最大可借
quoteMaxBorrowableAmount 计价币最大可借
maintainMarginRate 维持保证金率
initRate 初始保证金率

支持杠杆的所有币对

限速规则:10次/1s (IP)

HTTP请求 获取支持杠杆的所有币对

请求示例

curl "https://api.bitget.com/api/margin/v1/public/currencies"

返回数据:

{
    "code": "00000",
    "msg": "success",
    "requestTime": 1679383565084,
    "data": [
        {
            "symbol": "ETHUSDT",
            "baseCoin": "ETH",
            "quoteCoin": "USDT",
            "maxCrossLeverage": "3",
            "maxIsolatedLeverage": "10",
            "warningRiskRatio": "0.80000000",
            "liquidationRiskRatio": "1.00000000",
            "minTradeAmount": "0.00010000",
            "maxTradeAmount": "10000.00000000",
            "takerFeeRate": "0.00100000",
            "makerFeeRate": "0.00100000",
            "priceScale": "4",
            "quantityScale": "4",
            "minTradeUSDT": "5.00000000",
            "isBorrowable": true,
            "userMinBorrow": "0.00000001",
            "status": "1"
        }
    ]
}

返回值说明

返回字段 字段说明
symbol 币对名称
baseCoin 基础币
quoteCoin 计价币
maxCrossLeverage 全仓最大杠杆倍数, 0表示不支持全仓杠杆交易
maxIsolatedLeverage 逐仓最大杠杆倍数,0表示不支持逐仓杠杆交易
warningRiskRatio 预警风险率
liquidationRiskRatio 强平风险率
minTradeAmount 最小交易金额
maxTradeAmount 最大交易金额
takerFeeRate taker 费率
makerFeeRate maker 费率
priceScale 价格精度
quantityScale 数量精度
minTradeUSDT 最小交易usdt
isBorrowable 是否可借
userMinBorrow 最小借款
status 0:下架(前端页面不现实) 1:可交易 2:临时维护(不可交易,前段页面现实)

账户接口

获取全仓杠杆账户资产

限速规则:10次/1s

HTTP请求 获取账户资产

请求参数

参数名 参数类型 是否必须 描述
coin String 币种

请求示例

curl "https://api.bitget.com/api/margin/v1/cross/account/assets?coin=USDT" \
  -H "ACCESS-KEY:you apiKey" \
  -H "ACCESS-SIGN:*******" \
  -H "ACCESS-PASSPHRASE:*****" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json"

返回数据

{
    "code": "00000",
    "msg": "success",
    "requestTime": 1679383872196,
    "data": [
        {
            "coin": "USDT",
            "totalAmount": "96245.92605537",
            "available": "90745.92605537",
            "frozen": "5500.00000000",
            "borrow": "0.00001153",
            "interest": "0.00028974",
            "net": "96245.92575410",
            "ctime": "1673342905288"
        }
    ]
}

返回值说明

返回字段 字段说明
coin 币种名称
totalAmount 总金额
available 可用金额
frozen 冻结资产
borrow 借款
interest 利息,还款时先息后本,最小还款为利息
net 净资产 = available + frozen - borrow - interest, 到了mmr(维持保证金率)就爆仓
ctime 创建时间

获取逐仓杠杆账户资产

限速规则:10次/1s

HTTP请求

获取账户资产

请求参数

参数名 参数类型 是否必须 描述
symbol String 币对 (例如:BTCUSDT)

请求示例

curl "https://api.bitget.com/api/margin/v1/isolated/account/assets?symbol=BTCUSDT" \
  -H "ACCESS-KEY:you apiKey" \
  -H "ACCESS-SIGN:*******" \
  -H "ACCESS-PASSPHRASE:*****" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json"

返回数据

{
    "code": "00000",
    "msg": "success",
    "requestTime": 1679384019309,
    "data": [
        {
            "symbol": "BTCUSDT",
            "coin": "BTC",
            "totalAmount": "0.80089820",
            "available": "0.80089820",
            "frozen": "0.00000000",
            "borrow": "0.00000000",
            "interest": "0.00000000",
            "net": "0.80089820",
            "ctime": "1673341108446"
        }
    ]
}

返回值说明

返回字段 字段说明
coin 币种名称
symbol 币对名称
totalAmount 总金额
available 可用金额
frozen 冻结资产
borrow 借款
interest 利息,还款时先息后本,最小还款为利息
net 净资产 = available + frozen - borrow - interest, 风险率达到1就爆仓
ctime 创建时间

全仓借款接口

限速规则:10次/1s

HTTP请求 全仓借款接口

请求参数

参数名 参数类型 是否必须 描述
coin String 借出币种
borrowAmount String 借出数量(最长8位小数)

请求示例

curl "https://api.bitget.com/api/margin/v1/account/crossed/borrowing" \
  -H "ACCESS-KEY:you apiKey" \
  -H "ACCESS-SIGN:*******" \
  -H "ACCESS-PASSPHRASE:*****" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json"
  -d \'{"coin": "USDT","borrowAmount": "1"}'

返回数据

{
    "code": "00000",
    "msg": "success",
    "requestTime": 1679384172820,
    "data": {
        "clientOid": null,
        "coin": "USDT",
        "borrowAmount": "1.00000000"
    }
}

返回值说明

返回字段 字段说明
clientOid 客户端唯一标识(暂时不支持)
coin 借出币种
borrowAmount 借出数量

逐仓借款接口

限速规则:10次/1s

HTTP请求 逐仓借款接口

请求参数

参数名 参数类型 是否必须 描述
symbol String 借出币对 (例如:BTCUSDT)
coin String 借出币种
borrowAmount String 借出数量(最长为8位小数)

请求示例

curl "https://api.bitget.com/api/margin/v1/isolated/account/borrow" \
  -H "ACCESS-KEY:you apiKey" \
  -H "ACCESS-SIGN:*******" \
  -H "ACCESS-PASSPHRASE:*****" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json"
  -d \'{"coin": "USDT","borrowAmount": "1","symbol": "BTCUSDT"}'

返回数据

{
    "code": "00000",
    "msg": "success",
    "requestTime": 1679384491703,
    "data": {
        "clientOid": null,
        "symbol": "BTCUSDT",
        "coin": "USDT",
        "borrowAmount": "1.00000000"
    }
}

返回值说明

返回字段 字段说明
clientOid 客户端唯一标识 (暂时不支持)
coin 借出币种
borrowAmount 借出数量
symbol 借出币对

全仓还款接口

限速规则:10次/1s

HTTP请求 全仓还款接口

请求参数

参数名 参数类型 是否必须 描述
coin String 还款币种
repayAmount String 还款数量 (最长为8位小数)

请求示例

curl "https://api.bitget.com/api/margin/v1/cross/account/repay" \
  -H "ACCESS-KEY:you apiKey" \
  -H "ACCESS-SIGN:*******" \
  -H "ACCESS-PASSPHRASE:*****" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json"
  -d \'{"coin": "USDT","repayAmount": "1"}'

返回数据

{
    "code": "00000",
    "msg": "success",
    "requestTime": 1679384677925,
    "data": {
        "remainDebtAmount": "0.08363461",
        "clientOid": null,
        "coin": "USDT",
        "repayAmount": "1.00000000"
    }
}

返回值说明

返回字段 字段说明
remainDebtAmount 剩余欠款
clientOid 客户端唯一标识 (暂时不支持)
coin 币种
repayAmount 还款金额

逐仓还款接口

限速规则:10次/1s

HTTP请求 逐仓还款接口

请求参数

参数名 参数类型 是否必须 描述
repayAmount String 还款数量 (最长为8位小数)
coin String 还款币种
symbol String 还款币对 (例如:BTCUSDT)

请求示例

curl "https://api.bitget.com/api/margin/v1/isolated/account/repay" \
  -H "ACCESS-KEY:you apiKey" \
  -H "ACCESS-SIGN:*******" \
  -H "ACCESS-PASSPHRASE:*****" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json"
  -d \'{"coin": "USDT","repayAmount": "1","symbol":"BTCUSDT"}'

返回数据

{
    "code": "00000",
    "msg": "success",
    "requestTime": 1679384795979,
    "data": {
        "remainDebtAmount": "0.00001658",
        "clientOid": null,
        "symbol": "BTCUSDT",
        "coin": "USDT",
        "repayAmount": "1.00000000"
    }
}

返回值说明

返回字段 字段说明
remainDebtAmount 剩余欠款
clientOid 客户端唯一标识 (暂时不支持)
symbol 币对
coin 币种
repayAmount 还款金额

全仓风险率接口

限速规则 10次/1s

HTTP请求

请求参数

参数名 参数类型 是否必须 描述
coin String 币种

请求示例

curl "https://api.bitget.com/api/margin/v1/cross/account/riskRate?coin=BTC" \
  -H "ACCESS-KEY:you apiKey" \
  -H "ACCESS-SIGN:*******" \
  -H "ACCESS-PASSPHRASE:*****" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json" \

返回数据

{
    "code": "00000",
    "msg": "success",
    "requestTime": 1679385025143,
    "data": {
        "riskRate": "0.00000000"
    }
}

返回值说明

返回字段 字段说明
riskRate 风险率 (全仓总资产/全仓总负债)

逐仓风险率接口

限速规则 10次/1s

HTTP请求

请求参数

参数名 参数类型 是否必须 描述
symbol String 币对 (例如:BTCUSDT)
pageNum String 页码,默认1
pageSize String 每页大小,默认100,最大500

请求示例

curl "https://api.bitget.com/api/margin/v1/isolated/account/riskRate" \
  -H "ACCESS-KEY:you apiKey" \
  -H "ACCESS-SIGN:*******" \
  -H "ACCESS-PASSPHRASE:*****" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json"
  -d \'{"symbol": "BTCUSDT"}'

返回数据

{
    "code": "00000",
    "msg": "success",
    "requestTime": 1679385103180,
    "data": [
        {
            "symbol": "BTCUSDT",
            "riskRate": "0.00000000"
        }
    ]
}

返回值说明

返回字段 字段说明
symbol 币对
riskRate 风险率 (逐仓资产/逐仓负债)

全仓最大可借数量接口

限速规则 10次/1s

HTTP请求

请求参数

参数名 参数类型 是否必须 描述
coin String 币种

请求示例

curl -X POST "https://api.bitget.com/api/margin/v1/cross/account/maxBorrowableAmount" \
  -H "ACCESS-KEY:you apiKey" \
  -H "ACCESS-SIGN:*******" \
  -H "ACCESS-PASSPHRASE:*****" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json"
  -d \'{"coin": "USDT"}'

返回数据

{
    "code": "00000",
    "msg": "success",
    "requestTime": 1679385348895,
    "data": {
        "maxBorrowableAmount": "142999.91636538",
        "coin": "USDT"
    }
}

返回值说明

返回字段 字段说明
maxBorrowableAmount 最大可借数量 (数值会实时变化)
coin 币种

逐仓最大可借数量接口

限速规则 10次/1s

HTTP请求

请求参数

参数名 参数类型 是否必须 描述
coin String 币种
symbol String 币对 (例如:BTCUSDT)

请求示例

curl -X POST "https://api.bitget.com/api/margin/v1/isolated/account/maxBorrowableAmount" \
  -H "ACCESS-KEY:you apiKey" \
  -H "ACCESS-SIGN:*******" \
  -H "ACCESS-PASSPHRASE:*****" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json"
  -d \'{"coin": "USDT","symbol":"BTCUSDT"}'

返回数据

{
    "code": "00000",
    "msg": "success",
    "requestTime": 1679385484178,
    "data": {
        "symbol": "BTCUSDT",
        "coin": "USDT",
        "maxBorrowableAmount": "199999.99998342"
    }
}

返回值说明

返回字段 字段说明
symbol 币对
coin 币种
maxBorrowableAmount 最大可借数量 (数值会实时变化)

全仓最大可转出数量接口

限速规则 10次/1s

HTTP请求

请求参数

参数名 参数类型 是否必须 描述
coin String 币种

请求示例

curl "https://api.bitget.com/api/margin/v1/cross/account/maxTransferOutAmount?coin=USDT" \
  -H "ACCESS-KEY:you apiKey" \
  -H "ACCESS-SIGN:*******" \
  -H "ACCESS-PASSPHRASE:*****" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json"

返回数据

{
    "code": "00000",
    "msg": "success",
    "requestTime": 1679385546229,
    "data": {
        "coin": "USDT",
        "maxTransferOutAmount": "90745.92605537"
    }
}

返回值说明

返回字段 字段说明
coin 币种
maxTransferOutAmount 最大可转出数量

逐仓最大可转出数量接口

限速规则 10次/1s

HTTP请求

请求参数

参数名 参数类型 是否必须 描述
coin String 币种
symbol String 币对 (例如:BTCUSDT)

请求示例

curl "https://api.bitget.com/api/margin/v1/isolated/account/maxTransferOutAmount?coin=USDT&symbol=BTCUSDT" \
  -H "ACCESS-KEY:you apiKey" \
  -H "ACCESS-SIGN:*******" \
  -H "ACCESS-PASSPHRASE:*****" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json"

返回数据

{
    "code": "00000",
    "msg": "success",
    "requestTime": 1679385605021,
    "data": {
        "coin": "USDT",
        "symbol": "BTCUSDT",
        "maxTransferOutAmount": "85665.92083922"
    }
}

返回值说明

返回字段 字段说明
coin 币种
symbol 币对
maxTransferOutAmount 最大可转出数量

 

 

 

 

 

 

 

 

 

 

逐仓一键还款

限速规则 10次/1s (uid)

HTTP请求

请求示例

curl "https://api.bitget.com/api/margin/v1/isolated/account/flashRepay" \
  -H "ACCESS-KEY:you apiKey" \
  -H "ACCESS-SIGN:*******" \
  -H "ACCESS-PASSPHRASE:*****" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json" \
 -d \'{
    "symbols": ["BTCUSDT", "ETHUSDT"]
}'

请求参数

参数名 参数类型 是否必须 描述
symbols List 逐仓交易对/不传还全部(数组最大100个)

返回数据


{
  "code":"00000",
  "msg":"success",
  "requestTime":163123213132,
  "data": [
    {
      "id":"3423423",
      "symbol":"BTCUSDT",
      "code": "success"
    },
    {
      "id":"3423423",
      "symbol":"ETHUSDT",
      "code": "success"
    }
  ]

}

返回值说明

返回字段 字段说明
id 还款id
symbol 杠杆symbol交易对
code success还款请求成功

 

 

 

 

 

 

 

 

 

 

查询逐仓还款结果

限速规则 10次/1s (uid)

HTTP请求

请求示例

curl "https://api.bitget.com/api/margin/v1/isolated/account/queryFlashRepayStatus" \
  -H "ACCESS-KEY:you apiKey" \
  -H "ACCESS-SIGN:*******" \
  -H "ACCESS-PASSPHRASE:*****" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json" \
 -d \'{
    "idList": ["13423423", "36278902"]
}'

请求参数

参数名 参数类型 是否必须 描述
idList List yes 发起还款单请求id集合(最大100个id)

返回数据


{
  "code":"00000",
  "msg":"success",
  "requestTime":163123213132,
  "data": [
    {
      "id":"13423423",
      "status":"FINISH"

    },
    {
      "id":"36278902",
      "status":"FINISH"
    }
  ]
}

返回值说明

返回字段 字段说明
id 还款ID
status 还款结果状态

 

 

 

 

 

 

 

 

 

 

全仓一键还款

限速规则 10次/1s (uid)

HTTP请求

请求示例

curl "https://api.bitget.com/api/margin/v1/cross/account/flashRepay" \
  -H "ACCESS-KEY:you apiKey" \
  -H "ACCESS-SIGN:*******" \
  -H "ACCESS-PASSPHRASE:*****" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json" \
 -d \'{
    "coin": "BTC"
}'

请求参数

参数名 参数类型 是否必须 描述
coin String 全仓币种, 不传则是全仓所有币种全部还款

返回数据

{
  "code":"00000",
  "msg":"success",
  "requestTime":163123213132,
  "data": {
    "id":"23423423423432",
    "coin":"BTC"
  }
}

返回值说明

返回字段 字段说明
id 还款id
coin 还款币种,如果是还全部,则coin没有值返回

 

 

 

 

 

 

 

 

 

 

获取直客账户余额列表

限速规则 10次/1s (uid)

HTTP请求

请求示例

curl "https://api.bitget.com/api/margin/v1/cross/account/queryFlashRepayStatus" \
  -H "ACCESS-KEY:you apiKey" \
  -H "ACCESS-SIGN:*******" \
  -H "ACCESS-PASSPHRASE:*****" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json" \
 -d \'{
    "idList": ["13423423", "36278902"]
}'

请求参数

参数名 参数类型 是否必须 描述
idList List yes 发起平仓单请求id集合(最大100个id)

返回数据 ```Json

{ "code":"00000", "msg":"success", "requestTime":163123213132, "data": [ { "id":"13423423", "status":"FINISH"

}, { "id":"36278902", "status":"FINISH" } ] } ```

返回值说明

返回字段 字段说明
id 还款ID
status 还款结果状态

逐仓订单和交易记录接口

逐仓下单接口

限速规则 5次/1s

HTTP请求

请求参数

参数名 参数类型 是否必须 描述
symbol String 币对 (例如:BTCUSDT)
orderType String 订单类型 orderType
price String 价格
loanType String 杠杆订单模式 orderType
timeInForce String 订单策略 force
baseQuantity String limit必填,market sell 必填,卖单代表baseCoin(左币)数量
quoteAmount String market buy必填,买单代表quote Coin(右币)数量
clientOid String 自定义ID
side String buy or sell side

请求示例

curl "https://api.bitget.com/api/margin/v1/isolated/order/placeOrder" \
  -H "ACCESS-KEY:you apiKey" \
  -H "ACCESS-SIGN:*******" \
  -H "ACCESS-PASSPHRASE:*****" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json" \
  -d \'{
    "symbol": "BTCUSDT",
    "side": "buy",
    "price":"15100",
    "orderType": "limit",
    "timeInForce": "gtc",
    "baseQuantity": "0.1",
    "clientOid":"clientOid001",
    "loanType":"normal"
}

'

返回数据

{
  "code":"00000",
  "msg":"success",
  "requestTime":163123213132,
  "data":{
    "orderId":"1001",
    "clientOid":"clientOid001"
  }
}

返回值说明

返回字段 字段说明
orderId 订单ID
clientOid 自定义ID

 

 

 

 

 

 

 

 

 

 

 

 

逐仓批量下单接口

限速规则 5次/1s

HTTP请求

请求参数

参数名 参数类型 是否必须 描述
symbol String 币对 (例如:BTCUSDT)
orderList array 订单条目

orderList

参数名 参数类型 是否必须 描述
orderType String 订单类型 orderType
price String 价格
loanType String 杠杆订单模式 loanType
timeInForce String 订单策略 force
baseQuantity String limit必填,market sell 必填,卖单代表baseCoin(左币)数量
quoteAmount String market buy必填,买单代表quote Coin(右币)数量
clientOid String 自定义ID
side String buy or sell side

请求示例

curl "https://api.bitget.com/api/margin/v1/isolated/order/batchPlaceOrder" \
  -H "ACCESS-KEY:you apiKey" \
  -H "ACCESS-SIGN:*******" \
  -H "ACCESS-PASSPHRASE:*****" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json" \
 -d \'{
    "symbol": "BTCUSDT",
    "orderList": [
        {
            "side": "buy",
            "price":"23100",
            "orderType": "limit",
            "timeInForce": "gtc",
            "baseQuantity": "0.1",
            "loanType":"normal"
        }
    ]
}'

返回数据

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1666336231317,
  "data": {
    "resultList": [
      {
        "orderId": "96724974842718610",
        "clientOid": "qqq#1044sdf1343"
      }
    ],
    "failure": [
      {
        "clientOid": "qqq#1666185450114",
        "errorMsg": "clientOid duplicate"
      }
    ]
  }
}

返回值说明

返回字段 字段说明
resultList 成功下单响应array
> orderId 订单Id
> clientOid 客户端自定义Id
failure 失败下单array
> clientOid 客户端自定义Id
> errorMsg 错误信息

逐仓撤单接口

限速规则 5次/1s

HTTP请求

请求参数

参数名 参数类型 是否必须 描述
symbol String 交易对 (例如:BTCUSDT)
orderId String 订单ID (orderId he clientOid 二选一)
clientOid String 客户自定义ID (orderId he clientOid 二选一)

请求示例

curl "https://api.bitget.com/api/margin/v1/isolated/order/cancelOrder" \
  -H "ACCESS-KEY:you apiKey" \
  -H "ACCESS-SIGN:*******" \
  -H "ACCESS-PASSPHRASE:*****" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json" \
 -d \'{
    "symbol": "BTCUSDT",
    "orderId": "3242384623846284238"
}'

请求参数

参数名 参数类型 是否必须 描述
symbol String 币对
orderList array 订单条目

orderList

参数名 参数类型 是否必须 描述
orderType String 订单类型
price String 价格
loanType String 杠杆订单模式
timeInForce String 订单策略
baseQuantity String limit必填,market sell 必填,卖单代表baseCoin(左币)数量
quoteAmount String market buy必填,买单代表quote Coin(右币)数量
clientOid String 自定义ID
side String buy or sell

返回数据

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1666336231317,
  "data": {
    "resultList": [
      {
        "orderId": "96724974842718610",
        "clientOid": "qqq#1044sdf1343"
      }
    ],
    "failure": [
      {
        "clientOid": "qqq#1666185450114",
        "orderId": "96724974842718610",
        "errorMsg": "clientOid duplicate"
      }
    ]
  }
}

返回值说明

返回字段 字段说明
resultList 成功下单响应array
> orderId 订单Id
> clientOid 客户端自定义Id
failure 失败下单array
> clientOid 客户端自定义Id
> orderId 订单ID
> errorMsg 错误信息

逐仓批量撤单接口

限速规则 5次/1s

HTTP请求

请求参数

参数名 参数类型 是否必须 描述
symbol String 交易对 (例如:BTCUSDT)
orderIds array 订单ID集合 (orderIds和clientOids二选一)
clientOids array 客户自定义ID集合 (orderIds和clientOids二选一)

请求示例

curl "https://api.bitget.com/api/margin/v1/isolated/order/batchCancelOrder" \
  -H "ACCESS-KEY:you apiKey" \
  -H "ACCESS-SIGN:*******" \
  -H "ACCESS-PASSPHRASE:*****" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json" \
 -d \'{
    "symbol": "BTCUSDT",
    "orderIds": ["3242384623846284238"]
}'

返回数据

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1666336231317,
  "data": {
    "resultList": [
      {
        "orderId": "96724974842718610",
        "clientOid": "qqq#1044sdf1343"
      }
    ],
    "failure": [
      {
        "clientOid": "qqq#1666185450114",
        "errorMsg": "clientOid duplicate"
      }
    ]
  }
}

返回值说明

返回字段 字段说明
resultList 成功下单响应array
> orderId 订单Id
> clientOid 客户端自定义Id
failure 失败下单array
> clientOid 客户端自定义Id
> errorMsg 错误信息

获取当前委托

限速规则: 10次/1s (uid)

HTTP请求

请求参数

参数名 参数类型 是否必须 描述
symbol String 交易对 (例如:BTCUSDT)
orderId String 订单ID
clientOid String 客户自定义ID
startTime String 开始时间, ms, 值需要在90天内
endTime String 结束时间
pageSize String 查询条数

请求示例

curl "https://api.bitget.com/api/margin/v1/isolated/order/openOrders?symbol=BTCUSDT_UMCBL&startTime=1659403328000&endTime=1659410528000&pageSize=20" \
  -H "ACCESS-KEY:you apiKey" \
  -H "ACCESS-SIGN:*******" \
  -H "ACCESS-PASSPHRASE:*****" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json"

返回数据

{
  "code":"00000",
  "message":"success",
  "data":{
    "orderList":[{
      "symbol":"btcusdt",
      "orderType":"limit", 
      "source":"API",
      "orderId":"2222222",
      "clientOid":"xxxxxxx",
      "price":"17000",
      "loanType":"autoLoan",
      "timeInForce":"gtc",
      "side":"buy",
      "status":"new",
      "baseQuantity":"1",
      "quoteAmount":"17000",
      "fillPrice":"17000",
      "fillQuantity":"1", 
      "fillTotalAmount":"17000",  
      "cTime":"1622697148000" 
    }],
    "maxId":"2222222",
    "minId":"2222222"
  }
}

返回值说明

返回字段 字段说明
symbol 交易对名称
orderId 订单号
clientOid 客户端自定义id
fillQuantity 成交数量
fillPrice 成交价格
fillTotalAmount 成交金额
timeInForce 下单策略 force
price 委托价格
source 订单来源 source
status 订单状态 status
side 开单方向 side
baseQuantity 基础币数量
quoteAmount 计价币数量
orderType 订单类型 orderType
cTime 创建时间
loanType 杠杆订单策略 loanType

获取历史委托

限速规则: 10次/1s (uid)

HTTP请求

请求参数

参数名 参数类型 是否必须 描述
symbol String 交易对 (例如:BTCUSDT)
orderId String 订单ID
source String 下单来源
clientOid String 客户自定义ID
startTime String 开始时间, ms, 值需要在90天内
endTime String 结束时间
pageSize String 查询条数
minId String 翻页ID,接口返回minId (上一次查询返回的minId,返回ID小于minId的数据)

请求示例

curl "https://api.bitget.com/api/margin/v1/isolated/order/history?symbol=BTCUSDT&startTime=1659403328000&endTime=1659410528000&pageSize=20" \
  -H "ACCESS-KEY:you apiKey" \
  -H "ACCESS-SIGN:*******" \
  -H "ACCESS-PASSPHRASE:*****" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json"

返回数据

{
  "code":"00000",
  "message":"success",
  "data":{
    "orderList":[{
      "symbol":"btcusdt",
      "orderType":"limit", 
      "source":"API",
      "orderId":"2222222",
      "clientOid":"xxxxxxx",
      "price":"17000",
      "loanType":"autoLoan",
      "timeInForce":"gtc",
      "side":"buy",
      "status":"new",
      "baseQuantity":"1",
      "quoteAmount":"17000",
      "fillPrice":"17000",
      "fillQuantity":"1", 
      "fillTotalAmount":"17000",  
      "cTime":"1622697148000" 
    }],
    "maxId":"2222222",
    "minId":"2222222"
  }
}

返回值说明

返回字段 字段说明
symbol 交易对名称
orderId 订单号
clientOid 客户端自定义id
fillQuantity 成交数量
fillPrice 成交价格
fillTotalAmount 成交金额
timeInForce 下单策略 force
price 委托价格
source 订单来源 source
status 订单状态 status
side 开单方向 side
baseQuantity 基础币数量
quoteAmount 计价币数量
orderType 订单类型 orderType
cTime 创建时间
loanType 杠杆订单策略 loanType

获取成交明细

限速规则: 10次/1s (uid)

HTTP请求

请求参数

参数名 参数类型 是否必须 描述
symbol String 交易对 (例如:BTCUSDT)
orderId String 订单ID
lastFillId String 撮合ID, 翻页相关参数,首次查询不传,查询第二页及后面的数据时,取上一次查询返回的lastFillId,结果会返回小于该值的数据;可以缩短查询响应时间
startTime String 开始时间
endTime String 结束时间
pageSize String 查询条数

请求示例

curl "https://api.bitget.com/api/margin/v1/isolated/order/fills?symbol=BTCUSDT&startTime=1659403328000&endTime=1659410528000&pageSize=20" \
  -H "ACCESS-KEY:you apiKey" \
  -H "ACCESS-SIGN:*******" \
  -H "ACCESS-PASSPHRASE:*****" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json"

返回数据

{
  "code":"00000",
  "message":"success",
  "requestTime":"1622697148000",
  "data":{
    "resultList":[
      {
        "orderId":"100021",
        "fillId":"102211",
        "orderType":"limit",
        "side":"buy",
        "fillPrice":"38293.12",
        "fillQuantity":"1",
        "fillTotalAmount":"38293.12",
        "cTime":"1622697148000",
        "feeCcy":"USDT",
        "fees":"0.0001"
      }
    ],
    "maxId":"102211",
    "minId":"102211"
  }
}

返回值说明

返回字段 字段说明
symbol 交易对名称
orderId 订单号
fillId 成交明细ID
fillQuantity 成交数量
fillPrice 成交价格
fillTotalAmount 成交金额
side 开单方向 side
feeCcy 手续费币种
orderType 订单类型 orderType
cTime 创建时间
fees 手续费

获取逐仓借款历史纪录

限速规则: 10次/1s (uid)

HTTP请求

请求参数

参数名 参数类型 是否必须 描述
symbol String 交易对 (例如:BTCUSDT)
loanId String 借款ID(单条数据精准匹配)
coin String 币种
startTime String 开始时间
endTime String 结束时间
pageSize String 查询条数
pageId String 查询返回的minId,以进行翻页 (上一次查询返回的minId,返回ID小于minId的数据)

请求示例

curl "https://api.bitget.com/api/margin/v1/isolated/loan/list?symbol=BTCUSDT&startTime=1659403328000&endTime=1659410528000&pageSize=20" \
  -H "ACCESS-KEY:you apiKey" \
  -H "ACCESS-SIGN:*******" \
  -H "ACCESS-PASSPHRASE:*****" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json"

返回数据

{
  "code":"00000",
  "message":"success",
  "data":{
    "resultList":[
      {
        "loanId":"34234234234324",
        "symbol":"BTCUSDT",
        "coin":"BTC",
        "cTime":"102211213000",
        "amount":"22.22", 
        "type":"autoLoan" 
      }
    ],
    "maxId":"34234234234324",
    "minId":"34234234234324"
  }
}

返回值说明

返回字段 字段说明
symbol 交易对名称
loanId ID
coin 借款币种
amount 借款数量
type 借款类型
cTime 创建时间

获取逐仓还款历史纪录

限速规则: 10次/1s (uid)

HTTP请求

请求参数

参数名 参数类型 是否必须 描述
symbol String 交易对 (例如:BTCUSDT)
repayId String 还款ID
coin String 币种
startTime String 开始时间
endTime String 结束时间
pageSize String 查询条数
pageId String 查询返回的minId,以进行翻页 (上一次查询返回的minId,返回ID小于minId的数据 )

请求示例

curl "https://api.bitget.com/api/margin/v1/isolated/repay/list?symbol=BTCUSDT&startTime=1659403328000&endTime=1659410528000&pageSize=20" \
  -H "ACCESS-KEY:you apiKey" \
  -H "ACCESS-SIGN:*******" \
  -H "ACCESS-PASSPHRASE:*****" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json"

返回数据

{
  "code":"00000",
  "message":"success",
  "data":{
    "resultList":[
      {
        "repayId":"32423423423",
        "symbol":"BTCUSDT",
        "coin":"BTC",
        "cTime":"162211242000",
        "totalAmount":"22.22", 
        "type":"autoRepay",
        "interest": "0.22",
        "amount": "22"
      }
    ],
    "maxId":"32423423423",
    "minId":"32423423423"
  }
}

返回值说明

返回字段 字段说明
symbol 交易对名称
repayId ID
coin 币种
amount 还款本金
totalAmount 还款总额
interest 还款利息
type 还款类型
cTime 创建时间

逐仓借贷利息记录

限速规则: 10次/1s (uid)

HTTP请求

请求参数

参数名 参数类型 是否必须 描述
symbol String 交易对
coin String 币种
startTime String 开始时间
pageSize String 查询条数
pageId String 查询返回的minId,以进行翻页 (上一次查询返回的minId,返回ID小于minId的数据 )

请求示例

curl "https://api.bitget.com/api/margin/v1/isolated/interest/list?symbol=BTCUSDT&startTime=1659403328000&pageSize=20" \
  -H "ACCESS-KEY:you apiKey" \
  -H "ACCESS-SIGN:*******" \
  -H "ACCESS-PASSPHRASE:*****" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json"

返回数据

{
  "code":"00000",
  "message":"success",
  "data":{
    "resultList":[
      {
        "interestId":"34523523",
        "symbol":"BTCUSDT",
        "cTime":"16588502211",
        "amount":"22.22", 
        "type": "first",
        "interestCoin": "BTC", 
        "loanCoin": "BTC",   
        "interestRate":"0.00001"  
      }
    ],
    "maxId":"34523523",
    "minId":"34523523"
  }
}

返回值说明

返回字段 字段说明
symbol 交易对名称
interestId ID
interestCoin 利息币种
amount 利息
interestRate 日利率
loanCoin 借贷币种
type 利息类型
cTime 创建时间

逐仓强平记录

限速规则: 10次/1s (uid)

HTTP请求

请求参数

参数名 参数类型 是否必须 描述
symbol String 交易对
startTime String 开始时间
endTime String 结束时间
pageSize String 查询条数
pageId String 上一次查询返回的minId,返回ID小于minId的数据

请求示例

curl "https://api.bitget.com/api/margin/v1/isolated/liquidation/list?symbol=BTCUSDT&startTime=1659403328000&endTime=1659410528000&pageSize=20" \
  -H "ACCESS-KEY:you apiKey" \
  -H "ACCESS-SIGN:*******" \
  -H "ACCESS-PASSPHRASE:*****" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json"

返回数据

{
  "code":"00000",
  "message":"success",
  "data":[
    {
      "liqId":"123",
      "symbol":"BTCUSDT",
      "liqStartTime": "1653453245342",
      "liqEndTime": "16312423423432",
      "liqRisk":"1.01", 
      "totalAssets": "1242.34",  
      "totalDebt": "1100", 
      "LiqFee":"1.2",
      "cTime":"1653453245342"
    }
  ],
  "maxId":"123",
  "minId":"123"
}

返回值说明

返回字段 字段说明
symbol 交易对名称
liqId ID
liqStartTime 强平开始时间
liqEndTime 强平结束时间
liqRisk 强平时风险率
totalAssets 强平时总资产
totalDebt 强平时总欠款
liqFee 强平手续费
cTime 创建时间

逐仓财务流水记录

限速规则: 10次/1s (uid)

HTTP请求

请求参数

参数名 参数类型 是否必须 描述
symbol String 交易对 (例如:BTCUSDT)
marginType String 流水类型 marginType
coin String 币种
startTime String 开始时间
endTime String 结束时间
pageSize String 查询条数
pageId String 查询返回的minId,以进行翻页 (上一次查询返回的minId,返回ID小于minId的数据 )

请求示例

curl "https://api.bitget.com/api/margin/v1/isolated/fin/list?symbol=BTCUSDT&startTime=1659403328000&endTime=1659410528000&pageSize=20" \
  -H "ACCESS-KEY:you apiKey" \
  -H "ACCESS-SIGN:*******" \
  -H "ACCESS-PASSPHRASE:*****" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json"

返回数据

{
  "code":"00000",
  "message":"success",
  "data":{
    "resultList":[
      {
        "marginId":"12868683",
        "symbol":"BTCUSDT",
        "coin":"USDT",
        "marginType": "transferIn",
        "amount":"1400",
        "fee":"1.01",
        "balance": "1242.34", 
        "cTime":"1653453245342"
      }
    ],
    "maxId":"123",
    "minId":"123"
  }
}

返回值说明

返回字段 字段说明
symbol 交易对名称
marginId ID
coin 币种
marginType 流水类型 marginType
amount 流水金额
fee 手续费
balance 账户余额
cTime 创建时间

全仓订单和交易记录接口

全仓下单接口

限速规则 10次/1s

HTTP请求

请求参数

参数名 参数类型 是否必须 描述
symbol String 币对 (例如:BTCUSDT)
orderType String 订单类型 orderType
price String 价格
loanType String 杠杆订单模式 loanType
timeInForce String 订单策略
baseQuantity String limit必填,market sell 必填,卖单代表baseCoin(左币)数量
quoteAmount String market buy必填,买单代表quote Coin(右币)数量
clientOid String 自定义ID
side String buy or sell side

请求示例

curl "https://api.bitget.com/api/margin/v1/cross/order/placeOrder" \
  -H "ACCESS-KEY:you apiKey" \
  -H "ACCESS-SIGN:*******" \
  -H "ACCESS-PASSPHRASE:*****" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json" \
  -d \'{
    "symbol": "BTCUSDT",
    "side": "buy",
    "price":"15100",
    "orderType": "limit",
    "timeInForce": "gtc",
    "baseQuantity": "0.1",
    "clientOid":"clientOid001",
    "loanType":"normal"
}

'

返回数据

{
  "code":"00000",
  "msg":"success",
  "requestTime":163123213132,
  "data":{
    "orderId":"1001",
    "clientOid":"clientOid001"
  }
}

返回值说明

返回字段 字段说明
orderId 订单ID
clientOid 自定义ID

全仓批量下单接口

限速规则 10次/1s

HTTP请求

请求参数

参数名 参数类型 是否必须 描述
symbol String 币对 (例如:BTCUSDT)
orderList array 订单条目

orderList

参数名 参数类型 是否必须 描述
orderType String 订单类型 orderType
price String 价格
loanType String 杠杆订单模式 loanType
timeInForce String 订单策略 force
baseQuantity String limit必填,market sell 必填,卖单代表baseCoin(左币)数量
quoteAmount String market buy必填,买单代表quote Coin(右币)数量
clientOid String 自定义ID
side String buy or sell side

请求示例

curl "https://api.bitget.com/api/margin/v1/cross/order/batchPlaceOrder" \
  -H "ACCESS-KEY:you apiKey" \
  -H "ACCESS-SIGN:*******" \
  -H "ACCESS-PASSPHRASE:*****" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json" \
 -d \'{
    "symbol": "BTCUSDT",
    "orderList": [
        {
            "side": "buy",
            "price":"23100",
            "orderType": "limit",
            "timeInForce": "gtc",
            "baseQuantity": "0.1",
            "loanType":"normal"
        }
    ]
}'

返回数据

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1666336231317,
  "data": {
    "resultList": [
      {
        "orderId": "96724974842718610",
        "clientOid": "qqq#1044sdf1343"
      }
    ],
    "failure": [
      {
        "clientOid": "qqq#1666185450114",
        "errorMsg": "clientOid duplicate"
      }
    ]
  }
}

返回值说明

返回字段 字段说明
resultList 成功下单响应array
> orderId 订单Id
> clientOid 客户端自定义Id
failure 失败下单array
> clientOid 客户端自定义Id
> errorMsg 错误信息

全仓撤单接口

限速规则 10次/1s

HTTP请求

请求参数

参数名 参数类型 是否必须 描述
symbol String 交易对 (例如:BTCUSDT)
orderId String 订单ID
clientOid String 客户自定义ID

请求示例

curl "https://api.bitget.com/api/margin/v1/cross/order/cancelOrder" \
  -H "ACCESS-KEY:you apiKey" \
  -H "ACCESS-SIGN:*******" \
  -H "ACCESS-PASSPHRASE:*****" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json" \
 -d \'{
    "symbol": "BTCUSDT",
    "orderId": "3242384623846284238",
    "clientOid": "",
}'

返回数据

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1666336231317,
  "data": {
    "resultList": [
      {
        "orderId": "96724974842718610",
        "clientOid": "qqq#1044sdf1343"
      }
    ],
    "failure": [
      {
        "clientOid": "qqq#1666185450114",
        "errorMsg": "clientOid duplicate"
      }
    ]
  }
}

返回值说明

返回字段 字段说明
resultList 成功下单响应array
> orderId 订单Id
> clientOid 客户端自定义Id
failure 失败下单array
> clientOid 客户端自定义Id
> errorMsg 错误信息

全仓批量撤单接口

限速规则 10次/1s

HTTP请求

请求参数

参数名 参数类型 是否必须 描述
symbol String 交易对 (例如:BTCUSDT)
orderId String 订单ID
clientOid String 客户自定义ID

请求示例

curl "https://api.bitget.com/api/margin/v1/cross/order/batchCancelOrder" \
  -H "ACCESS-KEY:you apiKey" \
  -H "ACCESS-SIGN:*******" \
  -H "ACCESS-PASSPHRASE:*****" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json" \
 -d \'{
    "symbol": "BTCUSDT",
    "orderIds": ["3242384623846284238"],
    "clientOids": [],
}'

返回数据

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1666336231317,
  "data": {
    "resultList": [
      {
        "orderId": "96724974842718610",
        "clientOid": "qqq#1044sdf1343"
      }
    ],
    "failure": [
      {
        "clientOid": "qqq#1666185450114",
        "errorMsg": "clientOid duplicate"
      }
    ]
  }
}

返回值说明

返回字段 字段说明
resultList 成功下单响应array
> orderId 订单Id
> clientOid 客户端自定义Id
failure 失败下单array
> clientOid 客户端自定义Id
> errorMsg 错误信息

获取全仓当前委托

限速规则: 10次/1s (uid)

HTTP请求

请求参数

参数名 参数类型 是否必须 描述
symbol String 交易对 (例如:BTCUSDT)
orderId String 订单ID
clientOid String 客户自定义ID
startTime String 开始时间, ms, 值需要在90天内
endTime String 结束时间
pageSize String 查询条数

请求示例

curl "https://api.bitget.com/api/margin/v1/cross/order/openOrders?symbol=BTCUSDT_UMCBL&startTime=1659403328000&endTime=1659410528000&pageSize=20" \
  -H "ACCESS-KEY:you apiKey" \
  -H "ACCESS-SIGN:*******" \
  -H "ACCESS-PASSPHRASE:*****" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json"

返回数据

{
  "code":"00000",
  "message":"success",
  "data":{
    "orderList":[{
      "symbol":"btcusdt",
      "orderType":"limit", 
      "source":"API",
      "orderId":"2222222",
      "clientOid":"xxxxxxx",
      "price":"17000",
      "loanType":"autoLoan",
      "timeInForce":"gtc",
      "side":"buy",
      "status":"new",
      "baseQuantity":"1",
      "quoteAmount":"17000",
      "fillPrice":"17000",
      "fillQuantity":"1", 
      "fillTotalAmount":"17000",  
      "cTime":"1622697148000" 
    }],
    "maxId":"2222222",
    "minId":"2222222"
  }
}

返回值说明

返回字段 字段说明
symbol 交易对名称
orderId 订单号
clientOid 客户端自定义id
fillQuantity 成交数量
fillPrice 成交价格
fillTotalAmount 成交金额
timeInForce 下单策略 force
price 委托价格
source 订单来源 source
status 订单状态 status
side 开单方向 side
baseQuantity 基础币数量
quoteAmount 计价币数量
orderType 订单类型 a href="#ordertype">orderType
cTime 创建时间
loanType 杠杆订单策略 a href="#loantype">loanType

获取全仓历史委托

限速规则: 10次/1s (uid)

HTTP请求

请求参数

参数名 参数类型 是否必须 描述
symbol String 交易对 (例如:BTCUSDT)
orderId String 订单ID
source String 下单来源
clientOid String 客户自定义ID
startTime String 开始时间, ms, 值需要在90天内
endTime String 结束时间
pageSize String 查询条数
minId String 翻页ID,接口返回minId (上一次查询返回的minId,返回ID小于minId的数据 )

请求示例

curl "https://api.bitget.com/api/margin/v1/cross/order/history?symbol=BTCUSDT&startTime=1659403328000&endTime=1659410528000&pageSize=20" \
  -H "ACCESS-KEY:you apiKey" \
  -H "ACCESS-SIGN:*******" \
  -H "ACCESS-PASSPHRASE:*****" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json"

返回数据

{
  "code":"00000",
  "message":"success",
  "data":{
    "orderList":[{
      "symbol":"btcusdt",
      "orderType":"limit", 
      "source":"API",
      "orderId":"2222222",
      "clientOid":"xxxxxxx",
      "price":"17000",
      "loanType":"autoLoan",
      "timeInForce":"gtc",
      "side":"buy",
      "status":"new",
      "baseQuantity":"1",
      "quoteAmount":"17000",
      "fillPrice":"17000",
      "fillQuantity":"1", 
      "fillTotalAmount":"17000",  
      "cTime":"1622697148000" 
    }],
    "maxId":"2222222",
    "minId":"2222222"
  }
}

返回值说明

返回字段 字段说明
symbol 交易对名称
orderId 订单号
clientOid 客户端自定义id
fillQuantity 成交数量
fillPrice 成交价格
fillTotalAmount 成交金额
timeInForce 下单策略
price 委托价格
source 订单来源 source
status 订单状态 status
side 开单方向 side
baseQuantity 基础币数量
quoteAmount 计价币数量
orderType 订单类型 orderType
cTime 创建时间
loanType 杠杆订单策略 loanType

获取全仓成交明细

限速规则: 10次/1s (uid)

HTTP请求

请求参数

参数名 参数类型 是否必须 描述
symbol String 交易对 (例如:BTCUSDT)
orderId String 订单ID
lastFillId String 撮合ID, 翻页相关参数,首次查询不传,查询第二页及后面的数据时,取上一次查询返回的lastFillId,结果会返回小于该值的数据;可以缩短查询响应时间
startTime String 开始时间
endTime String 结束时间
pageSize String 查询条数

请求示例

curl "https://api.bitget.com/api/margin/v1/cross/order/fills?symbol=BTCUSDT&startTime=1659403328000&endTime=1659410528000&pageSize=20" \
  -H "ACCESS-KEY:you apiKey" \
  -H "ACCESS-SIGN:*******" \
  -H "ACCESS-PASSPHRASE:*****" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json"

返回数据

{
  "code":"00000",
  "message":"success",
  "requestTime":"1622697148000",
  "data":{
    "resultList":[
      {
        "symbol":"BTCUSDT",
        "orderId":"100021",
        "fillId":"102211",
        "orderType":"limit",
        "side":"buy",
        "fillPrice":"38293.12",
        "fillQuantity":"1",
        "fillTotalAmount":"38293.12",
        "cTime":"1622697148000",
        "feeCcy":"btc",
        "fees":"0.0001"
      }
    ],
    "maxId":"102211",
    "minId":"102211"
  }
}

返回值说明

返回字段 字段说明
symbol 交易对名称
orderId 订单号
fillId 成交明细ID
fillQuantity 成交数量
fillPrice 成交价格
fillTotalAmount 成交金额
side 开单方向 side
feeCcy 手续费币种
orderType 订单类型 orderType
cTime 创建时间
fees 手续费

获取全仓借款历史纪录

限速规则: 10次/1s (uid)

HTTP请求

请求参数

参数名 参数类型 是否必须 描述
loanId String 借款ID
coin String 币种
startTime String 开始时间
endTime String 结束时间
pageSize String 查询条数
pageId String 查询返回的minId,以进行翻页 (上一次查询返回的minId,返回ID小于minId的数据 )

请求示例

curl "https://api.bitget.com/api/margin/v1/cross/loan/list?startTime=1679350657000&pageSize=20" \
  -H "ACCESS-KEY:you apiKey" \
  -H "ACCESS-SIGN:*******" \
  -H "ACCESS-PASSPHRASE:*****" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json"

返回数据

{
  "code":"00000",
  "message":"success",
  "data":{
    "resultList":[
      {
        "loanId":"34234234234324",
        "coin":"BTC",
        "cTime":"102211213000",
        "amount":"22.22", 
        "type":"autoLoan" 
      }
    ],
    "maxId":"34234234234324",
    "minId":"34234234234324"
  }
}

返回值说明

返回字段 字段说明
loanId ID
coin 借款币种
amount 借款数量
type 借款类型
cTime 创建时间

获取全仓还款历史纪录

限速规则: 10次/1s (uid)

HTTP请求

请求参数

参数名 参数类型 是否必须 描述
repayId String 还款ID
coin String 币种
startTime String 开始时间
endTime String 结束时间
pageSize String 查询条数
pageId String 查询返回的minId,以进行翻页 (上一次查询返回的minId,返回ID小于minId的数据 )

请求示例

curl "https://api.bitget.com/api/margin/v1/cross/repay/list?startTime=1659403328000&endTime=1659410528000&pageSize=20" \
  -H "ACCESS-KEY:you apiKey" \
  -H "ACCESS-SIGN:*******" \
  -H "ACCESS-PASSPHRASE:*****" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json"

返回数据

{
  "code":"00000",
  "message":"success",
  "data":{
    "resultList":[
      {
        "repayId":"32423423423",
        "coin":"BTC",
        "cTime":"162211242000",
        "totalAmount":"22.22", 
        "type":"autoRepay",
        "interest": "0.22",
        "amount": "22"
      }
    ],
    "maxId":"32423423423",
    "minId":"32423423423"
  }
}

返回值说明

返回字段 字段说明
repayId ID
coin 币种
amount 还款本金
totalAmount 还款总额
interest 还款利息
type 还款类型
cTime 创建时间

获取全仓利息利息记录

限速规则: 10次/1s (uid)

HTTP请求

请求参数

参数名 参数类型 是否必须 描述
coin String 币种
startTime String 开始时间
pageSize String 查询条数
pageId String 查询返回的minId,以进行翻页 (上一次查询返回的minId,返回ID小于minId的数据 )

请求示例

curl "https://api.bitget.com/api/margin/v1/cross/interest/list?startTime=1659403328000&pageSize=20" \
  -H "ACCESS-KEY:you apiKey" \
  -H "ACCESS-SIGN:*******" \
  -H "ACCESS-PASSPHRASE:*****" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json"

返回数据

{
  "code":"00000",
  "message":"success",
  "data":{
    "resultList":[
      {
        "interestId":"34523523",
        "cTime":"16588502211",
        "amount":"22.22", 
        "type": "first",
        "interestCoin": "BTC", 
        "loanCoin": "BTC",   
        "interestRate":"0.00001"  
      }
    ],
    "maxId":"34523523",
    "minId":"34523523"
  }
}

返回值说明

返回字段 字段说明
interestId ID
interestCoin 利息币种
amount 利息
interestRate 日利率
loanCoin 借贷币种
type 利息类型
cTime 创建时间

全仓强平记录

限速规则: 10次/1s (uid)

HTTP请求

请求参数

参数名 参数类型 是否必须 描述
startTime String 开始时间
endTime String 结束时间
pageSize String 查询条数
pageId String 查询返回的minId,以进行翻页 (上一次查询返回的minId,返回ID小于minId的数据 )

请求示例

curl "https://api.bitget.com/api/margin/v1/cross/liquidation/list?startTime=1659403328000&endTime=1659410528000&pageSize=20" \
  -H "ACCESS-KEY:you apiKey" \
  -H "ACCESS-SIGN:*******" \
  -H "ACCESS-PASSPHRASE:*****" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json"

返回数据

{
  "code":"00000",
  "message":"success",
  "data":[
    {
      "liqId":"123",
      "liqStartTime": "1653453245342",
      "liqEndTime": "16312423423432",
      "liqRisk":"1.01", 
      "totalAssets": "1242.34",  
      "totalDebt": "1100", 
      "LiqFee":"1.2",
      "cTime":"1653453245342"
    }
  ],
  "maxId":"123",
  "minId":"123"
}

返回值说明

返回字段 字段说明
liqId ID
liqStartTime 强平开始时间
liqEndTime 强平结束时间
liqRisk 强平时风险率
totalAssets 强平时总资产
totalDebt 强平时总欠款
LiqFee 强平手续费
cTime 创建时间

获取全仓财务流水记录

限速规则: 10次/1s (uid)

HTTP请求

请求参数

参数名 参数类型 是否必须 描述
marginType String 流水类型
coin String 币种
startTime String 开始时间
endTime String 结束时间
pageSize String 查询条数
pageId String 查询返回的minId,以进行翻页 (上一次查询返回的minId,返回ID小于minId的数据 )

请求示例

curl "https://api.bitget.com/api/margin/v1/cross/fin/liststartTime=1659403328000&endTime=1659410528000&pageSize=20" \
  -H "ACCESS-KEY:you apiKey" \
  -H "ACCESS-SIGN:*******" \
  -H "ACCESS-PASSPHRASE:*****" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json"

返回数据

{
  "code":"00000",
  "message":"success",
  "data":{
    "resultList":[
      {
        "marginId":"12868683",
        "coin":"USDT",
        "marginType": "transferIn",
        "amount":"1400",
        "fee":"1.01",
        "balance": "1242.34", 
        "cTime":"1653453245342"
      }
    ],
    "maxId":"123",
    "minId":"123"
  }
}

返回值说明

返回字段 字段说明
marginId ID
coin 币种
marginType 流水类型 marginType
amount 流水金额
fee 手续费
balance 账户余额
cTime 创建时间

WebSocketAPI

概述

WebSocket是HTML5一种新的协议(Protocol)。它实现了客户端与服务器全双工通信, 使得数据可以快速地双向传播。通过一次简单的握手就 可以建立客户端和服务器连接, 服务器根据业务规则可以主动推送信息给客户端。其优点如下:

强烈建议开发者使用WebSocket API获取市场行情和买卖深度等信息。 ​

域名 WebSocket API 建议使用
域名1 wss://ws.bitget.com/spot/v1/stream 国际

连接说明:

连接上ws后30s内订阅或订阅后30s内用户未发送ping指令,系统会自动断开连接

连接

连接说明

连接限制:100个/IP

订阅限制:240次/小时

如果出现网络问题,系统会自动断开连接

如果连接成功后30s未订阅或订阅后30s内服务器未向用户推送数据,系统会自动断开连接

为了保持连接有效且稳定,建议您进行以下操作:

  1. 每次接收到消息后,用户设置一个定时器,定时N秒,N 小于30。
  2. 如果定时器被触发(N 秒内没有收到新消息),发送字符串 'ping'。
  3. 期待一个文字字符串'pong'作为回应。如果在 N秒内未收到,请发出错误或重新连接。
  4. Websocket服务器每秒最多接受10个消息。消息包括:
  5. PING帧
  6. JSON格式的消息,比如订阅,断开订阅。
  7. 如果用户发送的消息超过限制,连接会被断开连接。反复被断开连接的IP有可能被服务器屏蔽;
  8. 单个连接最多可以订阅 1000 个Streams;
  9. 单个IP最多可以创建100个连接。

登录

api_key:用于调用API的用户身份唯一标示,需要用户申请

passphrase:API Key 的密码,如果没有口令的话传入空字符串("")即可

timestamp: 时间戳 是Unix Epoch时间,单位是秒, 时间戳30秒后会过期

sign:为签名字符串,签名规则参照如下:

Message即(待签名字符串)为: timestamp+method+requestPath

其中timestamp示例:const timestamp = '' + Date.now() / 1000

method一律默认为'GET'

requestPath 一律默认为'/user/verify'

请求在时间戳之后30秒会失效,如果您的服务器时间和API服务器时间有偏差,推荐使用 REST API查询API服务器的时间,然后设置时间戳

签名方式说明参考API概述里的验证部分

生成最终签名的步骤

第1步,将待签名字符串使用私钥secretkey进行hmac sha256加密

Signature = hmac_sha256(secretkey, Message)

第2步,对于Signature进行base64编码

Signature = base64.encode(Signature)

如果登录失败会自动断开链接

请求格式说明:

{
    "op": "login",
    "args": [{
        "apiKey": "<api_key>",
        "passphrase": "<passphrase>",
        "timestamp": "<timestamp>",
        "sign": "<sign>"
    }]
}

请求示例:

{
    "op": "login",
    "args": [{
        "apiKey": "bg_573af5eca856acd91c230da294ce2105",
        "passphrase": "123456",
        "timestamp": "1538054050",
        "sign": "8RCOqCJAhhEh4PWcZB/96QojLDqMAg4qNynIixFzS3E="
    }]
} 

成功返回示例:

{
    "event": "login",
    "code": "0",
    "msg": ""
} 

失败返回示例:

{
    "event": "error",
    "code": "30005",
    "msg": "error"
} 

订阅

订阅说明

请求格式说明

{
    "op": "subscribe",
    "args": ["<SubscriptionTopic> "]
}

WebSocket 频道分成两类: 公共频道 和 私有频道

公共频道无需登录,包括指数价格等。

私有频道需登录,包括全仓杠杆账户资产,逐仓杠杆账户资产、全仓杠杆订单、逐仓杠杆订单等。

用户可以选择订阅一个或者多个频道,多个频道总长度不能超过4096个字节。

请求示例

{
    "op": "subscribe",
    "args": [{
        "channel": "indexPrice",
        "instType": "mabl",
        "instId": "default"
    }]
}

请求参数

参数 类型 是否必须 描述
op String 操作,subscribe
args Array 请求订阅的频道列表
> instType String 产品类型mabl
> channel String 频道名
> instId String 产品ID (default订阅全部, 不支持指定symbol)

返回示例

{
    "action": "snapshot",
    "arg": {
        "instType": "mabl",
        "channel": "indexPrice",
        "instId": "default"
    },
    "data": [{
        "baseCoin": "TRX",
        "indexPrice": "0.06362400",
        "key": "TRXUSDT",
        "quoteCoin": "USDT",
        "symbol": "TRXUSDT",
        "timestamp": "1679732272775",
        "version": "1679732272775"
    }]
}

返回参数

参数 类型 是否必须 描述
action String 事件,snapshot
arg Object 订阅的频道
> instType String 产品类型mabl
> channel String 频道名
> instId String 产品ID
data Object 返回数据
> baseCoin String 基础币
> indexPrice String 指数价格
> key String 关键词 (数据唯一标识)
> quoteCoin String 计价币
> symbol String 币对
> timestamp String 时间戳
> version String 版本
code String 错误码
msg String 错误消息

取消订阅

可以取消一个或者多个频道

请求格式说明

{
    "op": "unsubscribe",
    "args": ["< SubscriptionTopic > "]
}

请求示例

{
    "op": "unsubscribe",
    "args": [{
        "instType": "mabl",
        "channel": "indexPrice",
        "instId": "default"
    }]
}

请求参数

参数 类型 是否必须 描述
op String 操作,unsubscribe
args Array 取消订阅的频道列表
> instType String 产品类型mabl
> channel String 频道名
> instId String 产品ID或者产品名称

返回示例

{
    "event": "unsubscribe",
    "args": {
        "instType": "mabl",
        "channel": "indexPrice",
        "instId": "default"
    }
} 

返回参数

参数 类型 是否必须 描述
action String 事件,snapshot
arg Object 取消订阅的频道
> instType String 产品类型mabl
> channel String 频道名
> instId String 产品ID或者产品名称
code String 错误码
msg String 错误消息

公共频道

杠杆币对指数价格推送

获取杠杆币对指数价格推送

请求示例

{
    "op": "subscribe",
    "args": [{
        "channel": "indexPrice",
        "instType": "mabl",
        "instId": "default"
    }]
}

请求参数

参数 类型 是否必须 描述
op String 操作,subscribe
args Array 请求订阅的频道列表
> instType String 产品类型mabl
> channel String 频道名
> instId String 产品ID(default订阅全部, 不支持指定symbol)

成功返回示例

返回示例

{
    "action": "snapshot",
    "arg": {
        "instType": "mabl",
        "channel": "indexPrice",
        "instId": "default"
    },
    "data": [{
        "baseCoin": "TRX",
        "indexPrice": "0.06362400",
        "key": "TRXUSDT",
        "quoteCoin": "USDT",
        "symbol": "TRXUSDT",
        "timestamp": "1679732272775",
        "version": "1679732272775"
    }]
}

返回参数

参数 类型 是否必须 描述
action String 事件,snapshot
arg Object 订阅的频道
> instType String 产品类型mabl
> channel String 频道名
> instId String 产品ID
data Object 返回数据
> baseCoin String 基础币
> indexPrice String 指数价格
> key String 关键词 (唯一标识)
> quoteCoin String 计价币
> symbol String 币对
> timestamp String 时间戳
> version String 版本
code String 错误码
msg String 错误消息

私有频道

全仓杠杆账户频道

每当帐户余额发生更改时,都会发送一个推送,其中包含可能由生成余额变动的事件而变动的资产,以下事件。

请求示例

{
    "op": "subscribe",
    "args": [{
        "channel": "cross_account", 
        "instType": "mabl", 
        "instId": "default"             
    }]
}

请求参数

参数 类型 是否必须 描述
op String 操作,subscribe unsubscribe
args Array 请求订阅的频道列表
> instType String 产品类型,mabl
> channel String 频道名,cross_account
> instId String 币种, 全部传 default (default全部推送, 不支持指定symbol)

成功返回示例

{
    "action": "snapshot",
    "arg": {
        "instType": "mabl",
        "channel": "cross_account",
        "instId": "default"
    },
    "data": [{
        "available": "9628.96000000",
        "borrow": "0.00000000",
        "coin": "USDT",
        "frozen": "381.04000000",
        "id": "1020496190816575488",
        "interest": "0.00000000",
        "key": "1020496190816575488",
        "uTime": "1679728870940",
        "version": "1023369776782827520"
    }]
}

返回参数

参数 类型 是否必须 描述
action String 事件 snapshot
arg Object 订阅的频道
> instType String 产品类型
> channel String 频道名
> instId String 币种
data Object 返回数据
> available String 可用金额
> borrow String 借款金额
> coin String 币种
> frozen String 冻结金额
> id String 序号
> interest String 利息
> key String 唯一 (唯一标识)
> uTime String 更新时间
> version String 版本号
code String 错误码
msg String 错误消息

逐仓杠杆账户频道

每当帐户余额发生更改时,都会发送一个推送,其中包含可能由生成余额变动的事件而变动的资产,以下事件。

请求示例

{
    "op": "subscribe",
    "args": [{
        "channel": "isolate_account", 
        "instType": "mabl", 
        "instId": "default"             
    }]
}

请求参数

参数 类型 是否必须 描述
op String 操作,subscribe unsubscribe
args Array 请求订阅的频道列表
> instType String 产品类型,mabl
> channel String 频道名,isolate_account
> instId String 币种, 全部传 default (default全部推送, 不支持指定symbol)

成功返回示例

{
    "action": "snapshot",
    "arg": {
        "instType": "mabl",
        "channel": "isolate_account",
        "instId": "default"
    },
    "data": [{
        "available": "9628.96000000",
        "borrow": "0.00000000",
        "symbol": "BTCUSDT_SPBL",
        "coin": "USDT",
        "frozen": "381.04000000",
        "id": "1020496190816575488",
        "interest": "0.00000000",
        "key": "1020496190816575488",
        "uTime": "1679728870940",
        "version": "1023369776782827520"
    }]
}

返回参数

参数 类型 是否必须 描述
action String 事件,snapshot (全量)
arg Object 订阅的频道
> instType String 产品类型
> channel String 频道名
> instId String 币种
data Object 返回数据
> available String 可用金额
> borrow String 借款金额
> symbol String 币对
> coin String 币种
> frozen String 冻结金额
> id String 序号
> interest String 利息
> key String 唯一 (唯一标识)
> uTime String 更新时间
> version String 版本号
code String 错误码
msg String 错误消息

首次推送:全量推送。

增量推送:推送交易变化

全仓杠杆订单频道

获取订单信息,首次订阅不推送,只有当下单、撤单、成交等事件触发时,推送snapshot数据。

请求示例

{
    "op": "subscribe",
    "args": [{
        "channel": "cross_orders",
        "instType": "mabl",     
        "instId": "BTCUSDT_SPBL"   
    }]
}

请求参数

参数 类型 是否必须 描述
op String 操作,subscribe unsubscribe
args Array 请求订阅的频道列表
> instType String 产品类型,mabl
> channel String 频道名, cross_orders
> instId String 币种 BTCUSDT_SPBL (必须传币对)

成功返回示例

{
    "action": "snapshot",
    "arg": {
        "instType": "mabl",
        "channel": "cross_orders",
        "instId": "BTCUSDT_SPBL"
    },
    "data": [{
        "baseQuantity": "0.010000000",
        "cTime": "1679729291287",
        "clientOid": "70715854a52e4daaa84e2a1e52ddb01d",
        "fillPrice": "19055.000000000",
        "fillQuantity": "0.010000000",
        "fillTotalAmount": "190.550000000",
        "key": "1023424313350610944",
        "loanType": "autoLoan",
        "orderId": "1023424313350610944",
        "orderType": "limit",
        "price": "19055.000000000",
        "quoteAmount": "190.550000000",
        "side": "buy",
        "source": "web",
        "status": "full-fill",
        "symbol": "BTCUSDT",
        "timeInForce": "normal",
        "version": "1023424313640017920"
    }]
}

返回参数

参数 类型 是否必须 描述
action String 事件,snapshot(全量)
arg Object 订阅的频道
> instType String 产品类型
> channel String 频道名
> instId String 币种
data Object 返回数据
> baseQuantity String 基础币数量
> cTime String 订单时间
> clientOid String 客户端唯一标识
> fillPrice String 成交价
> fillQuantity String 成交数量
> fillTotalAmount String 成交金额
> key String 唯一(唯一标识)
> loanType String 下单类型 loanType
> orderId String 订单Id
> orderType String 订单类型 orderType
> price String 订单价格
> quoteAmount String 计价币数量
> side String 买卖方式 side
> source String 订单来源 source
> status String 订单状态 status
> symbol String 币对
> timeInForce String gtc force
> version String 版本号
code String 错误码
msg String 错误消息

逐仓杠杆订单频道

获取订单信息,首次订阅不推送,只有当下单、撤单、成交等事件触发时,推送snapshot数据。

请求示例

{
    "op": "subscribe",
    "args": [{
        "channel": "isolate_orders",
        "instType": "mabl",     
        "instId": "BTCUSDT_SPBL"   
    }]
}

请求参数

参数 类型 是否必须 描述
op String 操作,subscribe unsubscribe
args Array 请求订阅的频道列表
> instType String 产品类型,mabl
> channel String 频道名, isolate_orders
> instId String 币种 BTCUSDT_SPBL(必须传币对)

成功返回示例

{
    "action": "snapshot",
    "arg": {
        "instType": "mabl",
        "channel": "isolate_orders",
        "instId": "BTCUSDT_SPBL"
    },
    "data": [{
        "baseQuantity": "0.001000000",
        "cTime": "1679729228954",
        "clientOid": "c4c8c920b864415aa8b723d5e470dc5c",
        "fillPrice": "19055.000000000",
        "fillQuantity": "0.001000000",
        "fillTotalAmount": "19.055000000",
        "key": "1023424051902865408",
        "loanType": "autoLoan",
        "orderId": "1023424051902865408",
        "orderType": "limit",
        "price": "19055.000000000",
        "quoteAmount": "19.055000000",
        "side": "buy",
        "source": "web",
        "status": "full-fill",
        "symbol": "BTCUSDT",
        "timeInForce": "normal",
        "version": "1023424052343267328"
    }]
}

返回参数

参数 类型 是否必须 描述
action String 事件,snapshot(全量)
arg Object 订阅的频道
> instType String 产品类型
> channel String 频道名
> instId String 币种
data Object 返回数据
> baseQuantity String 基础币数量
> cTime String 订单时间
> clientOid String 客户端唯一标识
> fillPrice String 成交价
> fillQuantity String 成交数量
> fillTotalAmount String 成交金额
> key String 唯一(唯一标识)
> loanType String 下单类型 loanType
> orderId String 订单Id
> orderType String 订单类型 orderType
> price String 订单价格
> quoteAmount String 计价币数量
> side String 买卖方式 side
> source String 订单来源 source
> status String 订单状态 status
> symbol String 币对
> timeInForce String gtc force
> version String 版本号
code String 错误码
msg String 错误消息

RestAPI错误

错误提示 错误码 http状态码
00000 成功! 400
40001 ACCESS_KEY不能为空 400
40002 ACCESS_SIGN不能为空 400
40003 签名不能为空 400
40004 请求时间戳过期 400
40005 无效的ACCESS_TIMESTAMP 400
40006 无效的ACCESS_KEY 400
40007 无效的Content_Type 400
40008 请求时间戳过期 400
40009 sign签名错误 400
40010 请求超时 400
40011 ACCESS_PASSPHRASE不能为空 400
40012 apikey/口令不正确 400
40013 用户状态异常 400
40014 权限不正确, 需要 {0} 权限 400
40015 系统异常,请稍后重试 400
40016 用户必须绑定手机或者谷歌 400
40017 参数校验失败 {0} 400
00171 参数校验失败 {0}{1} 400
00172 参数校验失败 400
40018 无效的IP 400
40019 参数 {0} 不能为空 400
40020 参数 {0} 异常 400
40021 用户禁止提币 400
40022 此账号该业务已被限制 400
40023 此账号该业务已被限制 400
40024 账号已被冻结 400
40025 此账号该业务已被限制 400
40026 用户已被禁用 400
40027 此账户地区提币必须kyc 400
40028 此subUid不属于该账号 400
40029 此账号不是Broker,请先申请成为Broker 400
40030 子账号无此权限 400
40031 该账号已注销,不可再次使用 400
40032 创建账号数量已达限制 400
40033 该邮箱已被使用 400
40034 参数 {0} 不存在 400
50001 coin {0} 不支持全仓 400
50002 symbol {0} 不支持逐仓 400
50003 coin {0} 不支持逐仓 400
50004 symbol {0} 不支持全仓 400
50005 symbol {0} 无效或者不支持杠杆交易 400
40035 遵循相关法律法规,根据您的当前登录信息,为方便您的使用,请先进行KYC 400
40036 passphrase 错误 400
40037 Apikey 不存在 400
40038 当前请求ip 没有在ip白名单列表 400
40039 userSignature签名错误 400
40040 user api key权限设置错误 400
40041 用户的ApiKey不存在 400
40043 FD Broker不存在 400
40045 被绑定的user不能是FD broker 400
40047 FD Broker绑定相关接口调用频率限制 400
40048 用户的ApiKey必须是母账号 400
40049 用户账号字段解密失败 400
40051 此账号不是FD Broker,请先申请成为FD Broker 400
40052 此账号已修改了安全设置。为了您账号的安全,24小时内禁止提币 400
40053 取值范围校验失败: {0}取值应在{1}之间 400
40054 根据{0}获取数据为空 400
40055 subName 长度控制在8位 400
40056 remark 长度需要满足1~20 400
40057 参数 {0} {1} 不符合规范 400
40058 参数 {0} 限制个数在 {1} 以内 400
40059 参数 {0} 应该小于 {1} 400
40060 subNames 存在重复的 400
40061 sub-account 不允许访问 400
40062 由于监管要求,您被限制下订单 400
40063 API超过添加的最大限制 400
40064 子账户创建失败,请检查是否有重复的 400
40065 此subApikey不存在 400
40066 该subUid不属于该账号或不是虚拟子账号 400
40067 子账户创建失败,请检查是否有重复的 400
40068 禁止子账户访问 400
40069 已达到创建子账号的最大数量 400
40070 passphrase 8-32个字母和数字字符 400
40071 subName 存在重复的 400
40072 symbol {0} 无效或者不支持合约交易 400
40102 合约配置不存在,请检查参数 400
40109 查不到该订单的数据,请确认订单号 400
40200 服务器升级,请稍后再试 400
40301 暂未获得使用权限,如需使用,请联系客服 400
40303 最多只能查询20000条数据 400
40304 clientOid或clientOrderId的长度不能大于50个字符 400
40305 clientOid或clientOrderId的长度不能大于64个字符,且不能是火星字符 400
40306 批量处理订单最多只能处理50条 400
40308 该合约正在临时维护 400
40309 该合约已下架 400
40400 状态校验异常 400
40401 该操作无法执行 400
40402 orderId或clientOId格式错误 400
40407 查询方向不是计划委托的方向 400
40408 范围错误 400
40409 格式错误 400
40704 只能查最近三个月的数据 400
40705 起止时间不能超过90天 400
40707 开始时间大于结束时间 400
40708 参数校验异常 400
40709 该仓位暂无持仓,不能设置自动追加保证金 400
40710 账户非正常状态 400
40711 合约账户余额不足 400
40712 保证金数量不足 400
40713 不能超过最大可转出保证金数量 400
40714 不允许直接追加保证金 400
40715 委托数量大于最大可开张数 400
40716 该交易对不支持全仓模式 400
40724 参数为空 400
40725 返回无映射信息 400
40726 全仓模式不支持自动追加保证金 400
40727 全仓模式不支持调整保证金 400
40728 您当前为交易员身份,请在当前带单下进行平仓 400
40729 调整仓位失败,当前持有仓位或委托或者计划委托 400
40730 当前有委托,或者计划委托,无法调整杠杆 400
40199 非交易员调用接口 400
40731 该产品不支持跟单交易 400
40732 当前不是交易员身份 400
40733 跟单平仓已经处理完成 400
40734 下单失败,交易员最少开仓张数{0}张 400
40735 多头仓位止盈价格请大于开仓均价 400
40736 多头仓位止盈价格请大于当前价格 400
40737 空头仓位止盈价格请小于开仓均价 400
40738 空头仓位止盈价格请小于当前价格 400
40739 多头仓位止损价格请小于开仓均价 400
40740 多头仓位止损价格请小于当前价格 400
40741 空头仓位止损价格请大于开仓均价 400
40742 空头仓位止损价格请大于当前价格 400
40743 该订单正在平仓中,不能再次平仓 400
40744 该追踪订单状态错误 400
40745 此带单正在委托中,暂不支持平仓 400
40746 当前最多可平仓张数为{0}张,超过的张数请到当前带单下平仓 400
40747 赠金不允许双向持仓 400
40748 委托价格高于最高买价 400
40749 委托价格低于于最低卖价 400
40750 该合约的计划委托已达到上限 400
40751 该合约的止盈止损委托已达到上限 400
40752 您被禁用当前业务,如有疑问请联系客服 400
40753 api权限已禁用,如有疑问请联系客服 400
40754 balance的可用不足. 400
40755 开仓可用不足. 400
40756 balance的锁定不足. 400
40757 position的可用不足. 400
40758 position的锁定不足. 400
40759 没有任何资产 400
40760 账户非正常状态 400
40761 未成交委托单总数过高 400
40762 委托数量大于最大可开数量 400
40763 委托数量不能超过对应档位的最大量 400
40764 订单剩余量小于本次成交量 400
40765 仓位剩余量小于本次成交量 400
40766 开仓委托数量小于本次成交量 400
40767 开仓处理时仓位不存在 400
40768 订单不存在 400
40769 拒绝订单已有成交 400
40770 结算或者手续费币种配置未找到. 400
40771 扎差时,不能拥有平仓委托. 400
40772 帐户不存在 400
40773 平仓只能发生在双向持仓下. 400
40774 单边持仓时委托类型也必须是单边持仓类型. 400
40775 做市帐户只能是单边持仓类型. 400
40776 创建订单错误. 400
40777 取消订单错误. 400
40778 币对{0}不支持{1}币种作为保证金 400
40779 请检查使用了正确的delegateType 400
40780 同一symbolId同一时刻有多条风险处理记录 400
40781 未找到转帐订单 400
40782 内部划转错误 400
40783 档位未找到 400
40784 需要配置modify depth帐户 400
40785 需要配置draw line帐户 400
40786 重复的clientOid 400
40787 价格步长不匹配 400
40788 批量内部划转错误 400
40789 配置项中tokenId重复 400
40790 配置项中symbolCode重复 400
40791 symbolCode的baseToken或者quoteToken不存在 400
40792 配置项中symbol重复 400
40793 BusinessSymbol的symbolCode不存在 400
40794 BusinessSymbol的supportMarginToken未配置 400
40795 因为结算或维护原因, 交易暂停 400
40796 调整后杠杆不在合适的范围内 400
40797 超过最大可设置杠杆倍数 400
40798 合约账户余额不足 400
40799 不能小于最小转入数量 400
40800 保证金数量不足 400
40801 不能超过最大可转出保证金数量 400
40802 仓位为零,不允许直接追加保证金 400
40803 调小杠杆,追加保证金数量不正确 400
40804 平仓数量不能超过持有仓位数量 400
40805 不支持的操作 400
40806 不支持的币种 400
40807 账户不存在 400
40808 参数校验异常 {0} 400
40809 执行价格参数校验异常 400
40810 触发价格参数校验异常 400
40811 参数 {0} 不应该为null 400
40812 条件 {0} 未满足 400
40813 参数 {0} 必须有值,不能为空 400
40814 杠杆倍数无变化 400
40815 委托价格高于最高买价 400
40816 委托价格低于于最低卖价 400
40817 当前订单状态不能撤销 400
40818 当前订单类型不能撤销 400
40819 订单不存在! 400
40820 平多委托价格不允许低于爆仓价 400
40821 平空委托价格不允许高于爆仓价 400
40822 合约配置不存在 400
40823 成交或合理标记价格不存在 400
40824 当前不允许挂市价单 400
40825 合约对手深度不存在 400
40826 因价格波动过大,市价委托成本不足,开仓委托失败。 400
40827 赠金不允许双向持仓 400
40828 特殊做市账户不能手动挂单 400
40829 多头仓位止盈价格请大于开仓均价 400
40830 多头仓位止盈价格请大于当前价格 400
40831 空头仓位止盈价格请小于开仓均价 400
40832 空头仓位止盈价格请小于当前价格 400
40833 多头仓位止损价格请小于开仓均价 400
40834 多头仓位止损价格请小于当前价格 400
40835 空头仓位止损价格请大于开仓均价 400
40836 空头仓位止损价格请大于当前价格 400
40837 该仓位暂无持仓,不能进行止盈止损委托 400
40838 该仓位暂无持仓,不能设置自动追加保证金 400
40839 该合约自动追加保证金功能已暂停使用 400
40840 分片做市账户重复 400
40841 线上环境不允许执行 400
40842 目前配置不允许调整,请稍后重试 400
40843 no_datasource_key_exists 400
40844 该合约正在临时维护 400
40845 该合约已下架 400
40846 状态校验异常 400
40847 该操作无法执行 400
40848 有仓位不能开启跟单交易 400
40849 该用户已存在进行中的跟单 400
40850 跟单进行中,不能转出余额 400
40851 账户状态错误,不能结束跟单 400
40852 有未成交的委托订单,不能结束跟单 400
40853 有未执行的计划委托,不能结束跟单 400
40854 该产品不支持跟单交易 400
40855 用户已结束跟单,不能再次结束跟单 400
40856 数据异常 400
40857 跟单号错误 400
40858 追踪订单状态错误 400
40859 该订单正在平仓中,不能再次平仓 400
40860 交易员不存在,不能设置跟随 400
40861 交易员已停用,不能设置跟随 400
40862 请撤销当前委托 400
40863 请撤销当前计划 400
40864 请将当前带单平仓 400
40865 此带单正在委托中,暂不支持平仓 400
40866 您当前为交易员身份,请在当前带单下进行平仓 400
40867 当前最多可平仓数量为{0},超过的数量请到当前带单下平仓 400
40868 您当前为交易员身份,暂不支持通过计划委托进行平仓 400
40869 您当前为交易员身份,暂不支持修改杠杆 400
40870 您当前正在进行跟单,暂不支持修改杠杆 400
40871 杠杆不满足配置,不能成为交易员 400
40872 调整仓位失败,当前持有仓位或委托或者计划委托 400
40873 帐户拥有保证金,需要转出 400
40874 全仓模式不支持自动追加保证金 400
40875 全仓模式不支持调整保证金 400
40876 追踪订单数量过多 400
40877 跟随追踪订单数量过多 400
40878 合约指数数据异常,为了避免造成您的损失,请稍后再试。 400
40879 风险处理中,不能调整资金. 400
40880 风险处理中,不能调整杠杆. 400
40881 当前有委托,或者计划委托,无法调整杠杆. 400
40882 您当前为交易员身份,不能切换为全仓模式 400
40883 币种混合时,不能调整为逐仓模式 400
40884 单向持仓时,不能调整为逐仓模式 400
40885 逐仓模式时,不能调整为单向持仓 400
40886 全仓模式时,不能调整自动追加保证金 400
40887 下单失败,单笔闪电开仓数量最多{0} 400
40888 下单失败,单笔闪电平仓数量最多{0} 400
40889 该合约的计划委托已达到上限 400
40890 该合约的止盈止损委托已达到上限 400
40891 仓位不足,不能设置止盈或者止损 400
40892 下单失败,交易员最少开仓数量{0} 400
40893 无法更新此仓位的杠杆系数,没有足够的保证金! 400
40894 跟单平仓已经处理完成 400
40895 预设价格与委托/执行价格不匹配 400
40896 预设止盈止损已经部分兑现,不允许修改 400
40897 系统体验金账户不存在 400
40898 系统体验金账户余额不足 400
40899 存储的用户数量超出限制 400
40900 系统体验金账户不一致 400
40901 合约体验金余额不足 400
40902 不允许使用未来时间 400
40903 获取杠杆信息失败 400
40904 归集资金费用失败 400
40905 收取用户资金费用失败 400
40906 支付用户资金费用失败 400
40907 结算处理中,不能进行划转 400
40908 并发操作失败 400
40909 划转处理中 400
40910 操作超时 400
40911 请求时间戳过期 400
40912 单次撤单不能超过50 400
40913 {0}必须传一个 400
40914 您当前为交易员身份,可使用的最大杠杆为{0} 400
40915 多头仓位止盈价格请>标记价格 400
40916 此账号该业务已被限制 400
40917 多头仓位止损价格请 < 标记价格 {0} 400
40918 交易员带单开仓过于频繁 400
40919 该功能暂未开放 400
40920 当前持有仓位或订单,仓位模式无法更换 400
40921 委托数量不能超过对应档位的最大量 400
40922 只允许修改 未成交的限价单 400
40923 订单数量和订单价格 没有变化 400
40924 orderId 和 clientOid 必须传入一个 400
40925 price or size 必须同时传入 400
43001 订单不存在 400
43002 挂单失败 400
43003 挂单失败 400
43004 没有可撤消的委单 400
43005 超过交易对最大委托数量限制 400
43006 下单数量小于最小交易数量 400
43007 下单数量大于最大交易数量 400
43008 当前委托价格不能小于{0}{1} 400
43009 当前委托价格超过限制{0}{1} 400
43010 交易额不能小于{0}{1} 400
43011 参数不合符规范 {0} 400
42013 划转失败 400
42014 当前币种不支持充币 400
42015 当前币种不支持提币 400
42016 symbol {0} 无效或者不支持现货交易 400
43013 止盈价格需要>当前价格 400
43014 止盈价格需要<当前价格 400
43015 止损价格需要<当前价格 400
43016 止损价格需要>当前价格 400
43017 您当前为交易员身份,暂不支持通过计划委托进行平仓 400
43020 止盈止损单不存在 400
43021 止盈止损单已经处于结束状态 400
43022 预设止盈止损触发失败 400
43023 仓位不足,不能设置止盈或者止损 400
43024 已有委托中的止盈/止损,请在全部撤销后更改 400
43025 计划委托单不存在 400
43026 计划委托单已经处于结束状态 400
43027 不满足最小下单价值{0} 400
43028 价格请输入{0}的整倍数 400
43029 当前委托的数量 > 最大可平仓数量 400
43032 rangeRate is smaller than {0} 400
43033 Trailing order does not exist 400
43034 The trigger price should be ≤ the current market price 400
43035 The trigger price should be ≥ the current market price 400
43036 交易员修改止盈止损300ms内只允许操作一次 400
43037 不能小于交易最小委托量{0} 400
43038 不能大于交易最大委托量{0} 400
43039 超过最大价格限制{0} 400
43040 价格最小变动为{0} 400
43041 超过最大交易额{0} 400
43042 低于最小交易额{0} 400
43043 该仓位暂无持仓,不能进行止盈止损委托 400
43044 追踪订单状态错误 400
43045 此交易员已达跟单上限,请选择其他交易员 400
43046 用户不存在 400
43047 跟随者被移除后的几分钟内不允许再次跟随,请稍后再试 400
43048 交易对为空 400
43049 不支持该保证金 400
43050 杠杆超过有效范围 400
43051 超过最大限制 400
43052 跟单数量不能低于{0} 400
43053 跟单比例不能超过{0} 400
43054 跟单比例不能低于{0} 400
43055 止损比例需介于{0}-{1} 400
43056 止盈比例需介于{0}-{1} 400
43057 子母账户之间不可带单或跟单 400
43058 参数校验失败 400
43059 操作失败,请重试 400
43060 排序规则必传 400
43061 排序字段必传 400
43062 该交易员不存在或不可跟单该交易员 400
43063 自己不能跟单自己 400
43064 当前带单订单状态错误 400
43065 跟踪单号 不存在 400
43066 操作失败 400
43067 加载数据已达上限,单次最大支持加载{0}条 400
43068 当前跟随者状态异常,暂不允许移除 400
43069 当跟随者账户权益低于{0}USDT时才可被移除 400
45001 未知错误 400
45002 资产可用不足 400
45003 开仓可用不足 400
45004 资产的锁定不足 400
45005 仓位的可用不足 400
45006 position的仓位不足 400
45007 position的锁定不足 400
45008 没有任何资产 400
45009 账户有风险,暂时不能交易 400
45010 委托数量不能超过对应档位的最大量 400
45011 订单剩余量<本次成交量 400
45012 仓位剩余量<本次成交量 400
45013 开仓委托数量<本次成交量 400
45014 开仓处理时仓位不存在 400
45015 订单不存在 400
45016 拒绝订单已有成交 400
45017 结算或者手续费币种配置未找到. 400
45018 扎差时,不能拥有平仓委托. 400
45019 帐户不存在 400
45020 平仓只能发生在双向持仓下. 400
45021 单边持仓时委托类型也必须是单边持仓类型. 400
45023 创建订单错误. 400
45024 取消订单错误. 400
45025 币对不支持该币种作为保证金 400
45026 请检查使用了正确的delegateType 400
45031 订单已经是终态 400
45034 重复的clientOid 400
45035 价格步长不匹配 400
45043 因为结算或维护原因, 交易暂停 400
45044 调整后杠杆不在合适的范围内 400
45045 超过最大可设置杠杆倍数 400
45047 调小杠杆,追加保证金数量不正确 400
45051 执行价格参数校验异常 400
45052 触发价格参数校验异常 400
45055 当前订单状态不能撤销 400
45056 当前订单类型不能撤销 400
45057 订单不存在! 400
45060 多头仓位止盈价格请>当前价格{0} 400
45061 空头仓位止盈价格请<当前价格{0} 400
45062 多头仓位止损价格请<当前价格{0} 400
45063 空头仓位止损价格请>当前价格{0} 400
45064 多头仓位止盈价格请>委托价格{0} 400
45065 空头仓位止盈价格请<委托价格{0} 400
45066 多头仓位止损价格请<委托价格{0} 400
45067 空头仓位止损价格请>委托价格{0} 400
45068 多头仓位止盈价格请>执行价格{0} 400
45075 该用户已存在进行中的跟单 400
45081 跟单号错误 400
45089 您当前正在进行跟单,暂不支持修改杠杆 400
45091 追踪订单数量过多 400
45097 当前有委托,或者计划委托,无法调整杠杆. 400
45098 您当前为交易员身份,不能切换为全仓模式 400
45099 币种混合时,不能调整为逐仓模式 400
45100 单向持仓时,不能调整为逐仓模式 400
45101 逐仓模式时,不能调整为单向持仓 400
45102 全仓模式时,不能调整自动追加保证金 400
45103 下单失败,单笔闪电开仓数量最多%s 400
45104 下单失败,单笔闪电平仓数量最多%s 400
45106 跟单平仓已经处理完成 400
45107 API限制开仓,如有问题请联系客服 400
45108 API限制平仓,如有问题请联系客服 400
45110 触发最小下单价值限制 {0} USDT 400
45111 触发最小下单数量 400
45112 触发最最大下单数量 400
45113 触发最大下单价值限制 400
45114 不满足最小下单要求 400
45115 price 应该满足 {0} 倍数 400
45116 当前账号持仓条数超过最大数量 {0} 400
45117 当前持有仓位或委托,无法调整保证金模式 400
45118 达到总笔数上限(当前委托笔数+当前带单笔数) {0} 400
45119 此合约暂不支持开仓操作 400
45120 委托数量 > 最大可开数量 400
45121 合理标记价格偏离盘口过大,您当前杠杆开仓风险较高 400
45122 空头仓位止损价格请>标记价格 {0} 400
45123 可用不足, 当前只可市价下单 400
45124 Please edit and submit again. 400
45125 Order cancellation is unavailable for inactive orders. Please cancel parent order and place a new order. 400
45126 Order cancellation is unavailable for inactive orders. Please cancel parent order and place a new order. 400
45127 Position brackets disabled TP SL 400
45128 Position brackets disabled modify qty 400
45129 撤单过于频繁, 同一个订单号一秒内只允许取消一次 400
41103 参数{0}错误 400
41101 参数{0}错误 400
41113 该交易对已下线 400
41114 当前交易对停盘中,具体开放时间请留意官方公告 400
43012 账户余额不足 400
41100 {0} 400
43111 参数错误 {0} 400
43112 提币金额小于手续费 {0} 400
43113 单笔超过了每日限额 {0} 400
43114 提币小于最小提币数 {0} 400
43115 此交易对未到开盘交易时间 400
43116 该chain提币需要tag 400
43117 超过可转出的最大金额 400
43118 clientOrderId重复 400
43119 Trading is not open 400
43120 symbol is not open trade 400
43121 Withdrawal address cannot be your own 400
43122 该币种限制买入额度{0},还剩{1} 400
43123 param error {0} 400
43124 withdraw step is error 400
43125 No more than 8 decimal places 400
43126 This currency does not support withdrawals 400
43127 非母账户发起划转,或母子账户关系错误 400
43128 超过总交易对最大委托数量限制 {0} 400
47001 Currency recharge is not enabled 400
47002 提币地址校验失败 400
49000 apiKey与用户userId不匹配 400
49001 非外部资金托管账户,不允许操作 400
49002 缺少http header: ACCESS-BROKER-KEY or ACCESS-BROKER-SIGN 400
49003 非法的IP,拒绝访问 400
49004 非法的ACCESS-BROKER-KEY值 400
49005 子账户拒绝访问 400
49006 ACCESS-BROKER-SIGN校验失败 400
49007 账户未绑定 400
49008 账户已绑定 400
49009 指定clientUserId和已绑定用户ID不一致 400
49010 账户 {0} 存在资产: {1} 400
49011 用户绑定前必须完成KYC 400
49020 不支持的币种 400
49021 资金操作进行中 400
49022 禁止访问 400
49023 余额不足 400
49024 {0} 数量精度错误 400
49025 请求内容和初次请求该requestId的内容不一致,具体参数 {0} 400
49026 {0} 最大 {1} 位 400
49030 外部资金托管账户, 拒绝访问 400
49040 未知异常 400
60001 startTime不能为空 400
60002 merchantId不能为空 400
60003 未找到订单 400
60004 未找到广告 400
60005 未找到商家 400
70001 活动ID错误,未找到该活动 400
70002 rankType错误不支持 400
45109 当前铺单账户为双向持仓 400
40000 Bitget正在为全球多个国家和地区提供服务,并严格遵守各个国家和地区的法规与监管要求。依据相关法规,Bitget当前无法对您所在的地区(中国大陆地区)提供服务,您没有开仓权限,给您带来不便,敬请谅解! 400
48001 参数验证失败 {0} 400
48002 缺少请求参数 400
46013 该币种限制卖出额度{0},还剩{0} 400
40404 请求的URL不存在 400
50010 未知错误 400
50012 账户已冻结或者已注销,请联系客服。 400
50013 账户已冻结、注销,请联系客服。 400
50019 该用户禁止交易 400
50059 不支持划转该币种 400
50052 资产划转时金额小于0 400
50048 超过交易对最大委托数量限制 400
50046 价格太低 400
50047 价格太高 400
50026 交易对未开放交易 400
50025 交易对未开放交易 400
50016 挂单数量低于交易对最小挂单数量 400
50017 挂单数量高于交易对最大挂单数量 400
50023 账号异常被冻结,如有疑问请联系客服 400
50031 系统异常 400
50044 未配置系统账户 400
50049 系统用户操作请求体为空 400
50050 系统借贷归集已经被执行过了 400
50027 交易对停止交易维护 400
50030 交易对即将开放 400
50029 交易对无下单价格 400
50028 交易对下线 400
50040 还款金额必须大于0 400
50042 还款金额必须大于利息 400
50041 还款金额必须小于可用资产 400
50051 对账时收到不在系统(缓存)中的用户 400
50024 交易对不存在 400
50011 参数校验异常 400
50053 借贷归还时金额小于0 400
50056 强平手续费缴纳时金额小于0 400
50054 利息归还时金额小于0 400
50055 手续费缴纳时金额小于0 400
50033 websocket查询的topic不存在 400
50057 穿仓补偿时金额小于0 400
50032 币种不存在 400
50036 借贷配置不存在 400
50037 该币种不可借贷 400
50038 超出系统限制额度 400
50034 借款金额必须大于0.00000001 400
50035 超出最大可借金额 400
50020 余额不足 400
50045 锁定资产不足 400
50015 子账号暂时不支持开通杠杆交易 400
50021 杠杆帐户不存在 400
50022 账户处于强平状态 400
50014 账户已存在 400
50060 重复的clientOid 400
50058 穿仓没收盈余金额小于0 400
50039 币对币种不匹配 400
50018 价格不能小于0 400
50043 未知的资产流水类型 400
50061 请修改后提交 400
50062 该订单已成交或者已撤单 400
50063 币种精度必须小于等于8位 400
50064 当前业务已冻结,如有疑问请联系客服 400
50065 币对已下架 400
50066 仓位平仓中,请稍后操作 400
31001 该用户不是交易员 400
31002 条件 {0} 未满足 400
31003 参数 {0} 必须有值,不能为空 400
31004 止盈价格需要>当前价格 400
31005 止损价格需要<当前价格 400
31006 此带单正在委托中,暂不支持平仓 400
31007 订单不存在 400
31008 该仓位暂无持仓,不能进行止盈止损委托 400
31009 追踪订单状态错误 400
31010 清退用户提示 400
31011 未完全成交订单平仓提示取消委托 400
31012 回调幅度大于{0} 400
31013 回调幅度小于{0} 400
31014 止盈收益率大于{0} 400
31015 止损收益率小于{0} 400
31016 批量执行异常 400
31017 超过最大价格限制{0} 400
31018 价格最小变动为 {0} 400
31019 支持交易币对不存在 400
31020 业务被限制 400
31021 该币对不可交易,请选择其他币对 400
31022 不满足该交易区最小下单量,请选择其他交易区 400
31023 结束跟单处理中 400
31024 该笔订单未完全成交,请到"现货交易"-"当前委托"下撤销该笔委托后,再进行卖出或结束操作! 400
31025 您的交易员身份已被停用或撤销,暂不支持此操作,如有疑问请联系客服! 400
31026 用户不存在 400
31027 操作失败,请重试 400
31028 参数验证失败 400
31029 用户不存在 400
31030 所选交易对为空 400
31031 您当前身份为交易员,暂不可进行跟单操作 400
31032 不能自己跟自己 400
31033 移除失败 400
31034 此交易员跟随人数达上限,请选择其他交易员 400
31035 跟单比例不能低于{0} 400
31036 跟单比例不能超过{0} 400
31037 跟单张数不能低于{0} 400
31038 超过最大限制 400
31039 交易员身份已被取消,无法设置提醒 400
31040 止盈比例需介于{0}%%-{1}%% 400
31041 止损比例需介于{0}%%-{1}%% 400
31042 您的交易员身份已暂停,若需设置带单合约请联系在线客服 400
31043 您的带单人数已经过平台增员,如需打开此功能请联系客服减员! 400
31044 您当前正在申请交易员,暂不允许跟单 400
31045 当前最多可止盈/止损数量为{0},超过的数量请到当前带单下操作。 400
31046 子母账户之间不可带单或跟单 400
31047 跟随者被移除后的{0}分钟内不允许再次跟随,请稍后再试! 400
31048 该交易员仅支持邀请用户跟随,请选择其他交易员! 400
31049 该交易员身份异常或已被撤销,暂不支持查看! 400
31050 交易员UID重复 400
31051 traderUserId 异常 400
31052 不能设置交易员未开启的带单对。 400
31053 executePrice 不能超过 triggerPrice 的{0} 400
31054 没有可撤销的订单 400
20001 startTime 必须小于 endTime 400
22001 暂无委托可撤销 400
22002 暂无仓位可平 400
22003 修改price 和 size 时 请务必 传入 newClientOid 400
22004 此 {0} 合约暂未支持API交易 400
22005 此合约暂不支持使用全仓模式 400
22006 委托价格 > 风控最高买价 400
22007 委托价格 < 风控最低卖价 400
22008 市场价格 > 风控最高买价 400
22009 市场价格 < 风控最低卖价 400
22010 请设置ip白名单地址 400
40100 由于监管要求,香港IP需要先完成身份验证 400
40101 请先完成KYC 400
00001 startTime 和 endTime 间隔不能大于366天 400
12001 当前最多可使用{0},剩余部分处于跟单或带单的冻结资产,暂不可使用 400
12002 当前币种{0},限制净卖出价值{1} USD 400
12003 当前币种{0},限制净买出价值{1} USD 400
13001 提币操作太频繁 400
13002 币种不存在 400
13003 提币超过每月限额 400
13004 您实际可提数量为{0} 400
13005 生成地址失败 400
60006 参数异常 400
60007 上传文件不能超过5M 400
60008 文件格式必须是[".jpg", ".jpeg", ".png"] 400
60009 文件格式不正确 400
60010 上传异常 400
60011 普通用户无法发布广告 400
60012 您当前为离线状态,请切换为在线状态后再发布广告! 400
60013 可用余额不足 400
60014 法币信息未查到 400
60015 数字币信息未查到 400
60016 仅支持发布CNY广告 400
60017 不支持发布CNY广告 400
60018 您的 KYC 认证仅支持发布{0} 400
60019 发布失败,无法获取汇率价格 400
60020 广告类型错误 400
60021 支付方式为空 400
60022 交易数量不正确 400
60023 不满足法币限额({0}-{1}) 400
60024 对账资金异常 400
60025 备注长度不能大于配置长度 400
60026 专属国家错误 400
60027 付款期限错误 400
60028 付款方式错误 400
60029 发布广告失败 400
60030 状态错误 400
60031 广告编号太长 400
60032 广告不存在 400
60033 发布的广告金额错误 400
60034 备注图片数量不能大于配置数量 400
60035 编辑广告失败 400
60036 payTimeLimit不能为空 400
60037 发布失败,定价与参考价差距大 400
60038 发布失败,浮动比率错误。 400
60039 用户不存在 400
60040 未授权不支持访问 400
60041 修改广告价格失败 400
60042 limitPrice 不能为空 400
60043 广告状态更新失败 400
60044 只有编辑中的广告,才能编辑 400
60045 超过可发布的广告数量 400
60046 priceValue 不能是空 400
60047 userPayMethodId 不能是空 400
13007 当前币种{0},24小时限制净买入价值{1} USD,还可以净购买价值{2} USD的{3} 400
11000 白名单已开启,您的账户只能提现到地址簿地址 400
40103 非常抱歉,根据您的IP地址和留存信息,您似乎位于我们目前无法提供服务的国家或地区 400
40104 无法转账到该账户 请确保这是个有效并完成认证的账户 400
30001 价格最小变动为 {0} % 400
40928 风控比例限制,您当前最大可开为{0} {1}。单个用户风控比例限额是所有母子账户一起计算 400
47003 白名单已开启,您的账户只能提现到地址簿地址 400
13008 单笔提币超过最大限额 400
13009 超过每日总额额度 400
32038 卖出价不能低于触发价的{0} 400

WebSocket错误代码

错误提示 错误码
频道不存在 30001
不合法的请求 30002
无效op 30003
用户需要登录 30004
登录失败 30005
请求频繁 30006
请求超过限制 30007
无效的ACCESS_KEY 30011
无效的ACCESS_PASSPHRASE 30012
无效的ACCESS_TIMESTAMP 30013
请求时间戳过期 30014
无效的签名 30015