Genesis Arbitrage

Genesis Arbitrage · · 15 menit baca

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-interest mencakup 13+ exchange: jumlahnya di total, rinciannya di exchanges, 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.

UkuranApa yang ditunjukkanHal yang perlu diwaspadai
OI dalam koinBerapa banyak posisi terbukaUkuran kontrak berbeda di tiap exchange
OI dalam dolarBerapa banyak uang dalam posisiBergerak bersama harga
Total OIPosisi di seluruh pasarBergantung pada exchange mana yang dijumlahkan
OI per exchangeDi mana posisi dibangunMetode 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:

ExchangeOI saat iniRiwayat OIYang perlu diperhatikan
BinanceGET /fapi/v1/openInterest, satu symbol per requestGET /futures/data/openInterestHistRiwayat hanya mencakup satu bulan terakhir
BybitGET /v5/market/tickers, semua simbol dalam satu requestGET /v5/market/open-interest, interval dari 5min hingga 1dopenInterest menghitung kedua sisi, singleOpenInterest satu sisi
OKXGET /api/v5/public/open-interestGET /api/v5/rubik/stat/contracts/open-interest-historyoi dalam kontrak, oiCcy dalam koin, oiUsd dalam dolar
HyperliquidPOST /info, tipe metaAndAssetCtxsTidak ada di dokumentasiOI 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",
      …
    }
  }
}
FieldArti
total.oi_usd / total.oi_tokensTotal OI dalam dolar dan dalam koin
total.avg_priceHarga koin rata-rata di seluruh exchange
total.volume_24hVolume 24 jam, USD
total.oi_change_5m/15m/30m/1hPerubahan OI selama 5, 15, dan 30 menit dan 1 jam, %
total.price_change_5m/15m/30m/1hPerubahan 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.

HargaOIPembacaan umumYang perlu dicek
NaikNaikPosisi baru searah pergerakan, kenaikan didukung uangFunding: sangat positif berarti long terlalu padat
TurunNaikShort menumpuk, atau long membeli saat harga turunFunding: sangat negatif berarti ada risiko short squeeze
NaikTurunKenaikan berjalan dari penutupan short, tanpa uang baruApakah OI turun di setiap exchange
TurunTurunLong ditutup, secara sukarela atau paksaOI 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.

ExchangePorsi OIOI 1 jamHarga 1 jam
Binance46,2%+8,0%+3,0%
ByBit27,0%+5,0%+3,1%
OKX17,5%+2,0%+2,9%
Bitget9,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

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.