Python ile spread ve fonlama izleyicisi
Kısaca
- İzleyici bir konsol programıdır: her
meta.freshness_secsaniyede/arbitrage/spot-spotve/funding/spreadveri setlerini tam olarak çeker, satırları eşiklere göre süzer, tabloları yazdırır ve bir CSV dosyasına ekler. - Her iki veri seti filtresiz istenir, bu yüzden
ETagile gelir: sonraki snapshot'tan önceIf-None-Matchile yapılan tekrar istek, kota harcamadan304döndürür.429ve503yanıtlarında istemciRetry-Aftersaniye bekler. - Bacak başına varsayılan %0,1 taker komisyonundan sonra kalan, spread eksi 0,2 puandır. Pro ve Max'te izleyici ilk üç çifti 1.000 $'lık emir defteriyle yeniden kontrol eder.
- Üst sınır: Trial'da 30 günde 86.400 çağrı, yani kotanın %17,28'i; emir defteri kontrolüyle Pro'da 1.296.000 çağrı, yani %25,92.
Spread ve fonlama izleyicisi, borsalar arası spreadleri ve fonlama spreadlerini döngü içinde çeken, eşiklerinizin üstündeki satırları tutan ve konsolda tablo olarak yazdıran bir programdır. Bu dersteki izleyici yaklaşık 170 satırlık bir Python kodudur: verisi Genesis API'den gelir, geçmişi bir CSV dosyasına gider ve hiçbir işlem açmaz. Bildirim de göndermez; Telegram mesajlı bot Python ile kripto arbitraj botu yazısında anlatılır.
Sorgu planı: endpoint'ler, sıklık ve çağrı kullanımı
| İstek | Ne verir | Ne zaman |
|---|---|---|
/account/usage | Plan, freshness_sec, rps_limit | Başlangıçta, kota harcamaz |
/arbitrage/spot-spot | Spot – Spot çiftleri | Her turda, tam veri seti |
/funding/spread | Fonlamaya göre en iyi borsa çiftleri | Her turda, tam veri seti |
/orderbooks/spreads/spot-spot | 1.000 $ için emir defteri Δ | Pro ve Max, turda üç çift |
Sıklığı meta.freshness_sec belirler: planınız için yeni snapshot Trial'da 60, Start'ta 30, Pro'da 10 ve Max'te 5 saniyede bir gelir. Bundan sık sorgulamak aynı meta.updated_at ile aynı snapshot'ı getirir. İki veri setinin alanları Spot — Spot ve Fonlama spread'i dokümanlarındadır.
| Plan ve kota | Bekleme | Tur başına istek | 30 günde çağrı |
|---|---|---|---|
| Trial, 500K | 60 sn | 2 | 86.400 |
| Start, 2M | 30 sn | 2 | 172.800 |
| Pro, 5M | 10 sn | 5 | 1.296.000 |
| Max, 10M | 5 sn | 5 | 2.592.000 |
Trial'da: 2 × 86.400 / 60 × 30 = 86.400 çağrı, kotanın %17,28'i. Pro'da iki veri setine üç emir defteri kontrolü eklenir: 5 × 86.400 / 10 × 30 = 1.296.000 çağrı, 5M'nin %25,92'si. Kota kuralları Genesis API limitleri rehberindedir.
İzleyici, saniye başına istek limitine istekler arasında 1,1 / rps_limit saniye bekleyerek uyar: Trial'da 1,1 saniye, Pro'da 0,22. Pro'da beş istekli bir tur yaklaşık bir saniye sürer.
Ayarlar ve ETag ile Retry-After destekli istemci
Bu dersteki yedi kod bloğu birlikte tüm monitor.py dosyasını oluşturur: onları tek bir dosyaya art arda kaydedin. Ayarlardaki eşikler örnektir; kendi komisyonlarınıza ve tutarlarınıza göre değiştirin.
import csv
import os
import time
from datetime import datetime, timezone
import requests
API = "https://api.genesisarbitrage.com/v1"
MIN_SPREAD = 1.0 # spread %1'den
MIN_VOLUME = 50_000 # her iki borsada 24 sa hacim 50.000 $'dan
MIN_FUNDING = 0.05 # fonlama spread'i %0,05'ten
FEE = 0.1 # bacak başına varsayılan taker komisyonu, %
TOP = 10 # her tablodaki satır sayısı
BOOK_TOP = 3 # her turda emir defterine karşı kontrol edilen çift, Pro/Max
BOOK_USD = 1000 # emir defteri kontrol tutarı, USD
CSV_FILE = "monitor.csv"
api = requests.Session()
api.headers["X-API-Key"] = os.environ["GENESIS_API_KEY"]
cache = {} # istek -> (ETag, yanıt gövdesi)
stats = {200: 0, 304: 0} # kaç 200 ve 304 yanıtı geldi
pace = {"gap": 1.1, "last": 0.0} # istekler arası bekleme, sn
Anahtar GENESIS_API_KEY ortam değişkeninden gelir ve her isteğin X-API-Key başlığında gider, URL'de asla. cache, her isteğe verilen son yanıtın ETag'ini ve gövdesini tutar, stats 200 ve 304 yanıtlarını sayar, pace ise son isteğin ne zaman gittiğini hatırlar.
def get(path, params=None):
"""Genesis API'ye GET: istek aralığı, ETag ve Retry-After ile yeniden deneme."""
key = (path, tuple(sorted((params or {}).items())))
for _ in range(4): # bir istek ve en fazla üç yeniden deneme
wait = pace["last"] + pace["gap"] - time.monotonic()
if wait > 0:
time.sleep(wait) # saniyede en fazla rps_limit istek
pace["last"] = time.monotonic()
hdr = {"If-None-Match": cache[key][0]} if key in cache else {}
r = api.get(API + path, params=params, headers=hdr,
timeout=15)
if r.status_code == 304: # snapshot değişmedi
stats[304] += 1
return cache[key][1]
if r.status_code in (429, 503):
wait = int(r.headers.get("Retry-After", "5"))
if wait > 60: # kota bittiğinde böyle görünür
raise SystemExit(f"Kota bitti: {wait} sn bekleyin")
time.sleep(wait)
continue
r.raise_for_status() # 400, 401, 403: yeniden denemek işe yaramaz
stats[200] += 1
body = r.json()
if "ETag" in r.headers: # yalnızca tam veri setlerinde bulunur
cache[key] = (r.headers["ETag"], body)
return body
raise RuntimeError("API meşgul, sonraki turda yeniden denenecek")
ETag, snapshot'ın sürüm etiketidir. get onu If-None-Match başlığıyla geri gönderir; snapshot değişene kadar sunucu gövdesiz 304 döndürür: kota harcanmaz ve fonksiyon önceki gövdeyi verir. 429 ve 503 yanıtlarında Retry-After saniye bekleyip yeniden dener; bir dakikadan uzun bekleme, dönem kotasının bittiği anlamına gelir ve izleyici durur. Hata kodları ve yeniden deneme kuralları Genesis API yanıtları ve hataları rehberindedir.
Spread ve fonlama: yükleme, eşikler ve sıralama
def spot_rows():
"""Eşiklerin üstündeki Spot – Spot çiftleri, coin transfer edilebilir."""
body = get("/arbitrage/spot-spot") # filtre yok: ETag var
rows = []
for x in body["data"]:
vol = min(x["volume_24h_buy"] or 0, x["volume_24h_sell"] or 0)
if (x["spread_pct"] >= MIN_SPREAD and vol >= MIN_VOLUME
and x["withdraw_enabled_buy"]
and x["deposit_enabled_sell"]):
rows.append({**x, "net": net(x["spread_pct"])})
rows.sort(key=lambda x: x["spread_pct"], reverse=True)
return rows[:TOP], body["meta"]
def funding_rows():
"""Fonlama spread'i en geniş coinler."""
body = get("/funding/spread") # filtre yok: ETag var
rows = [x for x in body["data"] if x["spread_pct"] >= MIN_FUNDING]
rows.sort(key=lambda x: x["spread_pct"], reverse=True)
return rows[:TOP], body["meta"]
Her iki veri seti de parametresiz istenir: min_spread, coin veya başka bir filtreyle yapılan isteğin yanıtı o istek için oluşturulur ve ETag olmadan gelir. Eşikleri izleyici kendisi uygular: en az MIN_SPREAD spread, her iki borsada en az MIN_VOLUME 24 saatlik hacim, alım borsasında çekim ve satım borsasında yatırma açık. null hacim sıfır sayılır, yani böyle bir satır eşiği geçmez.
Satırlar spread_pct değerine göre azalan sırada dizilir ve ilk TOP tanesi tabloya girer. /funding/spread içinde MIN_FUNDING eşiği, en iyi çiftin spread_pct değeriyle karşılaştırılır.
Komisyonlardan sonra kalan ve emir defteri kontrolü
def net(spread_pct):
"""İki taker komisyonundan sonra kalan, yaklaşık, %."""
return round(spread_pct - 2 * FEE, 4)
def book_net(row):
"""BOOK_USD tutarında emir defteri ve komisyonlardan sonra kalan. Pro ve Max."""
body = get("/orderbooks/spreads/spot-spot",
{"coin": row["coin"], "volume": BOOK_USD})
pair = (row["exchange_buy"], row["exchange_sell"])
for x in body["data"]:
if (x["exchange_buy"], x["exchange_sell"]) != pair:
continue
od = x["order_delta"]
if od["status"] != "ok":
return od["status"] # no_book veya exhausted
return net(od["spread_pct"])
return "gone" # çift veri setinden çıktı
Alımda %0,1 ve satımda %0,1 varsayılan taker komisyonu spreadi yaklaşık 0,2 puan düşürür: %1,62'lik bir çiftten 1,62 − 2 × 0,1 = %1,42 kalır. FEE değerine kendi borsalarınızın komisyonlarını yazın (maker ve taker). Çekim ücretleri API yanıtlarında yoktur ve izleyici onları hesaba katmaz.
Pro ve Max'te book_net, ilk üç çifti emir defterlerine karşı yeniden kontrol eder: çiftin coin'i ve volume=1000 ile /orderbooks/spreads/spot-spot, o coin'in satırlarını order_delta nesnesiyle döndürür; fonksiyon aynı borsa çiftine ait satırı alır (Emir defteri Δ). Defter yoksa veya tükendiyse sayı yerine no_book ya da exhausted durumu gelir. coin içeren isteğin ETag'i yoktur ve her seferinde bir çağrı harcar; bu yüzden bir tur yalnızca üç tane yapar, bunu BOOK_TOP belirler.
Konsol tablosu
def show(spot, s_meta, fund, f_meta):
now = time.time()
s_age = now - s_meta["updated_at"]
f_age = now - f_meta["updated_at"]
print(f"\nSpot – Spot, snapshot yaşı {s_age:.0f} sn")
print(f"{'Coin':<8}{'Al → sat':<20}"
f"{'Spread':>7}{'-komis.':>9}{'Defter':>11}")
for x in spot:
pair = f'{x["exchange_buy"]} → {x["exchange_sell"]}'
book = x.get("book", "—")
if isinstance(book, float):
book = f"{book:.2f}"
print(f'{x["coin"]:<8}{pair:<20}{x["spread_pct"]:>7.2f}'
f'{x["net"]:>9.2f}{book:>11}')
print(f"\nFonlama, snapshot yaşı {f_age:.0f} sn")
for x in fund:
b = x["best"]
legs = (f'{b["exchange_1"]} {b["interval_1"] or "?"} / '
f'{b["exchange_2"]} {b["interval_2"] or "?"}')
print(f'{x["coin"]:<8}{legs:<27}{x["spread_pct"]:>8.4f} %')
print(f"200 yanıtı: {stats[200]}, 304: {stats[304]}")
İlk tablo coin'i, borsa çiftini, spread_pct değerini, komisyondan sonra kalanı ve defterden sonra kalanı gösterir; tire, defterin kontrol edilmediği anlamına gelir. İkincisi, fonlama aralıkları ve spread_pct ile fonlamaya göre en iyi borsa çiftini gösterir. Tabloların üstünde snapshot yaşı bulunur: şimdiki zaman eksi meta.updated_at; altında ise başlangıçtan beri gelen 200 ve 304 yanıtlarının sayısı yer alır.
CSV geçmişi
def save(spot, fund):
"""Turu CSV'ye ekler: zaman, veri seti, çift, spreadler."""
new = not os.path.exists(CSV_FILE)
ts = datetime.now(timezone.utc).strftime("%Y-%m-%d %H:%M:%S")
with open(CSV_FILE, "a", newline="", encoding="utf-8") as f:
w = csv.writer(f)
if new:
w.writerow(["time_utc", "dataset", "coin", "leg_1",
"leg_2", "spread_pct", "net_pct", "book"])
for x in spot:
w.writerow([ts, "spot-spot", x["coin"], x["exchange_buy"],
x["exchange_sell"], x["spread_pct"], x["net"],
x.get("book")]) # None boş hücre olur
for x in fund:
b = x["best"]
w.writerow([ts, "funding", x["coin"], b["exchange_1"],
b["exchange_2"], x["spread_pct"], None, None])
Konsol tablosu bir sonraki tura kadar durur; monitor.csv ise her turu saklar: bir çiftin ne kadar sürdüğünü ve hangi saatlerde göründüğünü gösterir. csv modülü Python standart kütüphanesinin parçasıdır. Dosyayı modül dokümantasyonunun istediği gibi newline="" ile açın; aksi halde \r\n satır sonu kullanan sistemlerde dosyaya fazladan bir \r girer.
book sütunu, defterden sonra kalanı yüzde olarak ya da exhausted veya no_book durumunu tutar. Modül None değerini boş hücre olarak yazar, bu yüzden sütun fonlama satırları ve kontrol edilmemiş çiftler için boş kalır. Saatler UTC'dir.
Ana döngü
def main():
usage = get("/account/usage")["data"] # does not use quota
books = usage["plan"] in ("pro", "max")
pace["gap"] = 1.1 / usage["rps_limit"]
print("Plan", usage["plan"], "| snapshot adımı",
usage["freshness_sec"], "sn | emir defterleri:",
"evet" if books else "hayır")
pause = usage["freshness_sec"]
while True:
try:
spot, s_meta = spot_rows()
fund, f_meta = funding_rows()
if books:
for x in spot[:BOOK_TOP]:
x["book"] = book_net(x)
show(spot, s_meta, fund, f_meta)
save(spot, fund)
pause = s_meta.get("freshness_sec", pause)
except requests.HTTPError as e:
if e.response.status_code < 500:
raise # anahtar, plan veya parametreler: yeniden denemek işe yaramaz
print("Sunucu hatası, yeniden deneniyor:", e)
except (requests.RequestException, RuntimeError) as e:
print("Yanıt yok, yeniden deneniyor:", e)
time.sleep(pause) # freshness_sec'ten sık = aynı snapshot
if __name__ == "__main__":
try:
main()
except KeyboardInterrupt:
print("\nİzleyici durduruldu, geçmiş şurada:", CSV_FILE)
Başlangıçta izleyici /account/usage çağırır: istek kota harcamaz ve planı, freshness_sec ile rps_limit değerlerini döndürür (Kullanım). Plan, izleyiciye emir defterlerini kontrol edip etmeyeceğini söyler; rps_limit ise istekler arası beklemeyi belirler. İzleyici ağ kesintilerini ve 5xx hatalarını bir sonraki tura kadar atlatır; 4xx hataları (yanlış anahtar, süresi dolmuş abonelik, endpoint'i olmayan plan) onu durdurur.
Nasıl çalıştırılır ve çıktı nasıl okunur
python3 --version # Python 3.10 veya üstü gerekir
python3 -m pip install requests
export GENESIS_API_KEY="gns_live_XXXXXXXXXXXXXXXX"
python3 monitor.py
Pro planındaki çıktı, örnek amaçlıdır:
Plan pro | snapshot adımı 10 sn | emir defterleri: evet
Spot – Spot, snapshot yaşı 4 sn
Coin Al → sat Spread -komis. Defter
KLM ByBit → Gate 1.62 1.42 0.86
XYZ MEXC → Gate 1.24 1.04 exhausted
ABC BingX → HTX 1.12 0.92 0.31
QRS Gate → OKX 1.05 0.85 —
Fonlama, snapshot yaşı 4 sn
XYZ MEXC 4h / Bitget 8h 0.0600 %
ABC Hyper 1h / CoinEx 8h 0.0500 %
200 yanıtı: 6, 304: 0
KLM: satır spreadi %1,62, iki komisyondan sonra %1,42 ve 1.000 $'lık emir defteri ile komisyonlardan sonra %0,86. XYZ, 1.000 $'da defteri tüketti: böyle bir çift için tutarı azaltır ya da atlarsınız. QRS dördüncü satırdır, bu yüzden defteri istenmedi. Fonlama tablosu her borsanın ne sıklıkla uzlaştığını gösterir: Hyper (Hyperliquid'in yanıtlardaki adı) her saat, CoinEx ise 8 saatte bir. İzleyiciyi durdurmak için Ctrl+C'ye basın.
3. dersteki dört çift kontrolünden izleyici fiyat farkını ve transferi kendisi yapar, emir defterini Pro ve Max'te kontrol eder ve tablonun üstünde tazeliği gösterir. Kontratı ve çekim ücretini siz doğrularsınız.
Uygulama
İzleyiciyi başlatın
İlk çıktı satırı planı, snapshot adımını ve defterlerin kontrol edilip edilmediğini gösterir; bunları profilinizle karşılaştırın.
Eşiği değiştirin
MIN_SPREAD = 0.5yapın ve yeni satırların kaçında -komisyon sütununun sıfırın üstünde kaldığına bakın.Bir veri seti ekleyin
spot_rowsfonksiyonunu/arbitrage/futures-futuresiçin kopyalayın: satır biçimi aynıdır. Vadeli işlemlerde yatırma ve çekim kontrolünü çıkarın, çünkü orada borsalar arasında coin taşınmaz.Kullanımı kontrol edin
Bir saat sonra
/account/usageçağırın vecalls_useddeğerini tahminle karşılaştırın: Trial'da bu saatte en fazla 2 × 60 = 120 çağrıdır.Kalıcı çiftleri bulun
monitor.csvdosyasını bir elektronik tabloda açın ve her borsa çiftinin art arda kaç tur sürdüğünü sayın.
Bayat veriden ve hatalardan anahtarlara ve AI ajanlarına kadar otomasyon riskleri 5. derste anlatılır; filtre, sıkıştırma ve ETag ile tasarruflu sorgulama ise limitlere takılmadan API sorgulama yazısında.
Sorular ve cevaplar
İzleyici bir arbitraj botundan nasıl farklıdır?
İzleyici bir tablo yazdırır ve geçmişi tutar; bot yeni çiftler için bildirim gönderir ve tekrarlar hakkında sessiz kalır. İkisi istek ve filtreleme kodunu paylaşır; Telegram botu Python ile kripto arbitraj botu yazısında anlatılır.
freshness_sec'ten sık sorgulayabilir miyim?
Yeni veri almazsınız: planınız her freshness_sec saniyede bir snapshot alır. Bir sonraki snapshot'tan önce filtresiz bir istek ücretsiz 304 döndürür; filtreli bir istek ise aynı veri için bir çağrı harcar.
Defter sütununda neden tire görünüyor?
Emir defteri Δ yalnızca Pro ve Max'tedir ve izleyici onu ilk üç çift için ister (BOOK_TOP). Trial ve Start'ta endpoint 403 plan_restricted döndürür, bu yüzden izleyici onu çağırmaz.