Friends Data API独立数据服务

DATASET · market

含退市证券的日线行情

market.ohlcv_1d_survivorship
价格与行情

这是价格、成交、报价与衍生品行情中的“含退市证券的日线行情”数据集;一行由 trade_date、instrument_id 定位,主要字段包括 market、open、high、low、close。

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

WHAT IT ANSWERS

这张表适合回答什么

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

GRAIN & TIME

一行代表什么

业务粒度
每行代表“含退市证券的日线行情”的一条记录;逻辑粒度由 trade_date × instrument_id 共同确定。
时间口径
以 trade_date 为主要查询时间轴;除下方限制特别说明外,时间戳按 UTC、日期按来源市场日历解释。
更新节奏
由对应生产任务或事件触发更新,不承诺固定日历频率;查询前先检查最新时间。

KEY FIELDS

先看这些字段

trade_date
对应市场日历中的交易日。
instrument_id
WarrenHub 统一证券标识;跨证券数据集优先用它联接。

RECOMMENDED JOINS

怎样和其他表关联

ref.instrumenton instrument_id

用 instrument_id 补充证券代码、名称、市场、交易所和资产类型。

ref.calendaron market + trade_date(有 market 时)

需要计算交易日偏移时联接交易日历;无 market 字段时先确定适用市场。

HOW TO QUERY SAFELY

查询方法与已知限制

先用 catalog 确认当前契约;可按 catalog 中列出的 filters 进一步缩小范围;单页最多 5000 行,响应有 has_more 时原样传回 next_cursor 继续分页。

MACHINE CONTRACT

筛选、排序与分页

UNVERSIONED
默认排序
trade_date, instrument_id
唯一键
—
读取模式
relation_default
最大时间窗
未单独限制

可用 filters

instrument_id→ instrument_id · integer
market→ market · string
trade_date→ trade_date · 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/ohlcv_1d_survivorship/rows?limit=100&instrument_id=1"

FIELD DICTIONARY

12 个返回字段

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

#字段ClickHouse 类型JSON可空角色说明
1instrument_idUInt64integernofilter, default_orderWarrenHub canonical instrument identifier; use it for cross-dataset joins.标准术语表
2marketStringstringnofilterCanonical market or country-market code.标准术语表
3trade_datedateDatestring / datenotime, filter, default_orderTrading-session date in the dataset's market calendar.标准术语表
4openFloat64numbernovalueOpening price for the represented interval.标准术语表
5highFloat64numbernovalueHighest price for the represented interval.标准术语表
6lowFloat64numbernovalueLowest price for the represented interval.标准术语表
7closeFloat64numbernovalueClosing or last price for the represented interval.标准术语表
8volumeUInt64integernovalueTraded volume for the represented interval.标准术语表
9adjusted_closeFloat64numbernovalueSource-normalized field: adjusted close.名称推导
10vwapFloat64numbernovalueVolume-weighted average price for the represented interval.标准术语表
11n_tradesUInt64integernovalueCount of trades.名称推导
12asof_tsUTC_datetimeDateTime64(9, 'UTC')string / date-timenovalueUTC timestamp at which the observation is considered current.标准术语表
字典口径

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