توثيق Genesis API
كل ما تحتاجه للتكامل: المصادقة والحدود ونقاط النهاية ومخططات الاستجابة.
التوثيقمراجحة الأسهم
مراجحة الأسهم
TrialStartProMax
فروق الأسهم المرمّزة والمعادن والمؤشرات والسلع بين منصات CEX. رمز الأداة قد يختلف بين المنصات.
GET
https://api.genesisarbitrage.com/v1/arbitrage/stocksجرّب الطلب
GET
/v1/arbitrage/stocksيُحفظ المفتاح في متصفحك فقط ولا يُرسل إلى أي جهة سوى الـ API.
الصق مفتاحك وأرسل طلباً — سنعرض استجابة مختصرة.
معاملات الطلب
كل المعاملات اختيارية: بدون مرشحات تعيد نقطة النهاية مجموعة البيانات كاملة.
| المعامل | النوع | الوصف |
|---|---|---|
symbol | string | تصفية حسب رمز الأداة |
category | string | تصفية حسب الفئة |
exchange | string | تصفية حسب المنصة؛ عدة منصات بفواصل |
min_spread | number | أدنى فرق، % |
مثال طلب
bash
curl "https://api.genesisarbitrage.com/v1/arbitrage/stocks" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
مثال استجابة
يظهر عنصر واحد من مصفوفة data (بيانات حقيقية):
json
{
"symbol": "BRENT",
"category": "Commodity",
"exchange_buy": "MEXC",
"exchange_sell": "Ourbit",
"symbol_on_buy": "UKOIL",
"symbol_on_sell": "BRENTOIL",
"price_buy": 76.68,
"price_sell": 76.82,
"bid_buy": 76.71,
"ask_buy": 76.72,
"bid_sell": 76.8,
"ask_sell": 76.89,
"spread_pct": 0.18,
"trade_url_buy": "https://futures.mexc.com/exchange/UKOIL_USDT",
"trade_url_sell": "https://futures.ourbit.com/exchange/BRENTOIL_USDT"
}حقول الاستجابة
| الحقل | النوع | الوصف |
|---|---|---|
symbol | string | رمز الأداة |
category | string | الفئة: Stock أو Metal أو Index أو Commodity |
exchange_buy / exchange_sell | string | منصة الشراء / البيع |
symbol_on_buy / symbol_on_sell | string | رمز الأداة على هذه المنصة |
price_buy / price_sell | number | السعر على منصة الشراء / البيع |
bid_* / ask_* | number | null | أفضل عرض وطلب لكل جانب |
spread_pct | number | الفرق، % |
trade_url_buy / trade_url_sell | string | رابط منصة التداول |