示例说明

通用基础信息请参考基础信息文档。

下单频率限制

• 当下单数超过限制时，会收到带有429 HTTP CODE 的响应。请检查 GET /api/v1/exchangeInfo 的下单频率限制 (rateLimitType = ORDERS) 并等待封禁时间结束。
• 下单频率限制是基于每个账户计数的。

WEB SOCKET 连接限制

• Websocket服务器每秒最多接受5个消息。消息包括:
  • PING帧
  • PONG帧
  • JSON格式的消息, 比如订阅, 断开订阅.
• 如果用户发送的消息超过限制，连接会被断开连接。反复被断开连接的IP有可能被服务器屏蔽。

需要签名的接口示例

POST /api/v1/spot/order的示例

以下是在linux bash环境下使用 echo openssl 和curl工具实现的一个调用接口下单的示例 apikey、secret仅供示范

Key	Value
apiKey	SRQGN9M8Sr87nbfKsaSxm33Y6CmGVtUu9Erz73g9vHFNn36VROOKSaWBQ8OSOtSq
secretKey	30lfjDT51iOG1kYZnDoLNynOyMdIcmQyO1XYfxzYOmQfx9tjiI98Pzio4uhZ0Uk2

参数	取值
symbol	BTCUSDT
side	SELL
type	LIMIT
timeInForce	GTC
quantity	1
price	4000
recvWindow	100000
timestamp	1668481902307

示例 1: 所有参数通过 query string 发送

示例1: HMAC SHA256 签名:

$ echo -n "symbol=BTCUSDT&side=SELL&type=LIMIT&timeInForce=GTC&quantity=1&price=400&recvWindow=100000&timestamp=1668481902307" | openssl dgst -sha256 -hmac "30lfjDT51iOG1kYZnDoLNynOyMdIcmQyO1XYfxzYOmQfx9tjiI98Pzio4uhZ0Uk2"
(stdin)= 8420e499e71cce4a00946db16543198b6bcae01791bdb75a06b5a7098b156468

curl 调用: (HMAC SHA256)

$ curl -H "X-BB-APIKEY: SRQGN9M8Sr87nbfKsaSxm33Y6CmGVtUu9Erz73g9vHFNn36VROOKSaWBQ8OSOtSq" -X POST 'https://api.toobit.com/api/v1/spot/order' -d 'symbol=BTCUSDT&side=SELL&type=LIMIT&timeInForce=GTC&quantity=1&price=400&recvWindow=100000&timestamp=1668481902307&signature=8420e499e71cce4a00946db16543198b6bcae01791bdb75a06b5a7098b156468'

• queryString symbol=BTCUSDT
  &side=SELL
  &type=LIMIT
  &timeInForce=GTC
  &quantity=1
  &price=400
  &recvWindow=100000
  &timestamp=1668481902307

示例 2: 所有参数通过 request body 发送

示例2: HMAC SHA256 签名:

$ echo -n "symbol=BTCUSDT&side=SELL&type=LIMIT&timeInForce=GTC&quantity=1&price=400&recvWindow=100000&timestamp=1668481902307" | openssl dgst -sha256 -hmac "30lfjDT51iOG1kYZnDoLNynOyMdIcmQyO1XYfxzYOmQfx9tjiI98Pzio4uhZ0Uk2"
(stdin)= 8420e499e71cce4a00946db16543198b6bcae01791bdb75a06b5a7098b156468

curl 调用: (HMAC SHA256)

$ curl -H "X-BB-APIKEY: SRQGN9M8Sr87nbfKsaSxm33Y6CmGVtUu9Erz73g9vHFNn36VROOKSaWBQ8OSOtSq" -X POST 'https://api.toobit.com/api/v1/spot/order' -d 'symbol=BTCUSDT&side=SELL&type=LIMIT&timeInForce=GTC&quantity=1&price=400&recvWindow=100000&timestamp=1668481902307&signature=8420e499e71cce4a00946db16543198b6bcae01791bdb75a06b5a7098b156468'

• requestBody symbol=BTCUSDT
  &side=SELL
  &type=LIMIT
  &timeInForce=GTC
  &quantity=1
  &price=400
  &recvWindow=100000
  &timestamp=1668481902307

示例 3: 混合使用 query string 与 request body

• queryString:symbol=BTCUSDT&side=SELL&type=LIMIT&timeInForce=GTC
• requestBody:quantity=1&price=400&recvWindow=100000&timestamp=1668481902307

示例3: HMAC SHA256 签名:

$ echo -n "symbol=BTCUSDT&side=SELL&type=LIMIT&timeInForce=GTCquantity=1&price=400&recvWindow=10000000&timestamp=1668481902307" | openssl dgst -sha256 -hmac "30lfjDT51iOG1kYZnDoLNynOyMdIcmQyO1XYfxzYOmQfx9tjiI98Pzio4uhZ0Uk2"
(stdin)= 59ef0b2085ebb99cca5b6445c202d99add17be2d5d1861c0f4aa17bc785ac4d5

curl 调用: (HMAC SHA256)

$ curl -H "X-BB-APIKEY: SRQGN9M8Sr87nbfKsaSxm33Y6CmGVtUu9Erz73g9vHFNn36VROOKSaWBQ8OSOtSq" -X POST 'https://api.toobit.com/api/v1/spot/order?symbol=BTCUSDT&side=SELL&type=LIMIT&timeInForce=GTC' -d 'quantity=1&price=400&recvWindow=10000000&timestamp=1668481902307&signature=59ef0b2085ebb99cca5b6445c202d99add17be2d5d1861c0f4aa17bc785ac4d5'

注意在例子3里有一点不一样，"GTC"和"quantity=1"之间没有&。