Genesis Arbitrage

Genesis Arbitrage · · 12 dk okuma

Genesis API piyasa verileri: Fair – Last, pump'lar, OI, AI sinyalleri, arama

Kısaca

  • Altı piyasa endpoint'i siteyi yansıtır: Fair – Last, CEX Pumps – Dumps, DEX Dumps, OI Tracking, Genesis AI+ sinyalleri ve coin arama. DEX Dumps dışındaki hepsi Trial planından itibaren açıktır.
  • Fiyat ve açık pozisyon değişimleri 5 saniyeden bir saate kadar aralıklarda hazır yüzdeler olarak gelir; bunun için kendi geçmişinizi saklamanız gerekmez.
  • Genesis API yalnızca veri okur. Hareketleri ve anomalileri gösterir; alım satım kararı ve borsadaki işlemin kendisi sizde kalır.

Genesis API piyasa endpoint'leri, sitedeki Fair – Last, CEX Pumps – Dumps, DEX Dumps ve OI Tracking bölümleriyle aynı verileri; ayrıca Genesis AI+ sinyal akışını ve tüm borsalardaki coin kartını döndürür. Her çağrı, anahtarın X-API-Key başlığında gönderildiği bir HTTP GET'tir ve yanıt data ve meta zarfındadır. Geliştiriciler bu verileri ani hareket uyarıları, açık pozisyon izleyicileri ve işlem öncesi coin kontrolleri için kullanır.

Endpoint'ler ve planlar

EndpointNe döndürürAPI planları
/market/fair-priceİşaret fiyatı ve son işlemTrial, Start, Pro, Max
/market/pumpsCEX'te pump ve dump'larTrial, Start, Pro, Max
/market/dex-dumpsDEX'te token çöküşleriPro, Max
/market/open-interestBorsa bazında açık pozisyonTrial, Start, Pro, Max
/ai/signalsGenesis AI+ sinyalleriTrial, Start, Pro, Max
/coins/searchTüm borsalardaki coin kartıTrial, Start, Pro, Max

Temel URL https://api.genesisarbitrage.com/v1'dir; planınızın dışındaki bir endpoint 403 plan_restricted döndürür. Plan ayrıca veri tazeliğini belirler: Trial'da 60 sn, Start'ta 30 sn, Pro'da 10 sn ve Max'te 5 sn. Anahtar ve ilk istek hızlı başlangıçta, kotalar Genesis API limitlerinde, hata kodları ise Genesis API yanıtları ve hataları sayfasında anlatılır.

Fair – Last: /market/fair-price

Her satır, tek bir coinin tek bir borsadaki vadeli işlemidir: işaret fiyatı (Fair), son işlem fiyatı (Last) ve aralarındaki spread. İşaret fiyatı hesaplanır ve Binance Futures'ta likidasyon buna göre tetiklenir. Büyük fark, bir borsadaki işlemlerin Last'i ittiği ya da emir defterinde emirlerin tükendiği anlamına gelir. Bu tür satırların nasıl inceleneceği Fair – Last rehberinde, alanlar ise dokümantasyonda anlatılır.

ParametreTürNe yapar
exchangestringBorsa; birden fazlası için virgülle ayırın
coinstringCoin ticker'ı, örn. BTC
min_spreadnumberMutlak minimum spread, %
AlanTürAnlamı
fair_price / last_pricenumberİşaret fiyatı ve son işlem fiyatı
spread_pctnumberİkisi arasındaki spread, %
fair_changes / last_changesobjectHer fiyatın değişimi, %: s5, s10, s30 ve m1 — 5, 10 ve 30 saniye ile bir dakika
curl -G "https://api.genesisarbitrage.com/v1/market/fair-price" \
  -d exchange=ByBit \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"

-G bayrağı -d parametrelerini istek URL'sine taşır. Yanıt bir data dizisidir; burada ve aşağıda öğelerinden birini gösteriyoruz:

{
  "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 Pumps – Dumps: /market/pumps

Endpoint, CEX Pumps – Dumps tablosunu yansıtır: bir coinin borsanın vadeli işlemindeki fiyatı ve sekiz aralıktaki değişimi: change_5s, change_10s, change_30s, change_60s, change_5m, change_15m, change_30m ve change_1h alanları. min_change=5 isteği, en az bir aralıkta her iki yönde %5 veya daha fazla hareket eden coinleri tutar. Tüm alanlar endpoint dokümantasyonundadır.

ParametreTürNe yapar
exchangestringBorsa; birden fazlası için virgülle ayırın
coinstringCoin ticker'ı
min_changenumberMutlak fiyat değişimi eşiği, %
AlanTürAnlamı
pricenumberGüncel fiyat
change_5s … change_1hnumberAralık boyunca fiyat değişimi, %
volume_24hnumber24 saatlik hacim, USD
funding_pctnumber veya nullUzlaşma dönemi başına fonlama oranı, %
contract / networkstring veya nullKontrat adresi ve token ağı
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 Dumps: /market/dex-dumps

Pro ve Max planları. Endpoint, DEX Dumps bölümü gibi DEX'teki token çöküşlerini, havuz likiditesi ve tokenin CEX'te işlem görüp görmediğini gösteren bir bayrakla birlikte döndürür. Yanıt şeması dokümantasyondadır.

ParametreTürNe yapar
chainstringAğ, örn. bsc
min_liquiditynumberMinimum havuz likiditesi, USD
AlanTürAnlamı
tsintOlay zamanı, unix saniyesi
price / liquidity_usdnumberFiyat ve havuz likiditesi, USD
market_capnumber veya nullPiyasa değeri, USD
price_changesobjectFiyat değişimi, %: m5, h1, h6 ve h24
listed_on_cexbooleanCoinin CEX'te işlem görüp görmediği
cex_spot / cex_futuresstring[]Coinin spot ve vadeli işlemini sunan borsalar
pool_urlstringHavuz bağlantısı
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 Tracking: /market/open-interest

Açık pozisyon (OI), açılmış ve henüz kapatılmamış vadeli işlem pozisyonlarının hacmidir. Endpoint bunu OI Tracking tablosu gibi döndürür: coin toplamı total içinde, borsa bazında döküm exchanges içinde. Veri, Binance, Bybit, OKX, Bitget ve Gate dahil 13'ten fazla vadeli işlem borsasını kapsar. Genel bakış açık pozisyon API'si makalesinde, alanlar dokümantasyonda yer alır.

ParametreTürNe yapar
coinstringCoin ticker'ı
exchangestringBorsa; birden fazlası için virgülle ayırın
AlanTürAnlamı
total.oi_usd / total.oi_tokensnumberDolar ve coin cinsinden açık pozisyon
total.avg_pricenumberBorsalar genelinde hacim ağırlıklı ortalama fiyat
total.volume_24hnumber24 saatlik hacim, USD
total.oi_change_5m/15m/30m/1hnumberAralık boyunca OI değişimi, %
total.price_change_5m/15m/30m/1hnumberAralık boyunca fiyat değişimi, %
exchanges{}objectAynı metrikler borsa bazında: avg_price yerine price, ayrıca 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",
      …
    }
  }
}

Varsayımsal örnek: bir saatte OI %5'ten fazla artıyor ve fiyat da yükseliyor

Son bir saatte yeni pozisyon çeken ve fiyatı yükselen coinleri arıyorsunuz: total.oi_change_1h 5'ten büyük ve total.price_change_1h 0'dan büyük. İki alan da zaten yüzde cinsindendir.

Bir saat önce A coininin OI'si 40.000.000 $ idi, şimdi 42.600.000 $: (42.600.000 − 40.000.000) / 40.000.000 × 100 = %6,5. Aynı saatte fiyat 2,00 $'dan 2,056 $'a çıktı: (2,056 − 2,00) / 2,00 × 100 = %2,8. Yanıtta bu oi_change_1h: 6.5 ve price_change_1h: 2.8 olarak görünür.

CoinOI, 1 saFiyat, 1 saSonuç
A+%6,5+%2,8Geçer
B+%7,2−%1,9Hayır: OI fiyata karşı artıyor
C+%3,1+%4,0Hayır: OI eşiğin altında

B coininde OI düşen fiyata rağmen artıyor; bu genellikle short pozisyonların açıldığı anlamına gelir. Fiyatla birlikte artan OI devam edeceğinin sözünü vermez: aşırı ısınmış bir piyasa likidasyon zinciriyle tersine dönebilir.

  1. Tüm anlık görüntüyü isteyin

    Filtresiz tek bir çağrı her coini döndürür.

  2. Küçük coinleri eleyin

    Bir total.oi_usd eşiği koyun, örn. 5.000.000 $: OI küçükken birkaç büyük pozisyon yüksek bir yüzde üretir.

  3. Koşulu uygulayın

    oi_change_1h 5'ten büyük, price_change_1h 0'dan büyük.

  4. Hareketin ne kadar yaygın olduğunu kontrol edin

    exchanges içinde OI'si %5'ten fazla artan borsaları sayın: birkaç platformdaki artış daha fazla ağırlık taşır.

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  # küçük coinleri atla

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 veya yeniden oluşturma
            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}%, fiyat {price:+.1f}%, "
              f"OI'si artan borsa sayısı: {len(wide)}")

Genesis AI+ sinyalleri: /ai/signals

Genesis AI+ arbitraj sinyallerini kontrol eder ve her birini alpha'dan noise'a kadar derecelendirir. Endpoint bu akışı, Rusça ve İngilizce metinlerle ve platform bağlantılarıyla döndürür. category tek bir değer alır: alpha ve high için iki istek yapın ya da yanıtı kendi tarafınızda filtreleyin. Alan açıklamaları dokümantasyondadır.

ParametreTürNe yapar
categorystringDerece: alpha, high, middle, risky veya noise
coinstringCoin ticker'ı
AlanTürAnlamı
idstringTanımlayıcı: botunuz tekrarları atlamak için kullanır
ts / timeint / stringZaman: unix saniyesi ve ISO 8601
pipelinestringSinyal kaynağı
message_ru / message_enstring veya nullRusça ve İngilizce sinyal metni
linksarrayHazır bağlantılar: metin + 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"
    }
  ]
}

Coin arama: /coins/search

Endpoint, sitedeki Coin Search gibi bir coin kartı döndürür: ağ başına kontratlar, spot ve vadeli fiyatlar, her borsadaki para yatırma ve çekme durumu ve bir fonlama özeti. Ticker zorunlu query parametresine yazılır ve bilinmeyen bir coin 404 not_found döndürür. Burada data tek bir nesnedir. Alanlar dokümantasyondadır.

AlanTürAnlamı
contracts[]arrayKontratlar: adres, ağ ve onu kullanan borsalar
exchanges{}.spot_price / futures_pricenumber veya nullSpot ve vadeli fiyat; null piyasa yok demektir
exchanges{}.deposit / withdrawboolean veya nullPara yatırma ve çekmenin açık olup olmadığı
fundingobject veya nullFonlama özeti; null vadeli işlem yok demektir

Aynı ticker farklı borsalarda farklı tokenler olabilir: transferden önce contracts[] içindeki adresi borsanın para yatırma sayfasındaki kontratla karşılaştırın.

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", … }
  }
}

Sorular ve cevaplar

Trial planında hangi piyasa endpoint'leri var?

DEX Dumps dışındaki hepsi: bu endpoint Pro ve Max'te açıktır, Trial ve Start'ta 403 plan_restricted döndürür.

API açık pozisyon geçmişi sunuyor mu?

Hayır: endpoint, 5, 15 ve 30 dakika ile bir saatlik değişimleri içeren güncel anlık görüntüyü döndürür ve Genesis API'de geçmiş mum verisi yoktur. Yanıtları saklayarak geçmişi kendiniz oluşturun.

Bu endpoint'lerle işlem açabilir miyim?

Hayır. Genesis API yalnızca veri okur ve emir vermez: işlemi borsada kendiniz açarsınız.

Piyasa endpoint'lerini ne sıklıkla sorgulamalıyım?

meta.freshness_sec değerinden daha sık değil: Trial'da 60 sn'den Max'te 5 sn'ye kadar. Filtresiz bir yanıt ETag başlığı taşır. Bunu If-None-Match içinde geri gönderin; veri değişmediği sürece sunucu 304 ile yanıt verir ve bu kotanızı harcamaz.