Friends Data API独立数据服务

DATASET · market

A 股概念板块日行情

market.cn_concept_daily
A 股价格与行情

记录 A 股概念板块每日开高低收、成交量、成交额和涨跌幅,用于比较主题板块强弱;一行由 concept_code、trade_date、source 定位,主要字段包括 open、high、low、close、pre_close。

字段28
关键字段3
更新口径daily
时间列trade_date
单页上限5000
分页Cursor
PIT不支持
规模100K-999K

WHAT IT ANSWERS

这张表适合回答什么

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

GRAIN & TIME

一行代表什么

业务粒度
每行代表“A 股概念板块日行情”的一条记录;逻辑粒度由 concept_code × trade_date × source 共同确定。
时间口径
以 trade_date 为主要查询时间轴;除下方限制特别说明外,时间戳按 UTC、日期按来源市场日历解释。
更新节奏
通常按交易日或自然日更新;具体最新日期请以返回数据为准。

KEY FIELDS

先看这些字段

concept_code
用于确定该表业务粒度或默认顺序的 concept code 字段。
trade_date
对应市场日历中的交易日。
source
标准化数据来源;同一业务键可能因来源不同而有多行。

RECOMMENDED JOINS

怎样和其他表关联

ref.calendaron market + trade_date(有 market 时)

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

HOW TO QUERY SAFELY

查询方法与已知限制

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

MACHINE CONTRACT

筛选、排序与分页

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

可用 filters

market→ market · string
provider→ provider · string
source→ source · 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/cn_concept_daily/rows?limit=100&market=CN"

FIELD DICTIONARY

28 个返回字段

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

#字段ClickHouse 类型JSON可空角色说明
1concept_codeStringstringnodefault_order, warehouse_primary_key, contract_unique_keySource-normalized field: concept code.名称推导
2trade_datedateDatestring / datenotime, filter, default_order, warehouse_primary_key, contract_unique_keyTrading-session date in the dataset's market calendar.标准术语表
3openNullable(Float64)numberyesvalueOpening price for the represented interval.标准术语表
4highNullable(Float64)numberyesvalueHighest price for the represented interval.标准术语表
5lowNullable(Float64)numberyesvalueLowest price for the represented interval.标准术语表
6closeNullable(Float64)numberyesvalueClosing or last price for the represented interval.标准术语表
7pre_closeNullable(Float64)numberyesvalueSource-normalized field: pre close.名称推导
8avg_priceNullable(Float64)numberyesvaluePrice value for avg price.名称推导
9changeNullable(Float64)numberyesvalueSource-normalized field: change.名称推导
10pct_changeNullable(Float64)numberyesvalueSource-normalized field: pct change.名称推导
11volNullable(Float64)numberyesvalueSource-normalized field: vol.名称推导
12turnover_rateNullable(Float64)numberyesvalueSource-normalized field: turnover rate.名称推导
13total_mvNullable(Float64)numberyesvalueSource-normalized field: total mv.名称推导
14float_mvNullable(Float64)numberyesvalueSource-normalized field: float mv.名称推导
15marketLowCardinality(String)stringnofilterCanonical market or country-market code.标准术语表
16sourceLowCardinality(String)stringnofilter, default_order, warehouse_primary_key, contract_unique_key, provenanceNormalized upstream source identifier.标准术语表
17ingest_run_idStringstringnoprovenanceIdentifier of the ingestion run that produced the row.标准术语表
18versionUInt64integernoprovenanceMonotonic row version used for correction-aware reads.标准术语表
19is_deletedUInt8integernovalueSoft-delete marker; public serving excludes current tombstones.标准术语表
20ingested_atUTC_datetimeDateTime64(3, 'UTC')string / date-timenoprovenanceUTC timestamp when the source record entered the warehouse.标准术语表
21providerLowCardinality(String)stringnofilter, provenanceUpstream data provider identifier.标准术语表
22source_urlStringstringnoprovenanceURL of the upstream evidence or record when distributable.标准术语表
23source_record_idStringstringnoprovenanceProvider-side identifier for the source record.标准术语表
24raw_payload_hashStringstringnoprovenanceOpaque fingerprint of the normalized source payload for provenance checks.标准术语表
25parser_versionLowCardinality(String)stringnoprovenanceVersion of the parser or normalizer that produced the row.标准术语表
26quality_statusLowCardinality(String)stringnoprovenanceMachine-readable data-quality classification.标准术语表
27license_scopeLowCardinality(String)stringnoprovenanceLicense or redistribution scope attached to the row.标准术语表
28visibility_tierLowCardinality(String)stringnoprovenanceServing visibility tier attached to the row.标准术语表
字典口径

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