Skip to content

调用方式说明

BitForex-API edited this page Jul 31, 2018 · 3 revisions

行情API使用Get模式,其他API使用Post模式。
基于安全考虑,除行情API外的API请求都必须进行签名运算。一个合法的请求由以下几部分组成:

  • 方法请求地址 即访问服务器地址:https://api.bitforex.com 后面跟上方法名,比如 https://api.bitforex.com/api/v1/fund/mainAccount?currency=btc。

  • API 访问密钥(accessKey) 您申请的 APIKEY 中的accessKey。

  • 请求时间(nonce) 您发起请求的时间戳(毫秒)。

  • 签名(signData) 签名计算得出的值,用于确保签名有效和未被篡改。 ``` signData=hex(HMAC_SHA256(secretKey, content))

# 例请求链接
/api/v1/trade/placeOrder?
symbol=coin-usd-eth
&price=1000
&amount=1
&tradeType=1
&nonce=1501234567890
&accessKey=fd91cd9ba2cc78fed6bb40e0bcff29ba
       
# 对params进行排序(按首字母从小到大排序,首字母相同对比第二个字母):
accessKey=fd91cd9ba2cc78fed6bb40e0bcff29ba
&amount=1
&nonce=1501234567890
&price=1000
&symbol=coin-usd-eth
&tradeType=1

# 签名内容(content)为:
/api/v1/trade/placeOrder?accessKey=fd91cd9ba2cc78fed6bb40e0bcff29ba&amount=1&nonce=1501234567890&price=1000&symbol=coin-usd-eth&tradeType=1
  
# 用于签名密钥(secretKey):
82f192d903f363f22a031dfdbbeaf851
 
# 进行HMAC_SHA256加密并转为16进制,得到结果为:
2a0a848d76920a425190c5f2c509b45ef730956fac5331c79a988671223fd367

# 最终发送到服务器api请求为:
https://api.bitforex.com/api/v1/trade/placeBuyOrder?accessKey=fd91cd9ba2cc78fed6bb40e0bcff29ba&amount=1&nonce=1501234567890&price=1000&symbol=coin-usd-eth&signData=2a0a848d76920a425190c5f2c509b45ef730956fac5331c79a988671223fd367