Genesis API 市场数据:Fair – Last、拉升、OI、AI 信号与搜索
简而言之
- 六个市场接口与网站一一对应:Fair – Last、CEX Pumps – Dumps、DEX Dumps、OI Tracking、Genesis AI+ 信号和币种搜索。除 DEX Dumps 外,其余从 Trial 套餐起即可使用。
- 价格和持仓量的变化以现成的百分比返回,区间从 5 秒到一小时,无需自己保存历史数据。
- Genesis API 只读取数据。它展示波动和异常,交易决策以及在交易所的下单仍由您自己完成。
Genesis API 市场接口返回的数据与网站上的 Fair – Last、CEX Pumps – Dumps、DEX Dumps 和 OI Tracking 板块相同,另有 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 |
基础 URL 为 https://api.genesisarbitrage.com/v1,套餐之外的接口会返回 403 plan_restricted。套餐还决定数据新鲜度:Trial 为 60 秒,Start 为 30 秒,Pro 为 10 秒,Max 为 5 秒。密钥和第一次请求见快速开始,配额见 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 参数移到请求 URL 中。响应是一个 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 Pumps – Dumps:/market/pumps
该接口对应 CEX Pumps – Dumps 表格:币种在交易所合约上的价格,以及八个区间的涨跌幅,字段为 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 Dumps:/market/dex-dumps
Pro 和 Max 套餐。该接口返回 DEX 上的代币暴跌,与 DEX Dumps 板块一致,并附带资金池流动性,以及标明该代币是否在 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 Tracking:/market/open-interest
持仓量(OI)是已开立且尚未平仓的合约仓位总量。该接口返回的数据与 OI Tracking 表格一致:币种总量在 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。两个字段本身已经是百分比。
一小时前币种 A 的 OI 为 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,1 小时 | 价格,1 小时 | 结果 |
|---|---|---|---|
| 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 | 现成的链接:文本 + 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
该接口返回币种卡片,与网站上的 Coin 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 Dumps 外的全部接口:该接口仅对 Pro 和 Max 开放,在 Trial 和 Start 上会返回 403 plan_restricted。
API 有持仓量历史数据吗?
没有:接口返回的是当前快照,包含 5、15、30 分钟和一小时的变化,Genesis API 没有历史 K 线。请自行保存响应来积累历史。
能通过这些接口下单吗?
不能。Genesis API 只读取数据,不会下单:交易需要您自己在交易所完成。
市场接口应该多久轮询一次?
不要比 meta.freshness_sec 更频繁:从 Trial 的 60 秒到 Max 的 5 秒。不带过滤条件的响应带有 ETag 头。把它放在 If-None-Match 中回传,只要数据没有变化,服务器就返回 304,且不消耗您的配额。