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
| Endpoint | Yang dikembalikan | Paket API |
|---|---|---|
/market/fair-price | Mark price dan transaksi terakhir | Trial, Start, Pro, Max |
/market/pumps | Pump dan dump di CEX | Trial, Start, Pro, Max |
/market/dex-dumps | Anjloknya token di DEX | Pro, Max |
/market/open-interest | Open interest per exchange | Trial, Start, Pro, Max |
/ai/signals | Sinyal Genesis AI+ | Trial, Start, Pro, Max |
/coins/search | Kartu koin di semua exchange | Trial, 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.
| Parameter | Tipe | Fungsi |
|---|---|---|
exchange | string | Exchange; pisahkan dengan koma untuk beberapa |
coin | string | Ticker koin, mis. BTC |
min_spread | number | Spread absolut minimum, % |
| Field | Tipe | Arti |
|---|---|---|
fair_price / last_price | number | Mark price dan harga transaksi terakhir |
spread_pct | number | Spread di antara keduanya, % |
fair_changes / last_changes | object | Perubahan 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.
| Parameter | Tipe | Fungsi |
|---|---|---|
exchange | string | Exchange; pisahkan dengan koma untuk beberapa |
coin | string | Ticker koin |
min_change | number | Ambang perubahan harga absolut, % |
| Field | Tipe | Arti |
|---|---|---|
price | number | Harga saat ini |
change_5s … change_1h | number | Perubahan harga selama interval, % |
volume_24h | number | Volume 24 jam, USD |
funding_pct | number atau null | Funding rate per periode settlement, % |
contract / network | string atau null | Alamat 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.
| Parameter | Tipe | Fungsi |
|---|---|---|
chain | string | Network, mis. bsc |
min_liquidity | number | Likuiditas pool minimum, USD |
| Field | Tipe | Arti |
|---|---|---|
ts | int | Waktu kejadian, detik unix |
price / liquidity_usd | number | Harga dan likuiditas pool, USD |
market_cap | number atau null | Kapitalisasi pasar, USD |
price_changes | object | Perubahan harga, %: m5, h1, h6, dan h24 |
listed_on_cex | boolean | Apakah koin diperdagangkan di CEX |
cex_spot / cex_futures | string[] | Exchange yang memiliki spot dan futures koin tersebut |
pool_url | string | Tautan 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.
| Parameter | Tipe | Fungsi |
|---|---|---|
coin | string | Ticker koin |
exchange | string | Exchange; pisahkan dengan koma untuk beberapa |
| Field | Tipe | Arti |
|---|---|---|
total.oi_usd / total.oi_tokens | number | Open interest dalam dolar dan dalam koin |
total.avg_price | number | Harga rata-rata tertimbang volume di seluruh exchange |
total.volume_24h | number | Volume 24 jam, USD |
total.oi_change_5m/15m/30m/1h | number | Perubahan OI selama interval, % |
total.price_change_5m/15m/30m/1h | number | Perubahan harga selama interval, % |
exchanges{} | object | Metrik 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.
| Koin | OI, 1 jam | Harga, 1 jam | Hasil |
|---|---|---|---|
| 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.
Minta seluruh snapshot
Satu panggilan tanpa filter mengembalikan semua koin.
Buang koin kecil
Tetapkan ambang
total.oi_usd, mis. $5.000.000: dengan OI kecil, beberapa posisi besar saja menghasilkan persentase besar.Terapkan kondisinya
oi_change_1hdi atas 5,price_change_1hdi atas 0.Periksa seberapa luas pergerakannya
Hitung exchange di
exchangesyang 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.
| Parameter | Tipe | Fungsi |
|---|---|---|
category | string | Peringkat: alpha, high, middle, risky, atau noise |
coin | string | Ticker koin |
| Field | Tipe | Arti |
|---|---|---|
id | string | Pengenal: bot Anda memakainya untuk melewati pengulangan |
ts / time | int / string | Waktu: detik unix dan ISO 8601 |
pipeline | string | Sumber sinyal |
message_ru / message_en | string atau null | Teks sinyal dalam bahasa Rusia dan Inggris |
links | array | Tautan 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.
| Field | Tipe | Arti |
|---|---|---|
contracts[] | array | Kontrak: alamat, network, dan exchange yang memakainya |
exchanges{}.spot_price / futures_price | number atau null | Harga spot dan futures; null berarti tidak ada pasar |
exchanges{}.deposit / withdraw | boolean atau null | Apakah deposit dan penarikan dibuka |
funding | object atau null | Ringkasan 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.