API文档
  • 获取单个订单的交易明细

    1.请求URL:https://www.zerogoe.com/o/api/order/trades/{symbol}/{id}/{api_key}/{timestamp}/{sign_type}/{sign}

    2.请求类型:GET

    3.请求参数:

    参数 类型 是否参与签名 描述 示例
    symbol String 交易对名称 ETHQC
    id Integer 订单id 142455
    api_key String 用户apikey 5b092b11-001c-4e50-9d8e-00f9db752241
    timestamp long 时间戳精确到秒 1540619752
    sign_type String 签名类型 MD5
    sign String 具体查看签名认证 3cbbe236e86105b1a041cfe1fe01

    4.返回参数

    参数 类型 描述 示例
    state Integer 请求状态1成功,-1失败 1
    msg String 请求状态说明 success
    trades array 交易明细
    total int 返回的数量 1

    5.请求成功示例

    {
        state: 1,
        msg: "success",
        trades: [{略}],
        total: 0
        }

    6.请求失败示例

    {
        state: -1,
        msg: "ILLEGAL_TIMESTAMP",
        trades: null,
        total: 0
        }


  • 获取订单列表

    1.请求URL:https://www.zerogoe.com/o/api/orders/{symbol}/{page}/{page_size}/{status}/{api_key}/{timestamp}/{sign_type}/{sign}

    2.请求类型:GET

    3.请求参数:

    参数 类型 是否参与签名 描述 示例
    symbol String 交易对名称 ETHQC
    page Integer 页码,起始页码为1 1
    page_size Integer 每页数量,最大20 20
    status String 0表示未完成(挂单中),1表示已完成(含已取消),2表示所有 1
    api_key String 用户apikey 5b092b11-001c-4e50-9d8e-00f9db752241
    timestamp long 时间戳精确到秒 1540619752
    sign_type String 签名类型 MD5
    sign String 具体查看签名认证 3cbbe236e86105b1a041cfe1fe01

    4.返回参数

    参数 类型 描述 示例
    state Integer 请求状态1成功,-1失败 1
    msg String 查询的交易对名称 ETHQC
    orders array 订单列表
    total Integer 返回的数量 1

    5.请求成功示例

    {
        state: 1,
        msg: "ETHQC",
        orders: [{略},{略},{略} ],
        total: 0
        }

    6.请求失败示例

    {
        state: -1,
        msg: "ILLEGAL_TIMESTAMP",
        orders: null,
        total: 0
        }


  • 获取已成交记录

    1.请求URL:https://www.zerogoe.com/o/api/trades/{symbol}/{page}/{pageSize}/{api_key}/{timestamp}/{sign_type}/{sign}

    2.请求类型:GET

    3.请求参数:

    参数 类型 是否参与签名 描述 示例
    symbol String 交易对名称 ETHQC
    page Integer 页码,起始页码为1 1
    page_size Integer 每页数量,最大20 20
    api_key String 用户apikey 5b092b11-001c-4e50-9d8e-00f9db752241
    timestamp long 时间戳精确到秒 1540619752
    sign_type String 签名类型 MD5
    sign String 具体查看签名认证 3cbbe236e86105b1a041cfe1fe01

    4.返回参数

    参数 类型 描述 示例
    state Integer 请求状态1成功,-1失败 1
    msg String 请求状态说明 success
    trades array 交易明细
    total int 返回的数量 1

    5.请求成功

    {
        state: 1,
        msg: "success",
        trades: [{略},{略},{略}],
        total: 0
        }

    6.请求失败

    {
        state: -1,
        msg: "ILLEGAL_TIMESTAMP",
        trades: null,
        total: 0
        }


  • 获取单个币的资产

    1.请求URL:https://www.zerogoe.com/a/api/account/{currency}/{api_key}/{timestamp}/{sign_type}/{sign}

    2.请求类型:GET

    3.请求参数:

    参数 类型 是否参与签名 描述 示例
    currency String 货币名称 ETH
    api_key String 用户apikey 5b092b11-001c-4e50-9d8e-00f9db752241
    timestamp long 时间戳精确到秒 1540619752
    sign_type String 签名类型 MD5
    sign String 具体查看签名认证 3cbbe236e86105b1a041cfe1fe01

    4.返回参数

    参数 类型 描述 示例
    state Integer 请求状态1成功,-1失败 1
    msg String 请求状态说明 success
    account Object 账户明细

    5.请求成功示例

    {
        state: 1,
        msg: "success",
            account: {
            currency: "ETH",
            total_balance: 0,
            rozen_balance: 0,
            available_balance: 0
        }
        }

    6.请求失败示例

    {
        state: -1,
        msg: "ILLEGAL_TIMESTAMP",
        trades: null
        }


  • 获得会员资产列表

    1.请求URL:https://www.zerogoe.com/a/api/accounts/{api_key}/{timestamp}/{sign_type}/{sign}

    2.请求类型:GET

    3.请求参数:

    参数 类型 是否参与签名 描述 示例
    api_key String 用户apikey 5b092b11-001c-4e50-9d8e-00f9db752241
    timestamp long 时间戳精确到秒 1540619752
    sign_type String 签名类型 MD5
    sign String 具体查看签名认证 3cbbe236e86105b1a041cfe1fe01

    4.返回参数

    参数 类型 描述 示例
    state Integer 请求状态1成功,-1失败 1
    msg String 请求状态说明 success
    accounts array 交易明细
    currencys --- --- ---

    5.请求成功示例

    {
        state: 1,
        msg: "success",
        accounts: [
        {
            currency: "PMD",
            total_balance: 3.992,
            frozen_balance: 2,
            balance: 1.992
        },
        {
            currency: "PWRC",
            total_balance: 0.998,
            frozen_balance: 0,
            balance: 0.998
        },
        {
            currency: "QC",
            total_balance: 546.58,
            frozen_balance: 513.1,
            balance: 33.48
        }
        ],
        currencys: null
        }

    6.请求失败

    {
        state: -1,
        msg: "ILLEGAL_TIMESTAMP",
        accounts: null,
        currencys: null
        }


  • 获取所有行情汇总

    1.请求URL:http://www.blackhorse.pro/m/allticker/ { ts }

    2.请求类型:GET

    3.请求参数:

    参数 类型 描述 示例
    TS 时间戳精确到秒 1540619752

    4.返回参数

    参数 类型 描述 示例
    state Integer 请求状态1成功,-1失败 1
    msg string 请求状态说明 成功
    data object 所有交易对行情

    5.请求成功

    {
            state: 1,
            msg: "success",
            data: {
                btcqc_ticker: {
                    state: 1,
                    msg: "success",
                    dspName: "BTC/USDT",
                    symbol: "btcqc",
                    timestamp: 1540632797891,
                    open: 0.58,
                    high: 0.5804,
                    low: 0.5797,
                    close: 0.58,
                    volume: 15278357.43,
                    bis1: [
                        0.58,
                        5000
                    ],
                    ask1: [
                        0.5802,
                        270
                    ],
                    upOrDown: -1,
                    pricePrecision: 4,
                    volumePrecision: 2,
                    order: 1,
                    areaId: 1,
                    canBuy: 1,
                    canSell: 1,
                    stopDesc: "",
                    quoteCurrencyName: "USDT",
                    baseCurrencyName: "BTC",
                    minBuyVolume: 0,
                    minBuyAmount: 0,
                    minSellVolume: 0,
                    fixedBuyPrice: 0,
                    canRecharge: 1
                },
                ...
            }}


  • 获取交易对市场深度

    1.请求URL:https://www.zerogoe.com/o/m/depth/{symbol}

    2.请求类型:GET

    3.请求参数:

    参数 类型 描述 示例
    symbol String 交易对名称 ETHQC

    4.返回参数

    参数 类型 描述 示例
    state Integer 请求状态1成功,-1失败 1
    msg String 请求状态说明 success
    symbol String 交易对名称 ETHQC
    timestamp long 时间戳精确到秒 1540619752
    bids array 买方报价
    asks array 卖方报价
    5.请求成功
    {
            state: 1,
            msg: "success",
            symbol: "ethqc",
            timestamp: 1540633292277,
            bids: [
                [
                1394,
                0.41
                ],
                ...
            ],
            asks: [
                [
                1394,
                0.41
                ],
                ...
            ]
        }


  • 获取系统支持的交易对

    1.请求URL:https://www.zerogoe.com/m/symbol

    2.请求类型:GET

    3.请求参数:无

    4.返回参数

    参数 类型 描述 示例
    state Integer 请求状态1成功,-1失败 1
    msg String 请求状态说明 success
    symbols array 交易对描述

    5.请求成功

    {
            state: 1,
            msg: "success",
            symbols: [
                {
                    symbol: "btcqc",
                    base_currency: "BTC",
                    quote_currency: "USDT",
                    price_precision: 4,
                    volume_precision: 2,
                    taker_fee: 0.002,
                    maker_fee: 0.002
                },
                ...
            ]
        }


  • 创建交易订单

    1.请求URL:https://www.zerogoe.com/o/api/order

    2.请求类型:POST

    3.请求参数:

    参数 类型 是否参与签名 描述 示例
    api_key String 用户apikey 5b092b11-001c-4e50-9d8e-00f9db752241
    o_no String 交易订单号,32位随机字符串 1540635044555-0.7886791948144788
    o_price_type String 价格类型:limit、market,分别代表限价单、市价单 limit
    o_type String 订单类型:sell,buy,分别代表卖、买 sell
    price BigDecimal 价格 136.8
    volume BigDecimal 数量 0.1
    symbol String 交易对名称 ETHQC
    timestamp long 时间戳精确到秒 1540619752
    sign_type String 签名类型 MD5
    sign String 具体查看签名认证 ade9e763f24276512c033f7cef76

    4.返回参数

    参数 类型 描述 示例
    state Integer 请求状态1成功,-1失败 1
    msg String 请求状态说明 success
    data long 订单id 2344221

    5.请求成功

    {
        state: 1,
        msg: "success",
        data: 2344221
        }

    6.请求失败

    {
        "state":-1,
        "msg":"NO_SUFFICIENT_FUNDS"
        }


  • 取消交易订单

    1.请求URL:https://www.zerogoe.com/o/api/order

    2.请求类型:DELETE

    3.请求参数:

    参数 类型 是否参与签名 描述 示例
    api_key String 用户apikey 5b092b11-001c-4e50-9d8e-00f9db752241
    o_no String 交易订单号,32位随机字符串 1540635044555-0.7886791948144788
    id Integer 订单id 234452
    symbol String 交易对名称 ETHQC
    timestamp long 时间戳精确到秒 1540619752
    sign_type String 签名类型 MD5
    sign String 具体查看签名认证 ade9e763f24276512c033f7cef76

    4.返回参数

    参数 类型 描述 示例
    state Integer 请求状态1成功,-1失败 1
    msg String 请求状态说明 success

    5.请求成功

    {
        state: 1,
        msg: "success"
        }

    6.请求失败

    {
        state: -1,
        msg: "LANG_ORDER_IS_DONE_OR_CANCELED"
        }


  • 获取K线数据

    1.请求URL:https://www.zerogoe.com/m/kline/{symbol}/{type}/{size}

    2.请求类型:GET

    3.请求参数:

    参数 类型 描述 示例
    symbol String 交易对名称,ETHQC、BTCQC ETHQC
    type String K线周期类型,1min、5min、15min、30min、60min、1day、1mon、1week 1min
    size Integer 获取数据数量,1、10、100、100 1

    4.返回参数

    参数 类型 描述 示例
    success boolean 请求状态true成功,false失败 true
    data array k线数据

    5.请求成功

    {
        "success": true,
        "data": {
            "lines": [
            [
                1540863480000,
                800,
                800,
                800,
                800,
                0
            ]
            ]
        }
        }

    6.请求失败

    {
        state: -1,
        msg: "参数类型不正确"
        }


  • 获取公告列表

    1.请求URL:https://www.zerogoe.com/n/news/304/{page}/{size}

    2.请求类型:GET

    3.请求参数:

    参数 类型 是否参与签名 描述 示例
    page Integer 页数,从1开始 1
    size Integer 每页请求数量 10

    4.返回参数

    参数 类型 描述 示例
    state Integer 请求状态1成功,-1失败 1
    msg String 请求状态说明 success
    data object 列表数据
    total int 公告总数量 20
    list array 公告列表

    5.请求成功示例

    {
            state: 1,
            msg: "success",
            data: {
                total: 29,
                list: [
                    {
                        column_id: 304,
                        a_abstract: "",
                        create_time: "2018-11-26 17:05:47",
                        a_title: "公告标题",
                        a_abstract_en: "",
                        id: 153,
                        a_time: "2018-11-26 17:00",
                        a_title_en: "Announcement of"
                    }
                    
                ]
            }
        }


  • 获取公告详情

    1.请求URL:https://www.zerogoe.com/n/news/{id}

    2.请求类型:GET

    3.请求参数:

    参数 类型 是否参与签名 描述 示例
    id Integer 公告id 153

    4.返回参数

    参数 类型 描述 示例
    state Integer 请求状态1成功,-1失败 1
    msg String 请求状态说明 success
    data object 公告对象

    5.请求成功示例

    {
        state: 1,
        msg: "success",
        data: {
        id: 153,
        column_id: 304,
        a_title: "公告标题",
        a_title_en: "Notice title",
        a_abstract: "",
        a_abstract_en: "",
        a_img_file: null,
        a_img_file_en: null
        // 省略一些字段
        }
        }