【API 教程（三）】获取公共数据：新手也能读懂的实战指南

为什么“公共数据”是黑客马拉松中的第一生产力

无论你是量化交易员、数据分析师，还是 Web3 创业者，公共数据就是燃料。最新成交价、指数价格、标记价格这些词经常一起出现，却没人一次说清楚它们的差异。本文把它掰开揉碎，结合 API 给你一套“拿来即用”的代码模板，短时间搭出高可用的数据流。

核心关键词：API、公共数据、最新成交价、指数价格、标记价格、量化交易、K线、策略交易

三种价格的秘密：最新成交价、指数价格、标记价格

1. 最新成交价

含义：盘口最后一笔撮合成交的价格，直观但噪声大。
出现位置：交易界面最显眼的“价格”处，有不停弹跳的数字提示。

API 拿到的样子

{
  "trade_id": 123456,
  "price": "56132.5",
  "size": "0.14"
}

用处：高频策略需要毫秒级粒度成交明细时，必须订阅该字段。

2. 指数价格

含义：以多家主流交易所现货深度加权得到，充当“公允价”。
权重因子：通常是 50% binance + 30% coinbase + 20% kraken，每 5 分钟重算。

API 字段示例

{
  "instId": "BTC-USDT",
  "idxPx": "56120.8"
}

作用：所有自动减仓、分摊计算依据 指数价格，不是 最新成交价，防止插针。

3. 标记价格

含义：标记价格 = 指数价格 + 资金费用基差，永续合约用它清算。
资金费用因素：当市场连续溢价，正的资金费率不断抬高 标记价格，牵引资金借贷。

代码片段：快速获得标记价格

GET /api/v5/public/mark-price?instId=BTC-USDT-SWAP

{ "markPx": "56125.0", "ts": "1712301234567" }

手把手：用公共数据爬出一条分析链条

Step 1 订阅 Tick

import websocket, json, pprint

def on_message(ws, msg):
    tick = json.loads(msg)['data'][0]
    pprint({
        "last": tick['last'],
        "idxPx": tick['idxPx'],
        "markPx": tick['markPx']
    })

ws = websocket.WebSocketApp(
    "wss://ws.okx.com:8443/ws/v5/public",
    on_message=on_message
)
ws.send('{"op":"subscribe","args":[{"channel":"tickers","instId":"BTC-USDT-SWAP"}]}')
ws.run_forever()

把 tick['last']、tick['markPx']、tick['idxPx'] 写进本地 时序数据库，过期的 K 线映射一目了然。

Step 2 把公共数据丢进实盘引擎

策略A：当 |最新成交价 - 标记价格| > 0.5% 就做套利，多空各开一手，根据资金费率 $r$ 平仓。
策略B：马丁格尔 补仓策略，也依赖最新成交价，但止盈价以 指数价格 为准，防止 Overshoot。

👉 想调试实盘中如何不到 5 行代码注入止盈止损？点击一看就会！

Step 3 打通可视化

使用 plotly 在 Jupyter 中渲染：

import pandas as pd, plotly.graph_objects as go

df = pd.read_csv('btc_tickers.csv')
fig = go.Figure()
fig.add_trace(go.Scatter(x=df.ts, y=df.last, mode='lines', name='最新成交价'))
fig.add_trace(go.Scatter(x=df.ts, y=df.markPx, mode='lines', name='标记价格'))
fig.show()

场景案例：用公共数据模拟“头肩顶”逃顶

数据准备：拉取 BTC 4小时 K线，字段选 最高价、最低价、收盘价、指数价格。
形态识别：
- 高左肩 ≈ 56500 美金
- 头部 ≈ 57200 美金
- 右肩 ≈ 56100 美金
  颈线突破 指数价格 55800，触发全部长单清仓。
信号回测：用 public endpoints 跑 2023~2024 BTC 历史 K线，胜率 68%。

👉 5000 行 K线实时回测数据打包下载，直接上手！

FAQ：获取公共数据最常被问的 5 个问题

Q1：公共数据接口是否收费？
A：读取 tick、bar、订单薄快照都不收费，但频率有限制：200 次/2 秒/账号。

Q2：为何有时 最新成交价和指数价格 差距 > 2%？
A：当币安暂停充提导致现货深度骤降，指数权重对 binance 依然高，这时合约插针，套利资金已拉大差距。

Q3：如何一次性拉取 500 条 k线？
A：公共接口上限 300 条，使用分页 after 参数，循环两次即可。

Q4：标记价格多久更新一次？
A：现货永续合约，每 100 毫秒更新；杠杆现货则 1 秒，请到文档确认市场类型。

Q5：公共数据能否做杠杆？
A：不能。杠杆与仓位挂钩，需登录后的私有接口。公共数据只提供行情，不提供账户信息。

操场作业：下周把三大价格写进三行策略

首行：实时拉 最新成交价 做触发
次行：以 标记价格 设止损价位
末行：按 指数价格 ±1% 出货

把脚本挂在本地 24 小时跑，回头告诉我胜率与收益。

–END–