Genesis API market data: Fair – Last, pumps, OI, AI signals, search
In short
- Six market endpoints mirror the site: Fair – Last, CEX Pumps – Dumps, DEX Dumps, OI Tracking, Genesis AI+ signals and coin search. Everything except DEX Dumps is available from the Trial plan.
- Price and open interest changes arrive as ready-made percentages over intervals from 5 seconds to an hour, so you don't need to store your own history to get them.
- Genesis API only reads data. It shows moves and anomalies, while the trading decision and the trade itself on the exchange stay with you.
Genesis API market endpoints return the same data as the Fair – Last, CEX Pumps – Dumps, DEX Dumps and OI Tracking sections of the site, plus the Genesis AI+ signal feed and a coin card across every exchange. Each call is an HTTP GET with the key in the X-API-Key header and a response in the data and meta envelope. Developers use this data for sharp-move alerts, open interest monitors and pre-trade coin checks.
Endpoints and plans
| Endpoint | What it returns | API plans |
|---|---|---|
/market/fair-price | Mark price and last trade | Trial, Start, Pro, Max |
/market/pumps | Pumps and dumps on CEX | Trial, Start, Pro, Max |
/market/dex-dumps | Token crashes on DEX | Pro, Max |
/market/open-interest | Open interest by exchange | Trial, Start, Pro, Max |
/ai/signals | Genesis AI+ signals | Trial, Start, Pro, Max |
/coins/search | A coin card across all exchanges | Trial, Start, Pro, Max |
The base URL is https://api.genesisarbitrage.com/v1, and an endpoint outside your plan returns 403 plan_restricted. The plan also sets data freshness: 60 s on Trial, 30 s on Start, 10 s on Pro and 5 s on Max. The key and the first request are covered in the quick start, quotas in Genesis API limits and error codes in Genesis API responses and errors.
Fair – Last: /market/fair-price
Each row is one coin's futures on one exchange: the mark price (Fair), the last trade price (Last) and the spread between them. The mark price is calculated, and on Binance Futures liquidation triggers on it. A wide gap means trades on one exchange pushed Last, or the order book ran out of orders. How to examine such rows is covered in the Fair – Last guide, the fields in the documentation.
| Parameter | Type | What it does |
|---|---|---|
exchange | string | Exchange; comma-separated for several |
coin | string | Coin ticker, e.g. BTC |
min_spread | number | Minimum absolute spread, % |
| Field | Type | Meaning |
|---|---|---|
fair_price / last_price | number | Mark price and last trade price |
spread_pct | number | Spread between them, % |
fair_changes / last_changes | object | Change of each price, %: s5, s10, s30 and m1 — over 5, 10 and 30 seconds and a minute |
curl -G "https://api.genesisarbitrage.com/v1/market/fair-price" \
-d exchange=ByBit \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
The -G flag moves the -d parameters into the request URL. The response is a data array; here and below we show one of its items:
{
"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
The endpoint mirrors the CEX Pumps – Dumps table: a coin's price on an exchange's futures and its change over eight intervals in the fields change_5s, change_10s, change_30s, change_60s, change_5m, change_15m, change_30m and change_1h. A request with min_change=5 keeps coins that moved 5% or more in either direction on at least one interval. All fields are in the endpoint documentation.
| Parameter | Type | What it does |
|---|---|---|
exchange | string | Exchange; comma-separated for several |
coin | string | Coin ticker |
min_change | number | Absolute price change threshold, % |
| Field | Type | Meaning |
|---|---|---|
price | number | Current price |
change_5s … change_1h | number | Price change over the interval, % |
volume_24h | number | 24h volume, USD |
funding_pct | number or null | Funding rate per settlement period, % |
contract / network | string or null | Contract address and token network |
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
Pro and Max plans. The endpoint returns token crashes on DEX, like the DEX Dumps section, with pool liquidity and a flag showing whether the token trades on CEX. The response schema is in the documentation.
| Parameter | Type | What it does |
|---|---|---|
chain | string | Network, e.g. bsc |
min_liquidity | number | Minimum pool liquidity, USD |
| Field | Type | Meaning |
|---|---|---|
ts | int | Event time, unix seconds |
price / liquidity_usd | number | Price and pool liquidity, USD |
market_cap | number or null | Market cap, USD |
price_changes | object | Price change, %: m5, h1, h6 and h24 |
listed_on_cex | boolean | Whether the coin trades on CEX |
cex_spot / cex_futures | string[] | Exchanges with the coin's spot and futures |
pool_url | string | Pool link |
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) is the volume of futures positions that are open and not yet closed. The endpoint returns it like the OI Tracking table: the coin total in total and the per-exchange breakdown in exchanges. The data covers 13+ futures exchanges, including Binance, Bybit, OKX, Bitget and Gate. An overview is in the open interest API article, the fields in the documentation.
| Parameter | Type | What it does |
|---|---|---|
coin | string | Coin ticker |
exchange | string | Exchange; comma-separated for several |
| Field | Type | Meaning |
|---|---|---|
total.oi_usd / total.oi_tokens | number | Open interest in dollars and in coins |
total.avg_price | number | Volume-weighted average price across exchanges |
total.volume_24h | number | 24h volume, USD |
total.oi_change_5m/15m/30m/1h | number | OI change over the interval, % |
total.price_change_5m/15m/30m/1h | number | Price change over the interval, % |
exchanges{} | object | The same metrics per exchange: price instead of avg_price, plus 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",
…
}
}
}
Hypothetical example: OI up more than 5% in an hour, together with price
You want coins that drew new positions over the last hour while the price rose: total.oi_change_1h above 5 and total.price_change_1h above 0. Both fields are already in percent.
An hour ago coin A had $40,000,000 of OI, now it has $42,600,000: (42,600,000 − 40,000,000) / 40,000,000 × 100 = 6.5%. Over the same hour the price rose from $2.00 to $2.056: (2.056 − 2.00) / 2.00 × 100 = 2.8%. In the response this shows up as oi_change_1h: 6.5 and price_change_1h: 2.8.
| Coin | OI, 1h | Price, 1h | Result |
|---|---|---|---|
| A | +6.5% | +2.8% | Passes |
| B | +7.2% | −1.9% | No: OI rises against the price |
| C | +3.1% | +4.0% | No: OI below the threshold |
Coin B has OI rising on a falling price, which usually means shorts are being opened. OI rising together with the price does not promise continuation: an overheated market can reverse in a cascade of liquidations.
Request the whole snapshot
One call without filters returns every coin.
Drop small coins
Set a
total.oi_usdthreshold, e.g. $5,000,000: with a small OI, a couple of large positions produce a big percentage.Apply the condition
oi_change_1habove 5,price_change_1habove 0.Check how broad the move is
Count the exchanges in
exchangeswhere OI also grew by more than 5%: growth on several venues carries more weight.
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 # skip small coins
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 or 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}%, price {price:+.1f}%, "
f"exchanges with OI growth: {len(wide)}")
Genesis AI+ signals: /ai/signals
Genesis AI+ checks arbitrage signals and grades each one from alpha to noise. The endpoint returns that feed with the text in Russian and English and links to the venues. category takes a single value: for alpha and high, make two requests or filter the response on your side. Field descriptions are in the documentation.
| Parameter | Type | What it does |
|---|---|---|
category | string | Grade: alpha, high, middle, risky or noise |
coin | string | Coin ticker |
| Field | Type | Meaning |
|---|---|---|
id | string | Identifier: your bot uses it to skip repeats |
ts / time | int / string | Time: unix seconds and ISO 8601 |
pipeline | string | Signal source |
message_ru / message_en | string or null | Signal text in Russian and English |
links | array | Ready links: text + 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"
}
]
}
Coin search: /coins/search
The endpoint returns a coin card, like Coin Search on the site: contracts per network, spot and futures prices, deposit and withdrawal status on every exchange and a funding summary. The ticker goes in the required query parameter, and an unknown coin returns 404 not_found. Here data is a single object. Fields are in the documentation.
| Field | Type | Meaning |
|---|---|---|
contracts[] | array | Contracts: address, network and the exchanges that use it |
exchanges{}.spot_price / futures_price | number or null | Spot and futures price; null means no market |
exchanges{}.deposit / withdraw | boolean or null | Whether deposits and withdrawals are open |
funding | object or null | Funding summary; null means no futures |
One ticker can be different tokens on different exchanges: before a transfer, compare the address from contracts[] with the contract on the exchange's deposit page.
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", … }
}
}
Questions and answers
Which market endpoints are on the Trial plan?
All except DEX Dumps: that endpoint is open on Pro and Max and returns 403 plan_restricted on Trial and Start.
Does the API have open interest history?
No: the endpoint returns the current snapshot with changes over 5, 15 and 30 minutes and an hour, and Genesis API has no historical candles. Build the history yourself by storing the responses.
Can I open trades through these endpoints?
No. Genesis API only reads data and places no orders: you open the trade on the exchange yourself.
How often should I poll the market endpoints?
No more often than meta.freshness_sec: from 60 s on Trial to 5 s on Max. A response without filters carries an ETag header. Send it back in If-None-Match, and while the data hasn't changed the server answers 304, which doesn't use your quota.