API 2.0 - Mua/Bán Bitcoin, Ethereum | Sàn giao dịch tiền điện tử

    # 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 thông số thị trường giao dịch

Trả về các thông số như phí giao dịch, khối lượng đặt lệnh nhỏ nhất, độ chính xác của giá, ...của tất cả các thị trường giao dịch mà hệ thống hỗ trợ

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

Ví dụ:

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

Tài liệu về loại coin

Trở lại thông tin trạng thái của loại coin trong tất cả các hệ thống hỗ trợ, bao gồm nạp, rút, giao dịch ...

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

Ví dụ:

    # 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 chi tiết diễn biến thị trường giao dịch

Trả về các thông tin chi tiết diễn biến của các thị trường giao dịch mà hệ thống hỗ trợ, thông tin về coin bao gồm tên, vốn hóa thị trường, lượng cung cấp, giá mới nhất, xu hướng tăng giảm, đồ thị giá, ...

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

Ví dụ:

    # 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 tất cả diễn biến thị trường

Trả về các thông tin diễn biến thị trường mới nhất, cao nhất, thấp nhất và khối lượng giao dịch của tất cả các cặp giao dịch mà hệ thống hỗ trợ, cập nhật mỗi 20 giây:

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

Ví dụ:

    # 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 diễn biến thị trường đơn lẻ

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

Hãy thay [CURR_A] and [CURR_B] thành loại coin mà bạn muốn xem

Loại hoán đổi được hỗ trợ:

Ví dụ:

    # 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 độ sâu thị trường

Trả về độ sâu thị trường của tất cả các cặp giao dịch mà hệ thống hỗ trợ (Lệnh ủy thác), trong đó asks là lệnh ủy thác bán, bids là lệnh ủy thác mua.

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

API độ sâu thị trường hisện tại

Trả về độ sâu thị trường hiện tại (Lệnh ủy thác), trong đó asks là lệnh ủy thác bán, bids là lệnh ủy thác mua.

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

Hãy thay [CURR_A] and [CURR_B] thành loại coin mà bạn muốn xem

Loại hoán đổi được hỗ trợ:

Ví dụ:

    # 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 lịch sử giao dịch

Trả về lịch sử 80 giao dịch thành công gần nhất

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

Ví dụ:

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

Trả về từ [TID] về sau nhiều nhất lịch sử 1000 giao dịch thành công

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

Hãy thay [CURR_A] and [CURR_B] thành loại coin mà bạn muốn xem

Loại hoán đổi được hỗ trợ:

Ví dụ:

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

Biểu đồ hình nến thị trường giao dịch

Trả về biểu đồ hình nến trong khoản thời gian gần đây của thị trường giao dịch

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

Ví dụ:

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

Trả về biểu đồ hình nến trong phạm vi [range_hour]

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

Hãy thay [CURR_A] and [CURR_B] thành loại coin mà bạn muốn xem, GROUP_SEC và RANGE_HOUR thành khu vực thời gian cần xem.

Loại hoán đổi được hỗ trợ:

Ví dụ:

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

Giải thích giá trị trả về

   time: Dấu thời gian
   volume: KL giao dịch
   close: Giá đóng cửa
   high: Giá cao nhất
   low: Giá thấp nhất
   open: Giá mở cửa

API độ sâu thị trường

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

API độ sâu thị trường hisện tại

Trả về độ sâu thị trường hiện tại (Lệnh ủy thác), trong đó asks là lệnh ủy thác bán, bids là lệnh ủy thác mua.

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

Hãy thay [CURR_A] and [CURR_B] thành loại coin mà bạn muốn xem

Loại hoán đổi được hỗ trợ:

Ví dụ:

    # 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 tự động giao dịch

Hệ thống trả về giải thích tương ứng với mã lỗi

Người dùng đầu tiên cần thông qua liên kết này để nhận Key và Secret dùng cho xác thực cổng kết nổi API. Sau đó dùng Secret làm mật khẩu trong chương trình, thông qua phương thức mã khóa SHA512 cần Sign nhận được từ dữ liệu POST cho máy chủ, đồng thời trong phần Header của yêu cầu HTTPS truyền về Key và Sign. Vui lòng tham khảo chi tiết về cổng kết nối và chương trình ví dụ

API nhận số dư tài khoản

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

Phương thức gửi dữ liệu tham số: POST

Thông số

Định dạng dữ liệu trả về: JSON

Ví dụ:

    # 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 nhận số dư của tài khoản ký quỹ

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

Phương thức gửi dữ liệu tham số: POST

Thông số

Định dạng dữ liệu trả về: JSON

Ví dụ:

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

Nhận số dư tài khoản ký quỹ API

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

Phương thức gửi dữ liệu tham số: POST

Thông số

Định dạng dữ liệu trả về: JSON

Ví dụ:

    # 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 nhận địa chỉ nạp tiền

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

Phương thức gửi dữ liệu tham số: POST

Định dạng dữ liệu trả về: JSON

Tham số yêu cầu

Tên tham số	Loại tham số	Bắt buộc điền	Miêu tả
currency	String	Có	Loại coin như (BTC, LTC)

Ví dụ:

    # 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 nhận lịch sử nạp và rút tiền

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

Phương thức gửi dữ liệu tham số: POST

Định dạng dữ liệu trả về: JSON

Tham số yêu cầu

Tên tham số	Loại tham số	Bắt buộc điền	Miêu tả
start	String	Không	Thời gian bắt đầu UNIX(như 1469092370)
end	String	Không	Thời gian kết thúc UNIX(như 1469713981)
sortType	String	Không	Thứ tự sắp xếp ("ASC": tăng dần, "DESC": giảm dần)
page	String	Không	Số trang, bắt đầu từ 1

Ví dụ:

    # 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 đặt lệnh mua vào

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

Phương thức gửi dữ liệu tham số: POST

Định dạng dữ liệu trả về: JSON

Tham số yêu cầu

Tên tham số	Loại tham số	Bắt buộc điền	Miêu tả	Ví dụ:
currencyPair	String	Có	Cặp coin giao dịch(Như btc_usdt,ltc_btc)	ltc_btc
rate	String	Có	Giá	1000
amount	String	Có	Lượng giao dịch	800
orderType	String	Không	Loại lệnh("gtc"：Lệnh phổ thông（Mặc định）；“ioc”：Lập tức tiến hành nếu không sẽ hủy lệnh（Immediate -or-Cancel，IOC）)	ioc
text	String	Không	Người dùng tự đặt nội dung cho lệnh, bắt buộc dùng tiền tố "t-" mở đầu, nếu không tính tiền tố đầu, độ dài là 16 ký tự trong phạm vi [0-9a-zA-Z-_.].	t-1128392

Ví dụ:

    # 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", //Người dùng tự đặt nội dung cho lệnh, nếu truyền vào thì trở lại, không truyền vào thì không trở lại
		"message":"Success"
    }

Chú ý: Giá trị orderNumber trả về có thể dùng để tìm kiếm và hủy lệnh.

API đặt lệnh bán

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

Phương thức gửi dữ liệu tham số: POST

Định dạng dữ liệu trả về: JSON

Tham số yêu cầu

Tên tham số	Loại tham số	Bắt buộc điền	Miêu tả	Ví dụ:
currencyPair	String	Có	Cặp coin giao dịch(Như btc_usdt,ltc_btc)	ltc_btc
rate	String	Có	Giá	1000
amount	String	Có	Lượng giao dịch	800
orderType	String	Không	Loại lệnh("gtc"：Lệnh phổ thông（Mặc định）；“ioc”：Lập tức tiến hành nếu không sẽ hủy lệnh（Immediate -or-Cancel，IOC）)	ioc
text	String	Không	Người dùng tự đặt nội dung cho lệnh, bắt buộc dùng tiền tố "t-" mở đầu, nếu không tính tiền tố đầu, độ dài là 16 ký tự trong phạm vi [0-9a-zA-Z-_.].	t-1128392

Ví dụ:

    # 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", //Người dùng tự đặt nội dung cho lệnh, nếu truyền vào thì trở lại, không truyền vào thì không trở lại
		"message":"Success"
    }

Chú ý: Giá trị orderNumber trả về có thể dùng để tìm kiếm và hủy lệnh.

Đặt lệnh số lượng lớn

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

Phương thức gửi dữ liệu tham số: POST

Định dạng dữ liệu trả về: JSON

Tham số yêu cầu

Tên tham số	Loại tham số	Bắt buộc điền	Miêu tả	Ví dụ:
batch_orders_json	Json	Có	text:Người dùng tự đặt nội dung cho lệnh, bắt buộc dùng tiền tố "t-" mở đầu, nếu không tính tiền tố đầu, độ dài là 16 ký tự trong phạm vi [0-9a-zA-Z-_.]. currencyPair:Cặp coin giao dịch(Như btc_usdt,ltc_btc) side: Loại mua bán buy: Mua vào ;sell: Bán ra rate:Giá amount:Lượng giao dịch orderType:Loại lệnh("gtc"：Lệnh phổ thông（Mặc định）；“ioc”：Lập tức tiến hành nếu không sẽ hủy lệnh（Immediate -or-Cancel，IOC）)	[{ "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" } ]

Ví dụ:

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

Chú ý: Mỗi lần chỉ được đặt 4 cặp giao dịch, mỗi cặp giao dịch chỉ được đặt 5 lệnh

API hủy lệnh

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

Phương thức gửi dữ liệu tham số: POST

Định dạng dữ liệu trả về: JSON

Tham số yêu cầu

Tên tham số	Loại tham số	Bắt buộc điền	Miêu tả
orderNumber	String	Có	Mã lệnh đặt
currencyPair	String	Có	Cặp coin giao dịch (như ltc_btc)

Ví dụ:

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

API hủy nhiều lệnh

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

Phương thức gửi dữ liệu tham số: POST

Định dạng dữ liệu trả về: JSON

Tham số yêu cầu

Tên tham số	Loại tham số	Bắt buộc điền	Miêu tả
orders_json	String	Có	Dữ liệu json của mã lệnh đặt và pair; ví dụ:[ { "orderNumber":"7942422" "currencyPair":"ltc_btc" }, { "orderNumber":"7942423" "currencyPair":"ltc_btc" } ]

Ví dụ:

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

Lưu ý: Số lượng hủy theo lô được giới hạn ở 20

API hủy tất cả lệnh

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

Phương thức gửi dữ liệu tham số: POST

Định dạng dữ liệu trả về: JSON

Tham số yêu cầu

Tên tham số	Loại tham số	Bắt buộc điền	Miêu tả
type	int	Có	Loại lệnh đặt(0:Bán ra,1:Mua vào,-1:Không giới hạn)
currencyPair	String	Có	Cặp coin giao dịch(Ví dụ:ltc_btc)

Ví dụ:

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

API nhận trạng thái đặt lệnh

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

Phương thức gửi dữ liệu tham số: POST

Định dạng dữ liệu trả về: JSON

Tham số yêu cầu

Tên tham số	Loại tham số	Bắt buộc điền	Miêu tả
orderNumber	String	Có	Mã lệnh đặt
currencyPair	String	Có	Cặp coin giao dịch(Ví dụ :eth_btc)

Ví dụ:

    # 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 nhận danh sách lệnh đặt hiện tại của tôi

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

Phương thức gửi dữ liệu tham số: POST

Tham số yêu cầu

Tên tham số	Loại tham số	Bắt buộc điền	Miêu tả
currencyPair	String	Không	Cặp coin giao dịch(Ví dụ :eth_btc)

Khi tham số currencyPair trống, trả về lệnh đặt tất cả các thị trường giao dịch

Định dạng dữ liệu trả về: JSON

Ví dụ:

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

Nhận API bản ghi 100 giao dịch cuối cùng của tôi

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

Phương thức gửi dữ liệu tham số: POST

Định dạng dữ liệu trả về: JSON

Thông số

Tên tham số	Loại tham số	Bắt buộc điền	Miêu tả
currencyPair	String	Có	Cặp coin giao dịch
orderNumber	String	Không	Mã lệnh

Ví dụ:

    # 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 rút tiền

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

Phương thức gửi dữ liệu tham số: POST

Định dạng dữ liệu trả về: JSON

Tham số yêu cầu

Tên tham số	Loại tham số	Bắt buộc điền	Miêu tả
currency	String	Có	Loại coin(Ví dụ:btc)
amount	String	Có	Số lượng rút
address	String	Có	Địa chỉ (Nếu có thông tin cần ghi chú như memo, có thể đặt ở phía sau địa chỉ, dùng dấu cách để ngăn cách)
chain	String	Không	Thuộc loại chain

Ví dụ:

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

Hủy rút tiền API

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

Phương thức gửi dữ liệu tham số: POST

Định dạng dữ liệu trả về: JSON

Tham số yêu cầu

Tên tham số	Loại tham số	Bắt buộc điền	Miêu tả
withdraw_id	Int	Có	TXID

Ví dụ:

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

API tài khoản phụ

Truy vấn một tài khoản phụ khả dụng

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

Phương thức gửi dữ liệu tham số: POST

Định dạng dữ liệu trả về: JSON

Tham số yêu cầu

Tên tham số	Loại tham số	Bắt buộc điền	Miêu tả
sub_uid	Int	Có	Tài khoản phụ ID

Ví dụ:

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

Truy vấn tất cả tài khoản phụ khả dụng

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

Định dạng dữ liệu trả về: JSON

Ví dụ:

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

Chuyển tiền vào tài khoản phụ

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

Phương thức gửi dữ liệu tham số: POST

Định dạng dữ liệu trả về: JSON

Tham số yêu cầu

Tên tham số	Loại tham số	Bắt buộc điền	Miêu tả
sub_uid	Int	Có	Tài khoản phụ ID
transfer_type	String	Có	Nhà giao dịch nhập "in": từ tài khoản chính sang tài khoản phụ, "out": từ tài khoản phụ sang tài khoản chính
coin	String	Có	Coin
amount	String	Có	Số lượng

Ví dụ:

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

Tiêu chuẩn thu phí

Trở lại thông tin trạng thái của loại coin trong tất cả các hệ thống hỗ trợ, bao gồm nạp, rút, giao dịch ...

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

Ví dụ:

    # 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
             },...
   }

Giải thích giá trị trả về

    no:STT
    symbol:Coin
    name:Coin
    name_cn:Coin
    fee_usdt:Phí giao dịch đối với USDT
    fee_btc:Phí giao dịch với BTC
    fee_eth:Phí giao dịch với ETH
    deposit:Phí nạp
    withdraw_percent:Phí rút
    withdraw_fix:Phí rút
    withdraw_day_limit:Hạn mức rút tiền ngày (có thể tăng)
    withdraw_amount_mini:Ít nhất
    withdraw_day_limit_remain:Còn lại
    withdraw_eachtime_limit:Nhiều nhất 1 lần
    withdraw_fix_on_chain_ETH: Phí rút

Thông báo

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

Tham số yêu cầu

Tên tham số	Loại tham số	Bắt buộc điền	Miêu tả
page	Int	Không	Số trang, bắt đầu từ 1(1-1000)
lang	string	Không	Ngôn ngữ: cn (简体中文), kr (한국어), en (English), vn (Tiếng Việt), tw (繁体中文), es (Español), ru (Русский язык), fr (Français), th (ภาษาไทย)

Ví dụ:

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

Giải thích giá trị trả về

    id:STT
    title:Ghi chú
    brief:chi tiết
    updated_t:Thời gian cập nhật

Giải thích mã lỗi

Hệ thống trả về giải thích tương ứng với mã lỗi

Mã lỗi	chi tiết
1	Yêu cầu không hợp lệ
2	Phiên bản không hợp lệ
3	Yêu cầu không hợp lệ
4	Không có quyền truy cập
5,6	Key hoặc ký tên không hợp lệ, vui lòng tạo lại
7	Cặp coin không được hỗ trợ
8,9	Loại coin không được hỗ trợ
10	Lỗi Xác nhận
11	Nhận địa chỉ thất bại
12	Tham số trống
13	Lỗi hệ thống, liên hệ quản lý
14	Tài khoản không hợp lệ
15	Hủy đơn quá nhiều, thử lại sau 1 phút
16	Mã lệnh không hợp lệ hoặc đã hủy
17	Mã lệnh không hợp lệ
18	Khối lượng đặt lệnh không hợp lệ
19	Giao dịch đã tạm dừng
20	Khối lượng đặt lệnh quá nhỏ
21	Tài sản không đủ
24	Tài sản không hợp lệ
40	Yêu cầu quá nhiều , thử lại sau
102	Tạm ngừng rút
1401	ID tài khoản phụ không hợp lệ hoặc không tìm thấy tài khoản phụ
1402	Tài khoản phụ không thể sử dụng chuyển tiền
1403	Thông số không hợp lệ
1404	Chuyển sang tài khoản phụ không thành công
1405	Tài khoản phụ bị đóng băng

Chương trình ví dụ

Chương trình ví dụ PHP (Tham khảo thêm: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();

		}
	?>

ngôn ngữ và khu vực

tỷ giá hối đoái

Chọn ngôn ngữ và khu vực

Tiền pháp định

Không chuyển sang tiền pháp định Không hiển thị giá tiền pháp định

Tỷ giá hối đoái thời gian thực

CNY - ¥
USD - $
VND - ₫
EUR - €
GBP - £
HKD - $
JPY - ¥
RUB - ₽
TRY - ₺
INR - ₹
NGN - ₦
UAH - ₴
BRL - R$
MYR - RM
PGK - K
THB - ฿
PKR - ₨
BDT - ৳
PHP - ₱
CAD - $
IDR - Rp
ZAR - R
PLN - zł
SAR - ﷼‎
ARS - $
AED - د.إ
KZT - ₸
EGP - E£
UZS - so`m
TWD - ＄
GHS - GH₵
VES - Bs
MXN - ＄
COP - ＄
XAF - Fr
XOF - FCFA
BYN - Br
KES - Ksh
MAD - د.م
TZS - TSh
SEK - kr
AZN - ₼
CLP - $
HUF - Ft
RON - lei
AMD - ֏
DZD - د.ج
NPR - रू
JOD - د.ا.

Tới Gate.TR?

Gate.TR hiện đang trực tuyến.

Bạn có thể nhấp và truy cập Gate.TR hoặc ở lại Gate.io.

Ở lại Gate.io

Tới Gate.TR