公共

1、 接口

接口地址:https://open.df.com/v1

2、 签名

签名生成规则如下:

参与签名的字段包括有效的 api_key (Token,其获取方式详见帮助中心), time (由开发者生成的当前时间戳),

对所有待签名参数按照字段名的 ASCII 码从小到大排序(字典序)后,使用 键值对的格式(即key1value1key2value2…)拼接成字符串 string1。注意:如果请求参数中的 value 为 NULL 的情况,则在拼接字符串时不计入签名字符串,参数名均为小写字符。

接下来对 string1 + KEY(密钥) 作 MD5 加密,字段名和字段值都采用原始值,不进行 string1 转义。即 sign=Md5(string1 + KEY)。

请求参数示例:
					
			{
			  api_key = **token**,
			  country = 86,
			  mobile = 15882133579,
			  password = 654321zz,
			  time = 1516007245,
			}
					
				
拼接完成后:
					
String1 = api_key**token**country86mobile15882133579password654321zztime1516007245
sign = MD5(string1 + secretKey)
					
				

3、 公共响应值

响应值示例:

			{
			  "code": "0",
			  "data": "响应数据",
			  "msg": "suc"
			}

						
响应数据描述如下:
节点名称(关键字) 父节点 描述 类型
code 响应码 string
data 响应数据 任意类型
msg 响应信息: suc 成功 string

行情

1、 获取系统支持的所有交易对相关信息

请求路径:/common/symbols
请求协议: GET / POST
接口签名:否
请求参数:无
响应值示例:

			{
			  "code": "0",
			  "data": [
			    {
			      "symbol": "btusdt",
			      "depthList": [
			        0.000001,
			        0.001,
			        0.01
			      ],
			      "name": "BT/USDT",
			      "base_coin": "BT",
			      "count_coin": "USDT",
			      "price_precision": 6,
			      "amount_precision": 0,
			      "limitPriceMin": 0.000001,
			      "limitVolumeMin": 100,
			      "marketBuyMin": 1e-7,
			      "marketSellMin": 0.000001
			    }
			    // 更多数据
			    ],
			  "msg": "suc"
			}

						
响应数据描述如下:
节点名称(关键字) 父节点 描述 类型
symbol data 币对代号 string
depthList data 深度 array
base_coin data 基础币种 string
name data 币对名称 string
count_coin data 计价币种 string
price_precision data 价格精度 integer
amount_precision data 数量金额 integer
limitPriceMin data 最小限价价格 float
limitVolumeMin data 最小限价数量 float
marketBuyMin data 最小市场买入额 float
marketSellMin data 最小市场卖出量 float

2、 获取全部交易对24小行情

请求路径:/get_all_tickers
请求协议: GET / POST
接口签名:否
请求参数:无
响应值示例:

			{
			  "code": "0",
			  "data": [
			    {
			      "amount": 12817.724911,
			      "high": 0.003074,
			      "low": 0.00296,
			      "open": 0.002982,
			      "buy": 0.003051,
			      "sell": 0.003053,
			      "symbol": "btusdt",
			      "baseCoin": "BT",
			      "quoteCoin": "USDT",
			      "rose": 0.02347418,
			      "name": "BT/USDT",
			      "vol": 4238234,
			      "last": 0.003052
			    }
			    // 更多数据
			  ],
			  "msg": "suc"
			}

						
响应数据描述如下:
节点名称(关键字) 父节点 描述 类型
symbol data 币对代号 string
amount data 成交额 float
high data 最高价 float
low data 最低价 float
open data 开盘价 float
buy data 买1价 float
sell data 卖1价 float
rose data 涨幅 float
baseCoin data 基础币种 string
quoteCoin data 计价币种 string
name data 交易对名称 string
vol data 成交量 float
last data 最新成交价 float

3、 获取24小行情

请求路径:/get_ticker
请求协议: GET / POST
接口签名:否
请求参数示例:

symbol=btcusdt
						
请求数据描述如下:
名称(关键字) 描述 必填
symbol 币对代号
响应值示例:

			{
			  "code": "0",
			  "data": {
			    "amount": 44960711.399694,
			    "high": 8030,
			    "low": 7712.61,
			    "open": 7761.75,
			    "buy": 7964.24,
			    "sell": 7970.86,
			    "symbol": "btcusdt",
			    "baseCoin": "BTC",
			    "quoteCoin": "USDT",
			    "rose": 0.02694109,
			    "name": "BTC/USDT",
			    "vol": 5697.343,
			    "last": 7970.86
			  },
			  "msg": "suc"
			}

						
响应数据描述如下:
节点名称(关键字) 父节点 描述 类型
symbol data 币对代号 string
amount data 成交额 float
high data 最高价 float
low data 最低价 float
open data 开盘价 float
buy data 买1价 float
sell data 卖1价 float
rose data 涨幅 float
baseCoin data 基础币种 string
quoteCoin data 计价币种 string
name data 交易对名称 string
vol data 成交量 float
last data 最新成交价 float

4、 获取全部币对的K线刻度

请求路径:/get_all_records
请求协议: GET / POST
接口签名:否
请求参数示例:

period=1
						
请求数据描述如下:
名称(关键字) 描述 必填
period 时间区间(分钟)(默认值:1)
响应值示例:

    {
      "code": "0",
      "data": [
        {
          "btusdt": {
            "baseCoin": "BT",
            "quoteCoin": "USDT",
            "data": [
              [
                560324840,
                0.003043,
                0.003044,
                0.003041,
                0.003041,
                2404
              ]
              // 更多数据
            ],
            "name": "BT/USDT"
          }
        }
        // 更多数据
      ],
      "msg": "suc"
    }

						
响应数据描述如下:
节点名称(关键字) 父节点 描述 类型
键值对Key data 币对代号 string
baseCoin 键值对Value 基础币种 string
quoteCoin 键值对Value 计价币种 string
data 键值对Value 数据:时间、开盘价、最高价、最低价、收盘价、成交量 array
name 键值对Value 交易对名称 string

5、 获取币对的K线刻度

请求路径:/get_records
请求协议: GET / POST
接口签名:否
请求参数示例:

symbol=btcusdt&period=1
						
请求数据描述如下:
名称(关键字) 描述 必填
symbol 交易对代号
period 时间区间(分钟)(默认值:1)
响应值示例:

			{
			  "code": "0",
			  "data": [
			    [
			      1560325200,
			      7950.14,
			      7950.15,
			      7944.26,
			      7948.65,
			      4.8202
			    ]
		  	    // 更多数据
			  ],
			  "msg": "suc"
			}
						
响应数据描述如下:
节点名称(关键字) 父节点 描述 类型
data 数据:时间、开盘价、最高价、最低价、收盘价、成交量 array

6、 获取行情最新成交记录

请求路径:/get_trades
请求协议: GET / POST
接口签名:否
请求参数示例:

symbol=btcusdt&page=1&size=10
						
请求数据描述如下:
名称(关键字) 描述 必填
symbol 币对代号
page 页数(默认值:1)
size 每页数量(默认值:10)
响应值示例:

			{
			  "code": "0",
			  "data": [
			    {
			      "id": "201906122010425843BA06-08F6-4157-825A-399712366C99",
			      "symbol": "btcusdt",
			      "date": "2019-06-12T12:10:42.000+0000",
			      "side": "BUY",
			      "price": 7966.97,
			      "volume": 0.131
			    }
			    // 更多数据
			  ],
			  "msg": "suc"
			}

						
响应数据描述如下:
节点名称(关键字) 父节点 描述 类型
symbol data 币对代号 string
id data 成交流水号 string
date data 成交时间 date
side data 成交主动方向,BUY:买入,SELL:卖出 string
price data 价格 float
volume data 数量 float

7、 获取所有币对的最新成交价

请求路径:/market
请求协议: GET / POST
接口签名:否
请求参数:无
响应值示例:

			{
			  "code": "0",
			  "data": {
			    "btcusdt": 7980.51
			  },
			  "msg": "suc"
			}

						
响应数据描述如下:
节点名称(关键字) 父节点 描述 类型
键值对key data 币对 string
键值对value data 最新成交价 float

8、 查询买卖盘深度

请求路径:/market_dept
请求协议: GET / POST
接口签名:否
请求参数示例:

symbol=btcusdt&type=0
						
请求数据描述如下:
名称(关键字) 描述 必填
symbol 币对代号
type 深度档位(默认值:0)
响应值示例:

			{
			  "code": "0",
			  "data": {
			    "tick": {
			      "asks": [
			        [
			          7989.36,
			          0.1869,
			          1
			        ]
			      ],
			      "bids": [
			        [
			          7981.8,
			          0.1333,
			          1
			        ]
			      ]
			    },
			    "time": 1560342030375
			  },
			  "msg": "suc"
			}

						
响应数据描述如下:
节点名称(关键字) 父节点 描述 类型
tick data 行情 object
asks tick 卖出:单价、数量、个数 array
bids tick 买入:单价、数量、个数 array

用户

1、 获取用户资产余额

请求路径:/user/account
请求协议: GET / POST
接口签名:是
请求参数示例:

api_key=您的Token&sign=签名&time=1234567890
						
请求数据描述如下:
名称(关键字) 描述 必填
api_key 您的Token
sign 签名
time 时间戳
响应值示例:

			{
			  "code": "0",
			  "data": {
			    "coin_list": [
			      {
			        "coin": "usdt",
			        "locked": 0,
			        "normal": 0
			      }
			    ]
			  },
			  "msg": "suc"
			}

						
响应数据描述如下:
节点名称(关键字) 父节点 描述 类型
coin_list data 币种列表 array
coin data 币种名称 string
normal data 可用余额 float
locked data 冻结余额 float

币币交易

1、 查询全部订单

请求路径:/all_order
请求协议: GET / POST
接口签名:是
请求参数示例:

api_key=您的Token&sign=签名&time=1234567890&page=1&pageSize=10&symbol=btcusdt
						
请求数据描述如下:
名称(关键字) 描述 必填
api_key 您的Token
sign 签名
time 时间戳
page 页数(默认值:1)
pageSize 每页数量(默认值:10)
symbol 交易对代号
响应值示例:

			{
			  "code": "0",
			  "data": {
			    "rows": [
			      {
			        "baseCoin": "string",
			        "createdDate": "2019-06-12T12:46:34.778Z",
			        "date": "2019-06-12T12:46:34.778Z",
			        "feeRate": 0,
			        "id": "string",
			        "price": 0,
			        "quoteCoin": "string",
			        "side": "BUY",
			        "source": "WEB",
			        "success": true,
			        "symbol": "string",
			        "totalAmount": 0,
			        "totalVolume": 0,
			        "tradeCount": 0,
			        "trading": true,
			        "type": "LIMIT",
			        "volume": 0
			      }
			    ],
			    "total": 0
			  },
			  "msg": "suc"
			}

						
响应数据描述如下:
节点名称(关键字) 父节点 描述 类型
rows data 数据列表 array
total data 总页数 integer
baseCoin rows 基础币种 string
createdDate rows 创建时间 date
data rows 生效时间 date
feeRate rows 手续费率 float
id rows 订单号 string
price rows 价格 float
quoteCoin rows 计价币种 string
side rows 方向 string
source rows 来源:网页端(WEB)、APP、H5、API string
success rows 是否成功 boolean
symbol rows 交易对代号 string
totalAmount rows 成交金额 float
totalVolume rows 成交数量 float
tradeCount rows 成交次数 string
trading rows 是否在交易 boolean
type rows 类型:限价(LIMIT)、市价(MARKET) string
volume rows 数量 float

2、 下单

请求路径:/create_order
请求协议: GET / POST
接口签名:是
请求参数示例:

api_key=您的Token&sign=签名&time=1234567890&symbol=btcusdt&price=7000&side=BUY&type=1&volume=0.01&noticeId=EX201912021603250775DE4C54D4F757C0B72FC60DA&callbackUrl=https://btbtbt.com
						
请求数据描述如下:
名称(关键字) 描述 必填
api_key 您的Token
sign 签名
time 时间戳
symbol 交易对代号
price 价格,限价方式必填,市价方式勿填
side 方向:BUY(买入)、SELL(卖出)
type 挂单类型:1(限价委托)、2(市价委托)
volume 数量
callbackUrl 订单状态变更、成交数据回调地址
noticeId 通知 ID
响应值示例:

			{
			  "code": "0",
			  "data": "单号",
			  "msg": "suc"
			}

						
响应数据描述如下:
节点名称(关键字) 父节点 描述 类型
data 订单号 string

2.1 订单状态变更、成交数据回调接口详情

请求路径:callbackUrl
请求协议: POST
接口签名:否
回调数据描述如下:
  • 下单成功 noticeType = ORDER_CREATE
名称(关键字) 描述 数据类型
noticeType 通知类型 = ORDER_CREATE string
noticeId 通知 ID string
id 订单 ID string
symbol 币对 string
baseCoin 基础币种 string
quoteCoin 计价币种 string
price 价格 float
volume 数量 float
feeRate 手续费率 float
side 方向:BUY(买入)、SELL(卖出) string
type 类型:限价(LIMIT)、市价(MARKET) string
createdDate 创建时间 date
date 生效时间 date
trading 是否交易中 boolean
tradeCount 成交笔数 long
totalVolume 成交量 float
totalAmount 成交额 float
success 是否成功 boolean
回调值示例:

		{
		  "noticeId":"20616474296C772C8-9A3B-40DE11A68F23405",
		  "id":"EX201912061647427675DEA15AB605FAB602ED0", "symbol":"forusdt",
		  "baseCoin":"BT",
		  "quoteCoin":"USDT",
		  "price":0.020786,
		  "volume":88888.88,
		  "feeRate":null,
		  "side":"BUY",
		  "type":"LIMIT",
		  "date":null,
		  "createdDate":1575622063000,
		  "trading":null,
		  "success":null,
		  "noticeType":"ORDER_CREATE"
		}
				
  • 撤单 noticeType = ORDER_CANCEL
名称(关键字) 描述 数据类型
noticeType 通知类型 = ORDER_CANCEL string
noticeId 通知 ID string
id 撤单 ID string
orderId 订单 ID string
memberId 会员 ID integer
side 方向:BUY(买入)、SELL(卖出) string
coin 币种 string
volume 数量 float
createdDate 创建时间 date
updatedDate 修改时间 date
回调值示例:

		{
		  "noticeId":"20616474296C772C8-9A3B-40DE11A68F23405",
		  "id":"201912061647426005DEA156B5CE61A8E",
		  "orderId":"EX201912061647427675DEA15AB605FAB602ED0",
		  "memberId":8888,
		  "side":"BUY",
		  "symbol":"btusdt",
		  "coin":"USDT",
		  "volume":888888.88,
		  "createdDate":1575622063000,
		  "updatedDate":1575622063000,
		  "noticeType":"ORDER_CANCEL"
		}
				
  • 完成 noticeType = ORDER_FINISH
名称(关键字) 描述 数据类型
noticeType 通知类型 = ORDER_FINISH string
noticeId 通知 ID string
id 订单 ID string
回调值示例:

		{
		  "noticeId":"20616474296C772C8-9A3B-40DE11A68F23405",
		  "id":"EX201912061647427675DEA15AB605FAB602ED0",
		  "noticeType":"ORDER_FINISH"   
		}
					
  • 成交 noticeType = DEAL_CREATE
名称(关键字) 描述 数据类型
noticeType 通知类型 = DEAL_CREATE string
noticeId 通知 ID string
id 成交 ID string
memberId 会员 ID integer
tradeId 交易 ID string
orderId 订单 ID string
side 方向:BUY(买入)、SELL(卖出) string
symbol 币对 string
volume 数量 float
orderPrice 订单价格 float
price 成交价格 float
payCoin 付出币种 string
gainCoin 得到币种 string
payVolume 付出数量 float
gainVolume 得到数量 float
feeRate 手续费率 double
fee 手续费 float
feeCoin 手续费币种 string
back 退还数量 float
createdDate 创建时间 date
updatedDate 修改时间 date
回调值示例:

		{
		  "noticeId":"20616474296C772C8-9A3B-40DE11A68F23405",
		  "id":"201912061648405E88F46E91FD180603F",
		  "memberId":8888,
		  "tradeId":"20191206164840TD5DEA8414E18CFAA9",
		  "orderId":"EX201912061647427675DEA15AB605FAB602ED0",
		  "side":"BUY",
		  "symbol":"btusdt",
		  "volume":88888.88,
		  "orderPrice":0.014508,
		  "price":0.014462,
		  "payCoin":"USDT",
		  "gainCoin":"TRX",
		  "payVolume":6.54174108,
		  "gainVolume":452.34,
		  "feeRate":null,
		  "fee":null,
		  "feeCoin":null,
		  "back":0.02080764,
		  "createdDate":1575622120000,
		  "updatedDate":1575622120000,
		  "noticeType":"DEAL_CREATE"    
		}
				
返回值示例

"success"
				
响应数据描述如下:
名称(关键字) 描述 数据类型
SUCCESS 成功返回 string

3、 撤单

请求路径:/cancel_order
请求协议: GET / POST
接口签名:是
请求参数示例:

api_key=您的Token&sign=签名&time=1234567890&order_id=EX12345679&symbol=ethusdt
						
请求数据描述如下:
名称(关键字) 描述 必填
api_key 您的Token
sign 签名
time 时间戳
order_id 订单号
symbol 交易对代号
响应值示例:

			{
			  "code": "0",
			  "data": "单号",
			  "msg": "suc"
			}

						
响应数据描述如下:
节点名称(关键字) 父节点 描述 类型
data 订单号 string

4、 指定单号批量撤单

请求路径:/batchCancel
请求协议: POST
接口签名:是
请求参数示例:

		{
		  api_key = 您的Token,
		  param= {
		    "maxPrice": 1,
		    "minPrice": 0,
		    "orderList": [
		      "string"
		    ],
		    "side": "BUY",
		    "size": 0,
		    "symbol": "string"
		  },
		  sign= 签名,
		  time = 1516007245,
		}
				
请求数据描述如下:
名称(关键字) 描述 必填
api_key 您的Token
param.maxPrice 最高价
param.minPrice 最低价
param.orderList 订单号(类型:array)
param.side 方向:BUY(买入)、SELL(卖出)
param.size 撤单数量(默认值1,最大数量2000)
param.symbol 交易对代号
sign 签名
time 时间戳
响应值示例:

		{
		  "code": "0",
		  "data": "单号",
		  "msg": "suc"
		}
				
响应数据描述如下:
名称(关键字) 父节点 描述 类型
data 订单号 string

5、 批量撤单

请求路径:/cancel_order_all
请求协议: GET / POST
接口签名:是
请求参数示例:

api_key=您的Token&sign=签名&time=1234567890&symbol=btcusdt&size=50&pageSize=10
						
请求数据描述如下:
名称(关键字) 描述 必填
api_key 您的Token
sign 签名
time 时间戳
symbol 交易对代号
size 撤单数量(默认值:50)
pageSize 每页数量(默认值:10)
响应值示例:

			{
			  "code": "0",
			  "data": "单号",
			  "msg": "suc"
			}
						
响应数据描述如下:
节点名称(关键字) 父节点 描述 类型
data 订单号 array

6、 查询委托中的订单

请求路径:/new_order
请求协议: GET / POST
接口签名:是
请求参数示例:

api_key=您的Token&sign=签名&time=1234567890&page=1&pageSize=10&symbol=btcusdt
						
请求数据描述如下:
名称(关键字) 描述 必填
api_key 您的Token
sign 签名
time 时间戳
page 页数(默认值:1)
pageSize 每页数量(默认值:10)
symbol 交易对代号
响应值示例:

			{
			  "code": "0",
			  "data": {
			    "rows": [
			      {
			        "baseCoin": "string",
			        "createdDate": "2019-06-12T12:46:34.778Z",
			        "date": "2019-06-12T12:46:34.778Z",
			        "feeRate": 0,
			        "id": "string",
			        "price": 0,
			        "quoteCoin": "string",
			        "side": "BUY",
			        "source": "WEB",
			        "success": true,
			        "symbol": "string",
			        "totalAmount": 0,
			        "totalVolume": 0,
			        "tradeCount": 0,
			        "trading": true,
			        "type": "LIMIT",
			        "volume": 0
			      }
			    ],
			    "total": 0
			  },
			  "msg": "suc"
			}

						
响应数据描述如下:
节点名称(关键字) 父节点 描述 类型
rows data 数据列表 array
total data 总页数 integer
baseCoin rows 基础币种 string
createdDate rows 创建时间 date
date rows 生效时间 date
feeRate rows 手续费率 float
id rows 订单号 string
price rows 价格 float
quoteCoin rows 计价币种 string
side rows 方向 string
source rows 来源:网页端(WEB)、APP、H5、API string
success rows 是否成功 boolean
symbol rows 交易对代号 string
totalAmount rows 成交金额 float
totalVolume rows 成交数量 float
tradeCount rows 成交次数 string
trading rows 是否在交易 boolean
type rows 类型:限价(LIMIT)、市价(MARKET) string
volume rows 数量 float

7、 获取订单详情

请求路径:/order_info
请求协议: GET / POST
接口签名:是
请求参数示例:

api_key=您的Token&sign=签名&time=1234567890&order_id=EX1223456789&notice_id=EX1223456789&symbol=ethusdt
						
请求数据描述如下:
名称(关键字) 描述 必填
api_key 您的Token
sign 签名
time 时间戳
order_id 订单号
notice_id 通知 ID
symbol 交易对代号
响应值示例:

			{
			  "code": "0",
			  "data": {
			    "baseCoin": "string",
			    "createdDate": "2019-06-12T12:46:34.778Z",
			    "date": "2019-06-12T12:46:34.778Z",
			    "feeRate": 0,
			    "id": "string",
			    "price": 0,
			    "quoteCoin": "string",
			    "side": "BUY",
			    "source": "WEB",
			    "success": true,
			    "symbol": "string",
			    "totalAmount": 0,
			    "totalVolume": 0,
			    "tradeCount": 0,
			    "trading": true,
			    "type": "LIMIT",
			    "volume": 0
			  },
			  "msg": "suc"
			}

						
响应数据描述如下:
节点名称(关键字) 父节点 描述 类型
baseCoin data 基础币种 string
createdDate data 创建时间 date
date rows 生效时间 date
feeRate data 手续费率 float
id data 订单号 string
price data 价格 float
quoteCoin data 计价币种 string
side data 方向 string
source data 来源:网页端(WEB)、APP、H5、API string
success data 是否成功 boolean
symbol data 交易对代号 string
totalAmount data 成交金额 float
totalVolume data 成交数量 float
tradeCount data 成交次数 string
trading data 是否在交易 boolean
type data 类型:限价(LIMIT)、市价(MARKET) string
volume data 数量 float

8、 获取所有币对的交易数据

请求路径:/all_trade
请求协议: GET / POST
接口签名:是
请求参数示例:

api_key=您的Token&sign=签名&time=1234567890&order_id=EX1223456789&&symbol=ethusdt&page=1&pageSize=20&sort=1
										
请求数据描述如下:
名称(关键字) 描述 必填
api_key 您的Token
sign 签名
time 时间戳
order_id 订单号
symbol 交易对代号
page 页数(默认值:1)
pageSize 每页数量(默认值:20)
sort 排序方式:0(升序),1(降序)(默认值:1)
响应值示例:

		{
		  "code": "0",
		  "data": {
		    "rows": [
		      {
		        "id":"201912061648405E88F46E91FD18060 3F",
		        "orderId":"EX201912061647427675DEA15AB605FAB602ED0",
		        "side":"BUY",
		        "symbol":"btusdt",
		        "volume":88888.88,
		        "orderPrice":0.014508,
		        "price":0.014462,
		        "payCoin":"USDT",
		        "gainCoin":"ETH",
		        "payVolume":6.54174108,
		        "gainVolume":452.34,
		        "feeRate":null,
		        "fee":null,
		        "back":0.02080764,
		        "createdDate":1575622120000,
		      }
		    ],
		    "total": 0
		  },
		  "msg": "suc"
		}

				
响应数据描述如下:
节点名称(关键字) 父节点 描述 类型
rows data 数据列表 array
total data 总页数 integer
id rows 成交 ID string
orderId rows 订单 ID string
side rows 方向:BUY(买入)、SELL(卖出) string
symbol rows 交易对代号 string
volume rows 成交数量 float
orderPrice rows 订单价格 float
price rows 成交价格 float
payCoin rows 付出币种 string
gainCoin rows 得到币种 string
payVolume rows 付出数量 float
gainVolume rows 得到数量 float
feeRate rows 手续费率 double
fee rows 手续费 float
back rows 退还数量 float
createdDate rows 创建时间 date