Genesis Arbitrage

Genesis Arbitrage · · 18 dk okuma

Python ile kripto arbitraj botu: spread API'sinden Telegram bildirimlerine

Kısaca

  • Bir kripto arbitraj botunun dört halkası vardır: spread verisi, uygulanabilir çiftler için filtre, bildirim ve insan kararı. Kod ilk üçünü yapar; işlemleri borsalarda siz açarsınız.
  • Arbitrajda zor kısım uygulamadır: coini taşımak, komisyonlar, slipaj ve zaman. Bu yüzden bot yalnızca para çekme ve yatırmanın açık olduğu çiftleri tutar; Pro ve Max'te spreadi ayrıca 1.000 $'lık emir defteri üzerinden yeniden hesaplar.
  • Bot, Genesis API'yi en sık meta.freshness_sec aralığında sorgular, 429 ve 503 durumunda Retry-After süresini bekler ve aynı çift için en fazla 15 dakikada bir bildirim gönderir. Temel sürüm aylık 20 $'lık Trial planında çalışır.

Kripto arbitraj botu, borsalar arasındaki spreadleri (bir coinin yüzde olarak fiyat farkını) belirli aralıklarla çeken, gerçekten uygulayabileceğiniz çiftleri ayıklayan ve size bildiren bir programdır. Kararı ve işlemi insan verir. Borsalar arası spot arbitraj için böyle bir bot yaklaşık 140 satır Python tutar: spreadler Genesis API'den gelir, mesajlar Telegram Bot API üzerinden gider.

Arbitraj botu nelerden oluşur

Her arbitraj botu dört halkadan oluşur:

HalkaNe yaparBu botta
VeriBorsalardaki fiyatları ve spreadleri çekerGenesis API GET /arbitrage/spot-spot
FiltreUygulayabileceğiniz çiftleri ayırırPara yatırma ve çekme durumu, 1.000 $ için Emir defteri Δ
BildirimÇifti haber verirTelegram Bot API sendMessage yöntemi
Karar ve işlemÇifti kontrol eder ve işlem açarBorsalarda bir insan

Kendi veri toplayıcınızı yazmak en yavaş halkadır: her borsanın kendi API'si, kendi ticker ve ağ adları, kendi para yatırma ve çekme durumları vardır ve hepsini tek biçimde birleştirmek gerekir. Genesis API, Binance, OKX, Bybit, Bitget, MEXC ve Gate dahil 20'den fazla CEX borsasındaki hazır çiftleri fiyat, spread, ağ, kontrat, para yatırma ve çekme durumu ile hacimlerle birlikte verir. Her arbitraj endpoint'inin alanları Genesis API arbitraj endpoint'leri rehberinde, veri kaynağı seçimi ise Kripto API'leri: türler ve nasıl seçilir yazısında anlatılır.

İşlemler neden insanda kalır

Spread bulmak arbitrajın kolay kısmıdır. Zor olan uygulamadır: API yanıtındaki bir satır ile hesabınızdaki para arasında dört engel vardır.

Varsayımsal örnek: bot %1,2 spreadli bir çift gönderir; bu 1.000 $ için 12 $ eder. 1.000 $ için emir defterleri yürüdükten sonra %0,8, yani 8 $ kalır. Alımda ve satımda %0,1 taker komisyonu yaklaşık 2 $, coinin çekilmesi 3 $ tutar.

Coini kendiliğinden alıp çeken bir kod, bu aksaklıkların her birini kimsenin kontrol etmediği bir işleme çevirir. Bu yüzden bu bot sinyal gönderir: çekmeleri, yatırmaları ve emir defterinden sonraki spreadi kendisi kontrol eder; kontratı, komisyonları ve transfer rotasını ise işlemden önce bir insan doğrular. Genesis API zaten işlem yapamaz: yalnızca veri okur ve emir vermez. Bir çiftin adım adım elle kontrolü Borsalar arası kripto arbitraj yazısındadır.

Neler gerekir

python3 --version   # Python 3.10 veya üstü gerekir
python3 -m pip install requests

export GENESIS_API_KEY="gns_live_XXXXXXXXXXXXXXXX"
export TG_BOT_TOKEN="123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11"

# bot sohbetinde /start yazdıktan sonra yanıtta "chat":{"id":...} bulun
curl "https://api.telegram.org/bot$TG_BOT_TOKEN/getUpdates"

export TG_CHAT_ID="123456789"

export ile atanan değişkenler terminali kapatana kadar yaşar. Telegram dokümanlarına göre token botun tam kontrolünü, anahtar ise planınıza erişimi verir; bu yüzden ikisi de yalnızca ortam değişkenlerinde durur: koda veya depoya girmez.

Adım adım bot kodu

Aşağıdaki yedi blok eksiksiz bot.py dosyasıdır: hepsini bu sırayla tek dosyaya kaydedin. Ayarlardaki eşikler yer tutucudur; komisyonlarınıza ve işlem büyüklüğünüze göre değiştirin.

1. Ayarlar

import os
import time

import requests

API = "https://api.genesisarbitrage.com/v1"
TG = "https://api.telegram.org/bot" + os.environ["TG_BOT_TOKEN"]
CHAT_ID = os.environ["TG_CHAT_ID"]

MIN_SPREAD = 1.0      # satır spreadi %1'den
MIN_VOLUME = 50_000   # iki borsada da 24 sa hacim 50.000 $'dan
MIN_EXEC = 0.5        # 1.000 $'lık emir defterlerinden sonraki spread %0,5'ten
TOP = 5               # bir turda en fazla çift
REPEAT_SEC = 15 * 60  # bir çift en fazla 15 dakikada bir
RECHECK_SEC = 5 * 60  # defterin erittiği çift 5 dakika bekler

api = requests.Session()
api.headers["X-API-Key"] = os.environ["GENESIS_API_KEY"]
cache = {}       # istek -> (ETag, yanıt)
wait_until = {}  # çift -> sessiz kalınacak zamana kadar

Anahtar, api oturumuyla yapılan her isteğin X-API-Key başlığında gider, URL'ye hiç girmez. MIN_VOLUME, iki borsadan birinde 24 saatlik hacmi 50.000 $'ın altında olan çiftleri eler. cache yanıtların ETag'lerini, wait_until ise bir çift hakkında botun ne zamana kadar sessiz kalacağını tutar.

2. Genesis API çağrısı: Retry-After ve ETag

def get(path, params=None):
    """Retry-After ile yeniden deneme ve ETag destekli Genesis API GET isteği."""
    key = (path, tuple(sorted((params or {}).items())))
    for _ in range(4):  # bir istek ve en fazla üç yeniden deneme
        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
            return cache[key][1]
        if r.status_code in (429, 503):
            wait = int(r.headers.get("Retry-After", "5"))
            if wait > 60:  # tükenmiş kota böyle görünür
                raise SystemExit(f"Kota doldu: {wait} sn bekleyin")
            time.sleep(wait)
            continue
        r.raise_for_status()  # 400, 401, 403: yeniden deneme işe yaramaz
        body = r.json()
        if "ETag" in r.headers:  # ETag yalnızca tam veri setlerinde gelir
            cache[key] = (r.headers["ETag"], body)
        return body
    raise RuntimeError("Genesis API meşgul, sonraki turda yeniden denenecek")

Saniye başına rate limit veya indirme hacmi aşılırsa 429, veri yeniden oluşturulurken 503 döner. İkisi de Retry-After taşır ve get sunucunun istediği kadar saniye bekler. Tükenmiş kota da 429 döndürür, ama Retry-After sıfırlanma zamanına ayarlıdır ve bazen günler sürer; bu durumda bot durur. 400, 401 ve 403 yeniden denemeyle geçmez, bu yüzden raise_for_status onları fırlatır. Tüm limitler Genesis API limitleri rehberindedir.

3. Spreadler ve çiftlerin filtrelenmesi

def candidates():
    """Coini gerçekten taşınabilen Spot – Spot çiftleri."""
    body = get("/arbitrage/spot-spot",
               {"min_spread": MIN_SPREAD, "min_volume": MIN_VOLUME})
    # alım tarafında çekme açık, satım tarafında yatırma açık
    rows = [x for x in body["data"]
            if x["withdraw_enabled_buy"] and x["deposit_enabled_sell"]]
    rows.sort(key=lambda x: x["spread_pct"], reverse=True)
    return rows, body["meta"]["freshness_sec"]

min_spread ve min_volume satırları sunucuda filtreler. Yatırma ve çekme bayrakları için parametre yoktur, bu yüzden kodda kontrol edilir: alım borsasında çekme (withdraw_enabled_buy) ve satım borsasında yatırma (deposit_enabled_sell) açıksa coin taşınabilir. Spot — Spot dokümanındaki bir satırdan botun kullandığı alanlar:

{
  "coin": "FUEL",
  "exchange_buy": "ByBit",
  "exchange_sell": "Gate",
  "spread_pct": 0.11,
  "network": "ETH",
  "contract": "0x675B68AA4d9c2d3BB3F0397048e62E6B7192079c",
  "withdraw_enabled_buy": true,
  "deposit_enabled_sell": true,
  "volume_24h_buy": 17652.64,
  "volume_24h_sell": 12512.51,
  "trade_url_buy": "https://www.bybit.com/trade/spot/FUEL/USDT",
  "trade_url_sell": "https://www.gate.io/trade/FUEL_USDT",
  …
}

Bu satır botun filtrelerinden geçmezdi: %0,11 spread ve 50.000 $'ın altında hacimler. Bot, ağı ve kontratı mesaja koyar; böylece iki borsanın çekme ve yatırma sayfalarıyla karşılaştırabilirsiniz.

4. 1.000 $'lık emir defteri kontrolü

def exec_spread(row):
    """1.000 $'lık emir defterlerinden sonraki spread. Yalnızca Pro ve Max."""
    body = get("/orderbooks/spreads/spot-spot",
               {"coin": row["coin"], "volume": 1000})
    for x in body["data"]:
        od = x["order_delta"]
        if (x["exchange_buy"] == row["exchange_buy"]
                and x["exchange_sell"] == row["exchange_sell"]
                and od["status"] == "ok"):
            return od["spread_pct"]
    return None  # no_book, exhausted veya çift artık yok

Endpoint, coinin Spot – Spot veri setindeki satırlarını bir order_delta nesnesiyle döndürür; bu, Emir defteri Δ'dir: emir defterleri yürüdükten sonraki spread, yani alım borsasının ask'leri üzerinden alıp satım borsasının bid'lerine satmak. Fonksiyon, aynı borsalara sahip satırı alır ve status değeri ok ise order_delta.spread_pct değerini döndürür; no_book defter olmadığı, exhausted ise defterin 1.000 $'dan önce bittiği anlamına gelir. Defterler borsanın 5–20 saniye gerisindedir; alanlar Emir defteri Δ dokümanında ve emir defteri endpoint'leri rehberinde anlatılır.

Bu adım yalnızca Pro ve Max'te vardır; Trial ve Start'ta endpoint 403 plan_restricted döndürür. Bot başlangıçta planınızı okur ve orada kontrolü atlar: mesajda emir defterinin kontrol edilmediği yazar, derinliğe borsa terminalinde kendiniz bakarsınız.

5. Telegram mesajı

def message(row, ex):
    buy, sell = row["exchange_buy"], row["exchange_sell"]
    if ex is None:
        book = "emir defteri kontrol edilmedi (Trial veya Start)"
    else:
        book = f"1.000 $'lık emir defterlerinden sonra: {ex:.2f}%"
    return "\n".join([
        f'{row["coin"]}: {buy} → {sell}',
        f'Spread {row["spread_pct"]}%, {book}',
        f'Ağ {row["network"]}, kontrat {row["contract"] or "—"}',
        f'Alım: {row["trade_url_buy"]}',
        f'Satım: {row["trade_url_sell"]}',
    ])


def send(text):
    """Telegram Bot API sendMessage; 429'da retry_after kadar bekler."""
    for _ in range(3):
        r = requests.post(TG + "/sendMessage", timeout=15, json={
            "chat_id": CHAT_ID, "text": text,
            "link_preview_options": {"is_disabled": True}})
        if r.status_code != 429:
            r.raise_for_status()  # 400 veya 401: yanlış sohbet ya da token
            return
        wait = r.json().get("parameters", {}).get("retry_after", 5)
        time.sleep(wait)  # Telegram flood kontrolü
    raise RuntimeError("Telegram mesajı kabul etmedi")

sendMessage, 1 ile 4096 karakter arasında chat_id ve text alır; istek https://api.telegram.org/bot<token>/sendMessage adresine gider (Telegram Bot API dokümanları). is_disabled ile link_preview_options, bağlantı önizlemelerini kapatır. Flood kontrolünde Telegram 429 döndürür ve bekleme süresini saniye olarak parameters.retry_after içine koyar. Tek bir sohbette Telegram, botların saniyede birden fazla mesaj göndermemesini ister (bot geliştirici SSS'si).

Mesaj, varsayımsal bir örnekle şöyle görünür:

XYZ: MEXC → Gate
Spread 1.4%, 1.000 $'lık emir defterlerinden sonra: 0.62%
Ağ ETH, kontrat 0x…
Alım: https://…
Satım: https://…

6. Tekrarı önleme: bir çift 15 dakikada bir

def scan(books):
    """Bir tur: spreadler, emir defterleri, mesajlar."""
    rows, pause = candidates()
    done = 0
    for row in rows:
        key = (row["coin"], row["exchange_buy"], row["exchange_sell"])
        if time.time() < wait_until.get(key, 0):
            continue  # bildirim gitti ya da defter spreadi eritti
        if done == TOP:
            break
        done += 1
        ex = exec_spread(row) if books else None
        ok = not books or (ex is not None and ex >= MIN_EXEC)
        if ok:
            send(message(row, ex))
        # bildirimden sonra 15 dakika sessizlik, defter inceyse 5
        hold = REPEAT_SEC if ok else RECHECK_SEC
        wait_until[key] = time.time() + hold
        time.sleep(1)  # saniyede en fazla bir istek ve mesaj
    return pause

Çift; coin, alım borsası ve satım borsasından oluşan üçlüdür. Bildirimden sonra bot, spread korunsa bile o çift hakkında 15 dakika sessiz kalır. Defter spreadi eritmişse bot çifte 5 dakika sonra döner; böylece emir defteri kontrolleri her turda bir çağrıya mal olmaz. Bir tur, spreadi en geniş en fazla beş çifti alır ve her birinden sonra bir saniye durur: bu, botu Telegram'ın önerisi içinde ve her planın saniye başına limitinin altında tutar. Sözlük bellekte durur, bu yüzden yeniden başlatmadan sonra taze çiftler tekrar gelebilir.

7. Döngü: en az freshness_sec kadar duraklama

def main():
    usage = get("/account/usage")["data"]  # kota harcamaz
    books = usage["plan"] in ("pro", "max")
    pause = usage["freshness_sec"]
    print("Plan", usage["plan"], "| sorgu aralığı", pause, "sn",
          "| emir defterleri:", "evet" if books else "hayır")
    while True:
        try:
            pause = scan(books)
        except requests.HTTPError as e:
            if e.response.status_code < 500:
                raise  # anahtar, plan veya token: yeniden deneme 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)  # meta.freshness_sec'ten daha sık değil


if __name__ == "__main__":
    main()

Başlangıçta bot /account/usage çağırır: istek kota harcamaz ve planınızı ile freshness_sec değerini döndürür. Bu, veri tazeliğidir: planınızın yeni snapshot aldığı aralık; Trial'da 60 saniye, Start'ta 30, Pro'da 10, Max'te 5. Bundan sonra duraklama meta.freshness_sec değerinden gelir, çünkü daha sık sorgulamak aynı snapshot'ı döndürür. Ağ hataları ve 5xx hataları sonraki turu bekler; geri kalan 4xx hataları (yanlış anahtar, süresi dolmuş abonelik, endpoint'i olmayan plan, yanlış token veya chat_id) botu durdurur. Hata kodları Genesis API yanıtları ve hataları sayfasında listelenir; Telegram'sız bir spread izleyici Python ile spread ve fonlama oranı izleyici dersinde kurulur.

Nasıl çalıştırılır ve kontrol edilir

python3 bot.py
# Plan trial | sorgu aralığı 60 sn | emir defterleri: hayır
  1. İlk turu bekleyin

    Mesajlar, piyasada eşiklerinizin üstünde çift olduğunda gelir. Birkaç dakika içinde hiçbiri gelmezse MIN_SPREAD ve MIN_VOLUME değerlerini bir süreliğine düşürün: bu, API'den Telegram'a zincirin çalıştığını gösterir.

  2. Bir çifti tabloyla karşılaştırın

    Sitede Spot – Spot sayfasını açın: aynı coin ve borsa çifti tablodadır. Rakamlar biraz farklı olabilir, çünkü API snapshot'ı planınızın gecikmesiyle sunar.

  3. Tekrarı önlemeyi kontrol edin

    Aynı çift 15 dakika içinde yeniden gelmemelidir.

  4. Çağrı kullanımını izleyin

    /account/usage içindeki calls_used alanına veya profilinizdeki "Kullanılan çağrılar" satırına bakın: emir defteri kontrolü olmayan Trial'da bot günde yaklaşık 1.440 çağrı kullanır.

  5. Botu çalışır bırakın

    nohup python3 bot.py >> bot.log 2>&1 & botu arka planda çalıştırır; ortam değişkenlerini aynı terminal oturumunda tanımlayın.

Bot için hangi Genesis API planı gerekir

Bir tur, bir /arbitrage/spot-spot çağrısıdır; Pro ve Max'te buna en fazla beş /orderbooks/spreads/spot-spot çağrısı eklenir. Yalnızca 200 yanıtları kota harcar. 30 gün için üst sınır: (1 + tur başına kontrol) × 86.400 / duraklama × 30.

PlanSorgulama1.000 $'lık emir defteri kontrolü30 günde çağrı
Trial, ayda 20 $Her 60 snHayır500.000'den 43.200
Start, ayda 50 $Her 30 snHayır2 Mn'den 86.400
Pro, ayda 100 $Her 10 snEvet5 Mn'den en fazla 1.555.200
Max, ayda 200 $Her 5 snEvet10 Mn'den en fazla 3.110.400

Trial'da bu 86.400 / 60 × 30 = 43.200 çağrıdır, yani kotanın %8,64'ü. Pro'da, her turda beş defterin kontrol edildiği en kötü durumda 6 × 86.400 / 10 × 30 = 1.555.200 çağrı eder, yani kotanın %31,1'i. Kota kuralları dokümandaki Planlar ve limitler bölümündedir.

Arbitraj botunun riskleri

Kodsuz: Genesis Arbitrage Telegram bildirimleri

Kendi botunuzu yazıp çalıştırmak istemiyorsanız, Genesis Arbitrage Telegram bildirimleri çiftleri sizin yerinize gönderir. @BotFather'da bir bot oluşturur, token'ını sitede yapıştırır ve Spot - Spot, DEX - Futures, Crosschain ve Fonlama arbitrajı gibi kategorileri seçersiniz. Filtreler minimum spreadi, borsaları ve ağları, Para yatırma/çekme durumunu ve Emir spreadini belirler; Tekrar süresi (dk) ise aynı çiftin ne sıklıkla geri geleceğini sınırlar. Kişisel bot sitenin Pro planında çalışır, Genesis API planlarından ayrıdır; kurulum Telegram bildirimleri rehberindedir.

Sorular ve cevaplar

Bot kendi başına işlem yapabilir mi?

Genesis API üzerinden hayır: API yalnızca veri sunar ve emir vermez. İşlem, borsaların kendi API'leri ve işlem anahtarlarıyla eklenir; bu ayrı bir koddur ve riski size aittir: eski bir spread veya kapalı bir çekme, kimsenin kontrol etmediği bir işleme dönüşür.

Böyle bir bot ne kadara mal olur?

Kod ücretsizdir, botun Telegram kullanıcılarına mesajları da. Veri için ödersiniz: Genesis API Trial'da ayda 20 $'dan başlar, emir defteri kontrolü ise 100 $'lık Pro ile başlar. Ayrıca günün 24 saati çalışan bir bilgisayar veya sunucu gerekir.

Hangi Genesis API planına ihtiyacım var?

Temel bot için Trial yeterlidir: /arbitrage/spot-spot her planda vardır ve her 60 saniyede yeni bir snapshot gelir. Start veriyi her 30 saniyede yeniler. 1.000 $'lık Emir defteri Δ kontrolü yalnızca Pro ve Max'te çalışır.

Bot neden borsada spreadi kalmamış bir çift gönderdi?

Veri planınızın gecikmesiyle gelir ve diğer trader'lar da farkı kapatır. Ayrıca satır spreadi son işlemlerden hesaplanır, oysa yalnızca ask'ten alıp bid'e satabilirsiniz. İşlemden önce fiyatları ve emir defterini borsa terminalinde kontrol edin.

Botu GitHub'a koyabilir miyim?

Evet: koşullar Genesis API üzerinde kendi botlarınızı kurmaya izin verir, tek kısıt ham verinin olduğu gibi yeniden satılmasıdır. Anahtarı ve token'ı depodan uzak tutun. Anahtar herkese açık koda düşerse profilinizde "Yeniden üret"e tıklayın; @BotFather'daki /token komutu da bot token'ını değiştirir.