Genesis Arbitrage

Genesis Arbitrage · · 11 دقائق قراءة

بيانات السوق في Genesis API: Fair - Last والمضخات وOI وإشارات AI والبحث

باختصار

  • ست نقاط نهاية للسوق تطابق الموقع: Fair - Last ومضخات وانهيارات CEX وانهيارات DEX وتتبع OI وإشارات Genesis AI+ والبحث عن العملات. كلها متاحة من خطة Trial عدا انهيارات DEX.
  • تصل تغيّرات السعر والفائدة المفتوحة نسباً مئوية جاهزة عبر فترات من 5 ثوانٍ إلى ساعة، فلا حاجة إلى تخزين تاريخك الخاص للحصول عليها.
  • Genesis API يقرأ البيانات فقط. يعرض التحركات والشذوذات، أما قرار التداول والصفقة نفسها على المنصة فتبقى عندك.

تعيد نقاط نهاية السوق في Genesis API البيانات نفسها الموجودة في أقسام Fair - Last ومضخات وانهيارات CEX وانهيارات DEX وتتبع OI في الموقع، إضافة إلى تدفق إشارات Genesis AI+ وبطاقة العملة عبر كل المنصات. كل استدعاء طلب HTTP GET والمفتاح في الترويسة X-API-Key والاستجابة في غلاف data وmeta. يستخدم المطورون هذه البيانات لتنبيهات الحركات الحادة ومراقبة الفائدة المفتوحة وفحص العملة قبل الصفقة.

نقاط النهاية والخطط

نقطة النهايةما تعيدهخطط API
/market/fair-priceسعر العلامة وآخر صفقةTrial وStart وPro وMax
/market/pumpsالمضخات والانهيارات على CEXTrial وStart وPro وMax
/market/dex-dumpsانهيارات الرموز على DEXPro وMax
/market/open-interestالفائدة المفتوحة حسب المنصةTrial وStart وPro وMax
/ai/signalsإشارات Genesis AI+Trial وStart وPro وMax
/coins/searchبطاقة العملة عبر كل المنصاتTrial وStart وPro وMax

الرابط الأساسي هو https://api.genesisarbitrage.com/v1، وأي نقطة نهاية خارج خطتك تعيد 403 plan_restricted. وتحدد الخطة أيضاً حداثة البيانات: 60 ثانية في Trial و30 ثانية في Start و10 ثوانٍ في Pro و5 ثوانٍ في Max. المفتاح وأول طلب في البداية السريعة، والحصص في حدود Genesis API، وأكواد الأخطاء في استجابات Genesis API وأخطاؤه.

Fair - Last: /market/fair-price

كل صف هو عقود عملة واحدة الآجلة على منصة واحدة: سعر العلامة (Fair) وسعر آخر صفقة (Last) والسبريد بينهما. سعر العلامة محسوب، وعلى Binance Futures تعمل التصفية بحسبه. الفجوة الواسعة تعني أن صفقات على منصة واحدة دفعت Last، أو أن دفتر الأوامر نفد منه الطلب. طريقة فحص هذه الصفوف في دليل Fair - Last، والحقول في التوثيق.

المعاملالنوعوظيفته
exchangestringالمنصة؛ عدة منصات مفصولة بفاصلة
coinstringرمز العملة، مثل BTC
min_spreadnumberالحد الأدنى للسبريد المطلق، %
الحقلالنوعالمعنى
fair_price / last_pricenumberسعر العلامة وسعر آخر صفقة
spread_pctnumberالسبريد بينهما، %
fair_changes / last_changesobjectتغيّر كل سعر، %: s5 وs10 وs30 وm1 — خلال 5 و10 و30 ثانية ودقيقة
curl -G "https://api.genesisarbitrage.com/v1/market/fair-price" \
  -d exchange=ByBit \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"

يؤدي الخيار -G إلى نقل معاملات -d إلى رابط الطلب. الاستجابة مصفوفة data؛ نعرض هنا وفيما يلي أحد عناصرها:

{
  "exchange": "ByBit",
  "coin": "0G",
  "fair_price": 0.192,
  "last_price": 0.192,
  "spread_pct": 0.0,
  "trade_url": "https://www.bybit.com/trade/usdt/0GUSDT",
  "fair_changes": { "s5": 0.0, "s10": 0.052, "s30": 0.052, "m1": 0.0 },
  "last_changes": { "s5": 0.052, "s10": 0.052, "s30": 0.052, "m1": 0.0 }
}

مضخات وانهيارات CEX: /market/pumps

تطابق نقطة النهاية جدول مضخات وانهيارات CEX: سعر العملة في عقود المنصة الآجلة وتغيّره عبر ثماني فترات في الحقول change_5s وchange_10s وchange_30s وchange_60s وchange_5m وchange_15m وchange_30m وchange_1h. الطلب مع min_change=5 يُبقي العملات التي تحركت 5% أو أكثر في أي اتجاه على فترة واحدة على الأقل. كل الحقول في توثيق نقطة النهاية.

المعاملالنوعوظيفته
exchangestringالمنصة؛ عدة منصات مفصولة بفاصلة
coinstringرمز العملة
min_changenumberحد تغيّر السعر المطلق، %
الحقلالنوعالمعنى
pricenumberالسعر الحالي
change_5s … change_1hnumberتغيّر السعر خلال الفترة، %
volume_24hnumberحجم 24 ساعة، USD
funding_pctnumber or nullمعدل التمويل لكل فترة تسوية، %
contract / networkstring or nullعنوان العقد وشبكة الرمز
curl -G "https://api.genesisarbitrage.com/v1/market/pumps" \
  -d coin=BTC -d exchange=MEXC \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "exchange": "MEXC",
  "coin": "BTC",
  "price": 64267.9,
  "change_5s": 0.0,
  "change_10s": 0.0,
  "change_30s": 0.02,
  "change_60s": 0.06,
  "change_5m": 0.08,
  "change_15m": -0.06,
  "change_30m": -0.09,
  "change_1h": -0.2,
  "volume_24h": 2243246205,
  "funding_pct": 0.01,
  "network": "BNB Smart Chain(BEP20)",
  "trade_url": "https://futures.mexc.com/exchange/BTC_USDT"
}

انهيارات DEX: /market/dex-dumps

لخطتي Pro وMax. تعيد نقطة النهاية انهيارات الرموز على DEX كما في قسم انهيارات DEX، مع سيولة المجمّع وعلامة تبيّن هل يُتداول الرمز على CEX. مخطط الاستجابة في التوثيق.

المعاملالنوعوظيفته
chainstringالشبكة، مثل bsc
min_liquiditynumberالحد الأدنى لسيولة المجمّع، USD
الحقلالنوعالمعنى
tsintوقت الحدث، ثوانٍ unix
price / liquidity_usdnumberالسعر وسيولة المجمّع، USD
market_capnumber or nullالقيمة السوقية، USD
price_changesobjectتغيّر السعر، %: m5 وh1 وh6 وh24
listed_on_cexbooleanهل تُتداول العملة على CEX
cex_spot / cex_futuresstring[]المنصات التي فيها سبوت العملة وعقودها الآجلة
pool_urlstringرابط المجمّع
curl -G "https://api.genesisarbitrage.com/v1/market/dex-dumps" \
  -d chain=bsc -d min_liquidity=20000 \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "ts": 1783203653,
  "coin": "ONLY",
  "chain": "bsc",
  "price": 0.00009884,
  "liquidity_usd": 30477.58,
  "market_cap": 98840,
  "price_changes": {
    "m5": -58.03, "h1": 31.83, "h6": 31.83, "h24": 31.83
  },
  "pool_url": "https://dexscreener.com/bsc/0x2a18…",
  "listed_on_cex": false,
  "cex_spot": [],
  "cex_futures": []
}

تتبع OI: /market/open-interest

الفائدة المفتوحة (OI) هي حجم مراكز العقود الآجلة المفتوحة وغير المغلقة بعد. تعيدها نقطة النهاية كما في جدول تتبع OI: إجمالي العملة في total والتفصيل حسب المنصة في exchanges. تغطي البيانات 13+ منصة عقود آجلة، منها Binance وBybit وOKX وBitget وGate. نظرة عامة في مقال API الفائدة المفتوحة، والحقول في التوثيق.

المعاملالنوعوظيفته
coinstringرمز العملة
exchangestringالمنصة؛ عدة منصات مفصولة بفاصلة
الحقلالنوعالمعنى
total.oi_usd / total.oi_tokensnumberالفائدة المفتوحة بالدولار وبالعملات
total.avg_pricenumberمتوسط السعر المرجّح بالحجم عبر المنصات
total.volume_24hnumberحجم 24 ساعة، USD
total.oi_change_5m/15m/30m/1hnumberتغيّر OI خلال الفترة، %
total.price_change_5m/15m/30m/1hnumberتغيّر السعر خلال الفترة، %
exchanges{}objectالمقاييس نفسها لكل منصة: price بدل avg_price، إضافة إلى trade_url
curl -G "https://api.genesisarbitrage.com/v1/market/open-interest" \
  -d coin=GRAM \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "coin": "GRAM",
  "total": {
    "oi_usd": 96544685.3,
    "oi_tokens": 58105803.3,
    "avg_price": 1.661224,
    "volume_24h": 47010004.63,
    "oi_change_1h": 0.3185,
    "price_change_1h": -0.1929,
    …
  },
  "exchanges": {
    "ByBit": {
      "price": 1.6609,
      "oi_usd": 26838489.41,
      "oi_change_1h": -0.097,
      "trade_url": "https://www.bybit.com/trade/usdt/GRAMUSDT",
      …
    }
  }
}

مثال افتراضي: ارتفاع OI أكثر من 5% في ساعة مع السعر

تريد العملات التي جذبت مراكز جديدة خلال الساعة الأخيرة بينما ارتفع السعر: total.oi_change_1h فوق 5 وtotal.price_change_1h فوق 0. كلا الحقلين نسبة مئوية جاهزة.

قبل ساعة كان لدى العملة A فائدة مفتوحة بقيمة 40,000,000 دولار، والآن 42,600,000: (42,600,000 − 40,000,000) / 40,000,000 × 100 = 6.5%. وخلال الساعة نفسها ارتفع السعر من 2.00 إلى 2.056 دولار: (2.056 − 2.00) / 2.00 × 100 = 2.8%. في الاستجابة يظهر ذلك كـ oi_change_1h: 6.5 وprice_change_1h: 2.8.

العملةOI، ساعةالسعر، ساعةالنتيجة
A+6.5%+2.8%تجتاز
B+7.2%−1.9%لا: OI يرتفع عكس السعر
C+3.1%+4.0%لا: OI دون الحد

العملة B فائدتها المفتوحة ترتفع مع سعر يهبط، وهذا يعني عادةً أن مراكز بيع تُفتح. وارتفاع OI مع السعر لا يعد باستمرار الحركة: السوق المحموم قد ينعكس في سلسلة تصفيات.

  1. اطلب اللقطة كاملة

    استدعاء واحد دون فلاتر يعيد كل العملات.

  2. أسقط العملات الصغيرة

    حدّد عتبة لـ total.oi_usd، مثلاً 5,000,000 دولار: مع OI صغير يعطي مركزان كبيران نسبة مئوية كبيرة.

  3. طبّق الشرط

    oi_change_1h فوق 5 وprice_change_1h فوق 0.

  4. افحص اتساع الحركة

    عُدّ المنصات في exchanges التي نما فيها OI بأكثر من 5% أيضاً: النمو على عدة منصات أثقل وزناً.

import os
import time
import requests

API = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
MIN_OI_USD = 5_000_000  # skip small coins

def get(path, **params):
    while True:
        r = requests.get(API + path, headers=HEADERS,
                         params=params, timeout=15)
        if r.status_code in (429, 503):  # rate limit or rebuild
            time.sleep(int(r.headers.get("Retry-After", "5")))
            continue
        r.raise_for_status()
        return r.json()["data"]

for row in get("/market/open-interest"):
    t = row["total"]
    oi, price = t.get("oi_change_1h"), t.get("price_change_1h")
    if oi is None or price is None:
        continue
    if (t.get("oi_usd") or 0) < MIN_OI_USD:
        continue
    if oi > 5 and price > 0:
        wide = [ex for ex, m in row["exchanges"].items()
                if (m.get("oi_change_1h") or 0) > 5]
        print(f"{row['coin']}: OI {oi:+.1f}%, price {price:+.1f}%, "
              f"exchanges with OI growth: {len(wide)}")

إشارات Genesis AI+: /ai/signals

Genesis AI+ يفحص إشارات المراجحة ويصنّف كل واحدة من alpha إلى noise. تعيد نقطة النهاية هذا التدفق بالنص بالروسية والإنجليزية وروابط الأسواق. يقبل category قيمة واحدة: لـ alpha وhigh أرسل طلبين أو صفِّ الاستجابة من جهتك. وصف الحقول في التوثيق.

المعاملالنوعوظيفته
categorystringالتصنيف: alpha أو high أو middle أو risky أو noise
coinstringرمز العملة
الحقلالنوعالمعنى
idstringالمعرّف: يستخدمه بوتك لتخطي المكرر
ts / timeint / stringالوقت: ثوانٍ unix وISO 8601
pipelinestringمصدر الإشارة
message_ru / message_enstring or nullنص الإشارة بالروسية والإنجليزية
linksarrayروابط جاهزة: نص + url
curl -G "https://api.genesisarbitrage.com/v1/ai/signals" \
  -d coin=UTYA \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "id": "1783198680493",
  "ts": 1783198680,
  "time": "2026-07-04T20:58:00Z",
  "coin": "UTYA",
  "pipeline": "public",
  "category": "noise",
  "message_ru": "Глянул на UTYA — DEX против MEXC Futures…",
  "message_en": "Checked UTYA — DEX against MEXC Futures…",
  "links": [
    {
      "text": "MEXC Futures",
      "url": "https://futures.mexc.com/exchange/UTYA_USDT"
    }
  ]
}

البحث عن العملات: /coins/search

تعيد نقطة النهاية بطاقة العملة، مثل البحث عن العملات في الموقع: العقود لكل شبكة وأسعار السبوت والعقود الآجلة وحالة الإيداع والسحب على كل منصة وملخص التمويل. يوضع الرمز في المعامل الإلزامي query، والعملة المجهولة تعيد 404 not_found. هنا data كائن واحد. الحقول في التوثيق.

الحقلالنوعالمعنى
contracts[]arrayالعقود: العنوان والشبكة والمنصات التي تستخدمه
exchanges{}.spot_price / futures_pricenumber or nullسعر السبوت والعقود الآجلة؛ null تعني لا سوق
exchanges{}.deposit / withdrawboolean or nullهل الإيداع والسحب مفتوحان
fundingobject or nullملخص التمويل؛ null تعني لا عقود آجلة

قد يكون الرمز الواحد رموزاً مختلفة على منصات مختلفة: قبل التحويل قارن العنوان من contracts[] بالعقد في صفحة الإيداع على المنصة.

curl -G "https://api.genesisarbitrage.com/v1/coins/search" \
  -d query=IRYS \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "coin": "IRYS",
  "contracts": [
    {
      "address": "0x91152b4ef635403efbae860edd0f8c321d7c035d",
      "network": "BNB Smart Chain(BEP20)",
      "exchanges": ["MEXC", "Ourbit"]
    }
  ],
  "exchanges": {
    "MEXC": {
      "spot_price": 0.01329,
      "futures_price": 0.0133,
      "deposit": true,
      "withdraw": true,
      "spot_url": "https://www.mexc.com/exchange/IRYS_USDT",
      …
    }
  },
  "funding": {
    "spread_pct": 0.0,
    "best": { "exchange_1": "Bitget", "exchange_2": "OKX", … }
  }
}

أسئلة وأجوبة

ما نقاط نهاية السوق في خطة Trial؟

كلها عدا انهيارات DEX: هذه النقطة مفتوحة في Pro وMax وتعيد 403 plan_restricted في Trial وStart.

هل في API تاريخ للفائدة المفتوحة؟

لا: تعيد نقطة النهاية اللقطة الحالية مع التغيّرات خلال 5 و15 و30 دقيقة وساعة، وليس في Genesis API شموع تاريخية. ابنِ التاريخ بنفسك بتخزين الاستجابات.

هل أفتح صفقات عبر هذه النقاط؟

لا. Genesis API يقرأ البيانات فقط ولا يضع أوامر: تفتح الصفقة بنفسك على المنصة.

كم مرة أستعلم عن نقاط نهاية السوق؟

ليس أكثر من meta.freshness_sec: من 60 ثانية في Trial إلى 5 ثوانٍ في Max. تحمل الاستجابة دون فلاتر الترويسة ETag. أعدها في If-None-Match، وما دامت البيانات لم تتغير يردّ الخادم 304 الذي لا يستهلك حصتك.