Genesis Arbitrage

Genesis Arbitrage · · 12 min read

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

EndpointWhat it returnsAPI plans
/market/fair-priceMark price and last tradeTrial, Start, Pro, Max
/market/pumpsPumps and dumps on CEXTrial, Start, Pro, Max
/market/dex-dumpsToken crashes on DEXPro, Max
/market/open-interestOpen interest by exchangeTrial, Start, Pro, Max
/ai/signalsGenesis AI+ signalsTrial, Start, Pro, Max
/coins/searchA coin card across all exchangesTrial, 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.

ParameterTypeWhat it does
exchangestringExchange; comma-separated for several
coinstringCoin ticker, e.g. BTC
min_spreadnumberMinimum absolute spread, %
FieldTypeMeaning
fair_price / last_pricenumberMark price and last trade price
spread_pctnumberSpread between them, %
fair_changes / last_changesobjectChange 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.

ParameterTypeWhat it does
exchangestringExchange; comma-separated for several
coinstringCoin ticker
min_changenumberAbsolute price change threshold, %
FieldTypeMeaning
pricenumberCurrent price
change_5s … change_1hnumberPrice change over the interval, %
volume_24hnumber24h volume, USD
funding_pctnumber or nullFunding rate per settlement period, %
contract / networkstring or nullContract 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.

ParameterTypeWhat it does
chainstringNetwork, e.g. bsc
min_liquiditynumberMinimum pool liquidity, USD
FieldTypeMeaning
tsintEvent time, unix seconds
price / liquidity_usdnumberPrice and pool liquidity, USD
market_capnumber or nullMarket cap, USD
price_changesobjectPrice change, %: m5, h1, h6 and h24
listed_on_cexbooleanWhether the coin trades on CEX
cex_spot / cex_futuresstring[]Exchanges with the coin's spot and futures
pool_urlstringPool 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.

ParameterTypeWhat it does
coinstringCoin ticker
exchangestringExchange; comma-separated for several
FieldTypeMeaning
total.oi_usd / total.oi_tokensnumberOpen interest in dollars and in coins
total.avg_pricenumberVolume-weighted average price across exchanges
total.volume_24hnumber24h volume, USD
total.oi_change_5m/15m/30m/1hnumberOI change over the interval, %
total.price_change_5m/15m/30m/1hnumberPrice change over the interval, %
exchanges{}objectThe 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.

CoinOI, 1hPrice, 1hResult
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.

  1. Request the whole snapshot

    One call without filters returns every coin.

  2. Drop small coins

    Set a total.oi_usd threshold, e.g. $5,000,000: with a small OI, a couple of large positions produce a big percentage.

  3. Apply the condition

    oi_change_1h above 5, price_change_1h above 0.

  4. Check how broad the move is

    Count the exchanges in exchanges where 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.

ParameterTypeWhat it does
categorystringGrade: alpha, high, middle, risky or noise
coinstringCoin ticker
FieldTypeMeaning
idstringIdentifier: your bot uses it to skip repeats
ts / timeint / stringTime: unix seconds and ISO 8601
pipelinestringSignal source
message_ru / message_enstring or nullSignal text in Russian and English
linksarrayReady 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.

FieldTypeMeaning
contracts[]arrayContracts: address, network and the exchanges that use it
exchanges{}.spot_price / futures_pricenumber or nullSpot and futures price; null means no market
exchanges{}.deposit / withdrawboolean or nullWhether deposits and withdrawals are open
fundingobject or nullFunding 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.