Genesis Arbitrage

Genesis Arbitrage · · 3 menit baca

ETag dan If-None-Match

ETag adalah header respons HTTP yang membawa tag versi data: selama resource tidak berubah, tag-nya juga tetap. Klien mengirim tag itu kembali lewat header If-None-Match, dan jika server masih memiliki versi tersebut, server menjawab 304 Not Modified tanpa body. Kedua header didefinisikan di RFC 9110 (HTTP Semantics, 2022).

Cara kerja request bersyarat

Contoh hipotetis dengan tag "a7f3c9":

LangkahRequestRespons
1GET /v1/funding/rates200, ETag: "a7f3c9", body JSON
2URL yang sama dengan If-None-Match: "a7f3c9"304 Not Modified, tanpa body
3Request yang sama setelah data diperbarui200, tag baru dan JSON baru

Menurut standar, respons 304 berakhir pada header dan tidak boleh memuat body, jadi klien memakai salinannya sendiri. Server yang membandingkan tag; klien hanya menyimpan tag terakhir yang diterima dan mengirimkannya bersama request yang sama.

import os
import requests

URL = "https://api.genesisarbitrage.com/v1/funding/rates"
cache = {"tag": None, "data": None}  # kumpulan data penuh dan tag-nya

def get_rates():
    headers = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
    if cache["tag"]:
        headers["If-None-Match"] = cache["tag"]
    r = requests.get(URL, headers=headers, timeout=10)
    if r.status_code == 304:
        return cache["data"]  # data tidak berubah, kuota tidak terpakai
    r.raise_for_status()
    cache["tag"] = r.headers.get("ETag")
    cache["data"] = r.json()["data"]
    return cache["data"]

# pilih koin secara lokal: request dengan coin datang tanpa ETag
btc = [row for row in get_rates() if row["coin"] == "BTC"]

ETag di Genesis API

Hanya respons 200 yang dihitung sebagai panggilan Genesis API: 304 tidak memakai kuota Anda, tetapi tetap dihitung dalam batas request per detik. Respons ini tanpa body, dan respons di bawah 64 KB tidak dihitung dalam batas volume unduhan. Dataset penuh tanpa filter membawa tag: respons untuk request dengan coin atau filter dibangun khusus untuk request itu dan datang tanpa ETag, sehingga di sana filter itu sendiri yang menghemat traffic (paket dan limit).

Contoh hipotetis: sebuah bot mengambil ringkasan penuh analitik funding /funding/analytics/summary (paket Pro dan Max) setiap 60 detik. Bagian ini sekitar 600 KB setelah gzip, dan tag-nya berubah kira-kira setiap 15 menit. Dalam 30 hari itu berarti 30 × 24 × 60 = 43.200 request. Dengan If-None-Match, hanya 30 × 24 × 4 = 2.880 di antaranya yang mengunduh bagian penuh; 40.320 sisanya kembali sebagai 304 tanpa body dan tanpa potongan kuota. Traffic turun dari sekitar 26 GB menjadi 1,7 GB.

Lihat juga: polling API, HTTP 429, kesegaran data, format respons, ETag, dan error Genesis API, cara polling API tanpa terkena limit.

Tanya jawab

Apakah respons 304 memakai kuota Genesis API?

Tidak. Hanya respons 200 yang memakai kuota; 304 dan error gratis, tetapi tetap dihitung dalam batas request per detik.

Bagaimana jika respons tidak memiliki ETag?

Lakukan polling tidak lebih sering dari meta.freshness_sec dan bandingkan meta.updated_at dengan respons sebelumnya: nilai yang sama berarti snapshot belum diperbarui.