REST API

3658api edited this page Jun 25, 2018 · 2 revisions

api访问root地址:

https://api.3658.net

1.现货行情接口

method: GET

uri: /v1/tickers

请求参数:

参数名称 参数类型 是否必须 描述 取值范围
symbol String true 支持的交易对 btc_cnyt,ltc_cnyt,eth_cnyt,cnytplus_cnyt

响应参数:

参数名称 参数类型 是否必须 描述
result object true 请求结果描述
date number true 响应时间戳(毫秒级)
ticker object true 行情信息

响应参数示例:

{
    "result":{
        "resCode":200,      // 响应状态码, 取值范围:200,500,其他
        "errMsg":"SUCCESS"  // 错误信息
    },
    "date":1510649131,    // 时间戳
    "ticker":{
        "high":"2",       // 24小时最高价
        "low":"2",        // 24小时最低价
        "last":"2",       // 最新成交价 
        "vol":"1",        // 24小时成交量
        "buy":"0.4",      // 买一价
        "sell":"0.6"      // 卖一价
    }
}

2.K线数据接口

method: GET

uri: /v1/kline

请求参数:

参数名称 参数类型 是否必须 描述 取值范围
symbol String true 支持的交易对 btc_cnyt,ltc_cnyt,eth_cnyt,cnytplus_cnyt
time String false 查询的时间维度,默认为1min 1min, 3min, 5min, 15min, 30min, 1hour, 2hour, 4hour, 6hour, 12hour, day, 3day, week
size int false 查询的条数,默认为1000

响应参数:

参数名称 参数类型 是否必须 描述
result object true 请求结果描述
date number true 响应时间戳(毫秒级)
kline List true K线信息

响应参数示例:

{
    "result":{
        "resCode":200,
        "errMsg":"SUCCESS"
    },
    "date":1510649131,    // 时间戳
    "kline":[
        [
            1510590960000,  // 时间戳
            2,              // 开盘价
            2,              // 收盘价
            2,              // 最高价
            2,              // 最低价
            1               // 24小时成交量
        ],
        [
            1510591020000,
            2,
            2,
            2,
            2,
            1
        ],
        [
            1510591080000,
            2,
            2,
            2,
            2,
            1
        ],
        [
            1510591140000,
            2,
            2,
            2,
            2,
            1
        ]
    ]
}

3.市场深度接口

method: GET

uri: /v1/depth

请求参数:

参数名称 参数类型 是否必须 描述 取值范围
symbol String true 支持的交易对 btc_cnyt,ltc_cnyt,eth_cnyt,cnytplus_cnyt
size int false 查询的条数,默认为200条 [0,200]

响应参数:

参数名称 参数类型 是否必须 描述
result object true 请求结果描述
date number true 响应时间戳(毫秒级)
askList List true 买方深度信息
bidList List true 卖方深度信息

响应参数示例:

{
    "result":{
        "resCode":200,
        "errMsg":"SUCCESS"
    },
    "date":1510649131,    // 时间戳
    "buyList":[
        [
            0.4,   // 挂单价
            1      // 挂单量
        ]
    ],
    "sellList":[
        [
            0.6,
            1
        ]
    ]
}

4.交易信息接口

method: GET

uri: /v1/trades

请求参数:

参数名称 参数类型 是否必须 描述 取值范围
symbol String true 支持的交易对 btc_cnyt,ltc_cnyt,eth_cnyt,cnytplus_cnyt
size int false 查询的条数,默认为200条 [0,200]

响应参数:

参数名称 参数类型 是否必须 描述
result object true 请求结果描述
date number true 响应时间戳(毫秒级)
trades List true 交易信息

响应参数示例:

{
    "result":{
        "resCode":200,
        "errMsg":"SUCCESS"
    },
    "trades":[
        {
            "amount":10,          // 交易量
            "time":1510208299333, // 交易时间毫秒级时间戳
            "type":2,             // 买入卖出类型 1:买入 2:卖出
            "price":2             // 交易价
        },
        {
            "amount":10,
            "time":1510207686910,
            "type":2,
            "price":1
        },
        {
            "amount":1,
            "time":1510133830736,
            "type":1,
            "price":0.0123
        },
        {
            "amount":0.9,
            "time":1510133361020,
            "type":1,
            "price":0.8
        }
    ]
}
Clone this wiki locally
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.