Рынок в 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 | Пампы и дампы на CEX | Trial, Start, Pro, Max |
/market/dex-dumps | Обвалы токенов на DEX | Pro, 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», поля — в документации.
| Параметр | Тип | Что делает |
|---|---|---|
exchange | string | Биржа; несколько — через запятую |
coin | string | Тикер монеты, например BTC |
min_spread | number | Минимальный спред по модулю, % |
| Поле | Тип | Что значит |
|---|---|---|
fair_price / last_price | number | Маркировочная цена и цена последней сделки |
spread_pct | number | Спред между ними, % |
fair_changes / last_changes | object | Изменение каждой цены, %: 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 % и больше в любую сторону. Все поля — в документации эндпоинта.
| Параметр | Тип | Что делает |
|---|---|---|
exchange | string | Биржа; несколько — через запятую |
coin | string | Тикер монеты |
min_change | number | Порог изменения цены по модулю, % |
| Поле | Тип | Что значит |
|---|---|---|
price | number | Текущая цена |
change_5s … change_1h | number | Изменение цены за интервал, % |
volume_24h | number | Объём за 24 часа, USD |
funding_pct | number или null | Ставка фандинга за период начисления, % |
contract / network | string или 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. Схема ответа — в документации.
| Параметр | Тип | Что делает |
|---|---|---|
chain | string | Сеть, например bsc |
min_liquidity | number | Минимальная ликвидность пула, USD |
| Поле | Тип | Что значит |
|---|---|---|
ts | int | Время события, unix-секунды |
price / liquidity_usd | number | Цена и ликвидность пула, USD |
market_cap | number или null | Капитализация, USD |
price_changes | object | Изменение цены, %: m5, h1, h6 и h24 |
listed_on_cex | boolean | Торгуется ли монета на CEX |
cex_spot / cex_futures | string[] | Биржи со спотом и фьючерсом монеты |
pool_url | string | Ссылка на пул |
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 открытого интереса», поля — в документации.
| Параметр | Тип | Что делает |
|---|---|---|
coin | string | Тикер монеты |
exchange | string | Биржа; несколько — через запятую |
| Поле | Тип | Что значит |
|---|---|---|
total.oi_usd / total.oi_tokens | number | Открытый интерес в долларах и в монетах |
total.avg_price | number | Средневзвешенная по объёму цена по биржам |
total.volume_24h | number | Объём за 24 часа, USD |
total.oi_change_5m/15m/30m/1h | number | Изменение OI за интервал, % |
total.price_change_5m/15m/30m/1h | number | Изменение цены за интервал, % |
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 вместе с ценой продолжения не обещает: перегретый рынок может развернуться каскадом ликвидаций.
Запросите весь срез
Один вызов без фильтров отдаёт все монеты.
Отсейте мелкие монеты
Задайте порог
total.oi_usd, например $5 000 000: на малом OI пара крупных позиций даёт большой процент.Примените условие
oi_change_1hбольше 5,price_change_1hбольше 0.Проверьте ширину движения
Посчитайте биржи в
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 сделайте два запроса или фильтруйте ответ у себя. Описание полей — в документации.
| Параметр | Тип | Что делает |
|---|---|---|
category | string | Оценка: alpha, high, middle, risky или noise |
coin | string | Тикер монеты |
| Поле | Тип | Что значит |
|---|---|---|
id | string | Идентификатор: по нему бот отсеивает повторы |
ts / time | int / string | Время: unix-секунды и ISO 8601 |
pipeline | string | Источник сигнала |
message_ru / message_en | string или null | Текст сигнала на русском и английском |
links | array | Готовые ссылки: 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_price | number или null | Цена спота и фьючерса; null — рынка нет |
exchanges{}.deposit / withdraw | boolean или null | Открыты ли ввод и вывод |
funding | object или 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 — квоту такой ответ не тратит.