接入指南

接入指南

• Python 示例
• Golang 示例
• Telegram API交流群

请求验证

API URL https://api.deepcoin.com

生成 APIKey

在对任何请求进行签名之前，您必须通过交易网站创建一个 APIKey。创建 APIKey 后，您将获得 3 个必须记住的信息：

• APIKey
• SecretKey
• Passphrase

APIKey 和 SecretKey 将由平台随机生成和提供，Passphrase 将由您提供以确保 API 访问的安全性。平台将存储 Passphrase 加密后的哈希值进行验证，但如果您忘记 Passphrase，则无法恢复，请您通过交易网站重新生成新的 APIKey。

每个 APIKey 最多可绑定 20 个 IP 地址；未绑定 IP 且拥有交易或提币权限的 APIKey，将在闲置 30 天之后自动删除。

发起请求

所有 REST 私有请求头都必须包含以下内容：

• DC-ACCESS-KEY 字符串类型的 APIKey。
• DC-ACCESS-SIGN 使用 HMAC SHA256 哈希函数获得哈希值，再使用 Base-64 编码（请参阅签名）。
• DC-ACCESS-TIMESTAMP 发起请求的时间（UTC），如：2020-12-08T09:08:57.715Z
• DC-ACCESS-PASSPHRASE 您在创建 API 密钥时指定的 Passphrase。

所有请求都将被格式化为 application/json 类型的请求，并且具有有效的 JSON。

签名

DC-ACCESS-SIGN 的请求头是由 timestamp + method + requestPath + body 字符串（+表示字符串拼接），以及 SecretKey，使用 HMAC SHA256方法加密，通过 Base-64编码输出而得到的。

如：

sign = CryptoJS.enc.Base64.stringify(
  CryptoJS.HmacSHA256(timestamp + 'GET' + '/users/self/verify', SecretKey)
)

其中，timestamp 的值为 DC-ACCESS-TIMESTAMP 请求头相同，为 ISO 格式，如 2020-12-08T09:08:57.715Z。

method 是请求方法，字母全部大写：GET 或 POST。 requestPath 是请求接口路径，例如：/deepcoin/account/balance。 body 是指请求主体的字符串，如果请求没有主体（通常为 GET 请求）则 body 可省略。如：

{ "instId": "BTC-USDT", "lever": "5", "mgnMode": "isolated" }

GET 请求参数是算作 requestPath，不算 body

SecretKey 为用户申请 APIKey 时所生成。如：22582BD0CFF14C41EDBF1AB98506286D