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 verir | Ne zaman gerekir |
|---|---|---|
| Borsa API'si | Tek bir borsanın fiyatları, emir defterleri ve işlemleri; anahtarla emir | O borsada işlem yapmak, bir paritenin işlem akışı |
| Piyasa verisi API'si | Birçok borsa tek formatta, hazır spread'ler | Borsaları 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 API | Havuz fiyatları ve likidite, swap'lar, slippage | CEX'te olmayan tokenlar, DEX – CEX kurulumları |
| Türev verileri | Fonlama, açık pozisyon, vadeli işlem fiyatları | Fonlama arbitrajı, pozisyon dengesizliği |
| Tahmin piyasası ve oran API'leri | YES 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çüt | Neye bakılır |
|---|---|
| Platform ve zincir kapsamı | Kullandığınız borsalar, spot ve vadeli işlem, DEX'ler ve zincirler |
| Tazelik ve gecikme | Yanıttaki oluşturma zamanı, yenileme adımı, emir defteri yaşı |
| Alan normalleştirme | Tutarlı ticker'lar, birimler, yüzdeler ve zaman |
| Para yatırma ve çekme durumu | Borsa ve ağ bazında para yatırma ve çekme bayrakları |
| Emir defteri derinliği | Sizin büyüklüğünüz için gerçekleşme fiyatı |
| Rate limit ve kotalar | Saniyedeki istek, dönem başına çağrı, neyin çağrı sayıldığı |
| Fiyat | Plan 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örev | Borsa API'leri üzerinde kendi kodunuz | Genesis API |
|---|---|---|
| Emir verme | Tek yol: borsanın işlem API'si | Hayır, salt okunur |
| Bir paritenin her işlemi | Borsa WebSocket'i | Hayır, 60–5 sn'de bir anlık görüntü |
| 20'den fazla borsada spread'ler | 40'a kadar bağlayıcı artı birleştirme | Tek istek |
| Para yatırma ve çekme durumu | Borsa başına bir endpoint, Binance'te anahtarla | Kurulum satırındaki alanlar |
| DEX, zincir üstü, tahmin piyasaları | Düğümler, indeksleyiciler, platform API'leri | Aynı 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 endpoint | API planları |
|---|---|---|
| CEX spread'leri | /arbitrage/spot-spot | Tümü |
| DEX ve zincirler arası | /arbitrage/dex-spot | Pro, Max |
| Emir defterleri | /orderbooks/exec | Pro, Max |
| Fonlama ve OI | /funding/rates | Tümü |
| Zincir üstü | /onchain/{section} | Start, Pro, Max |
| Tahmin piyasaları ve surebet'ler | /predictions/arbitrage | Start: 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.
| Plan | Aylık çağrı | Saniyedeki istek | Tazelik |
|---|---|---|---|
| Trial, ayda 20 $ | 500K | 1 | 60 sn |
| Start, 50 $ | 2M | 2 | 30 sn |
| Pro, 100 $ | 5M | 5 | 10 sn |
| Max, 200 $ | 10M | 15 | 5 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ı).