API open interest: OI futures lintas exchange dan cara membacanya
Ringkasan
- Open interest adalah volume posisi futures yang masih terbuka. Jika dihitung dalam koin, ia menunjukkan arus masuk posisi; jika dihitung dalam dolar, ia ikut bergerak bersama harga.
- Setiap exchange menerbitkan OI dalam format dan satuannya sendiri. Di Genesis API, satu panggilan
/market/open-interestmencakup 13+ exchange: jumlahnya ditotal, rinciannya diexchanges, serta perubahan OI dan harga selama 5, 15, dan 30 menit dan 1 jam, di semua paket. - Dibaca bersama harga dan funding, OI menunjukkan siapa yang membangun posisi dan siapa yang membayar untuk menahannya. OI tidak memprediksi harga; keputusan dan transaksi di exchange tetap di tangan Anda.
API open interest mengembalikan, untuk setiap koin, volume posisi futures yang terbuka, dalam koin dan dolar, per exchange dan secara total, beserta perubahannya dalam beberapa menit dan jam terakhir. Exchange menerbitkan OI untuk kontraknya sendiri lewat API masing-masing, dan formatnya berbeda dari satu exchange ke exchange lain. Di Genesis API, seluruh snapshot datang dari satu panggilan ke /market/open-interest: 13+ exchange futures, termasuk Binance, Bybit, OKX, Bitget, dan Gate, dengan perubahan OI dan harga selama 5, 15, dan 30 menit dan 1 jam, di semua paket, mulai dari Trial seharga $20 per bulan.
Apa itu open interest
Open interest (OI) adalah total posisi pada kontrak futures yang terbuka dan belum ditutup. Setiap kontrak punya dua sisi, long dan short, dan OI menghitung salah satunya: satu trader membeli 1 BTC long, trader lain menjual 1 BTC short, dan open interest bertambah 1 BTC.
OI naik ketika kedua sisi transaksi membuka posisi, turun ketika keduanya menutup, dan tetap ketika posisi berpindah dari satu trader ke trader lain. Jadi OI yang naik berarti posisi baru masuk, dan OI yang turun berarti posisi ditutup, baik secara sukarela maupun paksa.
OI dalam koin dan dalam dolar
Exchange melaporkan OI dalam kontrak, dalam koin, atau langsung dalam dolar, dan koin dikonversi ke dolar menurut harga. Pada contoh respons Genesis API, oi_usd ByBit untuk GRAM sama dengan oi_tokens dikali price: 16.159.003,8 × 1,6609 = 26.838.489,41.
Angka dolar berguna untuk membandingkan koin dan exchange, tetapi ia bergerak bersama harga. Contoh ilustrasi: sebuah exchange memiliki 2.000.000 koin dalam posisi terbuka pada harga $1,50, sehingga OI-nya 2.000.000 × $1,50 = $3.000.000. Satu jam kemudian posisi tidak berubah, harganya $1,65, dan OI dalam dolar sudah 2.000.000 × $1,65 = $3.300.000, naik 10% tanpa satu pun posisi baru.
Total OI dan rincian per exchange
Total OI suatu koin menjumlahkan OI di exchange yang mencantumkan futures koin tersebut dan menunjukkan berapa banyak uang yang ditahan pasar dalam posisi. Rinciannya menunjukkan di mana uang itu berada: pada respons yang sama, ByBit memegang 26.838.489,41 / 96.544.685,3 × 100 = 27,8% dari OI dolar GRAM.
| Ukuran | Apa yang ditunjukkan | Hal yang perlu diwaspadai |
|---|---|---|
| OI dalam koin | Berapa banyak posisi terbuka | Ukuran kontrak berbeda di tiap exchange |
| OI dalam dolar | Berapa banyak uang dalam posisi | Bergerak bersama harga |
| Total OI | Posisi di seluruh pasar | Bergantung pada exchange mana yang dijumlahkan |
| OI per exchange | Di mana posisi dibangun | Metode exchange berbeda-beda |
Apa yang dikembalikan API Binance, Bybit, OKX, dan Hyperliquid
Setiap exchange menerbitkan OI untuk kontraknya lewat API sendiri. Berikut isi dokumentasi resminya:
| Exchange | OI saat ini | Riwayat OI | Yang perlu diperhatikan |
|---|---|---|---|
| Binance | GET /fapi/v1/openInterest, satu symbol per request | GET /futures/data/openInterestHist | Riwayat hanya mencakup satu bulan terakhir |
| Bybit | GET /v5/market/tickers, semua simbol dalam satu request | GET /v5/market/open-interest, interval dari 5min hingga 1d | openInterest menghitung kedua sisi, singleOpenInterest satu sisi |
| OKX | GET /api/v5/public/open-interest | GET /api/v5/rubik/stat/contracts/open-interest-history | oi dalam kontrak, oiCcy dalam koin, oiUsd dalam dolar |
| Hyperliquid | POST /info, tipe metaAndAssetCtxs | Tidak ada di dokumentasi | OI untuk futures perpetual dalam satu request |
Detailnya ada di dokumentasi Binance, Bybit, OKX, dan Hyperliquid. Riwayat Binance datang sebagai sumOpenInterest dan sumOpenInterestValue, sedangkan OKX mengembalikan 1.440 entri terakhir dengan interval mulai dari 5 menit. Hyperliquid menerima request ke https://api.hyperliquid.xyz/info dengan body {"type": "metaAndAssetCtxs"} dan mengembalikan openInterest untuk setiap perpetual bersama markPx dan funding.
Perbedaan metode bisa mencapai dua kali lipat. Pada contoh respons /v5/market/open-interest Bybit, openInterest bernilai 63.910.691 dan singleOpenInterest 31.955.346, tepat setengahnya: yang pertama menghitung kedua sisi, yang kedua menghitung satu sisi, seperti pada definisi OI di atas.
Membangun satu snapshot sendiri berarti melakukan polling ke tiap exchange sesuai aturannya, mengonversi kontrak ke koin dan koin ke dolar, serta tetap dalam batas setiap exchange. Di Binance, itu butuh request terpisah untuk setiap kontrak.
Open interest di Genesis API: /market/open-interest
Endpoint /market/open-interest mengembalikan data yang sama dengan tabel Pelacakan OI di situs: total OI per koin di total dan rincian per exchange di exchanges. Tanpa parameter, Anda mendapat semua koin; coin menyisakan satu koin, dan exchange menyisakan exchange yang dipilih, dipisah koma untuk beberapa exchange.
curl -G "https://api.genesisarbitrage.com/v1/market/open-interest" \
-d coin=GRAM \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
Respons berupa array data. Di bawah ini salah satu elemennya dari dokumentasi, dengan beberapa field dipotong:
{
"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",
…
}
}
}
| Field | Arti |
|---|---|
total.oi_usd / total.oi_tokens | Total OI dalam dolar dan dalam koin |
total.avg_price | Harga koin rata-rata di seluruh exchange |
total.volume_24h | Volume 24 jam, USD |
total.oi_change_5m/15m/30m/1h | Perubahan OI selama 5, 15, dan 30 menit dan 1 jam, % |
total.price_change_5m/15m/30m/1h | Perubahan harga pada interval yang sama, % |
exchanges{} | Metrik yang sama per exchange: price sebagai pengganti avg_price, ditambah trade_url |
Perubahan berupa persentase: 0.3185 berarti 0,3185%. Nilai kosong datang sebagai null, jadi lewati saja. Kesegaran data bergantung pada paket: 60 dtk di Trial, 30 dtk di Start, 10 dtk di Pro, dan 5 dtk di Max, sehingga polling lebih sering daripada meta.freshness_sec tidak ada gunanya.
Respons tanpa filter membawa header ETag. Kirim kembali di If-None-Match, dan snapshot yang tidak berubah akan kembali sebagai 304 yang tidak memakai kuota Anda; mekanismenya dijelaskan di ETag dan If-None-Match. Filter exchange hanya mempersempit exchanges: total tetap dihitung dari semua exchange.
Field, parameter, dan form "Coba sekarang" ada di bagian "Pelacakan OI" pada dokumentasi. Semua endpoint pasar dibahas dengan contoh di panduan Data pasar Genesis API.
Membaca OI bersama harga: empat skenario
OI yang naik memberi tahu bahwa posisi sedang dibuka, tetapi tidak menunjukkan sisi mana yang mendorongnya. Harga pada interval yang sama memberi petunjuk.
| Harga | OI | Pembacaan umum | Yang perlu dicek |
|---|---|---|---|
| Naik | Naik | Posisi baru searah pergerakan, kenaikan didukung uang | Funding: sangat positif berarti long terlalu padat |
| Turun | Naik | Short menumpuk, atau long membeli saat harga turun | Funding: sangat negatif berarti ada risiko short squeeze |
| Naik | Turun | Kenaikan berjalan dari penutupan short, tanpa uang baru | Apakah OI turun di setiap exchange |
| Turun | Turun | Long ditutup, secara sukarela atau paksa | OI anjlok dalam 5 menit menunjukkan likuidasi |
Pada contoh dokumentasi, total OI GRAM naik 0,32% dalam satu jam sementara harga turun 0,19%, yang secara formal masuk ke baris kedua. Namun pecahan persen per jam adalah noise biasa: baca skenario ini pada pergerakan yang jelas dan pada koin dengan OI besar.
OI dan funding: siapa yang menahan posisi dan siapa yang membayarnya
Funding rate menunjukkan sisi mana pada futures perpetual yang membayar sisi lain, dan OI menunjukkan berapa banyak posisi yang terbuka. Bersama-sama keduanya menunjukkan ke mana pasar condong dan seberapa besar leverage yang dipakai.
OI dan harga naik dengan rate sangat positif berarti long menambah posisi dan membayar short untuk menahannya. Jika harga berbalik, likuidasi mereka mempercepat penurunan. OI dan harga naik dengan rate negatif berarti short membangun posisi melawan pergerakan, dan kenaikan tajam dapat menutup mereka secara paksa.
Setiap kombinasi funding, OI, dan harga diuraikan di Funding rate sebagai indikator pasar. Di Genesis API, /funding/rates mengembalikan rate setiap exchange, juga di semua paket: rate per interval funding (funding_pct) dan rate yang dinormalisasi ke 8 jam (funding_8h_pct). Endpoint funding dan riwayat funding yang telah diselesaikan dibahas di API funding rate, dan field-nya ada di dokumentasi.
Python: OI naik lebih dari 5% dalam satu jam saat harga naik
Skrip menarik seluruh snapshot dalam satu panggilan dan menyimpan koin yang total OI-nya tumbuh lebih dari 5% dalam satu jam sementara harga naik, dengan OI itu sendiri $5 juta atau lebih. Untuk setiap koin, skrip mencetak rincian per exchange: porsi OI exchange tersebut serta perubahan OI dan harganya selama satu jam. Key berasal dari variabel lingkungan GENESIS_API_KEY; pada 429 dan 503 skrip menunggu Retry-After detik lalu mencoba lagi.
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 # pada OI kecil, satu posisi menggesernya jauh
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 atau data sedang dibangun ulang
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 {pct(t['oi_change_1h'])} dalam 1 jam, "
f"harga {pct(t['price_change_1h'])}, "
f"total ${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} porsi {share:4.1f}%, "
f"OI {pct(m.get('oi_change_1h'))}, "
f"harga {pct(m.get('price_change_1h'))}")
Contoh output ilustrasi untuk koin XYZ: OI +6,2% dalam satu jam, harga +3,0%, total OI $48,1 juta.
| Exchange | Porsi OI | OI 1 jam | Harga 1 jam |
|---|---|---|---|
| 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% |
Pertumbuhannya merata: OI naik di keempat exchange, dan 5% atau lebih di tiga di antaranya. Seandainya +6,2% yang sama berasal dari satu exchange yang satu jam lalu memegang 10% OI koin tersebut, OI-nya harus tumbuh 62%: 0,10 × 62 = 6,2. Lonjakan di satu exchange lebih sering berarti satu pemain besar, dan terlalu dini menarik kesimpulan tentang pasar darinya.
Bagian kedua menambahkan funding: satu panggilan /funding/rates untuk semua koin, dan untuk setiap koin yang ditemukan, rate 8 jam terendah dan tertinggi di antara exchange serta berapa banyak exchange yang rate-nya positif.
# funding rate setiap exchange: satu panggilan mencakup semua koin
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']}: tidak ada funding rate")
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']}: funding 8 jam {lo:+.4f}% ({lo_ex}) "
f"hingga {hi:+.4f}% ({hi_ex}), positif di {plus} dari {len(fr)}")
Skrip melakukan dua panggilan. Jika dijalankan sekali semenit, itu 2 × 60 × 24 × 30 = 86.400 panggilan per 30 hari, kurang dari seperlima kuota 500 ribu paket Trial. Untuk polling dalam loop tanpa menghabiskan kuota pada data yang tidak berubah, tambahkan ETag dan If-None-Match: tekniknya ada di Cara polling API tanpa terkena limit, dan kuota serta request per detik ada di panduan Limit Genesis API.
Catatan: apa yang mendistorsi open interest
- Metode exchange berbeda. Bybit punya dua field OI yang selisihnya dua kali lipat, OKX menghitung
oidalam kontrak yang ukurannya ditetapkan exchange, dan ticker satu koin bisa berbeda: PEPE di satu exchange, 1000PEPE di exchange lain. Perubahan persentase lebih aman untuk dibandingkan antar exchange: ia tidak bergantung pada satuan selama setiap exchange menghitung dengan cara yang sama dari satu pembacaan ke pembacaan berikutnya. - Dolar bergantung pada harga.
oi_usdsetiap exchange adalah OI dalam koin dikali harganya sendiri, sehingga pada pergerakan tajam OI dalam dolar berubah meskipun posisi tidak bergerak. - Likuidasi menimbulkan lonjakan. Dalam rentetan likuidasi, exchange menutup posisi secara paksa: OI turun beberapa persen dalam hitungan menit sementara harga bergerak keras. Anjloknya
oi_change_5mbersamaan denganprice_change_5myang tajam adalah ciri khas likuidasi. - OI kecil menghasilkan persentase besar. Pada koin dengan OI beberapa ratus ribu dolar, satu posisi menggesernya hingga puluhan persen, dan ambang pada
total.oi_usdmenyaring noise itu. - Total bergantung pada exchange mana yang disertakan. Jika sebuah koin mendapat futures di satu exchange lagi, total OI tumbuh berkat tempat baru itu padahal tidak ada yang berubah di exchange lain. Periksa pertumbuhan total terhadap rincian
exchanges.
Tanpa kode, data yang sama ada di tabel Pelacakan OI di situs; kolom, filter, dan grafiknya dijelaskan di panduan. Kuota dan harga paket API ada di halaman Harga Genesis API.
Tanya jawab
Apa bedanya open interest dengan volume perdagangan?
Volume adalah jumlah transaksi dalam suatu periode; open interest adalah posisi yang masih terbuka saat ini. Setiap transaksi dihitung dalam volume, tetapi ia mengubah OI hanya ketika kedua sisi membuka atau menutup posisi. Volume tinggi dengan OI datar berarti posisi sebagian besar hanya berpindah tangan. Respons /market/open-interest memuat kedua angka: volume_24h dan oi_usd.
Di mana saya bisa mendapatkan riwayat open interest?
Genesis API tidak memiliki riwayat: endpoint mengembalikan snapshot saat ini dan perubahan selama 5, 15, dan 30 menit dan 1 jam, jadi deret panjang harus Anda bangun sendiri dengan menyimpan respons. Exchange menyediakan riwayat di API masing-masing: Binance untuk satu bulan terakhir, Bybit dengan interval dari 5 menit hingga sehari, OKX 1.440 entri terakhir. Di situs, tombol Chart di Pelacakan OI membuka grafik OI pada paket Pro situs.
Seberapa sering data OI diperbarui di Genesis API?
Kesegaran bergantung pada paket API: 60 detik di Trial, 30 di Start, 10 di Pro, dan 5 di Max. Waktu pembuatan snapshot ada di meta.updated_at, dan jeda untuk paket Anda ada di meta.freshness_sec. Polling lebih cepat dari itu tidak ada manfaatnya, dan dengan If-None-Match snapshot yang tidak berubah kembali sebagai 304, yang tidak memakai kuota Anda.
Apa arti open interest naik saat harga turun?
Biasanya short baru sedang dibuka, atau ada yang membeli long melawan pergerakan. Jika pada saat yang sama funding menjadi negatif, short juga membayar long untuk menahan posisinya. Pembalikan tajam ke atas pada titik itu dapat memaksa short menutup posisi dan mempercepat kenaikan.