Genesis Arbitrage

Genesis Arbitrage · · 11 دقیقه مطالعه

داده‌های بازار در 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پامپ و دامپ در 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 دلار 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 همراه با قیمت ادامه حرکت را وعده نمی‌دهد: بازار داغ‌شده می‌تواند در زنجیره‌ای از لیکوئید شدن‌ها برگردد.

  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 باز است و در 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 می‌دهد که از سهمیه شما کم نمی‌کند.