Genesis Arbitrage

Genesis Arbitrage · · 阅读约 22 分钟

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/pumpsCEX 上的拉升与砸盘Trial、Start、Pro、Max
/market/dex-dumpsDEX 上的代币暴跌Pro、Max
/market/open-interest按交易所的持仓量Trial、Start、Pro、Max
/ai/signalsGenesis 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 指南,字段说明见文档。

参数类型作用
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 参数移到请求 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% 或以上的币种。全部字段见接口文档。

参数类型作用
exchangestring交易所;多个用逗号分隔
coinstring币种代码
min_changenumber价格变化绝对值阈值,%
字段类型含义
pricenumber当前价格
change_5s … change_1hnumber该区间内的价格变化,%
volume_24hnumber24 小时成交量,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 Dumps:/market/dex-dumps

Pro 和 Max 套餐。该接口返回 DEX 上的代币暴跌,与 DEX Dumps 板块一致,并附带资金池流动性,以及标明该代币是否在 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 Tracking:/market/open-interest

持仓量(OI)是已开立且尚未平仓的合约仓位总量。该接口返回的数据与 OI Tracking 表格一致:币种总量在 total 中,按交易所的明细在 exchanges 中。数据覆盖 13 家以上的合约交易所,包括 Binance、Bybit、OKX、Bitget 和 Gate。概览见 持仓量 API 一文,字段说明见文档。

参数类型作用
coinstring币种代码
exchangestring交易所;多个用逗号分隔
字段类型含义
total.oi_usd / total.oi_tokensnumber以美元和币数计的持仓量
total.avg_pricenumber各交易所的成交量加权平均价
total.volume_24hnumber24 小时成交量,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。两个字段本身已经是百分比。

一小时前币种 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 与价格同步上升并不保证趋势延续:过热的市场可能在连环强平中反转。

  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现成的链接:文本 + 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_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 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,且不消耗您的配额。