دادههای بازار در Genesis API: Fair - Last، پامپها، OI، سیگنالهای AI و جستوجو
به طور خلاصه
- شش نقطه پایانی بازار با سایت یکی است: Fair - Last، پامپ - دامپ CEX، دامپهای DEX، ردیابی OI، سیگنالهای Genesis AI+ و جستوجوی ارز. همه بهجز دامپهای DEX از پلن Trial در دسترساند.
- تغییر قیمت و اوپن اینترست بهصورت درصدِ آماده در بازههای 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 دلار OI داشت و اکنون 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، 1 ساعت | قیمت، 1 ساعت | نتیجه |
|---|---|---|---|
| A | +6.5% | +2.8% | میگذرد |
| B | +7.2% | −1.9% | خیر: OI برخلاف قیمت بالا میرود |
| C | +3.1% | +4.0% | خیر: OI زیر آستانه است |
در ارز B با افت قیمت، OI بالا میرود که معمولاً یعنی پوزیشنهای شورت باز میشوند. بالا رفتن 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 باز است و در Trial و Start 403 plan_restricted برمیگرداند.
آیا API تاریخچه اوپن اینترست دارد؟
خیر: نقطه پایانی اسنپشات فعلی را با تغییرات 5، 15 و 30 دقیقه و یک ساعت برمیگرداند و Genesis API کندل تاریخی ندارد. تاریخچه را خودتان با ذخیره پاسخها بسازید.
آیا با این نقاط پایانی میتوان معامله باز کرد؟
خیر. Genesis API فقط داده میخواند و سفارش نمیگذارد: معامله را خودتان در صرافی باز میکنید.
نقاط پایانی بازار را هر چند وقت یکبار بخوانم؟
نه بیشتر از meta.freshness_sec: از 60 ثانیه در Trial تا 5 ثانیه در Max. پاسخ بدون فیلتر سربرگ ETag دارد. آن را در If-None-Match پس بفرستید و تا وقتی داده تغییر نکرده سرور 304 میدهد که از سهمیه شما کم نمیکند.