بيانات السوق في 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 | المضخات والانهيارات على CEX | Trial وStart وPro وMax |
/market/dex-dumps | انهيارات الرموز على DEX | Pro و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، والحقول في التوثيق.
| المعامل | النوع | وظيفته |
|---|---|---|
exchange | string | المنصة؛ عدة منصات مفصولة بفاصلة |
coin | string | رمز العملة، مثل BTC |
min_spread | number | الحد الأدنى للسبريد المطلق، % |
| الحقل | النوع | المعنى |
|---|---|---|
fair_price / last_price | number | سعر العلامة وسعر آخر صفقة |
spread_pct | number | السبريد بينهما، % |
fair_changes / last_changes | object | تغيّر كل سعر، %: 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% أو أكثر في أي اتجاه على فترة واحدة على الأقل. كل الحقول في توثيق نقطة النهاية.
| المعامل | النوع | وظيفته |
|---|---|---|
exchange | string | المنصة؛ عدة منصات مفصولة بفاصلة |
coin | string | رمز العملة |
min_change | number | حد تغيّر السعر المطلق، % |
| الحقل | النوع | المعنى |
|---|---|---|
price | number | السعر الحالي |
change_5s … change_1h | number | تغيّر السعر خلال الفترة، % |
volume_24h | number | حجم 24 ساعة، USD |
funding_pct | number or null | معدل التمويل لكل فترة تسوية، % |
contract / network | string 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. مخطط الاستجابة في التوثيق.
| المعامل | النوع | وظيفته |
|---|---|---|
chain | string | الشبكة، مثل bsc |
min_liquidity | number | الحد الأدنى لسيولة المجمّع، USD |
| الحقل | النوع | المعنى |
|---|---|---|
ts | int | وقت الحدث، ثوانٍ unix |
price / liquidity_usd | number | السعر وسيولة المجمّع، USD |
market_cap | number or null | القيمة السوقية، USD |
price_changes | object | تغيّر السعر، %: m5 وh1 وh6 وh24 |
listed_on_cex | boolean | هل تُتداول العملة على CEX |
cex_spot / cex_futures | string[] | المنصات التي فيها سبوت العملة وعقودها الآجلة |
pool_url | string | رابط المجمّع |
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 الفائدة المفتوحة، والحقول في التوثيق.
| المعامل | النوع | وظيفته |
|---|---|---|
coin | string | رمز العملة |
exchange | string | المنصة؛ عدة منصات مفصولة بفاصلة |
| الحقل | النوع | المعنى |
|---|---|---|
total.oi_usd / total.oi_tokens | number | الفائدة المفتوحة بالدولار وبالعملات |
total.avg_price | number | متوسط السعر المرجّح بالحجم عبر المنصات |
total.volume_24h | number | حجم 24 ساعة، USD |
total.oi_change_5m/15m/30m/1h | number | تغيّر OI خلال الفترة، % |
total.price_change_5m/15m/30m/1h | number | تغيّر السعر خلال الفترة، % |
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 مع السعر لا يعد باستمرار الحركة: السوق المحموم قد ينعكس في سلسلة تصفيات.
اطلب اللقطة كاملة
استدعاء واحد دون فلاتر يعيد كل العملات.
أسقط العملات الصغيرة
حدّد عتبة لـ
total.oi_usd، مثلاً 5,000,000 دولار: مع OI صغير يعطي مركزان كبيران نسبة مئوية كبيرة.طبّق الشرط
oi_change_1hفوق 5 وprice_change_1hفوق 0.افحص اتساع الحركة
عُدّ المنصات في
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 أرسل طلبين أو صفِّ الاستجابة من جهتك. وصف الحقول في التوثيق.
| المعامل | النوع | وظيفته |
|---|---|---|
category | string | التصنيف: alpha أو high أو middle أو risky أو noise |
coin | string | رمز العملة |
| الحقل | النوع | المعنى |
|---|---|---|
id | string | المعرّف: يستخدمه بوتك لتخطي المكرر |
ts / time | int / string | الوقت: ثوانٍ unix وISO 8601 |
pipeline | string | مصدر الإشارة |
message_ru / message_en | string or null | نص الإشارة بالروسية والإنجليزية |
links | array | روابط جاهزة: نص + 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_price | number or null | سعر السبوت والعقود الآجلة؛ null تعني لا سوق |
exchanges{}.deposit / withdraw | boolean or null | هل الإيداع والسحب مفتوحان |
funding | object 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 الذي لا يستهلك حصتك.