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: toplamtotaliçinde, dökümexchangesiç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österir | Dikkat edilecek nokta |
|---|---|---|
| Coin cinsinden OI | Kaç pozisyon açık | Kontrat büyüklükleri borsaya göre değişir |
| Dolar cinsinden OI | Pozisyonlarda ne kadar para var | Fiyatla birlikte hareket eder |
| Toplam OI | Piyasa genelindeki pozisyonlar | Hangi borsaların toplandığına bağlıdır |
| Borsa bazında OI | Pozisyonların nerede biriktiği | Borsa 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:
| Borsa | Güncel OI | OI geçmişi | Dikkat edin |
|---|---|---|---|
| Binance | GET /fapi/v1/openInterest, istek başına bir symbol | GET /futures/data/openInterestHist | Geçmiş yalnızca son ayı kapsar |
| Bybit | GET /v5/market/tickers, tüm semboller tek istekte | GET /v5/market/open-interest, 5min ile 1d arası adımlar | openInterest iki tarafı sayar, singleOpenInterest bir tarafı |
| OKX | GET /api/v5/public/open-interest | GET /api/v5/rubik/stat/contracts/open-interest-history | oi kontrat, oiCcy coin, oiUsd dolar cinsinden |
| Hyperliquid | POST /info, metaAndAssetCtxs türü | Dokümanda yok | Sü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",
…
}
}
}
| Alan | Anlamı |
|---|---|
total.oi_usd / total.oi_tokens | Dolar ve coin cinsinden toplam OI |
total.avg_price | Borsalar genelinde ortalama coin fiyatı |
total.volume_24h | 24 saatlik hacim, USD |
total.oi_change_5m/15m/30m/1h | OI'nin 5, 15 ve 30 dakikadaki ile 1 saatteki değişimi, % |
total.price_change_5m/15m/30m/1h | Aynı 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.
| Fiyat | OI | Olağan yorum | Neye bakmalı |
|---|---|---|---|
| Yukarı | Yukarı | Hareket yönünde yeni pozisyonlar, yükseliş parayla destekleniyor | Fonlama: güçlü pozitifse long'lar kalabalık |
| Aşağı | Yukarı | Short'lar birikiyor veya long'lar düşüşe karşı alım yapıyor | Fonlama: güçlü negatifse short squeeze riski var |
| Yukarı | Aşağı | Yükseliş short kapatmalarıyla ilerliyor, yeni para yok | OI'nin her borsada düşüp düşmediği |
| Aşağı | Aşağı | Long'lar isteyerek ya da zorla kapanıyor | 5 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 $.
| Borsa | OI payı | OI 1 sa | Fiyat 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
- Borsa yöntemleri farklıdır. Bybit'te iki kat farklı iki OI alanı vardır, OKX
oideğerini büyüklüğünü borsanın belirlediği kontratlarla sayar ve bir coinin sembolü değişebilir: PEPE bir borsada, 1000PEPE diğerinde. Borsalar arasında yüzde değişimleri karşılaştırmak daha güvenlidir: bir okumadan diğerine her borsa aynı yöntemle saydığı sürece birimlere bağlı değildir. - Dolar fiyata bağlıdır. Her borsanın
oi_usddeğeri, coin cinsinden OI'sinin kendi fiyatıyla çarpımıdır; bu yüzden sert bir harekette pozisyonlar yerinde dursa bile dolar OI değişir. - Tasfiyeler sıçrama yaratır. Bir tasfiye zincirinde borsalar pozisyonları zorla kapatır: fiyat sert hareket ederken OI birkaç dakika içinde yüzde birkaç düşer.
oi_change_5mdeğerinin çökmesi ve aynı andaprice_change_5mdeğerinin sert hareket etmesi tasfiyelerin imzasıdır. - Küçük OI büyük yüzdeler üretir. OI'si birkaç yüz bin dolar olan bir coinde tek bir pozisyon onu yüzde onlarca oynatır;
total.oi_usdüzerinde bir eşik bu gürültüyü eler. - Toplam, hangi borsaları içerdiğine bağlıdır. Bir coinin vadeli işlemi bir borsada daha açılırsa, diğerlerinde bir şey değişmediği halde toplam OI yeni borsa sayesinde büyür. Toplamdaki artışı
exchangesdökümüyle karşılaştırarak kontrol edin.
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.