Genesis API zincir üstü verisi: transferler, akışlar, unlock'lar, DEX swap'ları
Kısaca
- /onchain/{section} endpoint'i, büyük transferlerden hack'lere kadar dokuz Genesis OnChain akışının her birini Start, Pro ve Max planlarında döndürür. Bölümsüz /onchain isteği tüm akışları tek nesnede verir.
- Büyük DEX swap'ları, 24 saatlik veya 7 günlük analitik ve coin için 7 günlük özet Pro ve Max planlarında açıktır.
- Adres etiketleri bir atıftır, garanti değildir. Borsaya transfer her zaman satış anlamına gelmez, swap kaydı da doğrulamadan sonra silinebilir.
Genesis API'nin zincir üstü endpoint'leri Genesis OnChain bölümünün verisini döndürür: büyük token transferleri, borsalara para yatırma ve borsalardan çekme, ekip cüzdanı hareketleri, sürekli vadeli DEX pozisyonları, token unlock'ları, claim'ler ve hack'ler; ayrıca DEX üzerindeki büyük swap'lar. Her satırda gönderen ve alıcı etiketleri, USD tutarı ve explorer bağlantıları hazır gelir. Kendi blockchain indexer'ınızı kurmadan, kendi kodunuzdan balina takibi ve borsa akışı izlemesi için bu yeterlidir.
Endpoint'ler ve planlar
| Endpoint | Ne döndürür | API planları |
|---|---|---|
/onchain/{section} | Dokuz Genesis OnChain bölümünden biri | Start, Pro, Max |
/onchain | Dokuz bölümün tamamı tek nesnede | Start, Pro, Max |
/onchain/dex-swaps | Büyük DEX swap'ları | Pro, Max |
/onchain/analytics | 24 saatlik veya 7 günlük OnChain analitiği | Pro, Max |
/onchain/coin/{symbol} | Tek bir coin için 7 günlük özet | Pro, Max |
Trial planında tüm zincir üstü endpoint'ler 403 plan_restricted döndürür. Veri tazeliği Start'ta 30 sn, Pro'da 10 sn, Max'te 5 sn'dir; aynı değer meta.freshness_sec alanında da gelir. Anahtar ve ilk istek hızlı başlangıç bölümünde, kotalar Genesis API limitleri bölümünde anlatılır.
/onchain/{section} için dokuz bölüm
section | İçeriği | Panel bloğu |
|---|---|---|
large-transfers | Büyük token transferleri | Large Transfers |
cex-flows | Borsalara para yatırma ve borsalardan çekme | CEX Deposits / Withdrawals |
mint-bridge | Token mint'i ve köprü transferleri | Mint / Bridge |
team-wallets | Ekip cüzdanı hareketleri | Team Transfers |
perp-positions | Sürekli vadeli DEX'lerdeki büyük pozisyonlar | Perp. DEX Positions |
unlocks | Token unlock'ları | Unlocks |
claims | Claim'ler | Claims |
coin-traffic | Bir coinin tek hedefe yönelik transfer serileri | Coin Traffic |
hacks | Hack'ler ve exploit'ler | Hacks / Exploits |
Her bloğun ne gösterdiği ve hangi sinyallere bakılacağı Genesis OnChain panel rehberinde, parametreler dokümantasyonda anlatılır. Bölümsüz /onchain isteği data içinde bir nesne döndürür: anahtar bölüm adıdır, değer o bölümün satırlarıdır. Filtreler bu durumda tüm bölümlere uygulanır.
| Parametre | Tür | Ne yapar |
|---|---|---|
min_usd | number | Minimum olay tutarı, USD |
coin | string | Tek bir coinin satırları; hacks bölümünde coin yoktur, bu yüzden liste boş döner |
when | string | Yalnızca unlocks için: upcoming veya past |
section | string | /onchain?section=… isteği için bölüm |
when için başka herhangi bir değer 400 bad_request döndürür. Aşağıda coin-traffic bölümü ve data dizisinin bir öğesi var:
curl "https://api.genesisarbitrage.com/v1/onchain/coin-traffic" \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
"ts": 1783802410,
"token": "LAB",
"direction": "deposit",
"target": "Gate-io",
"target_address": "0x8782163068c7cd74D2510768a61135C1e4Eb07b3",
"total_usd": 573796.98,
"count": 18,
"window_hours": 5.69,
"avg_usd": 31878,
"largest_usd": 59891.78,
"transfers": [
{
"ts": 1783788640,
"usd": 59891.78,
"from_name": "0xec01…d1a5",
"tx_hash": "0xbf44850a7dc16086c08cfb…",
"chain": "bsc",
…
}
]
}
Bölüm alanları
large-transfers, cex-flows, mint-bridge, team-wallets ve claims bölümleri transferlerden oluşur; diğerlerinin kendi alanları vardır.
| Alanlar | Nerede | Anlamı |
|---|---|---|
ts, links | Tüm bölümler | Unix saniyesi olarak olay zamanı ve hazır bağlantılar: metin + url |
token / token_name | Transferler, coin-traffic | Token ticker'ı ve tam adı |
chain / chain_name, usd / amount | Transferler | Ağ, USD ve token cinsinden tutar |
from_* / to_* | Transferler | Gönderen ve alıcı: etiket, adres, explorer bağlantısı |
tx_hash / explorer_url / arkham_url | Transferler | İşlem hash'i, explorer ve Arkham bağlantıları |
direction, target / target_address | coin-traffic | deposit, withdrawal veya transfer yönü ve akışın hedefi |
total_usd / count / window_hours, transfers[] | coin-traffic | Serinin toplamı, transfer sayısı, saat cinsinden pencere ve en büyük transferler |
side / size / price / platform | perp-positions | Long veya Short, büyüklük, fiyat, platform |
unlock_percent / unlock_value_usd / hours_left / allocations | unlocks | Unlock payı ve değeri, kalan saat, tahsisler |
classification / technique / returned_funds | hacks | Sınıflandırma, saldırı tekniği, iade edilen fonlar |
DEX swap'ları: /onchain/dex-swaps
Pro ve Max planları. Endpoint, DEX Overview ekranındaki gibi büyük swap'ların akışını döndürür: her swap'ta havuzun likiditesinin ne kadarını aldığı, ondan hangi fiyat hareketinin beklendiği ve 30 saniye ile 5 dakika sonra ne olduğu görünür. Yanıt şeması dokümantasyondadır.
| Parametre | Tür | Ne yapar |
|---|---|---|
period | string | live — son 15 dakika, varsayılan; 1h, 6h, 24h veya 7d |
chain | string | Ağ |
side | string | buy veya sell |
dex | string | DEX; birden fazlası için virgülle ayırın |
min_usd | number | Minimum swap tutarı, USD |
min_impact | number | Minimum mutlak havuz etkisi, % |
final | boolean | true — yalnızca doğrulanmış swap'lar |
token | string | Token ticker'ı |
q | string | Token, ad, adresler, trader, hash, DEX ve ağ içinde arama |
| Alan | Tür | Anlamı |
|---|---|---|
id | string | Kalıcı tanımlayıcı: ağ, işlem, token |
tier | string | Havuz likiditesine göre kademe: T1 (30.000–100.000 $) ile T4 (10 milyon $ üzeri) arası |
pool_liquidity_usd / size_pct_liquidity / impact_est_pct | number veya null | Havuz likiditesi, swap'ın bunun içindeki payı ve tahmini fiyat etkisi, % |
price_after_30s_usd / price_after_5m_usd / move_after_5m_pct | number veya null | 30 sn ve 5 dk sonraki fiyat ile swap'tan sonraki 5 dakikada fiyat hareketi |
facts | string | Doğrulama durumu: pending, publish, 30s, final veya unavailable |
trader_name / trader_address | string veya null | Trader etiketi ve adresi |
Aşağıdaki örnekte, 4.120.000 $ likiditeli bir havuzda 412.500 $'lık swap havuzun 412.500 / 4.120.000 × 100 = %10,01'ini almıştır. Tahmini etki %4,8, 5 dakika sonra fiyat %1,9 hareket etmiştir.
curl -G "https://api.genesisarbitrage.com/v1/onchain/dex-swaps" \
-d period=1h -d min_usd=100000 -d final=true \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
"id": "ethereum:0x5f3c…e1:0x6982…1933",
"ts": 1794675511,
"token": "PEPE",
"chain": "ethereum",
"side": "buy",
"usd": 412500,
"dex": "Uniswap",
"pool_label": "PEPE/WETH 0.3%",
"tier": "T3",
"pool_liquidity_usd": 4120000,
"size_pct_liquidity": 10.01,
"impact_est_pct": 4.8,
"move_after_5m_pct": 1.9,
"facts": "final",
"explorer_url": "https://etherscan.io/tx/0x5f3c…e1"
}
OnChain analitiği: /onchain/analytics
Bu da Pro ve Max planlarında. Tek çağrı, Genesis OnChain Analytics ekranını period=24h (varsayılan) veya 7d için döndürür: toplamlar, saatlik gruplar, borsa akışları, unlock'lar, hack'ler, odaktaki coinler ve olay akışı. Tüm alanlar dokümantasyondadır.
| Alan | Tür | Anlamı |
|---|---|---|
kpi | object | Toplamlar: events, usd, tokens, cex_in, cex_out, cex_net |
hourly | object | 24h için 1 saat, 7d için 6 saat adımlı gruplar |
exchange_flows | object | Borsa başına: in_usd, out_usd, net |
tokens | array | En büyük olay ve CEX bağlamıyla odaktaki en fazla 40 coin |
events | array | Dönemin olay akışı, en fazla 600 |
cex_net, yatırılanlar eksi çekilenlerdir: örnekte 312.456.789 − 287.654.321 = 24.802.468, yani borsalara çıkanlardan 24,8 milyon $ fazla girmiştir.
curl -G "https://api.genesisarbitrage.com/v1/onchain/analytics" \
-d period=24h \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
"period": "24h",
"kpi": {
"events": 1284,
"usd": 912345678,
"tokens": 211,
"cex_in": 312456789,
"cex_out": 287654321,
"cex_net": 24802468
},
"exchange_flows": {
"Binance": {
"in_usd": 98123456, "out_usd": 87654321, "net": 10469135
}
},
"tokens": [ … ],
"events": [ … ]
}
OnChain coin: /onchain/coin/{symbol}
Pro ve Max planları ayrıca coin sayfasındaki gibi tek bir coin için 7 günlük özet alır: zincir üstü olaylar, DEX swap'ları, unlock'lar ve CEX bağlamı. Ticker yolda verilir, 1 ile 32 karakter arasındadır; yanıt en fazla 10 saniyede bir yeniden oluşturulur. Alanlar dokümantasyondadır.
| Alan | Tür | Anlamı |
|---|---|---|
cex | object veya null | Fiyat, OI, 8 saatlik fonlama, en iyi spread, ağlar, para yatırma ve çekme; coin desteklenen CEX'lerde yoksa null |
kpi | object | 7 günlük toplamlar: events, cex_in, cex_out, swaps, dex_buy, dex_sell |
by_section | object | Bölümlere göre olay sayıları; large_tx ve cex_deposits gibi anahtarlarla |
events / swaps | array | Olaylar ve swap'lar, en fazla 2000; tam sayılar events_total ve swaps_total içinde |
unlocks.upcoming / unlocks.past | array | Yaklaşan ve geçmiş unlock'lar |
curl "https://api.genesisarbitrage.com/v1/onchain/coin/PEPE" \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
"symbol": "PEPE",
"cex": {
"price": 0.00001,
"oi_usd": 412000000,
"funding_8h": 0.0081,
"best_spread": 0.42,
"deposit": true,
"withdraw": true,
"nets": ["ETH", "BSC"]
},
"kpi": {
"events": 38, "cex_in": 21000000,
"cex_out": 18500000, "swaps": 54
},
"events_total": 38,
"swaps_total": 54
}
Varsayımsal örnek: cex-flows ile bir coinin borsalara yatırılması
Amaç, son bir saatte bir coinin borsalara ne kadarının taşındığını bilmek ve her büyük para yatırma için bildirim almaktır. cex-flows bölümünde yön etiketlerde görünür: to_name içindeki borsa para yatırma, from_name içindeki borsa para çekme demektir.
Bir saatte ARB için dört para yatırma görüldü: 412.000 $, 260.000 $, 180.000 $ ve 148.000 $; toplam 412.000 $ + 260.000 $ + 180.000 $ + 148.000 $ = 1.000.000 $. Bir de 150.000 $'lık para çekme oldu. Borsalara net akış 1.000.000 $ − 150.000 $ = 850.000 $: giren, çıkandan fazla. İlk para yatırmanın varsayımsal satırı şöyle görünür:
{
"ts": 1794675511,
"token": "ARB",
"chain": "arbitrum_one",
"usd": 412000,
"amount": 1030000,
"from_name": "0x7a2f…c31b",
"to_name": "Binance Deposit",
"tx_hash": "0x9c1e…",
"explorer_url": "https://arbiscan.io/tx/0x9c1e…"
}
Coini ve eşiği belirleyin
coinvemin_usd, yanıtta tek bir coinin büyük transferlerini tutar.Para yatırmayı para çekmeden ayırın
to_nameiçindeki borsa para yatırmadır,from_nameiçindeki para çekme. Etiketleri büyük/küçük harfe bakmadan alt dize olarak eşleştirin.Pencereyi ve yeni transferleri sayın
Son saatin satırlarını
tsile toplayın, yalnızca yenitx_hashdeğerlerinde bildirim gönderin.Planınızın tazeliğinde sorgulayın
İstekler arasında
meta.freshness_seckadar bekleyin;429ve503durumundaRetry-Aftersaniye bekleyin.
import os
import time
import requests
API = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
COIN, MIN_USD = "ARB", 100_000
CEX = ("binance", "okx", "bybit", "coinbase") # etiket alt dizeleri
seen = set()
def is_cex(label):
return any(name in (label or "").lower() for name in CEX)
while True:
r = requests.get(f"{API}/onchain/cex-flows", headers=HEADERS,
params={"coin": COIN, "min_usd": MIN_USD},
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()
body = r.json()
hour_ago = time.time() - 3600
inflow = outflow = 0.0
for row in body["data"]:
if (row.get("ts") or 0) < hour_ago:
continue
usd = row.get("usd") or 0
if is_cex(row.get("to_name")): # borsaya para yatırma
inflow += usd
if row.get("tx_hash") not in seen:
seen.add(row.get("tx_hash"))
print(f"{COIN} → {row['to_name']}: ${usd:,.0f}")
elif is_cex(row.get("from_name")): # para çekme
outflow += usd
print(f"son bir saat: borsalara ${inflow:,.0f}, "
f"net akış ${inflow - outflow:,.0f}")
time.sleep(body["meta"]["freshness_sec"])
Betik yalnızca veri okur ve bildirim yazdırır; coinle ne yapacağınız sizin kararınızdır. Bir borsaya giden küçük transfer serileri coin-traffic bölümünde gruplanır; orada yön zaten direction alanındadır. Tüm coinlerin toplamları /onchain/analytics içinde kpi.cex_in, kpi.cex_out ve kpi.cex_net alanlarından gelir; zincir üstü veri kullanım senaryolarının genel bir özeti zincir üstü veri API'si makalesindedir.
Sorular ve cevaplar
Zincir üstü veri için hangi plan gerekir?
/onchain/{section} altındaki dokuz bölüm Start, Pro ve Max'te açıktır. DEX swap'ları, analitik ve coin özeti yalnızca Pro ve Max'tedir; Trial'da zincir üstü endpoint'ler 403 plan_restricted döndürür.
7 günden uzun geçmiş var mı?
En uzun pencereler swap'lar ve analitik için period=7d ile coin özetindeki 7 gündür; Genesis API'de ayrı bir arşiv yoktur. Uzun geçmiş için kayıtları her sorguda kendiniz saklayın.
Bir swap neden yanıttan kayboldu?
Doğrulamada işlemin yerine bir likidite yeniden dağıtımı bulundu ve kayıt silindi. Kayıtlı swap'ları id ile eşleştirin veya yalnızca final=true isteyin.
Yaklaşan token unlock'ları nasıl alınır?
/onchain/unlocks?when=upcoming isteğini gönderin. Her satırda unlock'ın payı ve değeri olan unlock_percent ile unlock_value_usd, ona kalan saati gösteren hours_left bulunur. min_usd değer eşiğini belirler, coin tek bir coini seçer.