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
| Endpoint | Ne döndürür | API planları |
|---|---|---|
/market/fair-price | İşaret fiyatı ve son işlem | Trial, Start, Pro, Max |
/market/pumps | CEX'te pump ve dump'lar | Trial, Start, Pro, Max |
/market/dex-dumps | DEX'te token çöküşleri | Pro, Max |
/market/open-interest | Borsa bazında açık pozisyon | Trial, Start, Pro, Max |
/ai/signals | Genesis AI+ sinyalleri | Trial, Start, Pro, Max |
/coins/search | Tü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.
| Parametre | Tür | Ne yapar |
|---|---|---|
exchange | string | Borsa; birden fazlası için virgülle ayırın |
coin | string | Coin ticker'ı, örn. BTC |
min_spread | number | Mutlak minimum spread, % |
| Alan | Tür | Anlamı |
|---|---|---|
fair_price / last_price | number | İşaret fiyatı ve son işlem fiyatı |
spread_pct | number | İkisi arasındaki spread, % |
fair_changes / last_changes | object | Her 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.
| Parametre | Tür | Ne yapar |
|---|---|---|
exchange | string | Borsa; birden fazlası için virgülle ayırın |
coin | string | Coin ticker'ı |
min_change | number | Mutlak fiyat değişimi eşiği, % |
| Alan | Tür | Anlamı |
|---|---|---|
price | number | Güncel fiyat |
change_5s … change_1h | number | Aralık boyunca fiyat değişimi, % |
volume_24h | number | 24 saatlik hacim, USD |
funding_pct | number veya null | Uzlaşma dönemi başına fonlama oranı, % |
contract / network | string veya null | Kontrat 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.
| Parametre | Tür | Ne yapar |
|---|---|---|
chain | string | Ağ, örn. bsc |
min_liquidity | number | Minimum havuz likiditesi, USD |
| Alan | Tür | Anlamı |
|---|---|---|
ts | int | Olay zamanı, unix saniyesi |
price / liquidity_usd | number | Fiyat ve havuz likiditesi, USD |
market_cap | number veya null | Piyasa değeri, USD |
price_changes | object | Fiyat değişimi, %: m5, h1, h6 ve h24 |
listed_on_cex | boolean | Coinin CEX'te işlem görüp görmediği |
cex_spot / cex_futures | string[] | Coinin spot ve vadeli işlemini sunan borsalar |
pool_url | string | Havuz 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.
| Parametre | Tür | Ne yapar |
|---|---|---|
coin | string | Coin ticker'ı |
exchange | string | Borsa; birden fazlası için virgülle ayırın |
| Alan | Tür | Anlamı |
|---|---|---|
total.oi_usd / total.oi_tokens | number | Dolar ve coin cinsinden açık pozisyon |
total.avg_price | number | Borsalar genelinde hacim ağırlıklı ortalama fiyat |
total.volume_24h | number | 24 saatlik hacim, USD |
total.oi_change_5m/15m/30m/1h | number | Aralık boyunca OI değişimi, % |
total.price_change_5m/15m/30m/1h | number | Aralık boyunca fiyat değişimi, % |
exchanges{} | object | Aynı 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.
| Coin | OI, 1 sa | Fiyat, 1 sa | Sonuç |
|---|---|---|---|
| A | +%6,5 | +%2,8 | Geçer |
| B | +%7,2 | −%1,9 | Hayır: OI fiyata karşı artıyor |
| C | +%3,1 | +%4,0 | Hayı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.
Tüm anlık görüntüyü isteyin
Filtresiz tek bir çağrı her coini döndürür.
Küçük coinleri eleyin
Bir
total.oi_usdeşiği koyun, örn. 5.000.000 $: OI küçükken birkaç büyük pozisyon yüksek bir yüzde üretir.Koşulu uygulayın
oi_change_1h5'ten büyük,price_change_1h0'dan büyük.Hareketin ne kadar yaygın olduğunu kontrol edin
exchangesiç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.
| Parametre | Tür | Ne yapar |
|---|---|---|
category | string | Derece: alpha, high, middle, risky veya noise |
coin | string | Coin ticker'ı |
| Alan | Tür | Anlamı |
|---|---|---|
id | string | Tanımlayıcı: botunuz tekrarları atlamak için kullanır |
ts / time | int / string | Zaman: unix saniyesi ve ISO 8601 |
pipeline | string | Sinyal kaynağı |
message_ru / message_en | string veya null | Rusça ve İngilizce sinyal metni |
links | array | Hazı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.
| Alan | Tür | Anlamı |
|---|---|---|
contracts[] | array | Kontratlar: adres, ağ ve onu kullanan borsalar |
exchanges{}.spot_price / futures_price | number veya null | Spot ve vadeli fiyat; null piyasa yok demektir |
exchanges{}.deposit / withdraw | boolean veya null | Para yatırma ve çekmenin açık olup olmadığı |
funding | object veya null | Fonlama ö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.