Friends Data API独立数据服务

DATASET · market

实时期权成交量与持仓量对比

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

对比期权合约盘中成交量和前一日持仓量,并拆分买卖方向,识别新开仓活跃度;一行由 session_date、underlying、expiry、strike 定位,主要字段包括 right、option_symbol、intraday_volume、intraday_prints、intraday_buy_contracts;交易时段持续更新。

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

WHAT IT ANSWERS

这张表适合回答什么

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

GRAIN & TIME

一行代表什么

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

KEY FIELDS

先看这些字段

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

RECOMMENDED JOINS

怎样和其他表关联

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

HOW TO QUERY SAFELY

查询方法与已知限制

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

MACHINE CONTRACT

筛选、排序与分页

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

可用 filters

option_symbol→ option_symbol · string
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_vol_vs_oi/rows?limit=100&underlying=FILTER_VALUE"

FIELD DICTIONARY

12 个返回字段

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.名称推导
3strikeFloat64numbernodefault_order, contract_unique_keySource-normalized field: strike.名称推导
4rightEnum8('C' = 1, 'P' = 2)stringnofilter, default_order, contract_unique_keySource-normalized field: right.名称推导
5option_symbolStringstringnofilterSource-normalized field: option symbol.名称推导
6session_datedateDatestring / datenodefault_order, contract_unique_keyCalendar date for session date (YYYY-MM-DD).名称推导
7intraday_volumeUInt64integernovalueQuantity for intraday volume.名称推导
8intraday_printsUInt64integernovalueSource-normalized field: intraday prints.名称推导
9intraday_buy_contractsUInt64integernovalueSource-normalized field: intraday buy contracts.名称推导
10prior_oiNullable(UInt64)integeryesvalueSource-normalized field: prior oi.名称推导
11oi_as_ofNullable(Date)string / dateyesvalueSource-normalized field: oi as of.名称推导
12vol_oi_ratioratioNullable(Float64)numberyesvalueRatio value for vol oi ratio.名称推导
字典口径

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