数据中心对外接口文档 - Xiaotian0617/Center GitHub Wiki
以下接口无特殊说明均为MediaType.APPLICATION_JSON_UTF8_VALUE格式
即json格式请求，部分get方法除外
接口请求地址前缀：http://xxx.com/data
前言：
- 以下返回接口可能随时间推移会有变化，请关注本文最新更新时间。
- 返回数据格式目前带有返回码，返回码会在这篇文章中详谈，下方返回的数据格式仅包含有效的数据返回即data中的数据，不包含状态码类的数据
- 状态码的返回的标准格式为：
{
"code": 0,
"data":{},
"dialog":{
"cancelAndClose": false,
"cancelBtn": "",
"cancelColor": "",
"code": "0",
"confirmBtn": "",
"confirmColor": "",
"content": "",
"contentColor": "",
"time": "",
"title": "OK",
"titleColor": "",
"type": "3",
"url": ""
}
}
接口正文：
- 获得所有库中拥有的全部OnlyKey列表
接口名：/getAllOnlyKeys
所需参数：无
请求方式：get/post
异常返回代码：6000 即请求失败，服务器异常
正常返回数据举例:
{
"data": [
{
"onlyKey": "Bcex_BTC_CKUSD",
"time": "1.519712599E9"
},
{
"onlyKey": "Bcex_BTC_CNET",
"time": "1.519712585E9"
},
{
"onlyKey": "Bcex_ETH_BTC",
"time": "1.519712585E9"
},
{
"onlyKey": "Bcex_ETH_CKUSD",
"time": "1.51971261E9"
},
{
"onlyKey": "Bcex_XRP_BTC",
"time": "1.519712595E9"
}
]
}
- 获得所有库中拥有的交易所列表
接口名：/getAllEXchange
所需参数：无
请求方式：get/post
异常返回代码：6000 即请求失败，服务器异常
正常返回数据举例：
{
"data": [
{
"cName": "",
"eName": "Bcex"
},
{
"cName": "",
"eName": "Bibox"
},
{
"cName": "",
"eName": "Bigone"
},
{
"cName": "",
"eName": "Binance"
}
]
}
- 获得所有市值信息
接口名：/getAllMarketCaps
所需参数:
| 参数名 | 参数说明 |
|---|---|
| offset | 当前页面，从0开始 |
| limit | 每页显示条数 |
请求方式：post （但参数需跟到请求地址后方，类似于Get请求，后期会优化，未传值返回全部）
异常返回代码：6000 即请求失败，服务器异常
正常返回数据举例：
{
"data": [
{
"24h_volume_usd": 6926810000,
"availableSupply": 16890687,
"id": "bitcoin",
"lastUpdated": 0,
"marketCapUsd": 181529280395,
"maxSupply": 21000000,
"name": "Bitcoin",
"onlyKey": "MarketCap_BITCOIN",
"percentChange1h": -0.21,
"percentChange24h": 4.26,
"percentChange7d": -5.03,
"priceBtc": 1,
"priceUsd": 10747.3,
"rank": 1,
"symbol": "BTC",
"totalSupply": 16890687
},
{
"24h_volume_usd": 2072190000,
"availableSupply": 97887413,
"id": "ethereum",
"lastUpdated": 0,
"marketCapUsd": 86379768396,
"maxSupply": 0,
"name": "Ethereum",
"onlyKey": "MarketCap_ETHEREUM",
"percentChange1h": -0.32,
"percentChange24h": 1.37,
"percentChange7d": -1.93,
"priceBtc": 0.0824792,
"priceUsd": 882.44,
"rank": 2,
"symbol": "ETH",
"totalSupply": 97887413
}]
}
| 参数名 | 参数说明 |
|---|---|
| 24h_volume_usd | 24小时美元交易量 |
| availableSupply | 流通量* |
| lastUpdated | 最后更新时间* |
| marketCapUsd | 美元市值 |
| maxSupply | 最大流通量* |
| name | 币种全称 |
| onlyKey | 系统内部唯一标识码 |
| percentChange1h | 1小时涨跌幅 |
| percentChange24h | 24小时涨跌幅 |
| percentChange7d | 7天涨跌幅 |
| priceBtc | 截止目前可兑换BTC数量 |
| priceUsd | 截止目前可兑换USD数量 |
| rank | 币种排行 |
| symbol | 币种简称 |
| totalSupply | 流通总量* |
| 上文中*表示本系统中尚未使用的数据或意义不明，意义仅供参考 |
- 根据某个币种全称查询币种市值信息
接口名：/getMarketCapById
所需参数:
{
"ename":"bitcoin"
}
请求方式：post
异常返回代码：
6000 即请求失败，服务器异常
1000 即参数错误
正常返回数据举例：
{
"data": {
"24h_volume_usd": 6940580000,
"availableSupply": 16890750,
"id": "",
"lastUpdated": 0,
"marketCapUsd": 182067083325,
"maxSupply": 21000000,
"name": "Bitcoin",
"onlyKey": "MarketCap_BITCOIN",
"percentChange1h": 0.09,
"percentChange24h": 4.51,
"percentChange7d": -4.63,
"priceBtc": 1,
"priceUsd": 10779.1,
"rank": 1,
"symbol": "",
"totalSupply": 16890750
}
}
| 参数名 | 参数说明 |
|---|---|
| 24h_volume_usd | 24小时美元交易量 |
| availableSupply | 流通量* |
| lastUpdated | 最后更新时间* |
| marketCapUsd | 美元市值 |
| maxSupply | 最大流通量* |
| name | 币种全称 |
| onlyKey | 系统内部唯一标识码 |
| percentChange1h | 1小时涨跌幅 |
| percentChange24h | 24小时涨跌幅 |
| percentChange7d | 7天涨跌幅 |
| priceBtc | 截止目前可兑换BTC数量 |
| priceUsd | 截止目前可兑换USD数量 |
| rank | 币种排行 |
| symbol | 币种简称 |
| totalSupply | 流通总量* |
| 上文中*表示本系统中尚未使用的数据或意义不明，意义仅供参考 |
- 根据某个币种简称查询相关币种的行情信息
接口名：/getAllMarketBySymbol
所需参数:
{
"coinName":"BTC",
"offset":0,(当前页码，从0开始，未传值查询全部)
"limit":10（页面展示条数，未传值查询全部）
}
请求方式：post
异常返回代码：
6000 即请求失败，服务器异常
1000 即参数错误
正常返回数据举例：
{
"data": [
{
"amt": 0,
"ask": 0,
"bid": 0,
"c": 0,
"ch": 1.389371,
"exch": "Bcex",
"from": "Exchange",
"h": 0,
"key": "Bcex_BTC_CKUSD",
"l": 0,
"la": 10512.05,
"o": 0,
"sym": "BTC",
"ts": 1519788978693,
"unit": "CKUSD",
"vol": 1428.2545,
"z8": -3.18613
},
{
"amt": 0,
"ask": 0,
"bid": 0,
"c": 0,
"ch": -0.018084,
"exch": "Bcex",
"from": "Exchange",
"h": 0,
"key": "Bcex_BTC_CNET",
"l": 0,
"la": 49979.81,
"o": 0,
"sym": "BTC",
"ts": 1519786317996,
"unit": "CNET",
"vol": 0.0102,
"z8": -0.00016
}
]
}
| 参数名 | 参数说明 |
|---|---|
| amt | amount,24小时交易额* |
| ask | 卖一 |
| bid | 买一 |
| c | close,收盘价 |
| ch | change,24小时涨跌幅 |
| exch | exchange,交易所名称 |
| from | 数据来源 |
| h | high,最高价 |
| key | OnlyKey,系统内唯一标识码 |
| l | low,最低价 |
| la | last,最新一笔成交价 |
| o | open,开盘价 |
| sym | symbol,币种简称 |
| ts | 数据最新时间 |
| unit | 单位（市场） |
| vol | volume,24小时交易量 |
| z8 | 中国式涨跌幅（与东八区凌晨的数据比较） |
| 上文中*表示本系统中尚未使用的数据或意义不明，意义仅供参考 |
- 根据某个交易所名称查询相关币种的行情信息
接口名：/getAllMarketByExchange
所需参数:
{
"exchangeName":"Huobi",
"offset":0,(当前页码，从0开始，未传值查询全部)
"limit":10（页面展示条数，未传值查询全部）
}
请求方式：post
异常返回代码：
6000 即请求失败，服务器异常
1000 即参数错误
正常返回数据举例：
{
"data": [
{
"amt": 0,
"ask": 10930.09,
"bid": 10930,
"c": 0,
"ch": 6.343854,
"exch": "Huobi",
"from": "Exchange",
"h": 10947.61,
"key": "Huobi_BTC_USDT",
"l": 10216.05,
"la": 10930,
"o": 0,
"sym": "BTC",
"ts": 1519789179374,
"unit": "USDT",
"vol": 12655,
"z8": 3.3645
},
{
"amt": 0,
"ask": 885.8,
"bid": 883.51,
"c": 0,
"ch": 1.841197,
"exch": "Huobi",
"from": "Exchange",
"h": 895.5,
"key": "Huobi_ETH_USDT",
"l": 864.21,
"la": 884.82,
"o": 0,
"sym": "ETH",
"ts": 1519789183432,
"unit": "USDT",
"vol": 52493,
"z8": 1.309584
}
]
}
| 参数名 | 参数说明 |
|---|---|
| amt | amount,24小时交易额* |
| ask | 卖一 |
| bid | 买一 |
| c | close,收盘价 |
| ch | change,24小时涨跌幅 |
| exch | exchange,交易所名称 |
| from | 数据来源 |
| h | high,最高价 |
| key | OnlyKey,系统内唯一标识码 |
| l | low,最低价 |
| la | last,最新一笔成交价 |
| o | open,开盘价 |
| sym | symbol,币种简称 |
| ts | 数据最新时间 |
| unit | 单位（市场） |
| vol | volume,24小时交易量 |
| z8 | 中国式涨跌幅（与东八区凌晨的数据比较） |
| 上文中*表示本系统中尚未使用的数据或意义不明，意义仅供参考 |
- 根据某个交易所名称或币种简称查询相关币种的行情信息
接口名：/getAllMarketByExchangeOrSymbol
所需参数:
{
"name":"Huobi",
"offset":0,(当前页码，从0开始，未传值查询全部)
"limit":10（页面展示条数，未传值查询全部）
}
请求方式：post
异常返回代码：
6000 即请求失败，服务器异常
1000 即参数错误
正常返回数据举例：
{
"data": [
{
"amt": 0,
"ask": 10930.09,
"bid": 10930,
"c": 0,
"ch": 6.343854,
"exch": "Huobi",
"from": "Exchange",
"h": 10947.61,
"key": "Huobi_BTC_USDT",
"l": 10216.05,
"la": 10930,
"o": 0,
"sym": "BTC",
"ts": 1519789179374,
"unit": "USDT",
"vol": 12655,
"z8": 3.3645
},
{
"amt": 0,
"ask": 885.8,
"bid": 883.51,
"c": 0,
"ch": 1.841197,
"exch": "Huobi",
"from": "Exchange",
"h": 895.5,
"key": "Huobi_ETH_USDT",
"l": 864.21,
"la": 884.82,
"o": 0,
"sym": "ETH",
"ts": 1519789183432,
"unit": "USDT",
"vol": 52493,
"z8": 1.309584
}
]
}
| 参数名 | 参数说明 |
|---|---|
| amt | amount,24小时交易额* |
| ask | 卖一 |
| bid | 买一 |
| c | close,收盘价 |
| ch | change,24小时涨跌幅 |
| exch | exchange,交易所名称 |
| from | 数据来源 |
| h | high,最高价 |
| key | OnlyKey,系统内唯一标识码 |
| l | low,最低价 |
| la | last,最新一笔成交价 |
| o | open,开盘价 |
| sym | symbol,币种简称 |
| ts | 数据最新时间 |
| unit | 单位（市场） |
| vol | volume,24小时交易量 |
| z8 | 中国式涨跌幅（与东八区凌晨的数据比较） |
| 上文中*表示本系统中尚未使用的数据或意义不明，意义仅供参考 |
- 根据OnlyKey获取K线数据
接口名：/getKlineByOnlyKey
所需参数:
{
"onlyKey":"Huobi_BTC_USDT",
"timeType":"kline_1d"(可选参数，默认kline),
"lastTime":1519797449(可选参数，最后一根的K线数据时间，默认最新500条K线)
}
请求方式：post
异常返回代码：
6000 即请求失败，服务器异常
1000 即参数错误
正常返回数据举例
{
"data": [
{
"close": 10950,
"exchange": "",
"high": 10977.6,
"id": "",
"low": 10567,
"onlyKey": "Huobi_BTC_USDT",
"open": 10569.91,
"symbol": "",
"timestamp": 1519776000,
"type": "",
"unit": "",
"volume": 3303.071994520797
}
]
}
| 参数名 | 参数说明 |
|---|---|
| close | 收盘价 |
| exchange | 交易所名称 |
| high | 最高价 |
| id | * |
| low | 最低价 |
| onlyKey | 系统内唯一标识码 |
| open | 开盘价 |
| symbol | 币种简称 |
| timestamp | 数据最新时间 |
| type | 数据来源* |
| unit | 单位（市场） |
| volume | 交易量 |
| 上文中*表示本系统中尚未使用的数据或意义不明，意义仅供参考 |
- 获得现在服务器所有的数据汇率
接口名：/getAllPriceRate
所需参数: 无 请求方式：post
异常返回代码：
6000 即请求失败，服务器异常
正常返回数据举例
{
"data": {
"JPY,USD": 0.0093617,
"ETH,USD": 887.552,
"LTC,USD": 219.827,
"USD,USD": 1,
"KRW,USD": 0.00093319,
"USD,JPY": 106.82,
"KRW,CNY": 0,
"USD,KRW": 0,
"EUR,USD": 1.232,
"USD,CNY": 6.3087,
"USDT,USD": 1,
"BIG,USD": 3.1546,
"USD,USDT": 1,
"EUR,CNY": 0,
"JPY,CNY": 0,
"BCH,USD": 1262.55,
"USD,EUR": 0,
"BTC,USD": 10975.6,
"BNB,USD": 11.0451,
"CNY,USD": 0.15851
}
}
注:JPY,USD 表示拿JPY换USD的汇率
9. 获得现在服务器所有的数据汇率
接口名：/getPriceRateByKey
所需参数:
json { "key":"USD,CNY" }
请求方式：post
异常返回代码：
6000 即请求失败，服务器异常
正常返回数据举例
{
"data": {
"key": "USD,CNY",
"rate": 6.3087
}
}
注:JPY,USD 表示拿JPY换USD的汇率