Welcome
欢迎来到Bitget API文档!点击这里直接开始
更新日志
2024年8月15日
- API接口限频调整
接口 | 原限频 | 新限频 |
---|---|---|
/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日
- API支持RSA密钥签名,增加RSA 签名示例
2023年08月08日
- 新增接口
- 接口查询条件:
- 获取全仓杠杆账户资产 参数 'coin' 改为非必填
- 获取逐仓杠杆账户资产 参数 'symbol' 改为非必填
2023年04月11日
- 新增SDK示例
2023年03月28日
- 新增接口 公共接口
- 新增接口 全仓、逐仓账户接口
- 新增接口 全仓下单和交易记录接口
- 新增接口 逐仓下单和交易记录接口
- 新增接口 websocket 杠杆币对指数价格推送 、全仓杠杆账户资产更新推送、逐仓杠杆账户资产资产更新推送、全仓杠杆订单推送、 逐仓杠杆订单推送
简介
API 简介
欢迎使用Bitget开发者文档!
此文档是Bitget API的唯一官方文档,Bitget API提供的能力会在此持续更新,请大家及时关注。
你可以通过点击上方菜单来切换获取不同业务的API,还可通过点击右上方的语言按钮来切换文档语言。
文档右侧是针对请求参数以及响应结果的示例。
更新关注
关于API新增、更新、下线等信息Bitget会提前发布公告进行通知,建议您关注和订阅我们的公告,及时获取相关信息。
您可以点击 这里 订阅公告。
联系我们
使用过程中如有问题或者建议,您可选择以下方式联系我们:
- 发送邮件至API@bitget.com。
- Telegram 点击加入
快速入门
接入准备
如需使用API ,请先登录网页端,完成API key的申请和权限配置,再据此文档详情进行开发和交易。
您可以点击 这里 创建 API Key。
每个用户可创建10组Api Key,每个Api Key可对应设置读取、交易两种权限。
权限说明如下:
- 读取权限:读取权限用于对数据的查询,例如:行情数据。
- 交易权限:交易权限用于下单、撤单等接口。
创建成功后请务必记住以下信息:
APIKey
API交易的身份标识,随机算法生成。Secretkey
私钥,由系统随机生成,用于签名的生成。Passphrase
口令,由用户自己设定,需要注意的是,Passphrase忘记之后是无法找回的,需要重新创建APIKey。
SDK/代码示例
SDK(推荐)
Java | Python | GoLang | NodeJs | PHP
PostMan 示例
接口类型
本章节主要为接口类型分以下两个方面:
- 公共接口
- 私有接口
公共接口
公共接口可用于获取配置信息和行情数据。公共请求无需认证即可调用。
私有接口
私有接口可用于订单管理和账户管理。每个私有请求必须使用规范的验证形式进行签名。
私有接口需要使用您的APIKey进行验证。
访问限制
本章节主要为访问限制:
- 429 当访问超过频率限制时,将返回状态429:请求太频繁。
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:
- ACCESS-KEY:API KEY作为一个字符串。
- ACCESS-SIGN:使用base64编码签名(请参阅签名消息)。
- ACCESS-TIMESTAMP:您请求的时间戳。
- ACCESS-PASSPHRASE:您在创建API KEY时设置的口令。
- Content-Type:统一设置为application/json。
- locale:支持多语言,如:中文(zh-CN),英语(en-US)
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 编码输出而得到的。
签名各字段说明
- timestamp:与 ACCESS-TIMESTAMP 请求头相同。
- method:请求方法(POST/GET),字母全部大写。
- requestPath:请求接口路径。
- queryString:请求URL中(?后的请求参数)的查询字符串。
- body:请求主体对应的字符串,如果请求没有主体(通常为GET请求)则body可省略。
queryString为空时,签名格式
timestamp + method.toUpperCase() + requestPath + body
queryString不为空时,签名格式
timestamp + method.toUpperCase() + requestPath + "?" + queryString + body
举例说明
获取最大可转出金额,以 USDT 为例:
- Timestamp = 1591089508404
- Method = "GET"
- requestPath = "/api/margin/v1/cross/account/maxTransferOutAmount"
- queryString= "?coin=USDT"
生成待签名的字符串:
'1591089508404GET/api/margin/v1/cross/account/maxTransferOutAmount?coin=USDT'
借款,以 USDT 为例:
- Timestamp = 1561022985382
- Method = "POST"
- requestPath = "/api/margin/v1/cross/account/borrow"
- body = {"coin":"USDT","borrowAmount":"1"}
生成待签名的字符串:
'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'。
请求交互说明
- 请求参数:根据接口请求参数规定进行参数封装。
- 提交请求参数:将封装好的请求参数通过GET/POST方式提交至服务器。
- 服务器响应:服务器首先对用户请求数据进行参数安全校验,通过校验后根据业务逻辑将响应数据以JSON格式返回给用户。
- 数据处理:对服务器响应数据进行处理。
成功
HTTP状态码200表示成功响应,并可能包含内容。如果响应含有内容,则将显示在相应的返回内容里面。
常见错误码
- 400 Bad Request – Invalid request format 请求格式无效
- 401 Unauthorized – Invalid API Key 无效的API Key
- 403 Forbidden – You do not have access to the requested resource 请求无权限
- 404 Not Found 没有找到请求
- 429 Too Many Requests 请求太频繁被系统限流
- 500 Internal Server Error – We had a problem with our server 服务器内部错误
- 如果失败body带有错误描述信息
标准规范
时间戳
请求签名中的ACCESS-TIMESTAMP的单位是毫秒。请求的时间戳必须在API服务时间的30秒内,否则请求将被视为过期并被拒绝。 如果本地服务器时间和API服务器时间之间存在较大的偏差,那么我们建议您使用通过查询API服务器时间来更新http header。
限频规则
如果请求过于频繁系统将自动限制请求,并在http header中返回429 too many requests状态码。
- 公共接口:如行情接口,统一限频为2秒最多20个请求。
- 授权接口:通过apikey限制授权接口的调用,参考每个接口的限频规则限频。
请求格式
目前只有两种格式的请求方法:GET和POST
- GET: 参数通过queryString在路径中传输到服务器。
- POST: 参数按照json格式发送body传输到服务器。
RestAPI
公共接口
全仓利率与最大可借数量配置
限速规则:10次/1s (IP)
HTTP请求 全仓利率与最大可借数量配置
- GET /api/margin/v1/cross/public/interestRateAndLimit
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
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请求 逐仓利率与最大可借数量配置
- GET /api/margin/v1/isolated/public/interestRateAndLimit
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
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请求 全仓档位梯度配置
- GET /api/margin/v1/cross/public/tierData
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
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请求 逐仓档位梯度配置
- GET /api/margin/v1/isolated/public/tierData
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
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请求 获取支持杠杆的所有币对
- GET /api/margin/v1/public/currencies
请求示例
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请求 获取账户资产
- GET /api/margin/v1/cross/account/assets
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
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请求
获取账户资产
- GET /api/margin/v1/isolated/account/assets
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
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请求 全仓借款接口
- POST /api/margin/v1/cross/account/borrow
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
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请求 逐仓借款接口
- POST /api/margin/v1/isolated/account/borrow
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
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请求 全仓还款接口
- POST /api/margin/v1/cross/account/repay
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
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请求 逐仓还款接口
- GET /api/margin/v1/isolated/account/repay
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
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请求
- GET /api/margin/v1/cross/account/riskRate
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
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请求
- POST /api/margin/v1/isolated/account/riskRate
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
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请求
- POST /api/margin/v1/cross/account/maxBorrowableAmount
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
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请求
- GET /api/margin/v1/isolated/account/maxBorrowableAmount
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
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请求
- GET /api/margin/v1/cross/account/maxTransferOutAmount
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
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请求
- GET /api/margin/v1/isolated/account/maxTransferOutAmount
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
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请求
- POST /api/margin/v1/isolated/account/flashRepay
请求示例
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请求
- POST /api/margin/v1/isolated/account/queryFlashRepayStatus
请求示例
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请求
- POST /api/margin/v1/cross/account/flashRepay
请求示例
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请求
- POST /api/margin/v1/cross/account/queryFlashRepayStatus
请求示例
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请求
- POST /api/margin/v1/isolated/order/placeOrder
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
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请求
- POST /api/margin/v1/isolated/order/batchPlaceOrder
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
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请求
- POST /api/margin/v1/isolated/order/cancelOrder
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
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请求
- POST /api/margin/v1/isolated/order/batchCancelOrder
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
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请求
- GET /api/margin/v1/isolated/order/openOrders
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
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请求
- GET /api/margin/v1/isolated/order/history
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
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请求
- GET /api/margin/v1/isolated/order/fills
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
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请求
- GET /api/margin/v1/isolated/loan/list
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
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 | 创建时间 |
- type
- autoLoan 自动借款
- manualLoan 手动借款
获取逐仓还款历史纪录
限速规则: 10次/1s (uid)
HTTP请求
- GET /api/margin/v1/isolated/repay/list
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
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 | 创建时间 |
- type
- autoRepay 自动还款
- manualRepay 手动还款
- liqRepay 爆仓还款
- forceRepay 强制还款
逐仓借贷利息记录
限速规则: 10次/1s (uid)
HTTP请求
- GET /api/margin/v1/isolated/interest/list
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
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 | 创建时间 |
- type
- first 首次借贷利息
- scheduled 计时利息
逐仓强平记录
限速规则: 10次/1s (uid)
HTTP请求
- GET /api/margin/v1/isolated/liquidation/list
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
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请求
- GET /api/margin/v1/isolated/fin/list
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
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请求
- POST /api/margin/v1/cross/order/placeOrder
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
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请求
- POST /api/margin/v1/cross/order/batchPlaceOrder
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
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请求
- POST /api/margin/v1/cross/order/cancelOrder
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
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请求
- POST /api/margin/v1/cross/order/batchCancelOrder
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
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请求
- GET /api/margin/v1/cross/order/openOrders
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
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请求
- GET /api/margin/v1/cross/order/history
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
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请求
- GET /api/margin/v1/cross/order/fills
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
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请求
- GET /api/margin/v1/cross/loan/list
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
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 | 创建时间 |
- type
- autoLoan 自动借款
- manualLoan 手动借款
获取全仓还款历史纪录
限速规则: 10次/1s (uid)
HTTP请求
- GET /api/margin/v1/cross/repay/list
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
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 | 创建时间 |
- type
- autoRepay 自动还款
- manualRepay 手动还款
- liqRepay 爆仓还款
- forceRepay 强制还款
获取全仓利息利息记录
限速规则: 10次/1s (uid)
HTTP请求
- GET /api/margin/v1/cross/interest/list
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
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 | 创建时间 |
- type
- first 首次借贷利息
- scheduled 计时利息
全仓强平记录
限速规则: 10次/1s (uid)
HTTP请求
- GET /api/margin/v1/cross/liquidation/list
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
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请求
- GET /api/margin/v1/cross/fin/list
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
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)。它实现了客户端与服务器全双工通信, 使得数据可以快速地双向传播。通过一次简单的握手就 可以建立客户端和服务器连接, 服务器根据业务规则可以主动推送信息给客户端。其优点如下:
- 客户端和服务器进行数据传输时,请求头信息比较小,大概2个字节。
- 客户端和服务器皆可以主动地发送数据给对方。
- 不需要多次创建TCP请求和销毁,节约宽带和服务器的资源。
强烈建议开发者使用WebSocket API获取市场行情和买卖深度等信息。
域名 | WebSocket API | 建议使用 |
---|---|---|
域名1 | wss://ws.bitget.com/spot/v1/stream | 国际 |
连接说明:
连接上ws后30s内订阅或订阅后30s内用户未发送ping指令,系统会自动断开连接
连接
连接说明:
连接限制:100个/IP
订阅限制:240次/小时
如果出现网络问题,系统会自动断开连接
如果连接成功后30s未订阅或订阅后30s内服务器未向用户推送数据,系统会自动断开连接
为了保持连接有效且稳定,建议您进行以下操作:
- 每次接收到消息后,用户设置一个定时器,定时N秒,N 小于30。
- 如果定时器被触发(N 秒内没有收到新消息),发送字符串 'ping'。
- 期待一个文字字符串'pong'作为回应。如果在 N秒内未收到,请发出错误或重新连接。
- Websocket服务器每秒最多接受10个消息。消息包括:
- PING帧
- JSON格式的消息,比如订阅,断开订阅。
- 如果用户发送的消息超过限制,连接会被断开连接。反复被断开连接的IP有可能被服务器屏蔽;
- 单个连接最多可以订阅 1000 个Streams;
- 单个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 频道分成两类: 公共频道
和 私有频道
公共频道
无需登录,包括指数价格等。
私有频道
需登录,包括全仓杠杆账户资产,逐仓杠杆账户资产、全仓杠杆订单、逐仓杠杆订单等。
- 用户账户频道
instId
为default
获取全部币种资产
用户可以选择订阅一个或者多个频道,多个频道总长度不能超过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 |