Genesis Arbitrage

Genesis Arbitrage · · 14 dk okuma

Açık pozisyon API: borsalar arası vadeli işlem OI verisi ve nasıl okunur

Kısaca

  • Açık pozisyon (OI), vadeli işlemlerde hâlâ açık duran pozisyonların hacmidir. Coin cinsinden sayıldığında pozisyonların girişini gösterir; dolar cinsinden sayıldığında fiyatla birlikte hareket eder.
  • Her borsa OI'yi kendi biçiminde ve kendi birimleriyle yayımlar. Genesis API'de tek bir /market/open-interest çağrısı 13+ borsayı kapsar: toplam total içinde, döküm exchanges içinde, OI ve fiyatın 5, 15 ve 30 dakikadaki ile 1 saatteki değişimi ise her planda gelir.
  • Fiyat ve fonlamayla birlikte okunduğunda OI, kimin pozisyon biriktirdiğini ve kimin onları tutmak için ödeme yaptığını gösterir. Fiyatı tahmin etmez; karar ve borsadaki işlem sizde kalır.

Açık pozisyon API'si her coin için açık vadeli işlem pozisyonlarının hacmini coin ve dolar cinsinden, borsa bazında ve toplam olarak, ayrıca son dakika ve saatlerde nasıl değiştiğiyle birlikte döndürür. Borsalar kendi kontratlarının OI verisini kendi API'leriyle yayımlar ve biçimler borsadan borsaya farklılık gösterir. Genesis API'de tüm anlık görüntü /market/open-interest için yapılan tek bir çağrıyla gelir: Binance, Bybit, OKX, Bitget ve Gate dahil 13+ vadeli işlem borsası; OI ve fiyatın 5, 15 ve 30 dakikadaki ile 1 saatteki değişimi her planda, ayda 20 $'lık Trial'dan itibaren.

Açık pozisyon nedir

Açık pozisyon (OI), bir vadeli işlem kontratında açık olan ve henüz kapatılmamış pozisyonların toplamıdır. Her kontratın iki tarafı vardır, long ve short, OI ise bunlardan yalnızca birini sayar: bir trader 1 BTC long alır, bir diğeri 1 BTC short satar, açık pozisyon 1 BTC artar.

Bir işlemin her iki tarafı da pozisyon açtığında OI artar, her ikisi de kapattığında azalır, pozisyon bir trader'dan diğerine geçtiğinde ise değişmez. Dolayısıyla OI'nin artması yeni pozisyonların girdiği, azalması ise pozisyonların isteyerek ya da zorla kapatıldığı anlamına gelir.

Coin ve dolar cinsinden OI

Borsalar OI'yi kontrat, coin veya doğrudan dolar cinsinden bildirir; coin cinsinden değerler fiyatla dolara çevrilir. Genesis API örnek yanıtında GRAM için ByBit'in oi_usd değeri oi_tokens çarpı price değerine eşittir: 16.159.003,8 × 1,6609 = 26.838.489,41.

Dolar rakamı coinleri ve borsaları karşılaştırmak için kullanışlıdır, ama fiyatla birlikte oynar. Açıklayıcı örnek: bir borsada açık pozisyonlar 1,50 $ fiyatla 2.000.000 coindir, yani OI 2.000.000 × 1,50 $ = 3.000.000 $'dır. Bir saat sonra pozisyonlar aynıdır, fiyat 1,65 $'dır ve dolar OI zaten 2.000.000 × 1,65 $ = 3.300.000 $'dır; tek bir yeni pozisyon açılmadan %10 artmıştır.

Toplam OI ve borsa bazında döküm

Bir coinin toplam OI'si, vadeli işlemlerini listeleyen borsalardaki OI'yi toplar ve piyasanın pozisyonlarda ne kadar para tuttuğunu gösterir. Döküm bu paranın nerede durduğunu gösterir: aynı yanıtta ByBit, GRAM dolar OI'sinin 26.838.489,41 / 96.544.685,3 × 100 = %27,8'ini tutar.

ÖlçüNe gösterirDikkat edilecek nokta
Coin cinsinden OIKaç pozisyon açıkKontrat büyüklükleri borsaya göre değişir
Dolar cinsinden OIPozisyonlarda ne kadar para varFiyatla birlikte hareket eder
Toplam OIPiyasa genelindeki pozisyonlarHangi borsaların toplandığına bağlıdır
Borsa bazında OIPozisyonların nerede biriktiğiBorsa yöntemleri farklıdır

Binance, Bybit, OKX ve Hyperliquid API'leri ne döndürür

Her borsa kontratlarının OI verisini kendi API'siyle yayımlar. Resmî dokümantasyonda yazanlar şöyle:

BorsaGüncel OIOI geçmişiDikkat edin
BinanceGET /fapi/v1/openInterest, istek başına bir symbolGET /futures/data/openInterestHistGeçmiş yalnızca son ayı kapsar
BybitGET /v5/market/tickers, tüm semboller tek istekteGET /v5/market/open-interest, 5min ile 1d arası adımlaropenInterest iki tarafı sayar, singleOpenInterest bir tarafı
OKXGET /api/v5/public/open-interestGET /api/v5/rubik/stat/contracts/open-interest-historyoi kontrat, oiCcy coin, oiUsd dolar cinsinden
HyperliquidPOST /info, metaAndAssetCtxs türüDokümanda yokSürekli vadeli işlemler için OI tek istekte

Ayrıntılar Binance, Bybit, OKX ve Hyperliquid dokümanlarındadır. Binance geçmişi sumOpenInterest ve sumOpenInterestValue olarak gelir; OKX ise 5 dakikalık adımlardan başlayarak son 1.440 kaydı döndürür. Hyperliquid, https://api.hyperliquid.xyz/info adresine {"type": "metaAndAssetCtxs"} gövdesiyle yapılan bir istek alır ve her sürekli vadeli işlem için markPx ile funding yanında openInterest değerini döndürür.

Yöntem farkı iki kat olabilir. Bybit'in /v5/market/open-interest örnek yanıtında openInterest 63.910.691, singleOpenInterest ise 31.955.346'dır, tam olarak yarısı: birincisi iki tarafı sayar, ikincisi yukarıdaki OI tanımındaki gibi bir tarafı.

Tek bir anlık görüntüyü kendiniz oluşturmak, her borsayı kendi kurallarıyla sorgulamak, kontratları coine ve coinleri dolara çevirmek ve her borsanın limitleri içinde kalmak demektir. Binance'te bunun için her kontrata ayrı bir istek gerekir.

Genesis API'de açık pozisyon: /market/open-interest

/market/open-interest endpoint'i, sitedeki OI Takibi tablosuyla aynı verileri döndürür: coin başına toplam OI total içinde, borsa bazında döküm exchanges içinde. Parametresiz çağrıda tüm coinleri alırsınız; coin tek bir coini bırakır, exchange seçilen borsaları bırakır, birden fazlası virgülle ayrılır.

curl -G "https://api.genesisarbitrage.com/v1/market/open-interest" \
  -d coin=GRAM \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"

Yanıt bir data dizisidir. Aşağıda dokümandan, bazı alanları kısaltılmış bir elemanı var:

{
  "coin": "GRAM",
  "total": {
    "oi_usd": 96544685.3,
    "oi_tokens": 58105803.3,
    "avg_price": 1.661224,
    "volume_24h": 47010004.63,
    "oi_change_5m": 0.0196,
    "oi_change_1h": 0.3185,
    "price_change_5m": -0.0228,
    "price_change_1h": -0.1929,
    …
  },
  "exchanges": {
    "ByBit": {
      "price": 1.6609,
      "oi_usd": 26838489.41,
      "oi_tokens": 16159003.8,
      "oi_change_1h": -0.097,
      "price_change_1h": -0.1683,
      "trade_url": "https://www.bybit.com/trade/usdt/GRAMUSDT",
      …
    }
  }
}
AlanAnlamı
total.oi_usd / total.oi_tokensDolar ve coin cinsinden toplam OI
total.avg_priceBorsalar genelinde ortalama coin fiyatı
total.volume_24h24 saatlik hacim, USD
total.oi_change_5m/15m/30m/1hOI'nin 5, 15 ve 30 dakikadaki ile 1 saatteki değişimi, %
total.price_change_5m/15m/30m/1hAynı aralıklarda fiyat değişimi, %
exchanges{}Aynı metrikler borsa bazında: avg_price yerine price, ayrıca trade_url

Değişimler yüzde olarak verilir: 0.3185 değeri %0,3185 anlamına gelir. Boş değerler null olarak gelir, bunları atlayın. Tazelik plana bağlıdır: Trial'da 60 sn, Start'ta 30 sn, Pro'da 10 sn ve Max'te 5 sn; yani meta.freshness_sec değerinden daha sık sorgulamanın bir faydası yoktur.

Filtresiz yanıt bir ETag başlığı taşır. Bunu If-None-Match içinde geri gönderirseniz değişmemiş bir anlık görüntü kotanızı harcamayan bir 304 olarak döner; mekanizma ETag ve If-None-Match yazısında anlatılır. exchange filtresi yalnızca exchanges alanını daraltır: total yine tüm borsalar üzerinden hesaplanır.

Alanlar, parametreler ve "Deneyin" formu dokümanların "OI Takibi" bölümündedir. Tüm piyasa endpoint'leri örneklerle Genesis API piyasa verileri rehberinde anlatılır.

OI'yi fiyatla okumak: dört senaryo

OI'nin artması pozisyonların açıldığını söyler, ama hangi tarafın bunu sürdürdüğünü söylemez. Aynı aralıktaki fiyat ipucu verir.

FiyatOIOlağan yorumNeye bakmalı
YukarıYukarıHareket yönünde yeni pozisyonlar, yükseliş parayla destekleniyorFonlama: güçlü pozitifse long'lar kalabalık
AşağıYukarıShort'lar birikiyor veya long'lar düşüşe karşı alım yapıyorFonlama: güçlü negatifse short squeeze riski var
YukarıAşağıYükseliş short kapatmalarıyla ilerliyor, yeni para yokOI'nin her borsada düşüp düşmediği
AşağıAşağıLong'lar isteyerek ya da zorla kapanıyor5 dakika içinde OI'nin çökmesi tasfiyelere işaret eder

Doküman örneğinde GRAM'in toplam OI'si bir saatte %0,32 artarken fiyat %0,19 düştü; bu da resmen ikinci satıra denk gelir. Ancak saatte yüzdenin kesirleri olağan gürültüdür: senaryoları net hareketlerde ve OI'si büyük coinlerde okuyun.

OI ve fonlama: pozisyonları kim tutuyor, bedelini kim ödüyor

Fonlama oranı, sürekli vadeli işlemlerde hangi tarafın diğerine ödeme yaptığını gösterir; OI ise kaç pozisyonun açık olduğunu. İkisi birlikte hem piyasanın hangi yöne eğildiğini hem de ne kadar kaldıraçlı olduğunu gösterir.

Fiyatla birlikte OI yükselirken oran güçlü pozitifse, long'lar pozisyon ekliyor ve onları tutmak için short'lara ödeme yapıyor demektir. Fiyat dönerse onların tasfiyeleri düşüşü hızlandırır. OI ve fiyat yükselirken oran negatifse, short'lar harekete karşı pozisyon biriktiriyordur ve sert bir yükseliş onları zorla kapatabilir.

Fonlama, OI ve fiyatın her kombinasyonu Piyasa göstergesi olarak fonlama oranı yazısında ele alınır. Genesis API'de /funding/rates her borsanın oranını döndürür, bu da her planda vardır: fonlama aralığı başına oran (funding_pct) ve 8 saate normalleştirilmiş oran (funding_8h_pct). Fonlama endpoint'leri ve gerçekleşmiş fonlama geçmişi Fonlama oranı API yazısında, alanlar ise dokümanlarda anlatılır.

Python: fiyat yükselirken bir saatte %5'ten fazla artan OI

Betik tüm anlık görüntüyü tek çağrıda alır ve toplam OI'si bir saatte %5'ten fazla artmış, fiyatı yükselmiş ve OI'sinin kendisi 5 milyon $ veya daha fazla olan coinleri tutar. Her biri için borsa bazında dökümü yazdırır: borsanın OI payı ile saat içindeki OI ve fiyat değişimleri. Anahtar GENESIS_API_KEY ortam değişkeninden gelir; 429 ve 503 durumlarında betik Retry-After saniye bekler ve yeniden dener.

import os
import time
import requests

API = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
MIN_OI_USD = 5_000_000  # küçük OI'de tek bir pozisyon onu çok oynatır

def get(path, **params):
    while True:
        r = requests.get(API + path, headers=HEADERS,
                         params=params, timeout=15)
        if r.status_code in (429, 503):  # rate limit veya verinin yeniden oluşturulması
            time.sleep(int(r.headers.get("Retry-After", "5")))
            continue
        r.raise_for_status()
        return r.json()["data"]

def passes(t):
    oi, px = t.get("oi_change_1h"), t.get("price_change_1h")
    if oi is None or px is None:
        return False
    return (t.get("oi_usd") or 0) >= MIN_OI_USD and oi > 5 and px > 0

def pct(v):
    return "n/a" if v is None else f"{v:+.1f}%"

hits = [r for r in get("/market/open-interest") if passes(r["total"])]
for row in hits:
    t = row["total"]
    print(f"{row['coin']}: OI 1 saatte {pct(t['oi_change_1h'])}, "
          f"fiyat {pct(t['price_change_1h'])}, "
          f"toplam ${t['oi_usd'] / 1e6:.1f}M")
    exs = sorted(row["exchanges"].items(), reverse=True,
                 key=lambda kv: kv[1].get("oi_usd") or 0)
    for name, m in exs:
        share = (m.get("oi_usd") or 0) / t["oi_usd"] * 100
        print(f"  {name:<8} pay {share:4.1f}%, "
              f"OI {pct(m.get('oi_change_1h'))}, "
              f"fiyat {pct(m.get('price_change_1h'))}")

XYZ coini için açıklayıcı çıktı: bir saatte OI +%6,2, fiyat +%3,0, toplam OI 48,1 milyon $.

BorsaOI payıOI 1 saFiyat 1 sa
Binance%46,2+%8,0+%3,0
ByBit%27,0+%5,0+%3,1
OKX%17,5+%2,0+%2,9
Bitget%9,3+%9,0+%3,2

Artış geniş tabanlıdır: OI dört borsanın hepsinde yükseldi, üçünde ise %5 veya daha fazla. Aynı +%6,2 bir saat önce coinin OI'sinin %10'unu tutan tek bir borsadan gelmiş olsaydı, o borsanın OI'sinin %62 artması gerekirdi: 0,10 × 62 = 6,2. Tek bir borsadaki sıçrama çoğunlukla tek bir büyük oyuncuya işaret eder ve ondan piyasa hakkında sonuç çıkarmak için henüz erkendir.

İkinci bölüm fonlamayı ekler: tüm coinler için tek bir /funding/rates çağrısı ve bulunan her coin için borsalar arasındaki en düşük ve en yüksek 8 saatlik oran ile kaç borsada oranın pozitif olduğu.

# her borsanın fonlama oranları: tek çağrı tüm coinleri kapsar
rates = {row["coin"]: row["exchanges"]
         for row in get("/funding/rates")}

for row in hits:
    fr = sorted((e["funding_8h_pct"], e["exchange"])
                for e in rates.get(row["coin"], [])
                if e.get("funding_8h_pct") is not None)
    if not fr:
        print(f"{row['coin']}: fonlama oranı yok")
        continue
    (lo, lo_ex), (hi, hi_ex) = fr[0], fr[-1]
    plus = sum(1 for rate, _ in fr if rate > 0)
    print(f"{row['coin']}: 8 saatlik fonlama {lo:+.4f}% ({lo_ex}) "
          f"ile {hi:+.4f}% ({hi_ex}) arasında, {len(fr)} borsanın {plus} tanesinde pozitif")

Betik iki çağrı yapar. Dakikada bir çalıştırılırsa 30 günde 2 × 60 × 24 × 30 = 86.400 çağrı eder; bu, Trial planının 500 bin kotasının beşte birinden azdır. Değişmemiş verilerde kota harcamadan döngüyle sorgulamak için ETag ve If-None-Match ekleyin: teknikler Limitlere takılmadan API nasıl sorgulanır yazısında, kotalar ve saniye başına istekler ise Genesis API limitleri rehberindedir.

Dikkat edilecekler: açık pozisyonu ne bozar

Kodsuz olarak aynı veriler sitedeki OI Takibi tablosundadır; sütunları, filtreleri ve grafikleri rehberde anlatılır. API planlarının kotaları ve fiyatları Genesis API fiyatları sayfasındadır.

Sorular ve cevaplar

Açık pozisyon işlem hacminden nasıl farklıdır?

Hacim, bir dönemdeki işlemlerin toplamıdır; açık pozisyon ise şu anda açık kalan pozisyonlardır. Her işlem hacme sayılır, ama OI'yi yalnızca her iki taraf da pozisyon açtığında ya da kapattığında değiştirir. Yüksek hacim ve sabit OI, pozisyonların çoğunlukla el değiştirdiği anlamına gelir. /market/open-interest yanıtında iki sayı da vardır: volume_24h ve oi_usd.

Açık pozisyon geçmişini nereden alabilirim?

Genesis API'de geçmiş yoktur: endpoint güncel anlık görüntüyü ve 5, 15 ve 30 dakikadaki ile 1 saatteki değişimleri döndürür, yani uzun bir seriyi yanıtları kaydederek siz oluşturursunuz. Borsalar geçmişi kendi API'lerinde sunar: Binance son ay için, Bybit 5 dakikadan bir güne kadar adımlarla, OKX son 1.440 kayıt için. Sitede OI Takibi'ndeki Grafik düğmesi, sitenin Pro planında bir OI grafiği açar.

Genesis API'de OI verisi ne sıklıkla güncellenir?

Tazelik API planına bağlıdır: Trial'da 60 saniye, Start'ta 30, Pro'da 10 ve Max'te 5. Anlık görüntünün oluşturulma zamanı meta.updated_at içindedir, planınızın gecikmesi ise meta.freshness_sec içinde. Bundan daha sık sorgulamak bir şey kazandırmaz; If-None-Match ile değişmemiş bir anlık görüntü kotanızı harcamayan bir 304 olarak döner.

Fiyat düşerken açık pozisyonun artması ne anlama gelir?

Genellikle yeni short'lar açılıyor ya da biri harekete karşı long alıyordur. Aynı anda fonlama negatife dönerse, short'lar da pozisyonlarını tutmak için long'lara ödeme yapıyor demektir. O noktada sert bir yukarı dönüş short'ları kapanmaya zorlayabilir ve yükselişi hızlandırabilir.