Genesis Arbitrage

Genesis Arbitrage · · 11 мин чтения

Рынок в Genesis API: Fair – Last, пампы, OI, AI-сигналы, поиск

Коротко

  • Шесть рыночных эндпоинтов повторяют разделы сайта: Fair – Last, CEX Пампы – Дампы, DEX Дампы, Трекинг OI, сигналы Genesis AI+ и поиск монет. Всё, кроме DEX Дампов, доступно с тарифа Trial.
  • Изменения цены и открытого интереса приходят готовыми процентами за интервалы от 5 секунд до часа — копить свою историю для них не нужно.
  • Genesis API только читает данные. Он показывает движения и аномалии, а решение о сделке и сама сделка на бирже остаются за вами.

Рыночные эндпоинты Genesis API отдают то же, что разделы сайта Fair – Last, CEX Пампы – Дампы, DEX Дампы и Трекинг OI, плюс ленту сигналов Genesis AI+ и карточку монеты по всем биржам. Каждый вызов — HTTP GET с ключом в заголовке X-API-Key и ответом в конверте data и meta. На этих данных собирают алерты о резких движениях, мониторы открытого интереса и проверку монеты перед сделкой.

Эндпоинты и тарифы

ЭндпоинтЧто отдаётТарифы API
/market/fair-priceМаркировочная цена и последняя сделкаTrial, Start, Pro, Max
/market/pumpsПампы и дампы на CEXTrial, Start, Pro, Max
/market/dex-dumpsОбвалы токенов на DEXPro, Max
/market/open-interestОткрытый интерес по биржамTrial, Start, Pro, Max
/ai/signalsСигналы Genesis AI+Trial, Start, Pro, Max
/coins/searchКарточка монеты по всем биржамTrial, Start, Pro, Max

Базовый адрес — https://api.genesisarbitrage.com/v1, эндпоинт вне тарифа отвечает 403 plan_restricted. Свежесть тоже задаёт тариф: 60 с на Trial, 30 с на Start, 10 с на Pro и 5 с на Max. Ключ и первый запрос — в быстром старте, квоты — в инструкции «Лимиты Genesis API», коды ошибок — в инструкции «Ответы и ошибки Genesis API».

Fair – Last: /market/fair-price

Каждая строка — фьючерс монеты на одной бирже: маркировочная цена (Fair), цена последней сделки (Last) и спред между ними. Маркировочная цена — расчётная, на Binance Futures по ней срабатывает ликвидация. Большой разрыв значит, что Last сдвинули сделки на одной бирже или в стакане кончились заявки. Разбор таких строк — в инструкции «Fair – Last», поля — в документации.

ПараметрТипЧто делает
exchangestringБиржа; несколько — через запятую
coinstringТикер монеты, например BTC
min_spreadnumberМинимальный спред по модулю, %
ПолеТипЧто значит
fair_price / last_pricenumberМаркировочная цена и цена последней сделки
spread_pctnumberСпред между ними, %
fair_changes / last_changesobjectИзменение каждой цены, %: s5, s10, s30 и m1 — за 5, 10, 30 секунд и минуту
curl -G "https://api.genesisarbitrage.com/v1/market/fair-price" \
  -d exchange=ByBit \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"

Флаг -G переносит параметры -d в адрес запроса. Ответ — массив data; здесь и дальше показан один его элемент:

{
  "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 Пампы – Дампы: /market/pumps

Эндпоинт повторяет таблицу CEX Пампы – Дампы: цену монеты на фьючерсах биржи и её изменение за восемь интервалов в полях change_5s, change_10s, change_30s, change_60s, change_5m, change_15m, change_30m и change_1h. Запрос с min_change=5 оставит монеты, которые хотя бы на одном интервале сдвинулись на 5 % и больше в любую сторону. Все поля — в документации эндпоинта.

ПараметрТипЧто делает
exchangestringБиржа; несколько — через запятую
coinstringТикер монеты
min_changenumberПорог изменения цены по модулю, %
ПолеТипЧто значит
pricenumberТекущая цена
change_5s … change_1hnumberИзменение цены за интервал, %
volume_24hnumberОбъём за 24 часа, USD
funding_pctnumber или nullСтавка фандинга за период начисления, %
contract / networkstring или nullАдрес контракта и сеть токена
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 Дампы: /market/dex-dumps

Тарифы Pro и Max. Эндпоинт отдаёт обвалы токенов на DEX, как раздел DEX Дампы, с ликвидностью пула и отметкой, есть ли токен на CEX. Схема ответа — в документации.

ПараметрТипЧто делает
chainstringСеть, например bsc
min_liquiditynumberМинимальная ликвидность пула, USD
ПолеТипЧто значит
tsintВремя события, unix-секунды
price / liquidity_usdnumberЦена и ликвидность пула, USD
market_capnumber или nullКапитализация, USD
price_changesobjectИзменение цены, %: m5, h1, h6 и h24
listed_on_cexbooleanТоргуется ли монета на CEX
cex_spot / cex_futuresstring[]Биржи со спотом и фьючерсом монеты
pool_urlstringСсылка на пул
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: /market/open-interest

Открытый интерес (OI) — объём фьючерсных позиций, которые открыты и ещё не закрыты. Эндпоинт отдаёт его, как таблица Трекинг OI: итог по монете в total и разбивку по биржам в exchanges. Данные — с 13+ фьючерсных бирж, среди них Binance, Bybit, OKX, Bitget и Gate. Обзор — в статье «API открытого интереса», поля — в документации.

ПараметрТипЧто делает
coinstringТикер монеты
exchangestringБиржа; несколько — через запятую
ПолеТипЧто значит
total.oi_usd / total.oi_tokensnumberОткрытый интерес в долларах и в монетах
total.avg_pricenumberСредневзвешенная по объёму цена по биржам
total.volume_24hnumberОбъём за 24 часа, USD
total.oi_change_5m/15m/30m/1hnumberИзменение OI за интервал, %
total.price_change_5m/15m/30m/1hnumberИзменение цены за интервал, %
exchanges{}objectТе же метрики по каждой бирже: price вместо avg_price, плюс 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",
      …
    }
  }
}

Условный пример: OI за час вырос больше чем на 5 % вместе с ценой

Нужны монеты, в которые за час пришли новые позиции, а цена росла: total.oi_change_1h больше 5 и total.price_change_1h больше 0. Оба поля уже в процентах.

Час назад OI монеты A был $40 000 000, сейчас — $42 600 000: (42 600 000 − 40 000 000) / 40 000 000 × 100 = 6,5 %. Цена за тот же час выросла с $2,00 до $2,056: (2,056 − 2,00) / 2,00 × 100 = 2,8 %. В ответе это oi_change_1h: 6.5 и price_change_1h: 2.8.

МонетаOI за часЦена за часИтог
A+6,5 %+2,8 %Проходит
B+7,2 %−1,9 %Нет: OI растёт против цены
C+3,1 %+4,0 %Нет: OI ниже порога

У монеты B OI растёт на падающей цене — так обычно выглядит набор шортов. Рост OI вместе с ценой продолжения не обещает: перегретый рынок может развернуться каскадом ликвидаций.

  1. Запросите весь срез

    Один вызов без фильтров отдаёт все монеты.

  2. Отсейте мелкие монеты

    Задайте порог total.oi_usd, например $5 000 000: на малом OI пара крупных позиций даёт большой процент.

  3. Примените условие

    oi_change_1h больше 5, price_change_1h больше 0.

  4. Проверьте ширину движения

    Посчитайте биржи в exchanges, где OI тоже вырос больше чем на 5 %: рост на нескольких площадках весомее.

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  # мелкие монеты не смотрим

def get(path, **params):
    while True:
        r = requests.get(API + path, headers=HEADERS,
                         params=params, timeout=15)
        if r.status_code in (429, 503):  # лимит или пересборка
            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:+.1f}%, "
              f"бирж с ростом OI: {len(wide)}")

Сигналы Genesis AI+: /ai/signals

Genesis AI+ проверяет арбитражные сигналы и ставит каждому оценку от alpha до noise. Эндпоинт отдаёт эту ленту с текстом на русском и английском и ссылками на площадки. category принимает одно значение: для alpha и high сделайте два запроса или фильтруйте ответ у себя. Описание полей — в документации.

ПараметрТипЧто делает
categorystringОценка: alpha, high, middle, risky или noise
coinstringТикер монеты
ПолеТипЧто значит
idstringИдентификатор: по нему бот отсеивает повторы
ts / timeint / stringВремя: unix-секунды и ISO 8601
pipelinestringИсточник сигнала
message_ru / message_enstring или nullТекст сигнала на русском и английском
linksarrayГотовые ссылки: 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"
    }
  ]
}

Поиск монет: /coins/search

Эндпоинт отдаёт карточку монеты, как поиск монеты на сайте: контракты по сетям, цены спота и фьючерсов, статусы ввода и вывода на каждой бирже и сводку фандинга. Тикер — в обязательном параметре query, для неизвестной монеты ответ — 404 not_found. data здесь — один объект. Поля — в документации.

ПолеТипЧто значит
contracts[]arrayКонтракты: адрес, сеть и биржи, где он используется
exchanges{}.spot_price / futures_pricenumber или nullЦена спота и фьючерса; null — рынка нет
exchanges{}.deposit / withdrawboolean или nullОткрыты ли ввод и вывод
fundingobject или nullСводка фандинга; null — фьючерсов нет

Один тикер на разных биржах бывает разными токенами: перед переводом сверьте адрес из contracts[] с контрактом на странице ввода биржи.

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", … }
  }
}

Вопросы и ответы

Какие рыночные эндпоинты есть на тарифе Trial?

Все, кроме DEX Дампов: этот эндпоинт открыт на Pro и Max, а на Trial и Start отвечает 403 plan_restricted.

Есть ли в API история открытого интереса?

Нет: эндпоинт отдаёт текущий срез с изменением за 5, 15, 30 минут и час, исторических свечей в Genesis API нет. Историю копите сами, сохраняя ответы.

Можно ли через эти эндпоинты открывать сделки?

Нет. Genesis API только читает данные и ордеров не ставит: сделку вы открываете на бирже сами.

Как часто опрашивать рыночные эндпоинты?

Не чаще meta.freshness_sec: от 60 с на Trial до 5 с на Max. Ответ без фильтров приходит с заголовком ETag. Верните его в If-None-Match, и пока данные не изменились, сервер ответит 304 — квоту такой ответ не тратит.