示例说明

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

Rest 基本信息

• 所有数据类型采用 JAVA 的数据类型定义。
• 跟单 OpenAPI 仅支持当前 API Key 对应带单员自己的数据和设置。
• 所有跟单接口都需要 OpenAPI V2 签名访问，API Key 账户类型必须为 COPY_TRADING。

访问限制

• 跟单接口的 REQUEST_WEIGHT 均为 1。
• 多次反复违反频率限制，或没有在收到 429 后停止发送请求的用户，将会被封禁 IP（错误码 418）。
• IP 封禁会被跟踪并调整封禁时长。对于反复违反规定的用户，封禁时间从 2 分钟到 3 天不等。

需要签名的接口示例

以下示例展示如何在 Linux bash 环境下使用 echo、openssl 和 curl 调用跟单接口。apiKey、secretKey 仅用于示范。

Key	Value
apiKey	SRQGN9M8Sr87nbfKsaSxm33Y6CmGVtUu9Erz73g9vHFNn36VROOKSaWBQ8OSOtSq
secretKey	30lfjDT51iOG1kYZnDoLNynOyMdIcmQyO1XYfxzYOmQfx9tjiI98Pzio4uhZ0Uk2

GET /api/v2/copy-trading/leader/orders/current 的示例

参数	取值
recvWindow	5000
timestamp	1717200000000

HMAC SHA256 签名:
$ echo -n "recvWindow=5000&timestamp=1717200000000" | openssl dgst -sha256 -hmac "30lfjDT51iOG1kYZnDoLNynOyMdIcmQyO1XYfxzYOmQfx9tjiI98Pzio4uhZ0Uk2"
(stdin)= 0b54c7a90b48f1b6c5cc8170f030594f3eb3c7e6dd81b76f65e18fc76f8b1a88

curl 调用:
$ curl -H "X-BB-APIKEY: SRQGN9M8Sr87nbfKsaSxm33Y6CmGVtUu9Erz73g9vHFNn36VROOKSaWBQ8OSOtSq" \
  -X GET 'https://api.toobit.com/api/v2/copy-trading/leader/orders/current?recvWindow=5000&timestamp=1717200000000&signature=0b54c7a90b48f1b6c5cc8170f030594f3eb3c7e6dd81b76f65e18fc76f8b1a88'

PUT /api/v2/copy-trading/leader/config 的示例

写接口不支持 read-only API Key。请求 body 参与签名时，签名字符串按 OpenAPI V2 的签名规则拼接。

参数	取值
recvWindow	5000
timestamp	1717200000000

HMAC SHA256 签名:
$ echo -n "recvWindow=5000&timestamp=1717200000000" | openssl dgst -sha256 -hmac "30lfjDT51iOG1kYZnDoLNynOyMdIcmQyO1XYfxzYOmQfx9tjiI98Pzio4uhZ0Uk2"
(stdin)= 0b54c7a90b48f1b6c5cc8170f030594f3eb3c7e6dd81b76f65e18fc76f8b1a88

curl 调用:
$ curl -H "X-BB-APIKEY: SRQGN9M8Sr87nbfKsaSxm33Y6CmGVtUu9Erz73g9vHFNn36VROOKSaWBQ8OSOtSq" \
  -H "Content-Type: application/json" \
  -X PUT 'https://api.toobit.com/api/v2/copy-trading/leader/config?recvWindow=5000&timestamp=1717200000000&signature=0b54c7a90b48f1b6c5cc8170f030594f3eb3c7e6dd81b76f65e18fc76f8b1a88' \
  -d '{
    "unLeadType": 0,
    "leadPositionType": 0,
    "tradeProtect": 1,
    "profitPeriod": 7,
    "profitRate": "10",
    "followAssetLowerLimit": "100",
    "fixedAmountFollowMin": "10",
    "fixedRateFollowMin": "1",
    "isNeedInvite": 0,
    "inviteScope": 0,
    "symbolIds": ["BTC-SWAP-USDT"]
  }'