Friends Data API独立数据服务

DATASET · market

实时期权买卖流不平衡

market.rt_option_flow_imbalance
价格与行情期权与波动率

把实时期权成交聚合为主动买入、主动卖出、合约数和权利金不平衡,帮助判断方向性资金流;一行由 session_date、underlying、expiry、right 定位,主要字段包括 n_prints、total_contracts、buy_contracts、sell_contracts、unknown_contracts;交易时段持续更新。

字段17
关键字段4
更新口径producer_schedule
时间列—
单页上限5000
分页Cursor
PIT不支持
规模view

WHAT IT ANSWERS

这张表适合回答什么

  • 查询历史或盘中价格与成交
  • 构建行情、波动率和衍生品特征

GRAIN & TIME

一行代表什么

业务粒度
每行代表“实时期权买卖流不平衡”的一条记录;逻辑粒度由 session_date × underlying × expiry × right 共同确定。
时间口径
该表没有单一主时间列;请使用业务日期或版本字段,并按关键字段确定范围。
更新节奏
由对应生产任务或事件触发更新,不承诺固定日历频率;查询前先检查最新时间。

KEY FIELDS

先看这些字段

session_date
session date 对应的日历日期。
underlying
用于确定该表业务粒度或默认顺序的 underlying 字段。
expiry
用于确定该表业务粒度或默认顺序的 expiry 字段。
right
用于确定该表业务粒度或默认顺序的 right 字段。

RECOMMENDED JOINS

怎样和其他表关联

该表主要按自身业务键使用,目前没有推荐的跨表主键联接。

HOW TO QUERY SAFELY

查询方法与已知限制

先用 catalog 确认当前契约;必须提供 underlying;单页最多 5000 行,响应有 has_more 时原样传回 next_cursor 继续分页。

MACHINE CONTRACT

筛选、排序与分页

UNVERSIONED
默认排序
session_date, underlying, expiry, right
唯一键
session_date, underlying, expiry, right
读取模式
relation_default
最大时间窗
未单独限制

可用 filters

right→ right · string
underlying→ underlying · string · 必填

POINT IN TIME

可复现读取

NOT AVAILABLE

该资产没有 PIT 契约。普通 rows 端点仍按当前公开读模式返回数据;不要把它表述成历史时点快照。

COPY-READY CALLS

怎么调用

同一数据集可用 HTTP、Python SDK、CLI 或 MCP;Key 始终只通过环境变量/Bearer Header 传递。

READ ONLY
HTTP
curl --fail-with-body -H "Authorization: Bearer $FRIENDS_DATA_API_KEY" "https://api.alphahubs.uk/api/v1/data/datasets/market/rt_option_flow_imbalance/rows?limit=100&underlying=FILTER_VALUE"

FIELD DICTIONARY

17 个返回字段

descriptionSource 可在 JSON 中区分仓库注释、标准术语表和名称推导说明。

#字段ClickHouse 类型JSON可空角色说明
1underlyingLowCardinality(String)stringnofilter, required_filter, default_order, contract_unique_keySource-normalized field: underlying.名称推导
2expiryDatestring / datenodefault_order, contract_unique_keySource-normalized field: expiry.名称推导
3rightEnum8('C' = 1, 'P' = 2)stringnofilter, default_order, contract_unique_keySource-normalized field: right.名称推导
4session_datedateDatestring / datenodefault_order, contract_unique_keyCalendar date for session date (YYYY-MM-DD).名称推导
5n_printsUInt64integernovalueCount of prints.名称推导
6total_contractsUInt64integernovalueSource-normalized field: total contracts.名称推导
7buy_contractsUInt64integernovalueSource-normalized field: buy contracts.名称推导
8sell_contractsUInt64integernovalueSource-normalized field: sell contracts.名称推导
9unknown_contractsUInt64integernovalueSource-normalized field: unknown contracts.名称推导
10notional_premiumFloat64numbernovalueSource-normalized field: notional premium.名称推导
11sweep_contractsUInt64integernovalueSource-normalized field: sweep contracts.名称推导
12sweep_printsUInt64integernovalueSource-normalized field: sweep prints.名称推导
13block_contractsUInt64integernovalueSource-normalized field: block contracts.名称推导
14block_printsUInt64integernovalueSource-normalized field: block prints.名称推导
15net_buy_ratioratioNullable(Float64)numberyesvalueRatio value for net buy ratio.名称推导
16at_ask_buy_pressureNullable(Float64)numberyesvalueSource-normalized field: at ask buy pressure.名称推导
17classified_shareNullable(Float64)numberyesvalueSource-normalized field: classified share.名称推导
字典口径

结构来自 Friends 只读身份可见的真实 serving relation;权限、过滤、排序、PIT 与分页来自可执行 DatasetSpec。Schema observed at 2026-10-06T18:08:52Z。