API 2.0 - 购买/出售比特币、以太币 | 加密货币交易所

    # Request
    GET: https://data.gateapi.io/api2/1/pairs
    # Response
        [
                "eth_btc","etc_btc","etc_eth","zec_btc","dash_btc","ltc_btc","bcc_btc","qtum_btc",
                "qtum_eth","xrp_btc","zrx_btc","zrx_eth","dnt_eth","dpy_eth","oax_eth","lrc_eth",
                "lrc_btc","pst_eth","tnt_eth","snt_eth","snt_btc","omg_eth","omg_btc","pay_eth",
                "pay_btc","bat_eth","cvc_eth","storj_eth","storj_btc","eos_eth","eos_btc"
        ]

返回值说明

    eth_btc: 以太币对比特币交易
   etc_btc: 以太经典对比特币
    etc_eth: 以太经典对以太币
   xrp_btc: 瑞波币对比特币
    zec_btc: ZCash对比特币
    ……

所有市场订单参数 API

返回所有系统支持的交易市场的参数信息，包括交易费，最小下单量，价格精度等。

URL: https://data.gateapi.io/api2/1/marketinfo

示例:

    # Request
    GET: https://data.gateapi.io/api2/1/marketinfo
    # Response
   {
        "result": "true",
        "pairs": [
                      {
                            "eth_btc": {
                                "decimal_places": 6,
                                "amount_decimal_places": 4,
                                "min_amount": 0.001,
                                "min_amount_a": 0.001,
                                "min_amount_b": 0.0001,
                                "fee": 0.2,
                                "trade_disabled ": 0,
                                "buy_disabled" : 0,
                                "sell_disabled" : 0,
                            }
                      },
                      {
                            "zec_btc": {
                                "decimal_places": 4,
                                "amount_decimal_places": 5,
                                "min_amount": 0.0001,
                                "min_amount_a": 0.0001,
                                "min_amount_b": 0.0001,
                                "fee": 0.2,
                                "trade_disabled ": 0,
                                "buy_disabled" : 0,
                                "sell_disabled" : 0,
                            }
                      }
            ]
    }

返回值说明

    decimal_places: 价格精度
    amount_decimal_places: 数量精度
    min_amount : 最小下单量
    min_amount_a : 币种a [CURR_A]的最小下单量
    min_amount_b : 币种b [CURR_B]的最小下单量
    fee : 交易费
    trade_disabled : 0表示未暂停交易，1表示已经暂停交易
    buy_disabled: 0表示可买，1表示不可买
    sell_disabled: 0表示可卖，1表示不可卖

币种状态

返回所有系统支持的币种状态信息，包括充值、提现、交易状态等。

URL: https://data.gateapi.io/api2/1/coininfo

示例:

    # Request
    GET: https://data.gateapi.io/api2/1/coininfo
    # Response
   {
        "result": "true",
        "pairs": [
                      {
                            "USDT": {
                                "delisted": 0,
                                "withdraw_disabled": 0,
								"withdraw_delayed ": 0,
                                "deposit_disabled": 0,
                                "trade_disabled": 0,
                            }
                      }
            ]
    }

返回值说明

    delisted : 0表示未下架，1表示已经下架
    withdraw_disabled : 0表示未暂停提现，1表示已经暂停提现
    withdraw_delayed : 0表示未提现没有延迟，1表示提现存在延迟
    deposit_disabled : 0表示未暂停充值，1表示已经暂停充值
    trade_disabled : 0表示未暂停交易，1表示已经暂停交易

交易市场详细行情 API

返回所有系统支持的交易市场的详细行情和币种信息，包括币种名，市值，供应量，最新价格，涨跌趋势，价格曲线等。

URL: https://data.gateapi.io/api2/1/marketlist

示例:

    # Request
    GET: https://data.gateapi.io/api2/1/marketlist
    # Response
       {
        "result": "true",
        "data": [
                {
                    "no": 1,
                    "symbol": "LTC",
                    "name": "Litecoin",
                    "name_en": "Litecoin",
                    "name_cn": "莱特币",
                    "pair": "ltc_btc",
                    "rate": "418.00",
                    "vol_a": 168120.2,
                    "vol_b": "65,616,561",
                    "curr_a": "LTC",
                    "curr_b": "BTC",
                    "curr_suffix": " BTC",
                    "rate_percent": "19.73",
                    "trend": "up",
                    "supply": 25760300,
                    "marketcap": "10,767,805,404",
                    "plot": null
                },
                {
                    "no": 2,
                    "symbol": "ETH",
                    "name": "ETH",
                    "name_en": "ETH",
                    "name_cn": "以太币",
                    "pair": "etc_eth",
                    "rate": "0.7450",
                    "vol_a": 65227328.3,
                    "vol_b": "51,041,999",
                    "curr_a": "etc",
                    "curr_b": "eth",
                    "curr_suffix": " eth",
                    "rate_percent": "-1.84",
                    "trend": "up",
                    "supply": 1050000000,
                    "marketcap": "782,250,000",
                    "plot": null
                }
            ]
    }

返回值说明

    symbol : 币种标识
    name: 币种名称
    name_en: 英文名称
    name_cn: 中文名称
    pair: 交易对
    rate: 当前价格
    vol_a: 被兑换货币交易量
    vol_b: 兑换货币交易量
    curr_a: 被兑换货币
    curr_b: 兑换货币
    curr_suffix: 货币类型后缀
    rate_percent: 涨跌百分百
    trend: 24小时趋势 up涨 down跌
    supply: 币种供应量
    marketcap: 总市值
    plot: 趋势数据

所有交易行情 API

返回系统支持的所有交易对的最新，最高，最低交易行情和交易量，每20秒钟更新:

URL: https://data.gateapi.io/api2/1/tickers

示例:

    # Request
    GET: https://data.gateapi.io/api2/1/tickers
    # Response
      {
          "eth_btc": {
                "result": "true",
                "last": 0.1,
                "lowestAsk": 0.1,
                "highestBid": "0.00000000",
                "percentChange": 0,
                "baseVolume": 0.001,
                "quoteVolume": 0.01,
                "high24hr": 0.1,
                "low24hr": 0.1
            },
        "xrp_btc": {
                "result": "true",
                "last": "0.00004720",
                "lowestAsk": "0.00005620",
                "highestBid": "0.00004550",
                "percentChange": -7.4510907045863,
                "baseVolume": 0.5324,
                "quoteVolume": 11417.333,
                "high24hr": "0.00005580",
                "low24hr": "0.00004560"
            }
        }

返回值说明

    baseVolume: 交易量
    high24hr:24小时最高价
    highestBid:买方最高价
    last:最新成交价
    low24hr:24小时最低价 
    lowestAsk:卖方最低价 
    percentChange:涨跌百分比 
    quoteVolume: 兑换货币交易量

单项交易行情 API

返回系统支持的所有交易对的最新，最高，最低交易行情和交易量，每20秒钟更新:

URL: https://data.gateapi.io/api2/1/ticker/[CURR_A]_[CURR_B]

请替换 [CURR_A] and [CURR_B] 为您需要查看的币种.

支持的兑换类型:

示例:

    # Request
    GET: https://data.gateapi.io/api2/1/ticker/eth_btc
    # Response
        {
            "result": "true",
            "last": 0.1,
            "lowestAsk": 0.1,
            "highestBid": "0.00000000",
            "percentChange": 0,
            "baseVolume": 0.001,
            "quoteVolume": 0.01,
            "high24hr": 0.1,
            "low24hr": 0.1
        }

返回值说明

   baseVolume: 交易量
   high24hr:24小时最高价
   highestBid:买方最高价
   last:最新成交价
   low24hr:24小时最低价 
   lowestAsk:卖方最低价 
   percentChange:涨跌百分比 
   quoteVolume: 兑换货币交易量

市场深度 API

返回系统支持的所有交易对的市场深度（委托挂单），其中 asks 是委卖单, bids 是委买单。

URL: https://data.gateapi.io/api2/1/orderBooks

当前市场深度 API

返回当前市场深度（委托挂单），其中 asks 是委卖单, bids 是委买单。

URL: https://data.gateapi.io/api2/1/orderBook/[CURR_A]_[CURR_B]

请替换 [CURR_A] and [CURR_B] 为您需要查看的币种.

支持的兑换类型:

示例:

    # Request
    GET: https://data.gateapi.io/api2/1/orderBook/eth_btc
    # Response
      {
        "result": "true",
        "asks": [
                [29500,    4.07172355],
                [29499,    0.00203397],
                [29495,    1],
                [29488,    0.0672],
                [29475,    0.001]
            ],
        "bids": [
                [28001, 0.0477],
                [28000, 0.35714018],
                [28000, 2.56222976],
                [27800, 0.0015],
                [27777, 0.1]
            ]
        }

返回值说明

    asks :卖方深度
    bids :买方深度

历史成交记录 API

返回最新80条历史成交记录：

URL: https://data.gateapi.io/api2/1/tradeHistory/[CURR_A]_[CURR_B]

示例:

    # Request
    GET: https://data.gateapi.io/api2/1/tradeHistory/eth_btc
    # Response
    {
        "result": "true",
        "data": [
            {
                "tradeID": "27734287",
                "date": "2017-09-29 11:52:05",
                "timestamp": "1506657125",
                "type": "buy",
                "rate": 0.1,
                "amount": 0.01,
                "total": 0.001,
                "fee": "0.002",
                "fee_coin": "eth"
                "gt_fee":"0",
                "point_fee":"0.1213",
            }
        ],
        "elapsed": "6.901ms"
    }

返回从[TID]往后的最多1000历史成交记录：

URL: https://data.gateapi.io/api2/1/tradeHistory/[CURR_A]_[CURR_B]/[TID]

请替换 [CURR_A] and [CURR_B] 为您需要查看的币种.

支持的兑换类型:

示例:

    # Request
    GET: https://data.gateapi.io/api2/1/tradeHistory/eth_btc/3275876
    # Response
    {
        "result": "true",
        "data": [
                {
                "tradeID": 3175762,
                "date": "2017-08-25 07:24:28",
                "type": "sell",
                "rate": 29011,
                "amount": 0.0019,
                "total": 55.1209,
                "fee": "0",
                "fee_coin": "btc",
                "gt_fee":"0",
                "point_fee":"0.1213",
                },
                {
                "tradeID": 3175771,
                "date": "2017-08-25 07:24:41",
                "type": "sell",
                "rate": 29011,
                "amount": 0.0032,
                "total": 92.8352,
                "fee": "0.0002",
                "fee_coin": "btc",
                "gt_fee":"0",
                "point_fee":"0",
                }
            ],
        "elapsed": "31.518ms"
    }

返回值说明

    amount: 成交币种数量
    date: 订单时间
    rate: 币种单价
    total: 订单总额
    tradeID: tradeID
    type: 买卖类型, buy买 sell卖 
    fee: 手续费
    fee_coin: 手续费币种
    gt_fee: GT抵扣的手续费
    point_fee: 点卡抵扣的手续费

交易市场K线数据

返回市场最近时间段内的K线数据：

URL: https://data.gateapi.io/api2/1/candlestick2/[CURR_A]_[CURR_B]?group_sec=[GROUP_SEC]&range_hour=[RANGE_HOUR]

示例:

    # Request
    https://data.gateapi.io/api2/1/candlestick2/btc_usdt?group_sec=60&range_hour=1
    # Response
    {
		"result": "true",
		"data": [
			[1524556800000, 12.8756391686, 9266.02, 9266.21, 9231.01, 9233.99],
			[1524558600000, 18.3153691562, 9255.79, 9284, 9251.01, 9252],
			[1524560400000, 17.5693326481, 9255, 9290.37, 9238.89, 9255.79],
			[1524562200000, 13.0314933662, 9281.92, 9295, 9239, 9255.4],
			[1524564000000, 26.0352948098, 9290.92, 9327.46, 9282, 9282],
			[1524565800000, 24.5813921079, 9300, 9340, 9290, 9297.5],
			[1524567600000, 27.8742949471, 9345, 9348.99, 9291.91, 9300],
			[1524569400000, 29.3344591996, 9299.99, 9349.99, 9290, 9343.93],
			[1524571200000, 28.4720072519, 9305, 9327.99, 9286.32, 9290.02],
			...
		]
	}

返回[range_hour]范围内的K线数据：

URL: https://data.gateapi.io/api2/1/candlestick2/[CURR_A]_[CURR_B]?group_sec=[GROUP_SEC]&range_hour=[RANGE_HOUR]

请替换 [CURR_A] 和 [CURR_B] 为您需要查看的币种，GROUP_SEC 和 RANGE_HOUR 替换为需要获取的时间区域.

支持的兑换类型:

示例:

    # Request
    GET: https://data.gateapi.io/api2/1/candlestick2/btc_usdt?group_sec=60&range_hour=1
    # Response
    {
		"result": "true",
		"data": [
			[1524556800000, 12.8756391686, 9266.02, 9266.21, 9231.01, 9233.99],
			[1524558600000, 18.3153691562, 9255.79, 9284, 9251.01, 9252],
			[1524560400000, 17.5693326481, 9255, 9290.37, 9238.89, 9255.79],
			[1524562200000, 13.0314933662, 9281.92, 9295, 9239, 9255.4],
			[1524564000000, 26.0352948098, 9290.92, 9327.46, 9282, 9282],
			[1524565800000, 24.5813921079, 9300, 9340, 9290, 9297.5],
			[1524567600000, 27.8742949471, 9345, 9348.99, 9291.91, 9300],
			[1524569400000, 29.3344591996, 9299.99, 9349.99, 9290, 9343.93],
			[1524571200000, 28.4720072519, 9305, 9327.99, 9286.32, 9290.02],
			...
		]
	}

返回值说明

   time: 时间戳
   volume: 交易量
   close: 收盘价
   最高价
   low: 最低价
   open: 开盘价

C2C交易市场深度 API

返回系统支持的所有C2C交易对的市场深度（委托挂单），其中 asks 是委卖单, bids 是委买单。

URL: https://data.gateapi.io/api2/1/orderBooks_c2c

当前市场深度 API

返回当前C2C交易市场深度（委托挂单），其中 asks 是委卖单, bids 是委买单。

URL: https://data.gateapi.io/api2/1/orderBook_c2c/[CURR_A]_[CURR_B]

请替换 [CURR_A] and [CURR_B] 为您需要查看的币种.

支持的兑换类型:

示例:

    # Request
    GET: https://data.gateapi.io/api2/1/orderBook_c2c/usdt_cny
    # Response
	{
		"result": "true",
		"asks": [
			["6.86", "306.1114", "100.0000", "30000.0000"],
			["6.86", "808.0467", "100.0000", "4220.0000"],
			["6.86", "12922.3622", "200.0000", "24131.4000"],
			["6.86", "4412.0000", "300.0000", "4412.0000"]
		],
		"bids": [
			["6.84", "3654.9707", "3654.0000", "3654.9700"],
			["6.84", "17487.1700", "1500.0000", "30000.0000"],
			["6.84", "21.1317", "20.0000", "1461.9883"],
			["6.83", "27846.0000", "800.0000", "30000.0000"]
		]
	},

返回值说明

    asks :卖方深度
    bids :买方深度

    price: 委托价
    amount: 数量
    min_amount: 单笔最小交易量
    max_amount: 单笔最大交易量

自动交易 API

系统返回错误码对应说明

用户首先要通过这个链接获取API接口身份认证用到的Key和Secret。然后在程序中用Secret作为密码，通过SHA512加密方式签名需要POST给服务器的数据得到Sign，并在HTTPS请求的Header部分传回Key和Sign。请参考以下接口说明和例子程序进行设置。

获取帐号资金余额API

API URL: https://api.gateio.la/api2/1/private/balances

参数数据提交方式：POST

参数：无

返回数据格式：JSON

示例:

    # Request
    POST: https://api.gateio.la/api2/1/private/balances
    # Response
    {
        "result": "true",
        "available": {
            "BTC": "1000",
            "ETH": "968.8",
            "ETC": "0",
            },
        "locked": {
            "ETH": "1"
            }
    }

返回值说明

    available: 可用各币种资金余额
    locked : 冻结币种金额

获取杠杆帐号资金余额API

API URL: https://api.gateio.la/api2/1/private/marginbalances

参数数据提交方式：POST

参数：无

返回数据格式：JSON

示例:

    # Request
    POST: https://api.gateio.la/api2/1/private/marginbalances
    # Response
    {
        "result": "true",
        "datas": [
            {
                "market": "BTC_USDT",
                "curr_a": "BTC",
                "curr_b": "USDT",
                "available_a": "99.993214",
                "available_b": "9994.000035",
                "frozen_a": "0.000000",
                "frozen_b": "0.000000",
                "borrowed_a": "0.000000",
                "borrowed_b": "0.000000"
            }
        ]
    }

返回值说明

    market: 交易对
    curr_a: 交易货币
    curr_b: 计价货币
    available_a: 交易货币可用额度
    available_b: 计价货币可用额度
    frozen_a: 交易货币冻结资金
    frozen_b: 计价货币冻结资金
    borrowed_a: 交易货币借入资金 
    borrowed_b: 计价货币借入资金

获取理财帐号资金余额API

API URL: https://api.gateio.la/api2/1/private/fundingbalances

参数数据提交方式：POST

参数：无

返回数据格式：JSON

示例:

    # Request
    POST: https://api.gateio.la/api2/1/private/fundingbalances
    # Response
    {
        "result": "true",
        "datas": [
            {
                "asset": "BTC",
                "available": "0.000000",
                "freeze": "10.000000",
                "lent": "0.000000",
                "total_lend": "10.000000"
            },
            {
                "asset": "USDT",
                "available": "0.000000",
                "freeze": "0.000000",
                "lent": "0.000000",
                "total_lend": "0.000000"
            },
            {
                "asset": "ETH",
                "available": "99987.911780",
                "freeze": "0.000000",
                "lent": "0.000000",
                "total_lend": "0.000000"
            }
        ]
    }

返回值说明

    asset: 币种,
    available: 可用资产
    freeze: 冻结资产
    lent: 借出金额
    total_lend: 理财总计

获取充值地址API

API URL: https://api.gateio.la/api2/1/private/depositAddress

参数数据提交方式：POST

返回数据格式：JSON

请求参数

参数名	参数类型	必填	描述
currency	String	是	币种如(BTC, LTC)

示例:

    # Request
    POST: https://api.gateio.la/api2/1/private/depositAddress
    # Response
    {
        "result": "true",
        "addr": "gateiowallet",
        "multichain_addresses": [{
            "chain": "BTC",
            "address": "1AW9TZBVnmVYtbrieiQiLMiN7nwRJjJ9mx",
            "payment_id": "",
            "payment_name": "",
            "obtain_failed": 0
        }, {
            "chain": "ETH",
            "address": "0xDd5e3A7eb45fbb6E8070F1B6292BF22670F1775D",
            "payment_id": "",
            "payment_name": "",
            "obtain_failed": 0
        }, {
            "chain": "TRX",
            "address": "TW9hDZgCUXpfmnMVacju1CL8xW2ch2FZfT",
            "payment_id": "",
            "payment_name": "",
            "obtain_failed": 0
        }, {
            "chain": "EOS",
            "address": "gateiowallet",
            "payment_id": "00053f26ad281b8c",
            "payment_name": "Memo",
            "obtain_failed": 0
        }],
        "message": "Sucess",
        "code": 0
    }

返回值说明

    addr: 钱包地址

获取充值提现历史API

API URL: https://api.gateio.la/api2/1/private/depositsWithdrawals

参数数据提交方式：POST

返回数据格式：JSON

请求参数

参数名	参数类型	必填	描述
start	String	否	起始UNIX时间(如 1469092370)
end	String	否	终止UNIX时间(如 1469713981)
sortType	String	否	排序顺序（"ASC":升序,"DESC":降序）
page	String	否	页码，取值从1开始

示例:

    # Request
    POST: https://api.gateio.la/api2/1/private/depositsWithdrawals
    # Response
    {
        "result": "true",
        "deposits": [
                {
                "id": "c204730",
                "currency": "ETH",
                "address": "1111 1111 1111 1111 1111 1",
                "amount": "222.61",
                "txid": "210496",
                "timestamp": "1474962729",
                "status": "DONE",
                "fee":"0.1"
                }

            ],
        "withdraws": [
                {
                "currency": "ETC",
                "address": "addr2",
                "amount": "600000000",
                "txid": "2104963",
                "timestamp": "1469092378",
                "status": "DONE",
                "fee":"0.1"
                }
            ],
        "message": "Success"
    }

返回值说明

    deposits: 充值
    withdraws: 提现
    currency: 币种
    address: 充值/提现地址
    amount: 金额
    timestamp: 发起时间戳
    status: 记录状态 DONE:完成; CANCEL:取消; REQUEST:请求中 
    fee : 交易费

下单交易买入API

API URL: https://api.gateio.la/api2/1/private/buy

参数数据提交方式：POST

返回数据格式：JSON

请求参数

参数名	参数类型	必填	描述	示例:
currencyPair	String	是	交易币种对(如btc_usdt,ltc_btc)	ltc_btc
rate	String	是	价格	1000
amount	String	是	有效量	800
orderType	String	否	订单类型("gtc"：普通订单（默认）；“ioc”：立即执行否则取消订单（Immediate -or-Cancel，IOC）；"poc":被动委托（只挂单，不吃单）（Pending -or-Cancelled，POC）)	ioc
text	String	否	用户自定义订单标识，必须以固定前缀 "t-"开头，不计算前缀的情况下，长度限制为 16 字节，范围 [0-9a-zA-Z-_.]。	t-1128392

示例:

    # Request
    POST: https://api.gateio.la/api2/1/private/buy
    # Response
    {
		"result":"true",
		"orderNumber":5825355678,
		"rate":"1000",
		"leftAmount":"0",
		"filledAmount":"0.1",
		"filledRate":"800.00",
                "text":"t-1128392", //用户自定义订单标识，传入则返回，不传入不返回
		"message":"Success"
    }

返回值说明

	orderNumber: 订单单号
	rate: 下单价格
	leftAmount: 剩余数量
	filledAmount: 成交数量
	filledRate: 成交价格
        text:用户自定义订单标识，传入则返回，不传入不返回

注：返回的orderNumber可用于查询，取消订单。

下单交易卖出API

API URL: https://api.gateio.la/api2/1/private/sell

参数数据提交方式：POST

返回数据格式：JSON

请求参数

参数名	参数类型	必填	描述	示例:
currencyPair	String	是	交易币种对(如btc_usdt,ltc_btc)	ltc_btc
rate	String	是	委托价	1000
amount	String	是	有效量	800
orderType	String	否	订单类型("gtc"：普通订单（默认）；“ioc”：立即执行否则取消订单（Immediate -or-Cancel，IOC）；"poc":被动委托（只挂单，不吃单）（Pending -or-Cancelled，POC）)	ioc
text	String	否	用户自定义订单标识，必须以固定前缀 "t-"开头，不计算前缀的情况下，长度限制为 16 字节，范围 [0-9a-zA-Z-_.]。	t-1128392

示例:

    # Request
    POST: https://api.gateio.la/api2/1/private/sell
    # Response
    {
		"result":"true",
		"orderNumber":5825355678,
		"rate":"1000",
		"leftAmount":"0",
		"filledAmount":"0.1",
		"filledRate":"800.00",
                "text":"t-1128392", //用户自定义订单标识，传入则返回，不传入不返回
		"message":"Success"
    }

返回值说明

	orderNumber: 订单单号
	rate: 下单价格
	leftAmount: 剩余数量
	filledAmount: 成交数量
	filledRate: 成交价格
        text:用户自定义订单标识，传入则返回，不传入不返回

注：返回的orderNumber可用于查询，取消订单。

批量下单

API URL: https://api.gateio.la/api2/1/private/batch_orders

参数数据提交方式：POST

返回数据格式：JSON

请求参数

参数名	参数类型	必填	描述	示例:
batch_orders_json	Json	是	text:用户自定义订单标识，必须以固定前缀 "t-"开头，不计算前缀的情况下，长度限制为 16 字节，范围 [0-9a-zA-Z-_.]。 currencyPair:交易币种对(如btc_usdt,ltc_btc) side: 买卖类型 buy:买入;sell:卖出 rate:委托价 amount:有效量 orderType:订单类型("gtc"：普通订单（默认）；“ioc”：立即执行否则取消订单（Immediate -or-Cancel，IOC）；"poc":被动委托（只挂单，不吃单）（Pending -or-Cancelled，POC）)	[{ "text": "t-1001", "currencyPair": "GT_USDT", "rate": 0.01, "amount": 1000, "side": "buy", "orderType": "gtc" }, { "text": "t-1002", "currencyPair": "BTC_USDT", "rate": 8000, "amount": 0.1, "side": "sell", "orderType": "ioc" } ]

示例:

    # Request
    POST: https://api.gateio.la/api2/1/private/batch_orders
    # Response
   {"result":"true","orders":"[[
        {
            "result": "true",
            "message": "Success",
            "code": 0,
            "ctime": 1574846296.986704,
            "side": 2,
            "orderNumber": 28237020,
            "rate": "0.01",
            "leftAmount": "1000.00000000",
            "filledAmount": "0",
            "market": "GT_USDT",
            "iceberg": "0",
            "text": "t-1001",
            "filledRate": "0.010000000",
            "feePercentage": 0.002,
            "feeValue": "0",
            "feeCurrency": "GT",
            "fee": "0 GT"
        },
        {
            "result": "true",
            "message": "Success",
            "code": 0,
            "ctime": 1574846296.995313,
            "side": 1,
            "orderNumber": 28237021,
            "rate": "8000",
            "leftAmount": "0.10000000",
            "filledAmount": "0",
            "market": "BTC_USDT",
            "iceberg": "0",
            "text": "t-1002",
            "filledRate": "8000.000000000",
            "feePercentage": 0.002,
            "feeValue": "0",
            "feeCurrency": "USDT",
            "fee": "0 USDT"}
         ]"
    }

注:每次只能下最多4个交易对且每个交易对只可批量下5个单

取消下单API

API URL: https://api.gateio.la/api2/1/private/cancelOrder

参数数据提交方式：POST

返回数据格式：JSON

请求参数

参数名	参数类型	必填	描述
orderNumber	String	是	下单单号
currencyPair	String	是	交易币种对(如 ltc_btc)

示例:

    # Request
    POST: https://api.gateio.la/api2/1/private/cancelOrder
    # Response
   {"result":"true","message":"Success"}

返回值说明

    result: 是否成功 true成功 false失败
    message: 提示消息

取消多个下单API

API URL: https://api.gateio.la/api2/1/private/cancelOrders

参数数据提交方式：POST

返回数据格式：JSON

请求参数

参数名	参数类型	必填	描述
orders_json	String	是	下单单号和pair的json数据; 示例:[ { "orderNumber":"7942422" "currencyPair":"ltc_btc" }, { "orderNumber":"7942423" "currencyPair":"ltc_btc" } ]

示例:

    # Request
    POST: https://api.gateio.la/api2/1/private/cancelOrders
    # Response
   {"result":"true","message":"Success"}

返回值说明

    result: 是否成功 true成功 false失败
    message: 提示消息

注：批量撤单每次只允许撤销20个订单

取消所有下单API

API URL: https://api.gateio.la/api2/1/private/cancelAllOrders

参数数据提交方式：POST

返回数据格式：JSON

请求参数

参数名	参数类型	必填	描述
type	int	是	下单类型(0:卖出,1:买入,-1:不限制)
currencyPair	String	是	交易币种对(示例: ltc_btc)

示例:

    # Request
    POST: https://api.gateio.la/api2/1/private/cancelAllOrders
    # Response
   {"result":"true","message":"Success"}

返回值说明

    result: 是否成功 true成功 false失败
    message: 提示消息

获取下单状态API

API URL: https://api.gateio.la/api2/1/private/getOrder

参数数据提交方式：POST

返回数据格式：JSON

请求参数

参数名	参数类型	必填	描述
orderNumber	String	是	下单单号
currencyPair	String	是	交易币种对(如: eth_btc)

示例:

    # Request
    POST: https://api.gateio.la/api2/1/private/getOrder
    # Response
    {
        "result":"true",
        "order":{
            "id":"15088",
            "status":"cancelled",
            "currencyPair":"eth_btc",
            "type":"sell",
            "rate":811,
            "amount":"0.39901357",
            "initialRate":811,
            "initialAmount":"1"
            },
        "message":"Success"
    }

返回值说明

    status: 订单状态 open已挂单 cancelled已取消 closed已完成
    currencyPair: 交易对
    type: 买卖类型 sell卖出, buy买入
    rate: 价格
    amount:买卖数量
    initialRate:下单价格
    initialAmount: 下单量

获取我的当前挂单列表API

API URL: https://api.gateio.la/api2/1/private/openOrders

参数数据提交方式：POST

请求参数

参数名	参数类型	必填	描述
currencyPair	String	否	交易币种对(如: eth_btc)

currencyPair参数为空时,返回所有交易市场挂单

返回数据格式：JSON

示例:

    # Request
    POST: https://api.gateio.la/api2/1/private/openOrders
    # Response
    {
        "result": "true", "message": "Success", "code": 0,"elapsed": "6.262ms",
        "orders": [
                {
                "orderNumber": "30032151",
                "type": "buy",
                "rate": 21367.521367521,
                "amount": "0.0936",
                "total": "2000",
                "initialRate": 21367.521367521,
                "initialAmount": "0.0936",
                "filledRate": 0,
                "filledAmount": 0,
                "currencyPair": "eth_btc",
                "timestamp": "1407828913",
                "status": "open"
                }
            ]
        }

返回值说明

    amount: 剩余未成交数量
    currencyPair: 订单交易对
    filledAmount: 已成交量
    filledRate: 成交价格
    initialAmount: 下单量
    initialRate:下单价格
    orderNumber: 订单号
    rate:交易单价
    status: 记录状态 DONE:完成; CANCEL:取消; REQUEST:请求中
    timestamp: 时间戳
    total2    type: 买卖类型 buy:买入;sell:卖出

获取我的最近100条成交记录API

API URL: https://api.gateio.la/api2/1/private/tradeHistory

参数数据提交方式：POST

返回数据格式：JSON

参数：

参数名	参数类型	必填	描述
currencyPair	String	是	交易币种对
orderNumber	String	否	订单号

示例:

    # Request
    POST: https://api.gateio.la/api2/1/private/tradeHistory
    # Response
    {
        "result": "true",
        "message": "Success",
        "trades": [
                {
                "id": "7942422",
                "orderid": "38100491",
                "pair": "ltc_btc",
                "type": "buy",
                "rate": "0.01719",
                "amount": "0.0588",
                "time": "06-12 02:49:11",
                "time_unix": "1402512551"
                }
            ]
    }

返回值说明

    orderid: 订单id
    pair: 交易对
    type: 买卖类型
    rate: 买卖价格
    amount: 订单买卖币种数量
    time: 订单时间
    time_unix: 订单unix时间戳

提现API

API URL: https://api.gateio.la/api2/1/private/withdraw

参数数据提交方式：POST

返回数据格式：JSON

请求参数

参数名	参数类型	必填	描述
currency	String	是	提现币种(如: btc)
amount	String	是	提现数量
address	String	是	地址(如果需要转账memo等备注信息，可以放在收款地址后面，空格隔开)
chain	String	否	链名称

示例:

    # Request
    POST: https://api.gateio.la/api2/1/private/withdraw
    # Response
    { "result": "true",  "message": "Success"}

返回值说明

    result: 是否成功 true成功 false失败
    message: 提示消息

取消提现API

API URL: https://api.gateio.la/api2/1/private/withdraw_cancel

参数数据提交方式：POST

返回数据格式：JSON

请求参数

参数名	参数类型	必填	描述
withdraw_id	Int	是	TXID

示例:

    # Request
    POST: https://api.gateio.la/api2/1/private/withdraw_cancel
    # Response
    { "result": "true",  "message": "Success"}

返回值说明

    result: 是否成功 true成功 false失败
    message: 提示消息

子账号API

查询单个子账号余额

API URL: https://api.gateio.la/api2/1/private/get_sub_account_available

参数数据提交方式：POST

返回数据格式：JSON

请求参数

参数名	参数类型	必填	描述
sub_uid	Int	是	子账号 ID

示例:

        # Request
        POST: https://api.gateio.la/api2/1/private/get_sub_account_available
        # Response
        {
            "result": true,
            "available": {
                "uid": "XXX",
                "BTC": "0.1",
                "USDT": "0",
                "GT": "0"
            }
        }

查询所有子账号余额

API URL: https://api.gateio.la/api2/1/private/get_sub_account_available

返回数据格式：JSON

示例:

    # Request
    POST: https://api.gateio.la/api2/1/private/get_sub_account_available
    # Response
        {
            "result": true,
            "available": [{
                "uid": "XXX",
                "BTC": "0.1",
                "USDT": "0",
                "GT": "0"
                }, {
                    "uid": "XXX",
                    "USDT": "94.70916"
                }]
        }

子账号资金划转

API URL: https://api.gateio.la/api2/1/private/sub_account_transfer

参数数据提交方式：POST

返回数据格式：JSON

请求参数

参数名	参数类型	必填	描述
sub_uid	Int	是	子账号 ID
transfer_type	String	是	划转类型 in为从主账号转到子账号，out为从子账号转到主账号
coin	String	是	币种
amount	String	是	数量

示例:

    # Request
    POST: https://api.gateio.la/api2/1/private/sub_account_transfer
    # Response
    {
	"result": "true",
	"message": "Success"
    }

返回值说明

    result: 是否成功 true成功 false失败
    message: 提示消息

费率标准

返回所有系统支持的币种费率标准信息，包括充值、提现、交易状态等。

URL: https://api.gateio.la/api2/1/private/feelist

示例:

    # Request
    POST: https://api.gateio.la/api2/1/private/feelist
    # Response
    {
        "GT":{
                "no":149,
                "symbol":"GT",
                "name":"GatechainToken",
                "name_cn":"GateChain",
                "fee_usdt":"0.2%",
                "fee_btc":"0.2%",
                "fee_eth":"-",
                "deposit":"0",
                "withdraw_percent":"0%",
                "withdraw_fix":"0.1",
                "withdraw_day_limit":"500000",
                "withdraw_amount_mini": 0.2,
                "withdraw_day_limit_remain": 500000,
                "withdraw_eachtime_limit": 500000,
                "withdraw_fix_on_chain_ETH": 4
             },
        "USDT":{
                "no":3,
                "symbol":"USDT",
                "name":"Tether",
                "name_cn":"Tether",
                "fee_usdt":"-",
                "fee_btc":"0.2%",
                "fee_eth":"0.2%",
                "deposit":"0",
                "withdraw_percent":"0%",
                "withdraw_fix":"3",
                "withdraw_day_limit":"300000",
                "withdraw_amount_mini": 53,
                "withdraw_day_limit_remain": 300000,
                "withdraw_eachtime_limit": 1000000,
                "usdt_erc20_withdraw_txfee": 10.0,
                "usdt_trc20_withdraw_txfee": 0.1,
                "withdraw_fix_on_chain_BTC":20,
                "withdraw_fix_on_chain_ETH":15,
                "withdraw_fix_on_chain_TRX":0,
                "withdraw_fix_on_chain_EOS":2.5
             },...
   }

返回值说明

    no:序号
    symbol:币种
    name:币种
    name_cn:币种
    fee_usdt:对USDT 交易费
    fee_btc:对BTC 交易费
    fee_eth:对ETH 交易费
    deposit:充值手续费
    withdraw_percent:提现手续费
    withdraw_fix:提现手续费
    withdraw_day_limit:日提现额度(可提高)
    withdraw_amount_mini:最少
    withdraw_day_limit_remain:剩余时间
    withdraw_eachtime_limit:一次最多
    withdraw_fix_on_chain_ETH: 提现手续费

公告

本站公告

URL: https://api.gateio.la/api2/1/annlist?page=1&lang=cn

请求参数

参数名	参数类型	必填	描述
page	Int	否	页码，取值从1开始(1-1000)
lang	string	否	语言: cn (简体中文), kr (한국어), en (English), vn (Tiếng Việt), tw (繁体中文), es (Español), ru (Русский язык), fr (Français), th (ภาษาไทย)

示例:

    # Request
    GET: https://api.gateio.la/api2/1/annlist?page=1
    # Response
        {
            "result": true,
            "message":"Success",
            "page":3,
            "data":[
                {
                    "id":"1",
                    "title":"test title 1",
                    "brief":"test brief 1",
                    "updated_t":"2020-06-02 11:59:04"
                },
                {
                    "id":"2",
                    "title":"test title 2",
                    "brief":"test brief 2",
                    "updated_t":"2020-06-02 11:59:04"
                }
            ]
        }

返回值说明

    id:序号
    title:标题
    brief:详情
    updated_t:更新时间

错误代码说明

系统返回错误码对应说明

错误代码	详情
1	无效请求
2	无效版本
3	无效请求
4	没有访问权限
5,6	Key或签名无效，请重新创建
7	币种对不支持
8,9	币种不支持
10	验证错误
11	地址获取失败
12	参数为空
13	系统错误，联系管理员
14	无效用户
15	撤单太频繁，一分钟后再试
16	无效单号，或挂单已撤销
17	无效单号
18	无效挂单量
19	交易已暂停
20	挂单量太小
21	资金不足
24	无效币种
40	请求太频繁，稍后再试
102	提现暂停
1401	子账号ID无效或不存在
1402	子账号不能资金划转
1403	无效参数
1404	子账号资金划转失败
1405	子账号已冻结

示例程序

PHP示例程序 (更多参考：JAVA, NODEJS, PYTHON, GO, PHP, CSHARP, PERL )

					

	<?php

		function gateio_query($path, array $req = array()) {
			// API settings, add your Key and Secret at here
			$key = '';
			$secret = '';

			// generate a nonce to avoid problems with 32bits systems
			$mt = explode(' ', microtime());
			$req['nonce'] = $mt[1].substr($mt[0], 2, 6);

			// generate the POST data string
			$post_data = http_build_query($req, '', '&');
			$sign = hash_hmac('sha512', urldecode($post_data), $secret);

			// generate the extra headers
			$headers = array(
				'KEY: '.$key,
				'SIGN: '.$sign
			);

			//!!! please set Content-Type to application/x-www-form-urlencoded if it's not the default value

			// curl handle (initialize if required)
			static $ch = null;
			if (is_null($ch)) {
				$ch = curl_init();
				curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
				curl_setopt($ch, CURLOPT_USERAGENT, 'Mozilla/4.0 (compatible; gateio PHP bot; '.php_uname('a').'; PHP/'.phpversion().')');
			}

			curl_setopt($ch, CURLOPT_URL, 'https://api.gateio.la/api2/'.$path);
			curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);
			curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
			curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
			curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);


			// run the query
			$res = curl_exec($ch);

			if ($res === false) throw new Exception('Could not get reply: '.curl_error($ch));
			//var_dump($res);
			//print_r($res);
			$dec = json_decode($res, true);
			if (!$dec) throw new Exception('Invalid data received, please make sure connection is working and requested API exists: '.$res);

			return $dec;
		}


		function curl_file_get_contents($url) {

			// our curl handle (initialize if required)
			static $ch = null;
			if (is_null($ch)) {
				$ch = curl_init();
				curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
				curl_setopt($ch, CURLOPT_USERAGENT,
					'Mozilla/4.0 (compatible; gateio PHP bot; '.php_uname('a').'; PHP/'.phpversion().')'
					);
			}
			curl_setopt($ch, CURLOPT_URL, 'https://data.gateapi.io/api2/'.$url);
			curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);

			// run the query
			$res = curl_exec($ch);
			if ($res === false) throw new Exception('Could not get reply: '.curl_error($ch));
			//echo $res;
			$dec = json_decode($res, true);
			if (!$dec) throw new Exception('Invalid data: '.$res);

			return $dec;
		}

		function get_top_rate($currency_pair, $type='BUY') {

			$url = '1/orderBook/'.strtoupper($currency_pair);
			$json = curl_file_get_contents($url);

			$rate = 0;

			if (strtoupper($type) == 'BUY') {
				$r =  $json['bids'][0];
				$rate = $r[0];
			} else  {
				$r = end($json['asks']);
				$rate = $r[0];
			}

			return $rate;
		}

		function get_pairs() {

			$url = '1/pairs';
			$json = curl_file_get_contents($url);

			return $json;
		}

		function get_marketinfo(){

			$url = '1/marketinfo';
			$json = curl_file_get_contents($url);

			return $json;
		}

		function get_tickers(){

			$url = '1/tickers';
			$json = curl_file_get_contents($url);

			return $json;
		}

		function get_ticker($current_pairs){

			$url = '1/ticker/'.strtoupper($current_pairs);
			$json = curl_file_get_contents($url);

			return $json;
		}

		function get_orderbooks(){

			$url = '1/orderBooks';
			$json = curl_file_get_contents($url);

			return $json;
		}

		function get_orderbook($current_pairs){

			$url = '1/orderBook/'.strtoupper($current_pairs);
			$json = curl_file_get_contents($url);

			return $json;
		}

		function get_trade_history($current_pairs, $tid){

			$url = '1/tradeHistory/'.strtoupper($current_pairs).'/'.$tid;
			$json = curl_file_get_contents($url);

			return $json;
		}

		function get_balances() {

			return gateio_query('1/private/balances');
		}

		function withdraw($currency, $amount, $address) {

			return gateio_query('1/private/withdraw',
				array(
					'currency' => strtoupper($currency),
					'amount' => $amount,
					'address' => $address
				)
			);
		}

		function get_order($order_number, $currency_pair) {

			return gateio_query('1/private/getOrder',
				array(
					'currencyPair' => strtoupper($currency_pair),
					'orderNumber' => $order_number
				)
			);
		}

		function cancel_order($order_number, $currency_pair) {

			return gateio_query('1/private/cancelOrder',
				array(
					'currencyPair' => strtoupper($currency_pair),
					'orderNumber' => $order_number
				)
			);
		}

		function cancel_all_orders($type, $currency_pair) {

			return gateio_query('1/private/cancelAllOrders',
				array(
					'type' => $type,
					'currencyPair' => strtoupper($currency_pair)
				)
			);
		}

		function sell($currency_pair, $rate, $amount) {

			return gateio_query('1/private/sell',
				array(
					'currencyPair' => strtoupper($currency_pair),
					'rate' => $rate,
					'amount' => $amount,
				)
			);
		}

		function buy($currency_pair, $rate, $amount) {

			return gateio_query('1/private/buy',
				array(
					'currencyPair' => strtoupper($currency_pair),
					'rate' => $rate,
					'amount' => $amount,
				)
			);
		}

		function get_my_trade_history($currency_pair, $order_number) {

			return gateio_query('1/private/tradeHistory',
				array(
					'currencyPair' => strtoupper($currency_pair),
					'orderNumber' => $order_number
				)
			);
		}

		function open_orders() {

			return gateio_query('1/private/openOrders');
		}

		function deposit_address($currency) {

			return gateio_query('1/private/depositAddress',
				array(
					'currency' => strtoupper($currency)
				)
			);
		}


		try {
			// example 1: get balances
			var_dump(get_balances());

			// example 2: place a buy order
			$pair = 'ltc_btc';
			$rate = get_top_rate($pair, $type) * 1.01;
			var_dump(buy($pair, $rate, '0.01'));

			// example 3: cancel an order
			var_dump(cancel_order(125811, $pair));

			// example 4: get order status
			var_dump(get_order(15088, $pair));

			// example 5: list all open orders
			var_dump(open_orders());

		} catch (Exception $e) {
			echo "Error:".$e->getMessage();

		}
	?>