Genesis Arbitrage

Genesis Arbitrage · · 12 menit baca

Data pasar Genesis API: Fair – Last, pump, OI, sinyal AI, pencarian

Ringkasan

  • Enam endpoint pasar mencerminkan situs: Fair – Last, CEX Pumps – Dumps, DEX Dumps, OI Tracking, sinyal Genesis AI+, dan pencarian koin. Semuanya kecuali DEX Dumps tersedia mulai paket Trial.
  • Perubahan harga dan open interest datang sebagai persentase siap pakai pada interval 5 detik hingga satu jam, jadi Anda tidak perlu menyimpan riwayat sendiri.
  • Genesis API hanya membaca data. API ini menunjukkan pergerakan dan anomali, sedangkan keputusan trading dan transaksinya di exchange tetap di tangan Anda.

Endpoint pasar Genesis API mengembalikan data yang sama dengan bagian Fair – Last, CEX Pumps – Dumps, DEX Dumps, dan OI Tracking di situs, ditambah feed sinyal Genesis AI+ dan kartu koin di semua exchange. Setiap panggilan adalah HTTP GET dengan kunci di header X-API-Key, dan respons berada dalam amplop data dan meta. Developer memakai data ini untuk alert pergerakan tajam, monitor open interest, dan pengecekan koin sebelum trading.

Endpoint dan paket

EndpointYang dikembalikanPaket API
/market/fair-priceMark price dan transaksi terakhirTrial, Start, Pro, Max
/market/pumpsPump dan dump di CEXTrial, Start, Pro, Max
/market/dex-dumpsAnjloknya token di DEXPro, Max
/market/open-interestOpen interest per exchangeTrial, Start, Pro, Max
/ai/signalsSinyal Genesis AI+Trial, Start, Pro, Max
/coins/searchKartu koin di semua exchangeTrial, Start, Pro, Max

URL dasarnya adalah https://api.genesisarbitrage.com/v1, dan endpoint di luar paket Anda mengembalikan 403 plan_restricted. Paket juga menentukan kesegaran data: 60 dtk di Trial, 30 dtk di Start, 10 dtk di Pro, dan 5 dtk di Max. Kunci dan permintaan pertama dibahas di panduan mulai cepat, kuota di limit Genesis API, dan kode error di respons dan error Genesis API.

Fair – Last: /market/fair-price

Setiap baris adalah futures satu koin di satu exchange: mark price (Fair), harga transaksi terakhir (Last), dan spread di antara keduanya. Mark price dihitung, dan di Binance Futures likuidasi terpicu berdasarkan harga ini. Selisih lebar berarti transaksi di satu exchange mendorong Last, atau order book kehabisan order. Cara memeriksa baris semacam itu dibahas di panduan Fair – Last, field-nya ada di dokumentasi.

ParameterTipeFungsi
exchangestringExchange; pisahkan dengan koma untuk beberapa
coinstringTicker koin, mis. BTC
min_spreadnumberSpread absolut minimum, %
FieldTipeArti
fair_price / last_pricenumberMark price dan harga transaksi terakhir
spread_pctnumberSpread di antara keduanya, %
fair_changes / last_changesobjectPerubahan masing-masing harga, %: s5, s10, s30, dan m1 — selama 5, 10, dan 30 detik serta satu menit
curl -G "https://api.genesisarbitrage.com/v1/market/fair-price" \
  -d exchange=ByBit \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"

Flag -G memindahkan parameter -d ke URL permintaan. Respons berupa array data; di sini dan seterusnya kami menampilkan salah satu itemnya:

{
  "exchange": "ByBit",
  "coin": "0G",
  "fair_price": 0.192,
  "last_price": 0.192,
  "spread_pct": 0.0,
  "trade_url": "https://www.bybit.com/trade/usdt/0GUSDT",
  "fair_changes": { "s5": 0.0, "s10": 0.052, "s30": 0.052, "m1": 0.0 },
  "last_changes": { "s5": 0.052, "s10": 0.052, "s30": 0.052, "m1": 0.0 }
}

CEX Pumps – Dumps: /market/pumps

Endpoint ini mencerminkan tabel CEX Pumps – Dumps: harga koin di futures sebuah exchange dan perubahannya di delapan interval pada field change_5s, change_10s, change_30s, change_60s, change_5m, change_15m, change_30m, dan change_1h. Permintaan dengan min_change=5 mempertahankan koin yang bergerak 5% atau lebih ke arah mana pun pada setidaknya satu interval. Semua field ada di dokumentasi endpoint.

ParameterTipeFungsi
exchangestringExchange; pisahkan dengan koma untuk beberapa
coinstringTicker koin
min_changenumberAmbang perubahan harga absolut, %
FieldTipeArti
pricenumberHarga saat ini
change_5s … change_1hnumberPerubahan harga selama interval, %
volume_24hnumberVolume 24 jam, USD
funding_pctnumber atau nullFunding rate per periode settlement, %
contract / networkstring atau nullAlamat kontrak dan network token
curl -G "https://api.genesisarbitrage.com/v1/market/pumps" \
  -d coin=BTC -d exchange=MEXC \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "exchange": "MEXC",
  "coin": "BTC",
  "price": 64267.9,
  "change_5s": 0.0,
  "change_10s": 0.0,
  "change_30s": 0.02,
  "change_60s": 0.06,
  "change_5m": 0.08,
  "change_15m": -0.06,
  "change_30m": -0.09,
  "change_1h": -0.2,
  "volume_24h": 2243246205,
  "funding_pct": 0.01,
  "network": "BNB Smart Chain(BEP20)",
  "trade_url": "https://futures.mexc.com/exchange/BTC_USDT"
}

DEX Dumps: /market/dex-dumps

Paket Pro dan Max. Endpoint ini mengembalikan anjloknya token di DEX, seperti bagian DEX Dumps, lengkap dengan likuiditas pool dan flag yang menunjukkan apakah token diperdagangkan di CEX. Skema respons ada di dokumentasi.

ParameterTipeFungsi
chainstringNetwork, mis. bsc
min_liquiditynumberLikuiditas pool minimum, USD
FieldTipeArti
tsintWaktu kejadian, detik unix
price / liquidity_usdnumberHarga dan likuiditas pool, USD
market_capnumber atau nullKapitalisasi pasar, USD
price_changesobjectPerubahan harga, %: m5, h1, h6, dan h24
listed_on_cexbooleanApakah koin diperdagangkan di CEX
cex_spot / cex_futuresstring[]Exchange yang memiliki spot dan futures koin tersebut
pool_urlstringTautan pool
curl -G "https://api.genesisarbitrage.com/v1/market/dex-dumps" \
  -d chain=bsc -d min_liquidity=20000 \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "ts": 1783203653,
  "coin": "ONLY",
  "chain": "bsc",
  "price": 0.00009884,
  "liquidity_usd": 30477.58,
  "market_cap": 98840,
  "price_changes": {
    "m5": -58.03, "h1": 31.83, "h6": 31.83, "h24": 31.83
  },
  "pool_url": "https://dexscreener.com/bsc/0x2a18…",
  "listed_on_cex": false,
  "cex_spot": [],
  "cex_futures": []
}

OI Tracking: /market/open-interest

Open interest (OI) adalah volume posisi futures yang terbuka dan belum ditutup. Endpoint ini mengembalikannya seperti tabel OI Tracking: total koin di total dan rincian per exchange di exchanges. Datanya mencakup 13+ exchange futures, termasuk Binance, Bybit, OKX, Bitget, dan Gate. Ikhtisarnya ada di artikel API open interest, field-nya di dokumentasi.

ParameterTipeFungsi
coinstringTicker koin
exchangestringExchange; pisahkan dengan koma untuk beberapa
FieldTipeArti
total.oi_usd / total.oi_tokensnumberOpen interest dalam dolar dan dalam koin
total.avg_pricenumberHarga rata-rata tertimbang volume di seluruh exchange
total.volume_24hnumberVolume 24 jam, USD
total.oi_change_5m/15m/30m/1hnumberPerubahan OI selama interval, %
total.price_change_5m/15m/30m/1hnumberPerubahan harga selama interval, %
exchanges{}objectMetrik yang sama per exchange: price sebagai ganti avg_price, ditambah trade_url
curl -G "https://api.genesisarbitrage.com/v1/market/open-interest" \
  -d coin=GRAM \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "coin": "GRAM",
  "total": {
    "oi_usd": 96544685.3,
    "oi_tokens": 58105803.3,
    "avg_price": 1.661224,
    "volume_24h": 47010004.63,
    "oi_change_1h": 0.3185,
    "price_change_1h": -0.1929,
    …
  },
  "exchanges": {
    "ByBit": {
      "price": 1.6609,
      "oi_usd": 26838489.41,
      "oi_change_1h": -0.097,
      "trade_url": "https://www.bybit.com/trade/usdt/GRAMUSDT",
      …
    }
  }
}

Contoh hipotetis: OI naik lebih dari 5% dalam sejam, bersama harga

Anda mencari koin yang menarik posisi baru selama satu jam terakhir sementara harganya naik: total.oi_change_1h di atas 5 dan total.price_change_1h di atas 0. Kedua field sudah dalam persen.

Satu jam lalu koin A memiliki OI $40.000.000, sekarang $42.600.000: (42.600.000 − 40.000.000) / 40.000.000 × 100 = 6,5%. Dalam jam yang sama harga naik dari $2,00 ke $2,056: (2,056 − 2,00) / 2,00 × 100 = 2,8%. Dalam respons ini muncul sebagai oi_change_1h: 6.5 dan price_change_1h: 2.8.

KoinOI, 1 jamHarga, 1 jamHasil
A+6,5%+2,8%Lolos
B+7,2%−1,9%Tidak: OI naik berlawanan dengan harga
C+3,1%+4,0%Tidak: OI di bawah ambang

Pada koin B, OI naik saat harga turun, yang biasanya berarti posisi short sedang dibuka. OI yang naik bersama harga tidak menjanjikan kelanjutan: pasar yang terlalu panas bisa berbalik dalam rangkaian likuidasi.

  1. Minta seluruh snapshot

    Satu panggilan tanpa filter mengembalikan semua koin.

  2. Buang koin kecil

    Tetapkan ambang total.oi_usd, mis. $5.000.000: dengan OI kecil, beberapa posisi besar saja menghasilkan persentase besar.

  3. Terapkan kondisinya

    oi_change_1h di atas 5, price_change_1h di atas 0.

  4. Periksa seberapa luas pergerakannya

    Hitung exchange di exchanges yang OI-nya juga naik lebih dari 5%: kenaikan di beberapa venue lebih berbobot.

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  # lewati koin kecil

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 rebuild
            time.sleep(int(r.headers.get("Retry-After", "5")))
            continue
        r.raise_for_status()
        return r.json()["data"]

for row in get("/market/open-interest"):
    t = row["total"]
    oi, price = t.get("oi_change_1h"), t.get("price_change_1h")
    if oi is None or price is None:
        continue
    if (t.get("oi_usd") or 0) < MIN_OI_USD:
        continue
    if oi > 5 and price > 0:
        wide = [ex for ex, m in row["exchanges"].items()
                if (m.get("oi_change_1h") or 0) > 5]
        print(f"{row['coin']}: OI {oi:+.1f}%, harga {price:+.1f}%, "
              f"exchange dengan kenaikan OI: {len(wide)}")

Sinyal Genesis AI+: /ai/signals

Genesis AI+ memeriksa sinyal arbitrase dan menilai tiap sinyal dari alpha hingga noise. Endpoint ini mengembalikan feed tersebut dengan teks dalam bahasa Rusia dan Inggris serta tautan ke venue. category hanya menerima satu nilai: untuk alpha dan high, lakukan dua permintaan atau filter respons di sisi Anda. Deskripsi field ada di dokumentasi.

ParameterTipeFungsi
categorystringPeringkat: alpha, high, middle, risky, atau noise
coinstringTicker koin
FieldTipeArti
idstringPengenal: bot Anda memakainya untuk melewati pengulangan
ts / timeint / stringWaktu: detik unix dan ISO 8601
pipelinestringSumber sinyal
message_ru / message_enstring atau nullTeks sinyal dalam bahasa Rusia dan Inggris
linksarrayTautan siap pakai: teks + url
curl -G "https://api.genesisarbitrage.com/v1/ai/signals" \
  -d coin=UTYA \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "id": "1783198680493",
  "ts": 1783198680,
  "time": "2026-07-04T20:58:00Z",
  "coin": "UTYA",
  "pipeline": "public",
  "category": "noise",
  "message_ru": "Глянул на UTYA — DEX против MEXC Futures…",
  "message_en": "Checked UTYA — DEX against MEXC Futures…",
  "links": [
    {
      "text": "MEXC Futures",
      "url": "https://futures.mexc.com/exchange/UTYA_USDT"
    }
  ]
}

Pencarian koin: /coins/search

Endpoint ini mengembalikan kartu koin, seperti Coin Search di situs: kontrak per network, harga spot dan futures, status deposit dan penarikan di setiap exchange, serta ringkasan funding. Ticker diisi pada parameter query yang wajib, dan koin yang tidak dikenal mengembalikan 404 not_found. Di sini data adalah satu objek. Field ada di dokumentasi.

FieldTipeArti
contracts[]arrayKontrak: alamat, network, dan exchange yang memakainya
exchanges{}.spot_price / futures_pricenumber atau nullHarga spot dan futures; null berarti tidak ada pasar
exchanges{}.deposit / withdrawboolean atau nullApakah deposit dan penarikan dibuka
fundingobject atau nullRingkasan funding; null berarti tidak ada futures

Satu ticker bisa berupa token berbeda di exchange berbeda: sebelum transfer, bandingkan alamat dari contracts[] dengan kontrak di halaman deposit exchange.

curl -G "https://api.genesisarbitrage.com/v1/coins/search" \
  -d query=IRYS \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "coin": "IRYS",
  "contracts": [
    {
      "address": "0x91152b4ef635403efbae860edd0f8c321d7c035d",
      "network": "BNB Smart Chain(BEP20)",
      "exchanges": ["MEXC", "Ourbit"]
    }
  ],
  "exchanges": {
    "MEXC": {
      "spot_price": 0.01329,
      "futures_price": 0.0133,
      "deposit": true,
      "withdraw": true,
      "spot_url": "https://www.mexc.com/exchange/IRYS_USDT",
      …
    }
  },
  "funding": {
    "spread_pct": 0.0,
    "best": { "exchange_1": "Bitget", "exchange_2": "OKX", … }
  }
}

Tanya jawab

Endpoint pasar apa saja yang ada di paket Trial?

Semuanya kecuali DEX Dumps: endpoint itu terbuka di Pro dan Max dan mengembalikan 403 plan_restricted di Trial dan Start.

Apakah API menyediakan riwayat open interest?

Tidak: endpoint mengembalikan snapshot terkini dengan perubahan selama 5, 15, dan 30 menit serta satu jam, dan Genesis API tidak memiliki candle historis. Bangun riwayatnya sendiri dengan menyimpan respons.

Bisakah saya membuka transaksi lewat endpoint ini?

Tidak. Genesis API hanya membaca data dan tidak menempatkan order: Anda membuka transaksi sendiri di exchange.

Seberapa sering saya boleh polling endpoint pasar?

Tidak lebih sering dari meta.freshness_sec: dari 60 dtk di Trial hingga 5 dtk di Max. Respons tanpa filter membawa header ETag. Kirim kembali di If-None-Match, dan selama data belum berubah server menjawab 304, yang tidak memakai kuota Anda.