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"
        ]

所有市場訂單參數 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,
                            }
                      }
            ]
    }

幣種狀態

返回所有系統支持的幣種狀態資訊，包括充值、提現、交易狀態等。

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,
                            }
                      }
            ]
    }

交易市場詳細行情 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
                }
            ]
    }

所有交易行情 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"
            }
        }

單項交易行情 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
        }

市場深度 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]
            ]
        }

歷史成交紀錄 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"
    }

交易市場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"]
		]
	},

自動交易 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"
            }
    }

獲取槓桿帳號資金餘額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"
            }
        ]
    }

獲取理財帳號資金餘額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"
            }
        ]
    }

獲取充值地址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
    }

獲取充值提現歷史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"
    }

下單交易買入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可用於查詢，取消訂單。

下單交易賣出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可用於查詢，取消訂單。

批量下單

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"}

取消多個下單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"}

注：批量撤單每次只允許撤銷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"}

獲取下單狀態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"
    }

獲取我的當前掛單列表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"
                }
            ]
        }

獲取我的最近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"
                }
            ]
    }

提現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"}

取消提現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"}

子帳號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"
    }

費率標準

返回所有系統支持的幣種費率標準資訊，包括充值、提現、交易狀態等。

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=tw

請求參數

參數名	參數類型	必填	描述
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();

		}
	?>