Friends Data API独立数据服务

DATASET · market

日内 K 线行情

market.ohlcv_intraday
盘中与逐笔价格与行情

按证券、时间戳和 interval 保存日内 OHLCV,支持盘中走势、微观波动和事件即时反应研究。

字段23
关键字段3
更新口径intraday
时间列ts
单页上限5000
分页Cursor
PIT不支持
规模1M-9M

WHAT IT ANSWERS

这张表适合回答什么

  • 查询分钟级价格路径
  • 计算盘中波动与成交量
  • 对齐新闻事件做短窗分析

GRAIN & TIME

一行代表什么

业务粒度
每行代表“日内 K 线行情”的一条记录;逻辑粒度由 instrument_id × ts × interval 共同确定。
时间口径
以 ts 为主要查询时间轴;除下方限制特别说明外,时间戳按 UTC、日期按来源市场日历解释。
更新节奏
交易时段内可多次更新;请检查时间列判断新鲜度。

KEY FIELDS

先看这些字段

instrument_id
WarrenHub 统一证券标识;跨证券数据集优先用它联接。
ts
该观测或行情区间的时间戳,除表内特别说明外为 UTC。
interval
行情或统计的聚合时间间隔。

RECOMMENDED JOINS

怎样和其他表关联

ref.instrumenton instrument_id

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

HOW TO QUERY SAFELY

查询方法与已知限制

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

MACHINE CONTRACT

筛选、排序与分页

UNVERSIONED
默认排序
instrument_id, interval, ts
唯一键
instrument_id, interval, ts
读取模式
canonical_final_active
最大时间窗
31 天

可用 filters

instrument_id→ instrument_id · integer · 必填
interval→ interval · string
source→ source · 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_intraday/rows?limit=100&instrument_id=1"

FIELD DICTIONARY

23 个返回字段

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

#字段ClickHouse 类型JSON可空角色说明
1instrument_idUInt64integernofilter, required_filter, default_order, warehouse_primary_key, contract_unique_keyWarrenHub canonical instrument identifier; use it for cross-dataset joins.标准术语表
2tsUTC_datetimeDateTime64(3, 'UTC')string / date-timenotime, default_order, warehouse_primary_key, contract_unique_keyUTC timestamp of the observation or market-data interval.标准术语表
3intervalLowCardinality(String)stringnofilter, default_order, warehouse_primary_key, contract_unique_keyAggregation or sampling interval.标准术语表
4openNullable(Float64)numberyesvalueOpening price for the represented interval.标准术语表
5highNullable(Float64)numberyesvalueHighest price for the represented interval.标准术语表
6lowNullable(Float64)numberyesvalueLowest price for the represented interval.标准术语表
7closeNullable(Float64)numberyesvalueClosing or last price for the represented interval.标准术语表
8volumeNullable(Float64)numberyesvalueTraded volume for the represented interval.标准术语表
9asof_tsUTC_datetimeDateTime64(3, 'UTC')string / date-timenovalueUTC timestamp at which the observation is considered current.标准术语表
10sourceLowCardinality(String)stringnofilter, provenanceNormalized upstream source identifier.标准术语表
11providerLowCardinality(String)stringnoprovenanceUpstream data provider identifier.标准术语表
12source_urlStringstringnoprovenanceURL of the upstream evidence or record when distributable.标准术语表
13source_record_idStringstringnoprovenanceProvider-side identifier for the source record.标准术语表
14raw_payload_hashStringstringnoprovenanceOpaque fingerprint of the normalized source payload for provenance checks.标准术语表
15parser_versionLowCardinality(String)stringnoprovenanceVersion of the parser or normalizer that produced the row.标准术语表
16quality_statusLowCardinality(String)stringnoprovenanceMachine-readable data-quality classification.标准术语表
17license_scopeLowCardinality(String)stringnoprovenanceLicense or redistribution scope attached to the row.标准术语表
18visibility_tierLowCardinality(String)stringnoprovenanceServing visibility tier attached to the row.标准术语表
19ingest_run_idStringstringnoprovenanceIdentifier of the ingestion run that produced the row.标准术语表
20versionUInt64integernoprovenanceMonotonic row version used for correction-aware reads.标准术语表
21is_deletedUInt8integernovalueSoft-delete marker; public serving excludes current tombstones.标准术语表
22created_atUTC_datetimeDateTime64(3, 'UTC')string / date-timenovalueUTC timestamp when the warehouse row was first created.标准术语表
23updated_atUTC_datetimeDateTime64(3, 'UTC')string / date-timenovalueUTC timestamp when the warehouse row was last updated.标准术语表
字典口径

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