API 2.0 - شراء/بيع Bitcoin والإيثريوم | إستبدال العملة الرقمية

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

واجهة برمجة تطبيقات جميع معلمات أوامر السوق

إرجاع معلومات المعلمة لجميع أسواق التداول التي يدعمها النظام , بما في ذلك رسوم المعاملات , والحد الأدنى لكمية الطلب , ودقة السعر , إلخ.

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

واجهة برمجة تطبيقات عروض الأسعار التفصيلية لسوق التداول

إرجاع معلومات السوق والعملات التفصيلية لجميع أسواق التداول التي يدعمها النظام , بما في ذلك اسم العملة والقيمة السوقية والعرض وآخر سعر واتجاهات الصعود والهبوط ومنحنيات الأسعار وما إلى ذلك.

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

واجهة برمجة تطبيقات جميع عروض الأسعار

قم بإرجاع أحدث وأعلى وأدنى عروض أسعار التداول وحجم التداول لجميع أزواج التداول التي يدعمها النظام , والتي يتم تحديثها كل 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"
            }
        }

واجهة برمجة تطبيقات اقتباس معاملة واحدة

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

رجى استبدال [CURR_A] و [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
        }

واجهة برمجة تطبيقات عمق السوق

تُرجع عمق السوق لجميع أزواج التداول التي يدعمها النظام (أوامر معلقة مؤتمنة) , حيث تكون الطلبات عبارة عن أمر بيع مفوض والعطاءات أمر شراء مفوض.

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

واجهة برمجة تطبيقات عمق السوق الحالية

العودة إلى عمق السوق الحالي (أوامر معلقة مؤتمنة) , حيث تكون الطلبات عبارة عن أمر بيع مفوض والعطاءات أمر شراء مفوض.

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

رجى استبدال [CURR_A] و [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"
    }

إرجاع ما يصل إلى 1000 سجل معاملات تاريخية من [TID] فصاعدًا：

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

رجى استبدال [CURR_A] و [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-line في سوق التداول

العودة إلى بيانات K-line للسوق في أحدث فترة زمنية：

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

إرجاع بيانات K-line ضمن نطاق [range_hour]：

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: سعر الاغلاق
   high: اعلى سعر
   low: اخفض سعر
   open: سعر الافتتاح

واجهة برمجة تطبيقات عمق سوق تداول P2P

إرجاع عمق سوق التداول من شخص لشخص، بما في ذلك طلبات الشراء وطلبات البيع.

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

واجهة برمجة تطبيقات عمق السوق الحالية

إرجاع عمق سوق التداول من شخص لشخص بما في ذلك طلب الشراء وطلب البيع.

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

رجى استبدال [CURR_A] و [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"]
		]
	},

واجهة برمجة تطبيقات التداول التلقائي

الوصف المقابل لرمز الخطأ الذي يعرضه النظام

يجب على المستخدمين أولاً الحصول على المفتاح والسر لمصادقة واجهة واجهة برمجة التطبيقات من خلال هذا الرابط . ثم استخدم Secret ككلمة المرور في البرنامج , وقم بتوقيع البيانات التي يجب إرسالها إلى الخادم من خلال طريقة تشفير SHA512 للحصول على Sign , وأعد المفتاح وتسجيل الدخول في الجزء العلوي من طلب HTTPS. يرجى الرجوع إلى أوصاف الواجهة التالية وعينات من البرامج للإعداد

الحصول على رصيد حساب 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': التنفيذ فورًا أو إلغاء الأمر (فوري أو إلغاء , IOC) ؛' poc ': أمر سلبي (أوامر معلقة فقط , لا تأكل مفردة) (Pending-or-Canceled, POC))	ioc
text	String	لا	يجب أن يبدأ معرف الطلب المقيد من قِبل المستخدم بالبادئة الثابتة ليست-'. بدون حساب البادئة , يقتصر الطول على 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"
    }

ملاحظة: يمكن استخدام رقم الطلب المرتجع للاستعلام وإلغاء الطلب.

ضع طلب مبيع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': التنفيذ فورًا أو إلغاء الأمر (فوري أو إلغاء , IOC) ؛' poc ': أمر سلبي (أوامر معلقة فقط , لا تأكل مفردة) (Pending-or-Canceled, POC))	ioc
text	String	لا	يجب أن يبدأ معرف الطلب المقيد من قِبل المستخدم بالبادئة الثابتة ليست-'. بدون حساب البادئة , يقتصر الطول على 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"
    }

ملاحظة: يمكن استخدام رقم الطلب المرتجع للاستعلام وإلغاء الطلب.

ترتيب دفعة

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

طريقة ارسال البيانات ：POST

إرجاع تنسيق البيانات：JSON

طلب المعامل

معامل	نوع المعامل	مطلوب	وصف	مثال:
batch_orders_json	Json	نعم	text:يجب أن يبدأ معرف الطلب المقيد من قِبل المستخدم بالبادئة الثابتة ليست-'. بدون حساب البادئة , يقتصر الطول على 16 بايت والنطاق هو [0-9a-zA-Z-_.] . currencyPair:تداول أزواج العملات (مثل btc_usdt , ltc_btc) side: نوع البيعbuy : شراء ; sell:بيع rate:سعر المعاملة amount:حجم التداول orderType:نوع الطلب (' gtc ': أمر عادي (افتراضي) ؛ 'ioc': التنفيذ فورًا أو إلغاء الأمر (فوري أو إلغاء , IOC) ؛' poc ': أمر سلبي (أوامر معلقة فقط , لا تأكل مفردة) (Pending-or-Canceled, 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	نعم	رقم الطلب وبيانات 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 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	نعم	سحب العنوان(إذا كنت بحاجة إلى نقل مذكرة وملاحظات أخرى , فيمكنك وضعها بعد عنوان الدفع , مفصولة بمسافات)
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	نعم	معرف النقل

مثال:

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

واجهة برمجة تطبيقات الحساب الفرعي

استعلم عن رصيد حساب فرعي واحد

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	نعم	نوع التحويل "داخلي": يقصد به من الحساب الرئيسي إلى حساب فرعي، "خارجي": يقصد به من حساب فرعي إلى الحساب الرئيسي
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: رسوم السحب

طلب المعامل

معامل	نوع المعامل	مطلوب	وصف
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:Title
    brief:التفاصيل
    updated_t:وقت التحديث

رمز الخطأ

الوصف المقابل لرمز الخطأ الذي يعرضه النظام

أكواد الخطأ	التفاصيل
1	طلب غير صالح
2	إصدار غير صالح
3	طلب غير صالح
4	لا يوجد إذن وصول
5,6	المفتاح أو التوقيع غير صالح , يرجى إعادة الإنشاء
7	زوج العملات غير مدعوم
8,9	العملة غير مدعومة
10	خطأ في التحقق
11	فشل الحصول على العنوان
12	المعلمات فارغة
13	خطأ في النظام , اتصل بالمسؤول
14	مستخدم غير صالح
15	قم بإلغاء الطلبات كثيرًا , حاول مرة أخرى خلال دقيقة واحدة
16	رقم الطلب غير صالح , أو تم إلغاء الأمر المعلق
17	Invalid Orderid
18	مبلغ الطلب المعلق غير صالح
19	تم تعليق المعاملة
20	حجم الأمر المعلق صغير جدًا
21	أموال غير كافية
24	أصول غير صالحة
40	عدد كبير جدًا من المحاولات. يرجى إعادة المحاولة لاحقًا.
102	تعليق السحب
1401	معرف الحساب الفرعي غير صالح أو غير موجود
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 - ₡

انتقال إلى Gate.tr؟

Gate.tr موجود على الإنترنت الآن.

يمكنك النقر والانتقال إلى Gate.tr أو البقاء في Gate.

البقاء في Gate

انتقال إلى Gate.tr

API (4.0) provides spot, margin and futures trading operations

REST API (Spot, Margin and Futures)

REST API Reference

العقود الآجلة WebSocket API

WS API 4.0 Reference

سوق فوریة WebSocket API

WS API 4.0 Reference (New) WS API Reference (Old)

API Keys

API (2.0) only provides spot

REST API

سوق فوریة WebSocket API

WS API Reference

واجهة برمجة تطبيقات جميع أزواج التداول

مثال:

واجهة برمجة تطبيقات جميع معلمات أوامر السوق

مثال:

معلومات العملة

مثال:

واجهة برمجة تطبيقات عروض الأسعار التفصيلية لسوق التداول

مثال:

واجهة برمجة تطبيقات جميع عروض الأسعار

مثال:

واجهة برمجة تطبيقات اقتباس معاملة واحدة

مثال:

واجهة برمجة تطبيقات عمق السوق

واجهة برمجة تطبيقات عمق السوق الحالية

مثال:

سجل معاملات السجل API

مثال:

مثال:

بيانات K-line في سوق التداول

مثال:

مثال:

وصف قيمة الإرجاع

واجهة برمجة تطبيقات عمق سوق تداول P2P

واجهة برمجة تطبيقات عمق السوق الحالية

مثال:

واجهة برمجة تطبيقات التداول التلقائي

مثال:

مثال:

مثال:

طلب المعامل

مثال:

طلب المعامل

مثال:

طلب المعامل

مثال:

طلب المعامل

مثال:

طلب المعامل

مثال:

طلب المعامل

مثال:

طلب المعامل

مثال:

طلب المعامل

مثال:

طلب المعامل

مثال:

طلب المعامل

مثال:

مثال:

طلب المعامل

مثال:

طلب المعامل

مثال:

واجهة برمجة تطبيقات الحساب الفرعي

طلب المعامل

مثال:

مثال:

طلب المعامل

مثال:

معيار السعر

مثال:

وصف قيمة الإرجاع

إعلان

طلب المعامل

مثال:

وصف قيمة الإرجاع

رمز الخطأ