Genesis Arbitrage

Genesis Arbitrage · · 14 dk okuma

Kripto API: kripto piyasa verisi API türleri ve işlem için doğru API nasıl seçilir

Kısaca

  • Kripto API, kodunuza piyasa verisi verir: fiyatlar, emir defterleri, fonlama oranları, zincir üstü işlemler ve tahmin piyasası kotasyonları. Borsa API'si tek bir platformu kapsar ve anahtarla emir alır; piyasa verisi API'si birçok platformu tek formatta birleştirir.
  • API'yi dokuz ölçüte göre seçin: platform ve zincir kapsamı, tazelik, alan normalleştirme, para yatırma ve çekme durumu, emir defteri derinliği, rate limit, fiyat, dokümantasyon ve veri kullanım şartları.
  • Genesis API salt okunur bir REST API'dir: CEX, DEX, zincir üstü, tahmin piyasaları ve bahis şirketi surebet'leri tek JSON formatında, planlar ayda 20 $'dan başlar. Emir vermez.

Kripto API, kodun kripto piyasa verisini okuduğu veya borsaya emir gönderdiği programlama arayüzüdür: fiyatlar, emir defterleri, fonlama oranları, blokzincir işlemleri, tahmin piyasası kotasyonları. API türleri kapsamlarına göre ayrılır: borsa API'si tek bir platformu bilir ve anahtarla emir alır, piyasa verisi API'si birçok platformu tek formatta birleştirir, zincir üstü API ise blokzinciri okur.

Kripto API türleri

API türüNe verirNe zaman gerekir
Borsa API'siTek bir borsanın fiyatları, emir defterleri ve işlemleri; anahtarla emirO borsada işlem yapmak, bir paritenin işlem akışı
Piyasa verisi API'siBirçok borsa tek formatta, hazır spread'lerBorsaları karşılaştırmak, tarayıcılar, uyarılar
Zincir üstü APIİşlemler, transferler, bakiyeler, kontrat olaylarıWhale'ler, borsa akışları, kilit açılımları
DEX APIHavuz fiyatları ve likidite, swap'lar, slippageCEX'te olmayan tokenlar, DEX – CEX kurulumları
Türev verileriFonlama, açık pozisyon, vadeli işlem fiyatlarıFonlama arbitrajı, pozisyon dengesizliği
Tahmin piyasası ve oran API'leriYES ve NO fiyatları, emir defterleri, bahis şirketi oranlarıTahmin piyasası arbitrajı, surebet'ler

Borsa API'leri

Kripto borsa API'si tek bir platformun arayüzüdür ve iki bölümden oluşur. Genel bölüm piyasa verisini anahtarsız sunar: Binance'te bu endpoint'ler NONE güvenlik türündedir ve GET /api/v3/ticker/price bir paritenin fiyatını döndürür. Özel bölüm — emirler, bakiyeler, işlem geçmişi — API anahtarı ve istek imzası ister; Binance'te bunlar TRADE ve USER_DATA türleridir (Binance dokümantasyonu).

Böyle bir API tek borsayı kapsar: bir coin'in fiyatını 20 borsada karşılaştırmak için farklı format ve limitlere sahip 20 bağlantı gerekir.

Piyasa verisi API'leri

Piyasa verisi API'si birçok borsadan veri toplar, normalleştirir ve tek istekte döndürür. Yanıt, platformları birleştirmek için gereken her şeyi zaten içerir: borsalar arası spread'ler, tek döneme normalleştirilmiş fonlama oranları, borsa bazında açık pozisyon.

Zincir üstü API'ler

Zincir üstü API blokzinciri okur: işlemler, token transferleri, adres bakiyeleri, akıllı kontrat olayları. En alt katman bir ağ düğümüdür: her Ethereum istemcisi JSON-RPC konuşur; eth_getBalance bakiyeyi wei cinsinden onaltılık sayı olarak, eth_getLogs ise filtreye uyan kontrat olaylarını döndürür.

Düğüm, hangi adreslerin bir borsaya, bir ekibe veya bir whale'e ait olduğunu bilmez; bu etiketleri indeksleyiciler ve zincir üstü analitik servisleri ekler. Bir trader'ın hangi verilere ihtiyaç duyduğu Zincir üstü veri API'si yazısında anlatılıyor.

DEX API'leri

DEX API, merkeziyetsiz borsalardaki havuz fiyatlarını ve likiditeyi, swap'ları ve slippage'i sunar. Swap havuz likiditesine göre ne kadar büyükse fiyatı o kadar kaydırır; bu yüzden DEX – CEX kurulumunda sizin işlem büyüklüğünüz için slippage gerekir, yeni tokenlarda ise token vergisi ve honeypot kontrolü gerekir. Ayrıntılar DEX API yazısında.

Türev verileri: fonlama ve açık pozisyon

Sürekli vadeli işlemler için fonlama oranı, açık pozisyon (açık pozisyonların hacmi) ve spot yanında vadeli işlem fiyatı gerekir. Borsalar fonlamayı 8, 4 veya 1 saatte bir uzlaştırır, bu yüzden oranlar tek döneme normalleştirildikten sonra karşılaştırılır. Ayrıntılar Fonlama oranı API'si ve Açık pozisyon API'si yazılarında.

Tahmin piyasası ve oran API'leri

Tahmin platformları YES ve NO kontrat fiyatlarını ve emir defterlerini sunar. Polymarket'te genel piyasa verisi kimlik bilgisi gerektirmez, emir ise kimlik doğrulama ve cüzdan imzası ister (Polymarket dokümantasyonu).

Formatlar burada da farklıdır: Kalshi'nin emir defterinde yalnızca bid'ler bulunur ve YES ask'ı 1 $ eksi en iyi NO bid'idir; yani 0,56 $'lık NO bid'i 0,44 $'lık YES ask'ı demektir (Kalshi dokümantasyonu). Bahis şirketi oranları, YES ve NO fiyatlarıyla zımni olasılık üzerinden karşılaştırılır — bkz. Polymarket API ve Kalshi API ile Spor oranları API'si.

REST ve WebSocket

REST API isteğe, sizin filtrelediğiniz bir anlık görüntüyle yanıt verir; güncellemeleri belirli aralıklarla polling yaparak alırsınız.

WebSocket bağlantıyı açık tutar ve sunucu her işlemi ve emir defteri değişikliğini iter. Karşılığında akışı boşluksuz işlemeniz, kopmalardan sonra yeniden bağlanmanız ve defteri anlık görüntü artı güncellemelerden yeniden kurmanız gerekir; Kalshi ise genel kanallar için bile bağlanırken kimlik doğrulaması ister. Saniye altı tepki için WebSocket gerekir; 20'den fazla borsada tarayıcılar ve uyarılar REST üzerinden çalışır.

Genesis API yalnızca RESTtir; WebSocket ve webhook yoktur: her istek bir GET'tir, yanıtlar gzip ile sıkıştırılmış JSON olarak gelir ve veri her meta.freshness_sec saniyede bir yenilenir. Filtresiz tam set isteğini, önceki ETag değerini If-None-Match içinde göndererek tekrarlarsanız ve hiçbir şey değişmemişse gövdesiz bir 304 döner; bu yanıt kota harcamaz. Polling kalıpları API polling en iyi uygulamaları yazısında.

Kripto API nasıl seçilir: kontrol listesi

İlk altı ölçüt canlı bir API yanıtında görünür; gerisi dokümantasyonda ve fiyatlandırmada yer alır.

ÖlçütNeye bakılır
Platform ve zincir kapsamıKullandığınız borsalar, spot ve vadeli işlem, DEX'ler ve zincirler
Tazelik ve gecikmeYanıttaki oluşturma zamanı, yenileme adımı, emir defteri yaşı
Alan normalleştirmeTutarlı ticker'lar, birimler, yüzdeler ve zaman
Para yatırma ve çekme durumuBorsa ve ağ bazında para yatırma ve çekme bayrakları
Emir defteri derinliğiSizin büyüklüğünüz için gerçekleşme fiyatı
Rate limit ve kotalarSaniyedeki istek, dönem başına çağrı, neyin çağrı sayıldığı
FiyatPlan veya çağrı başına ödeme, limit aşılınca ne olduğu
Dokümantasyon ve OpenAPIİstek ve yanıt örnekleri, şema
Veri kullanım şartlarıVeriler üzerinde kendi ürününüzü kurup kuramayacağınız

Kapsam ve tazelik

Kapsamı kendi listenize göre kontrol edin: botunuz MEXC ve Gate ile çalışıyorsa, ikisinden birini içermeyen API işe yaramaz. Veri tazeliği, anlık görüntünün oluşturulmasından bu yana kaç saniye geçtiğidir; gecikme ise borsadaki bir işlemden kodunuza giden yolun tamamıdır. Bir dakikalık anlık görüntüde bot, çoktan kapanmış spread'leri görür.

Alan normalleştirme

Aynı BTC/USDT paritesi borsa API'lerinde farklı yazılır: Binance'te BTCUSDT, OKX'te BTC-USDT (sürekli vadeli işlem BTC-USDT-SWAP), Gate'te BTC_USDT. Binance fiyatları string olarak ("price": "4.00000200" — dokümantasyondaki örnek) ve zamanı milisaniye cinsinden döndürür. Kodunuzun bu farkların her birini ele alması gerekir.

Piyasa verisi API'si alanları tek biçime getirir; Genesis API dokümantasyonundaki /funding/rates girdisinde olduğu gibi:

{
  "coin": "TON",
  "exchanges": [
    {
      "exchange": "MEXC",
      "funding_pct": 0.02,
      "funding_8h_pct": 0.04,
      "next_payout": "00:00",
      "interval": "4h",
      "price": 2.184,
      "trade_url": "https://futures.mexc.com/exchange/TON_USDT"
    }
  ]
}

MEXC bu coin için fonlamayı 4 saatte bir uzlaştırır ve dönem başına %0,02'lik oran funding_8h_pct içinde 8 saate normalleştirilir: 0,02 × 8 / 4 = %0,04 (bkz. Fonlama oranları).

Para yatırma ve çekme durumu

Borsalar arası spot kurulum, ancak coin alış borsasından çekilebiliyor ve satış borsasına yatırılabiliyorsa uygulanabilir. Binance'te ağ durumları GET /sapi/v1/capital/config/getall ile gelir; bu, hesabınızın API anahtarını gerektiren imzalı bir USER_DATA endpoint'idir (Binance dokümantasyonu). Genesis API'de durumlar her Spot – Spot satırında withdraw_enabled_buy ve deposit_enabled_sell olarak gelir (Spot — Spot dokümantasyonu).

Emir defteri derinliği

En iyi fiyattaki spread defterin tepesindeki farkı gösterir; 5.000 $'lık bir işlem ise piyasa derinliğinin birkaç seviyesini tüketir. Genesis API dokümantasyonundaki /orderbooks/spreads/spot-futures örneğinde BTC spread'i en iyi fiyatlarda %0,031, 5.000 $ için defterler boyunca ilerledikten sonra %0,0202'dir. Gerçekleşme fiyatları endpoint'i 500–10.000 $ için gerçekleşme fiyatlarını döndürür; ayrıntılar Kripto emir defteri API'si yazısında.

Limitler, fiyat ve dokümantasyon

Limitler farklı sayılır. Binance'te her endpoint'in bir ağırlığı vardır, birçok sembole yönelik istekler daha ağırdır ve 429 sonrasında istek göndermeye devam eden bir IP 2 dakikadan 3 güne kadar yasaklanır (Binance limitleri). Bir veri API'sinde çağrı kotasına, saniyedeki rate limit'e ve neyin çağrı sayıldığına bakın: Genesis API'de yalnızca 200 yanıtı kota harcar.

Fiyatlandırma ya kotalı bir plandır ya da çağrı başına ödemedir; limit aşılınca ne olduğunu öğrenin: 429 hatası mı, ek ücret mi. OpenAPI şeması, istemci üretmek ve yapay zekâ ajanlarını bağlamak için API'nin makine tarafından okunabilir açıklamasıdır; kullanım şartları ise veriler üzerinde ürün kurup kuramayacağınızı ve neyi yeniden satamayacağınızı söyler.

Tek istekle kontrol

Bu betik tam Spot – Spot setini çeker (her Genesis API planında mevcuttur) ve tek yanıtla kapsamı, anlık görüntünün yaşını ve aktarılabilir kurulumların payını kontrol eder:

import os
import time

import requests

BASE = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}

r = requests.get(BASE + "/arbitrage/spot-spot",
                 headers=HEADERS, timeout=15)
r.raise_for_status()
body = r.json()
rows, meta = body["data"], body["meta"]

# Coverage: which exchanges appear in the setups
venues = {x["exchange_buy"] for x in rows}
venues |= {x["exchange_sell"] for x in rows}
print("exchanges in response:", len(venues), sorted(venues))

# Freshness: snapshot age and the plan's refresh step
age = time.time() - meta["updated_at"]
print(f"snapshot {age:.0f} s old, plan step {meta['freshness_sec']} s")

# Transfer: withdrawals open on the buy side, deposits on the sell side
ok = [x for x in rows
      if x["withdraw_enabled_buy"] and x["deposit_enabled_sell"]]
print(f"transferable setups: {len(ok)} of {len(rows)}")

429 ve 503 için yeniden denemeler Genesis API yanıtları ve hataları yazısındaki get_json fonksiyonundan gelir. Ardından 3–5 kurulumun fiyatlarını ve durumlarını trade_url_buy ve trade_url_sell üzerinden borsalarda kontrol edin.

Kendiniz kurun veya hazır API kullanın

Bir iki borsa ve işlem için kendi kodunuz, onların API'leri üzerinde doğal seçimdir. Spot ve vadeli işlemli 20 borsa için bu 40'a kadar piyasa verisi bağlayıcısı demektir: Binance'te spot ve USDⓈ-M vadeli işlemler ayrı API'lerdir, api.binance.com ve fapi.binance.com. Her bağlayıcı REST anlık görüntülerini, yeniden bağlanmalı bir WebSocket akışını, kendi limitlerini ve sembol formatını taşır; üstüne birleştirme gelir: coin'ler kontrat ve ağa göre eşleştirilir, çünkü aynı ticker farklı borsalarda farklı tokenlar olabilir.

GörevBorsa API'leri üzerinde kendi kodunuzGenesis API
Emir vermeTek yol: borsanın işlem API'siHayır, salt okunur
Bir paritenin her işlemiBorsa WebSocket'iHayır, 60–5 sn'de bir anlık görüntü
20'den fazla borsada spread'ler40'a kadar bağlayıcı artı birleştirmeTek istek
Para yatırma ve çekme durumuBorsa başına bir endpoint, Binance'te anahtarlaKurulum satırındaki alanlar
DEX, zincir üstü, tahmin piyasalarıDüğümler, indeksleyiciler, platform API'leriAynı JSON formatı

Yaklaşımlar birleştirilebilir: veri API'si kurulumları bulur, işlem ise borsada elle ya da çekim yetkisi olmayan bir anahtarla borsanın işlem API'si üzerinden açılır (bkz. Kripto borsa hesabınızı nasıl korursunuz). Telegram uyarılı bir bot Python ile kripto arbitraj botu yazısında kurulur.

Genesis API nereye oturur

Genesis API, Genesis Arbitrage verilerinin REST API'sidir: CEX, DEX, zincir üstü, tahmin piyasaları ve bahis şirketi surebet'leri tek JSON formatında, anahtar X-API-Key başlığında. Sitenin yayınladığı aynı verileri 35'ten fazla endpoint üzerinden sunar (şemada 37 işlem) ve yalnızca veri okur.

VeriÖrnek endpointAPI planları
CEX spread'leri/arbitrage/spot-spotTümü
DEX ve zincirler arası/arbitrage/dex-spotPro, Max
Emir defterleri/orderbooks/execPro, Max
Fonlama ve OI/funding/ratesTümü
Zincir üstü/onchain/{section}Start, Pro, Max
Tahmin piyasaları ve surebet'ler/predictions/arbitrageStart: exact, dutch; Pro, Max: llm, sport

Kapsam: 20'den fazla CEX borsası (Binance, OKX, Bybit, Bitget, MEXC, Gate, BingX, Kraken, WhiteBit, Coinbase, CoinW, edgeX, HTX, Hyperliquid ve diğerleri), 8 saate normalleştirilmiş 1000'den fazla coin için fonlama, 13'ten fazla vadeli işlem borsasında açık pozisyon. Tahmin piyasaları Polymarket, Kalshi, Limitless, Predict.fun ve Opinion'dır; sport modu 13 platformda bahis şirketi surebet'leri kurar, yalnızca maç öncesi.

PlanAylık çağrıSaniyedeki istekTazelik
Trial, ayda 20 $500K160 sn
Start, 50 $2M230 sn
Pro, 100 $5M510 sn
Max, 200 $10M155 sn

API planları site aboneliğinden ayrıdır; ödeme kriptoyla yapılır, 3 ay için %10, 6 ay için %20 indirimle. Limitler aşılınca sunucu 429 döndürür ve ücret almaz; planınızın dışındaki endpoint ise 403 plan_restricted döndürür. Planları Genesis API fiyatları sayfasında karşılaştırın; kurallar Planlar ve limitler bölümünde.

Dokümantasyonun her bölümünün kendi adresi vardır: parametreler, alanlar, curl örneği ve Deneyin formu. Programlar ve yapay zekâ ajanları için OpenAPI 3.1 şeması ile llms-full.txt referansı vardır; kurulum Yapay zekâ ajanları için Genesis API yazısında anlatılıyor. Genesis API üzerinde kendi servislerinizi, botlarınızı ve panellerinizi kurabilirsiniz; ham veriyi olduğu gibi yeniden satamazsınız.

İlk istek — bir plan, profilinizdeki anahtar ve X-API-Key ile bir GET — hızlı başlangıç bölümünde, temelleri ise Kripto API nedir ve neleri otomatikleştirebilirsiniz dersinde anlatılıyor. Kodsuz, aynı veriler sitenin tablolarında ve Telegram uyarılarında bulunur.

Sorular ve cevaplar

Ücretsiz kripto API var mı?

Evet: genel borsa API'leri fiyatları, emir defterlerini ve işlemleri ücretsiz ve anahtarsız sunar (Binance'te NONE endpoint'leri), ancak her biri tek bir borsayı kapsar. Genesis API'nin ücretsiz planı yoktur: Trial, 500K çağrı için ayda 20 $'dır.

Kripto API kullanmak için SDK gerekir mi?

REST API için bir HTTP istemcisi yeterlidir: curl, Python'da requests veya JavaScript'te fetch. Genesis API'nin resmî SDK'sı yoktur ve her istek tek başlıklı bir GET'tir; OpenAPI 3.1 şemasından tipli bir istemci üretebilirsiniz.

Piyasa verisi API'si üzerinden işlem yapabilir miyim?

API Genesis API gibi salt okunursa hayır: kurulumları bulur ama emir vermez. Emirler borsa üzerinden verilir; elle ya da anahtar ve imza gerektiren işlem API'si ile (Binance'te TRADE endpoint'leri) — bu Genesis API'nin dışındadır ve sorumluluk size aittir.

API'den kripto fiyatı nasıl alınır?

Borsanın genel endpoint'i, paritenin o borsadaki fiyatını döndürür: Binance'te bu GET /api/v3/ticker/price'tır ve fiyat string olarak gelir. Bir coin'in tüm borsalardaki fiyatları ve para yatırma/çekme durumu, Genesis API'de /coins/search?query=BTC ile gelir (bkz. Coin araması).