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();

		}
	?>

语言及地区

汇率

选择语言及地区

简体中文
English
Tiếng Việt
繁體中文
This page is not intended for residents and citizens of Spain, Cuba, Bolivia, Venezuela and other Spanish-speaking jurisdictions listed in the Restricted Locations related terms of Gate's User Agreement.
Español
Русский
This page is not intended for residents and citizens of France, Canada and other French-speaking jurisdictions listed in the Restricted Locations related terms of Gate's User Agreement.
Français (Afrique)
Português (Portugal)
Bahasa Indonesia
日本語
بالعربية
Українська
Português (Brasil)

选择您所在的地区

法币汇率

不使用汇率切换不展示法币价格

实时汇率

CNY - ¥
VND - ₫
USD - $
INR - ₹
TRY - ₺
NGN - ₦
UAH - ₴
RUB - ₽
EUR - €
BRL - R$
PGK - K
PKR - ₨
BDT - ৳
PHP - ₱
GBP - £
IDR - Rp
ZAR - R
PLN - zł
SAR - ﷼‎
ARS - $
AED - د.إ
KZT - ₸
EGP - E£
UZS - so`m
TWD - ＄
HKD - $
GHS - GH₵
VES - Bs
XAF - Fr
XOF - FCFA
BYN - Br
KES - Ksh
MAD - د.م
AUD - A$
TZS - TSh
SEK - kr
AZN - ₼
COP - ＄
CLP - $
HUF - Ft
MXN - ＄
RON - lei
AMD - ֏
DZD - د.ج
NPR - रू
JOD - د.ا.
MRU - UM
IQD - ع.د
KWD - د.ك
QAR - ر.ق
TND - د.ت
GEL - ₾,
KGS - с
MDL - L
TJS - SM
LBP - ل.ل
LKR - Rs
LYD - ل.د
YER - ﷼
ETB - Br
SYP - £
UGX - Sh
ZMW - ZK
MYR - RM
BOB - Bs.
KHR - ៛
OMR - ر.ع.
DOP - RD$
PEN - S/.
BWP - P
CDF - FC
RWF - FRw
CHF - Fr.
AOA - Kz
CRC - ₡

前往土耳其站点？

土耳其站已上线

可点击前往 TR 分站，或是继续留在国际站

留在 Gate

前往 Gate.TR