SSPARKDATA
返回首页中文 / EN

面向 Agent 的公开市场数据契约

让你的 Agent直接读懂市场。

这里只展示客户可调用的行情、证券资料与 Agent 数据能力。每个参数、响应模式和数据对象都由当前 OpenAPI 契约生成。

浏览公开接口↓下载 OpenAPI YAML↗

发出第一条可信行情请求

使用领取到的租户 API Key 完成 Bearer 认证；响应会同时返回来源、缓存状态与生成时间。

curl --request GET \
+  'https://spark-data.cn/v1/market-data/quotes/latest?symbols=XSHG%3A600570' \
+  --header 'Authorization: Bearer $SPARKDATA_API_KEY'
Authorization: Bearer $SPARKDATA_API_KEY
公开操作
43
公开路径
30
公开对象
67
OPENAPI
3.1

证券资料Instruments

规范化的股票、ETF 与指数主数据资源。

1 个接口
GET/v1/instruments/{instrument_id}获取规范化股票、ETF 或指数资料
操作 ID
getInstrument
认证
租户 API Key

参数

instrument_idpath
InstrumentId必填

—示例: XSHG:600570

响应

200

已找到证券

application/json · InstrumentResponse
400

请求无效

application/problem+json · Problem
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
404

资源不存在

application/problem+json · Problem
429

租户 API Key 已超过速率限制

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request GET \
  'https://spark-data.cn/v1/instruments/XSHG:600570' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY'

行情数据Market Data

带缓存的最新行情、K 线与尽力而为的行情流。

3 个接口
GET/v1/market-data/bars查询股票、ETF 或指数的完整周期 OHLCV K 线

start 为闭区间，end 为开区间，默认返回 JSON。发送 Accept: application/x-ndjson 时，每行返回一根 K 线，最后附带 stream_end 控制记录。日内 K 线由数据源累计行情快照采样生成并标记为 snapshot_derived；日线来自数据源 OHLCV，ETF 与指数长周期由真实日线聚合并标记为 daily_derived。

操作 ID
listBars
认证
租户 API Key

参数

symbolsquery
InstrumentId[]必填

逗号分隔的规范证券 ID，数量受租户限额约束。示例: ["XSHG:600570","XSHE:000001"]

startquery
string<date-time>必填

UTC 闭区间起始时间。

endquery
string<date-time>必填

UTC 开区间结束时间，范围受租户限额约束。

timeframequery
BarTimeframe可选

—

adjustmentquery
raw | forward | backward可选

ETF 与指数 K 线只接受 raw。示例: raw

feedquery
auto | realtime | delayed可选已弃用

兼容性路由提示；当前部署的数据源提供一个 feed。示例: auto

sortquery
asc | desc可选

—示例: asc

响应

200

K 线 JSON 或 NDJSON 数据流

application/json · BarsResponse / application/x-ndjson · BarStreamRecord
400

请求无效

application/problem+json · Problem
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
404

资源不存在

application/problem+json · Problem
429

租户 API Key 已超过速率限制

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request GET \
  'https://spark-data.cn/v1/market-data/bars?symbols=XSHG%3A600570%2CXSHE%3A000001&start=2026-07-01T00%3A00%3A00Z&end=2026-08-01T00%3A00%3A00Z' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY'
GET/v1/market-data/quotes/latest获取多只股票、ETF 或指数的最新行情
操作 ID
getLatestQuotes
认证
租户 API Key

参数

symbolsquery
InstrumentId[]必填

逗号分隔的规范证券 ID，数量受租户限额约束。示例: ["XSHG:600570","XSHE:000001"]

feedquery
auto | realtime | delayed可选已弃用

兼容性路由提示；当前部署的数据源提供一个 feed。示例: auto

响应

200

最新行情

application/json · QuotesResponse
400

请求无效

application/problem+json · Problem
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
404

资源不存在

application/problem+json · Problem
429

租户 API Key 已超过速率限制

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request GET \
  'https://spark-data.cn/v1/market-data/quotes/latest?symbols=XSHG%3A600570%2CXSHE%3A000001' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY'
GET/v1/market-data/stream通过 SSE 推送尽力而为的最新行情

推送 quote、heartbeat 与 reconnect 事件。当前版本不提供持久化和回放，新连接从当前行情开始。常规 OpenAPI HTTP operation 已同时描述请求与单向 SSE 响应，因此无需单独维护 AsyncAPI 契约。

操作 ID
streamMarketData
认证
租户 API Key

参数

symbolsquery
InstrumentId[]必填

逗号分隔的规范证券 ID，数量受租户限额约束。示例: ["XSHG:600570","XSHE:000001"]

feedquery
auto | realtime | delayed可选已弃用

兼容性路由提示；当前部署的数据源提供一个 feed。示例: auto

heartbeat_secondsquery
integer可选

—示例: 20

响应

200

SSE 行情流

text/event-stream · MarketEvent
400

请求无效

application/problem+json · Problem
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
404

资源不存在

application/problem+json · Problem
429

租户 API Key 已超过速率限制

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request GET \
  'https://spark-data.cn/v1/market-data/stream?symbols=XSHG%3A600570%2CXSHE%3A000001' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY'

Agent 上下文Agent Context

由可复用缓存资源组装的 Agent 复合视图。

1 个接口
GET/v1/agent/context/{instrument_id}获取单只股票、ETF 或指数的完整缓存上下文

在一个适合 Agent 使用的响应中组合证券身份、最新行情与指定 K 线。接口不会创建单体缓存，而是复用规范化的单证券行情缓存和按时间分片的 K 线缓存，因此不同用户的重叠请求可以共享命中。省略 start 与 end 时，返回最多最近 365 个自然日的数据，并受租户 K 线范围限制；覆盖默认范围时两个时间参数必须同时提供。规范字段旁会原样保留数据源字段。

操作 ID
getAgentContext
认证
租户 API Key

参数

instrument_idpath
InstrumentId必填

—示例: XSHG:600570

startquery
string<date-time>可选

UTC 闭区间起始时间，必须与 end 同时提供。

endquery
string<date-time>可选

UTC 开区间结束时间，必须与 start 同时提供。

timeframequery
BarTimeframe可选

—

adjustmentquery
raw | forward | backward可选

ETF 与指数 K 线只接受 raw。示例: raw

sortquery
asc | desc可选

—示例: asc

响应

200

由可复用缓存资源组装的 Agent 上下文

application/json · AgentContextResponse
400

请求无效

application/problem+json · Problem
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
404

资源不存在

application/problem+json · Problem
429

租户 API Key 已超过速率限制

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request GET \
  'https://spark-data.cn/v1/agent/context/XSHG:600570' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY'

聚合数据Aggregate Data

九个面向 Agent 的能力接口，覆盖公开目录中的全部 371 个 operation。

18 个接口
GET/v1/discovery列出发现与筛选 operation 的精确契约
操作 ID
describeDiscovery
认证
租户 API Key

参数

operationquery
string可选

区分大小写的 operation 名称；省略时列出该能力下的全部 operation。

响应

200

所选能力下由工作簿生成的精确契约

application/json · OperationContractsResponse
400

请求无效

application/problem+json · Problem
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
429

租户 API Key 已超过速率限制

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request GET \
  'https://spark-data.cn/v1/discovery' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY'
POST/v1/discovery调用发现或筛选 operation
操作 ID
queryDiscovery
认证
租户 API Key

参数

此操作没有参数。

请求体

operation 必须属于公开目录中分配给该能力的 operation；parameters 必须使用准确的契约字段名。枚举参数可传字典 code、caption、reference code 或 A 股规范 ID，SparkData 会解析并校验实际发送给上游的 code。

application/json · AggregateQuery

响应

200

完整上游响应、已解析枚举输入与缓存元数据

application/json · AggregateResponse
400

请求无效

application/problem+json · Problem
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
429

租户 API Key 已超过速率限制

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request POST \
  'https://spark-data.cn/v1/discovery' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"operation":"operation_code","params":{}}'
GET/v1/entities列出实体资料 operation 的精确契约
操作 ID
describeEntities
认证
租户 API Key

参数

operationquery
string可选

区分大小写的 operation 名称；省略时列出该能力下的全部 operation。

响应

200

所选能力下由工作簿生成的精确契约

application/json · OperationContractsResponse
400

请求无效

application/problem+json · Problem
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
429

租户 API Key 已超过速率限制

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request GET \
  'https://spark-data.cn/v1/entities' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY'
POST/v1/entities调用实体或参考数据 operation
操作 ID
queryEntities
认证
租户 API Key

参数

此操作没有参数。

请求体

operation 必须属于公开目录中分配给该能力的 operation；parameters 必须使用准确的契约字段名。枚举参数可传字典 code、caption、reference code 或 A 股规范 ID，SparkData 会解析并校验实际发送给上游的 code。

application/json · AggregateQuery

响应

200

完整上游响应、已解析枚举输入与缓存元数据

application/json · AggregateResponse
400

请求无效

application/problem+json · Problem
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
429

租户 API Key 已超过速率限制

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request POST \
  'https://spark-data.cn/v1/entities' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"operation":"operation_code","params":{}}'
GET/v1/market-data列出行情 operation 的精确契约
操作 ID
describeMarketData
认证
租户 API Key

参数

operationquery
string可选

区分大小写的 operation 名称；省略时列出该能力下的全部 operation。

响应

200

所选能力下由工作簿生成的精确契约

application/json · OperationContractsResponse
400

请求无效

application/problem+json · Problem
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
429

租户 API Key 已超过速率限制

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request GET \
  'https://spark-data.cn/v1/market-data' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY'
POST/v1/market-data调用统一行情 operation
操作 ID
queryMarketData
认证
租户 API Key

参数

此操作没有参数。

请求体

operation 必须属于公开目录中分配给该能力的 operation；parameters 必须使用准确的契约字段名。枚举参数可传字典 code、caption、reference code 或 A 股规范 ID，SparkData 会解析并校验实际发送给上游的 code。

application/json · AggregateQuery

响应

200

完整上游响应、已解析枚举输入与缓存元数据

application/json · AggregateResponse
400

请求无效

application/problem+json · Problem
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
429

租户 API Key 已超过速率限制

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request POST \
  'https://spark-data.cn/v1/market-data' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"operation":"operation_code","params":{}}'
GET/v1/fundamentals列出基本面 operation 的精确契约
操作 ID
describeFundamentals
认证
租户 API Key

参数

operationquery
string可选

区分大小写的 operation 名称；省略时列出该能力下的全部 operation。

响应

200

所选能力下由工作簿生成的精确契约

application/json · OperationContractsResponse
400

请求无效

application/problem+json · Problem
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
429

租户 API Key 已超过速率限制

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request GET \
  'https://spark-data.cn/v1/fundamentals' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY'
POST/v1/fundamentals调用基本面或预测 operation
操作 ID
queryFundamentals
认证
租户 API Key

参数

此操作没有参数。

请求体

operation 必须属于公开目录中分配给该能力的 operation；parameters 必须使用准确的契约字段名。枚举参数可传字典 code、caption、reference code 或 A 股规范 ID，SparkData 会解析并校验实际发送给上游的 code。

application/json · AggregateQuery

响应

200

完整上游响应、已解析枚举输入与缓存元数据

application/json · AggregateResponse
400

请求无效

application/problem+json · Problem
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
429

租户 API Key 已超过速率限制

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request POST \
  'https://spark-data.cn/v1/fundamentals' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"operation":"operation_code","params":{}}'
GET/v1/ownership列出股权与持仓 operation 的精确契约
操作 ID
describeOwnership
认证
租户 API Key

参数

operationquery
string可选

区分大小写的 operation 名称；省略时列出该能力下的全部 operation。

响应

200

所选能力下由工作簿生成的精确契约

application/json · OperationContractsResponse
400

请求无效

application/problem+json · Problem
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
429

租户 API Key 已超过速率限制

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request GET \
  'https://spark-data.cn/v1/ownership' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY'
POST/v1/ownership调用股权或组合 operation
操作 ID
queryOwnership
认证
租户 API Key

参数

此操作没有参数。

请求体

operation 必须属于公开目录中分配给该能力的 operation；parameters 必须使用准确的契约字段名。枚举参数可传字典 code、caption、reference code 或 A 股规范 ID，SparkData 会解析并校验实际发送给上游的 code。

application/json · AggregateQuery

响应

200

完整上游响应、已解析枚举输入与缓存元数据

application/json · AggregateResponse
400

请求无效

application/problem+json · Problem
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
429

租户 API Key 已超过速率限制

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request POST \
  'https://spark-data.cn/v1/ownership' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"operation":"operation_code","params":{}}'
GET/v1/events列出事件与风险 operation 的精确契约
操作 ID
describeEvents
认证
租户 API Key

参数

operationquery
string可选

区分大小写的 operation 名称；省略时列出该能力下的全部 operation。

响应

200

所选能力下由工作簿生成的精确契约

application/json · OperationContractsResponse
400

请求无效

application/problem+json · Problem
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
429

租户 API Key 已超过速率限制

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request GET \
  'https://spark-data.cn/v1/events' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY'
POST/v1/events调用事件、公司行动或风险 operation
操作 ID
queryEvents
认证
租户 API Key

参数

此操作没有参数。

请求体

operation 必须属于公开目录中分配给该能力的 operation；parameters 必须使用准确的契约字段名。枚举参数可传字典 code、caption、reference code 或 A 股规范 ID，SparkData 会解析并校验实际发送给上游的 code。

application/json · AggregateQuery

响应

200

完整上游响应、已解析枚举输入与缓存元数据

application/json · AggregateResponse
400

请求无效

application/problem+json · Problem
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
429

租户 API Key 已超过速率限制

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request POST \
  'https://spark-data.cn/v1/events' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"operation":"operation_code","params":{}}'
GET/v1/analytics列出分析 operation 的精确契约
操作 ID
describeAnalytics
认证
租户 API Key

参数

operationquery
string可选

区分大小写的 operation 名称；省略时列出该能力下的全部 operation。

响应

200

所选能力下由工作簿生成的精确契约

application/json · OperationContractsResponse
400

请求无效

application/problem+json · Problem
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
429

租户 API Key 已超过速率限制

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request GET \
  'https://spark-data.cn/v1/analytics' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY'
POST/v1/analytics调用分析、估值或排行 operation
操作 ID
queryAnalytics
认证
租户 API Key

参数

此操作没有参数。

请求体

operation 必须属于公开目录中分配给该能力的 operation；parameters 必须使用准确的契约字段名。枚举参数可传字典 code、caption、reference code 或 A 股规范 ID，SparkData 会解析并校验实际发送给上游的 code。

application/json · AggregateQuery

响应

200

完整上游响应、已解析枚举输入与缓存元数据

application/json · AggregateResponse
400

请求无效

application/problem+json · Problem
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
429

租户 API Key 已超过速率限制

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request POST \
  'https://spark-data.cn/v1/analytics' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"operation":"operation_code","params":{}}'
GET/v1/economy列出宏观经济 operation 的精确契约
操作 ID
describeEconomy
认证
租户 API Key

参数

operationquery
string可选

区分大小写的 operation 名称；省略时列出该能力下的全部 operation。

响应

200

所选能力下由工作簿生成的精确契约

application/json · OperationContractsResponse
400

请求无效

application/problem+json · Problem
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
429

租户 API Key 已超过速率限制

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request GET \
  'https://spark-data.cn/v1/economy' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY'
POST/v1/economy调用宏观、区域或行业经济 operation
操作 ID
queryEconomy
认证
租户 API Key

参数

此操作没有参数。

请求体

operation 必须属于公开目录中分配给该能力的 operation；parameters 必须使用准确的契约字段名。枚举参数可传字典 code、caption、reference code 或 A 股规范 ID，SparkData 会解析并校验实际发送给上游的 code。

application/json · AggregateQuery

响应

200

完整上游响应、已解析枚举输入与缓存元数据

application/json · AggregateResponse
400

请求无效

application/problem+json · Problem
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
429

租户 API Key 已超过速率限制

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request POST \
  'https://spark-data.cn/v1/economy' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"operation":"operation_code","params":{}}'
GET/v1/content列出内容 operation 的精确契约
操作 ID
describeContent
认证
租户 API Key

参数

operationquery
string可选

区分大小写的 operation 名称；省略时列出该能力下的全部 operation。

响应

200

所选能力下由工作簿生成的精确契约

application/json · OperationContractsResponse
400

请求无效

application/problem+json · Problem
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
429

租户 API Key 已超过速率限制

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request GET \
  'https://spark-data.cn/v1/content' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY'
POST/v1/content调用研报、公告、新闻或政策 operation
操作 ID
queryContent
认证
租户 API Key

参数

此操作没有参数。

请求体

operation 必须属于公开目录中分配给该能力的 operation；parameters 必须使用准确的契约字段名。枚举参数可传字典 code、caption、reference code 或 A 股规范 ID，SparkData 会解析并校验实际发送给上游的 code。

application/json · AggregateQuery

响应

200

完整上游响应、已解析枚举输入与缓存元数据

application/json · AggregateResponse
400

请求无效

application/problem+json · Problem
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
429

租户 API Key 已超过速率限制

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request POST \
  'https://spark-data.cn/v1/content' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"operation":"operation_code","params":{}}'

数据目录Data Catalog

稳定数据集分组与观测型 readiness，不推断未知许可或水位线。

3 个接口
GET/v1/datasets列出覆盖全部 371 个 operation 的稳定数据集目录
操作 ID
listDatasets
认证
租户 API Key

参数

此操作没有参数。

响应

200

数据集目录

application/json · DatasetsResponse
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
429

租户 API Key 已超过速率限制

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request GET \
  'https://spark-data.cn/v1/datasets' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY'
GET/v1/datasets/{dataset_id}获取一个数据集及其全部 operation
操作 ID
getDataset
认证
租户 API Key

参数

dataset_idpath
cn-equity | funds | bonds | indices | classifications | wealth-products | hk-equity | us-equity | neeq | macro-research | announcements | news-policy | business-risk | smart-screening必填

—

响应

200

数据集详情

application/json · DatasetDetailResponse
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
404

资源不存在

application/problem+json · Problem
429

租户 API Key 已超过速率限制

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request GET \
  'https://spark-data.cn/v1/datasets/cn-equity' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY'
GET/v1/data-readiness获取不补造覆盖率、许可或水位线的数据就绪状态
操作 ID
getDataReadiness
认证
租户 API Key

参数

此操作没有参数。

响应

200

观测型数据目录就绪状态

application/json · DataReadinessResponse
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
429

租户 API Key 已超过速率限制

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request GET \
  'https://spark-data.cn/v1/data-readiness' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY'

研究Research

已发布研究模板和租户实验元数据，不提供托管执行。

5 个接口
GET/v1/research/templates列出六个证据型研究模板
操作 ID
listResearchTemplates
认证
租户 API Key

参数

此操作没有参数。

响应

200

已发布研究模板

application/json · ResearchTemplatesResponse
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
429

租户 API Key 已超过速率限制

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request GET \
  'https://spark-data.cn/v1/research/templates' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY'
GET/v1/experiment-runs列出租户实验追踪记录
操作 ID
listExperimentRuns
认证
租户 API Key

参数

此操作没有参数。

响应

200

实验记录列表

application/json · ExperimentRunsResponse
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
429

租户 API Key 已超过速率限制

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request GET \
  'https://spark-data.cn/v1/experiment-runs' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY'
POST/v1/experiment-runs登记计划中的研究或因子实验，但不触发执行
操作 ID
createExperimentRun
认证
租户 API Key

参数

此操作没有参数。

请求体

必填

application/json · CreateExperimentRun

响应

201

实验元数据已创建

application/json · ExperimentRunResponse
400

请求无效

application/problem+json · Problem
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
429

租户 API Key 已超过速率限制

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request POST \
  'https://spark-data.cn/v1/experiment-runs' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"operation":"operation_code","params":{}}'
GET/v1/experiment-runs/{run_id}获取一个实验追踪记录
操作 ID
getExperimentRun
认证
租户 API Key

参数

run_idpath
string<uuid>必填

—

响应

200

实验元数据

application/json · ExperimentRunResponse
400

请求无效

application/problem+json · Problem
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
404

资源不存在

application/problem+json · Problem
429

租户 API Key 已超过速率限制

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request GET \
  'https://spark-data.cn/v1/experiment-runs/RUN_ID' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY'
PATCH/v1/experiment-runs/{run_id}执行受限实验状态转换并保存结果摘要
操作 ID
updateExperimentRun
认证
租户 API Key

参数

run_idpath
string<uuid>必填

—

请求体

必填

application/json · UpdateExperimentRun

响应

200

实验元数据已更新

application/json · ExperimentRunResponse
400

请求无效

application/problem+json · Problem
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
404

资源不存在

application/problem+json · Problem
409

资源当前状态不允许执行此操作

application/problem+json · Problem
429

租户 API Key 已超过速率限制

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request PATCH \
  'https://spark-data.cn/v1/experiment-runs/RUN_ID' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"operation":"operation_code","params":{}}'

因子Factors

租户因子定义与不可变版本，不提供计算。

5 个接口
GET/v1/factors列出租户因子定义
操作 ID
listFactors
认证
租户 API Key

参数

此操作没有参数。

响应

200

因子定义列表

application/json · FactorsResponse
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
429

租户 API Key 已超过速率限制

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request GET \
  'https://spark-data.cn/v1/factors' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY'
POST/v1/factors创建因子定义，但不触发计算
操作 ID
createFactor
认证
租户 API Key

参数

此操作没有参数。

请求体

必填

application/json · CreateFactorDefinition

响应

201

因子定义已创建

application/json · FactorResponse
400

请求无效

application/problem+json · Problem
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
409

资源当前状态不允许执行此操作

application/problem+json · Problem
429

租户 API Key 已超过速率限制

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request POST \
  'https://spark-data.cn/v1/factors' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"operation":"operation_code","params":{}}'
GET/v1/factors/{factor_id}获取一个租户因子定义
操作 ID
getFactor
认证
租户 API Key

参数

factor_idpath
string<uuid>必填

—

响应

200

因子定义

application/json · FactorResponse
400

请求无效

application/problem+json · Problem
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
404

资源不存在

application/problem+json · Problem
429

租户 API Key 已超过速率限制

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request GET \
  'https://spark-data.cn/v1/factors/FACTOR_ID' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY'
GET/v1/factors/{factor_id}/versions列出因子的不可变版本
操作 ID
listFactorVersions
认证
租户 API Key

参数

factor_idpath
string<uuid>必填

—

响应

200

因子版本列表

application/json · FactorVersionsResponse
400

请求无效

application/problem+json · Problem
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
404

资源不存在

application/problem+json · Problem
429

租户 API Key 已超过速率限制

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request GET \
  'https://spark-data.cn/v1/factors/FACTOR_ID/versions' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY'
POST/v1/factors/{factor_id}/versions创建下一个不可变因子声明版本
操作 ID
createFactorVersion
认证
租户 API Key

参数

factor_idpath
string<uuid>必填

—

请求体

必填

application/json · CreateFactorVersion

响应

201

因子版本已创建

application/json · FactorVersionResponse
400

请求无效

application/problem+json · Problem
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
404

资源不存在

application/problem+json · Problem
429

租户 API Key 已超过速率限制

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request POST \
  'https://spark-data.cn/v1/factors/FACTOR_ID/versions' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"operation":"operation_code","params":{}}'

在线 AgentOnline Agent

A2A 1.0 Agent 发现、消息、Task、公开工作流事件与取消。

7 个接口
GET/.well-known/agent-card.json发现 SparkData 在线研究 Agent
操作 ID
getOnlineAgentCard
认证
公开

参数

此操作没有参数。

响应

200

Public A2A Agent Card

application/json · AgentCard
cURL
curl --request GET \
  'https://spark-data.cn/.well-known/agent-card.json'
POST/v1/agent/a2a/message:send发送消息并等待权威 Task 结果
操作 ID
sendAgentMessage
认证
用户会话 Cookie

参数

A2A-Versionheader
string必填

This interface supports A2A protocol version 1.0 only.

A2A-Extensionsheader
string可选

Comma-separated optional A2A extension URIs selected by the client.

X-CSRF-Tokenheader
string必填

Token returned by login or GET /v1/me; Origin must also exactly match an allowed production origin.

请求体

必填

application/a2a+json · SendAgentMessageRequest

响应

200

Completed or failed Task envelope

application/a2a+json · SendAgentMessageResponse
400

请求无效

application/problem+json · Problem
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
409

资源当前状态不允许执行此操作

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request POST \
  'https://spark-data.cn/v1/agent/a2a/message:send' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"operation":"operation_code","params":{}}'
POST/v1/agent/a2a/message:stream发送消息并流式接收 Task 生命周期事件
操作 ID
streamAgentMessage
认证
用户会话 Cookie

参数

A2A-Versionheader
string必填

This interface supports A2A protocol version 1.0 only.

A2A-Extensionsheader
string可选

Comma-separated optional A2A extension URIs selected by the client.

X-CSRF-Tokenheader
string必填

Token returned by login or GET /v1/me; Origin must also exactly match an allowed production origin.

请求体

必填

application/a2a+json · SendAgentMessageRequest

响应

200

Ordered A2A SSE events ending at a terminal Task state

text/event-stream · string
400

请求无效

application/problem+json · Problem
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
409

资源当前状态不允许执行此操作

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request POST \
  'https://spark-data.cn/v1/agent/a2a/message:stream' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"operation":"operation_code","params":{}}'
GET/v1/agent/a2a/tasks列出当前登录用户拥有的 Agent Task
操作 ID
listAgentTasks
认证
用户会话 Cookie

参数

A2A-Versionheader
string必填

This interface supports A2A protocol version 1.0 only.

contextIdquery
string<uuid>可选

—

pageSizequery
integer可选

—示例: 50

响应

200

Owner-scoped Task page

application/a2a+json · AgentTaskList
400

请求无效

application/problem+json · Problem
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request GET \
  'https://spark-data.cn/v1/agent/a2a/tasks' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY'
GET/v1/agent/a2a/tasks/{id}获取一个权威的用户级 Task 快照
操作 ID
getAgentTask
认证
用户会话 Cookie

参数

A2A-Versionheader
string必填

This interface supports A2A protocol version 1.0 only.

idpath
string<uuid>必填

—

响应

200

Current Task snapshot

application/a2a+json · AgentTask
400

请求无效

application/problem+json · Problem
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
404

资源不存在

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request GET \
  'https://spark-data.cn/v1/agent/a2a/tasks/value' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY'
POST/v1/agent/a2a/tasks/{id}:subscribe续订一个运行中 Task 的流式事件
操作 ID
subscribeAgentTask
认证
用户会话 Cookie

参数

A2A-Versionheader
string必填

This interface supports A2A protocol version 1.0 only.

A2A-Extensionsheader
string可选

Comma-separated optional A2A extension URIs selected by the client.

X-CSRF-Tokenheader
string必填

Token returned by login or GET /v1/me; Origin must also exactly match an allowed production origin.

idpath
string<uuid>必填

—

响应

200

Current Task followed by ordered SSE updates

text/event-stream · string
400

请求无效

application/problem+json · Problem
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
404

资源不存在

application/problem+json · Problem
409

资源当前状态不允许执行此操作

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request POST \
  'https://spark-data.cn/v1/agent/a2a/tasks/value:subscribe' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY'
POST/v1/agent/a2a/tasks/{id}:cancel取消一个运行中的用户级 Task
操作 ID
cancelAgentTask
认证
用户会话 Cookie

参数

A2A-Versionheader
string必填

This interface supports A2A protocol version 1.0 only.

X-CSRF-Tokenheader
string必填

Token returned by login or GET /v1/me; Origin must also exactly match an allowed production origin.

idpath
string<uuid>必填

—

请求体

可选

application/a2a+json · object

响应

200

Canceled Task snapshot

application/a2a+json · AgentTask
400

请求无效

application/problem+json · Problem
401

API Key 缺失、格式错误、过期、已吊销或无法识别

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
404

资源不存在

application/problem+json · Problem
409

资源当前状态不允许执行此操作

application/problem+json · Problem
503

MySQL、Redis 或上游依赖不可用

application/problem+json · Problem
cURL
curl --request POST \
  'https://spark-data.cn/v1/agent/a2a/tasks/value:cancel' \
  --header 'Authorization: Bearer $SPARKDATA_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"operation":"operation_code","params":{}}'

公开数据对象

仅列出客户接口会使用的数据对象；展开即可查看字段、类型与必填性。

67 公开对象
AgentCardobject
字段类型
namestring必填
descriptionstring必填
supportedInterfacesobject[]必填
versionstring必填
capabilitiesobject必填
defaultInputModesstring[]必填
defaultOutputModesstring[]必填
skillsobject[]必填
SendAgentMessageRequestobject
字段类型
messageAgentMessage必填
configurationAgentSendConfiguration可选
SendAgentMessageResponseobject
字段类型
taskAgentTask必填
AgentSendConfigurationobject
字段类型
acceptedOutputModestext/markdown | application/json[]可选
historyLengthinteger可选
AgentMessageobject
字段类型
messageIdstring<uuid>必填
roleROLE_USER | ROLE_AGENT必填
partsAgentPart[]必填
contextIdstring<uuid>可选
taskIdstring<uuid>可选
AgentPartobject | object
字段类型
AgentTaskStateTASK_STATE_SUBMITTED | TASK_STATE_WORKING | TASK_STATE_COMPLETED | TASK_STATE_FAILED | TASK_STATE_CANCELED
字段类型
AgentTaskStatusobject
字段类型
stateAgentTaskState必填
timestampstring<date-time>必填
messageAgentMessage可选
AgentArtifactobject
字段类型
artifactIdstring必填
namestring必填
partsAgentPart[]必填
extensionsstring<uri>[]可选
metadataobject可选
AgentTaskobject
字段类型
idstring<uuid>必填
contextIdstring<uuid>必填
statusAgentTaskStatus必填
artifactsAgentArtifact[]可选
historyAgentMessage[]可选
metadataobject必填
AgentTaskListobject
字段类型
tasksAgentTask[]必填
nextPageTokenstring可选
IdentityProvideremail | phone | wechat
字段类型
DatasetDefinitionobject
字段类型
dataset_idstring必填
namestring必填
descriptionstring必填
marketsstring[]必填
asset_classesstring[]必填
operation_countinteger必填
capabilitiesCapability[]必填
normalizationmixed | provider_envelope必填
rights_statusstring必填
freshnessstring必填
contract_versionstring必填
DatasetDetailobject
字段类型
DatasetReadinessobject
字段类型
dataset_idstring必填
contract_statusstring必填
delivery_statusstring必填
coverage_statusstring必填
rights_statusstring必填
watermarknull | string必填
operation_countinteger必填
observed_atstring<date-time>必填
ResearchTemplateobject
字段类型
template_idstring必填
versionstring必填
namestring必填
descriptionstring必填
required_datasetsstring[]必填
required_capabilitiesCapability[]必填
output_formatsapplication/json | text/markdown | text/html[]必填
evidence_requiredboolean必填
risk_noticestring必填
FactorDefinitionobject
字段类型
idstring<uuid>必填
tenant_idstring<uuid>必填
namestring必填
descriptionstring必填
input_datasetsstring[]必填
universe_rulestring必填
created_atstring<date-time>必填
CreateFactorDefinitionobject
字段类型
namestring必填
descriptionstring可选
input_datasetsstring[]必填
universe_rulestring必填
FactorVersionobject
字段类型
idstring<uuid>必填
factor_idstring<uuid>必填
version_numberinteger必填
expressionstring必填
lookback_daysinteger必填
adjustmentraw | forward | backward必填
created_atstring<date-time>必填
CreateFactorVersionobject
字段类型
expressionstring必填
lookback_daysinteger必填
adjustmentraw | forward | backward可选
ExperimentKindresearch | factor
字段类型
ExperimentStatusplanned | running | succeeded | failed | cancelled
字段类型
ExperimentRunobject
字段类型
idstring<uuid>必填
tenant_idstring<uuid>必填
kindExperimentKind必填
namestring必填
factor_version_idstring | null必填
research_template_idstring | null必填
inputsobject必填
code_refstring | null必填
data_manifest_refstring | null必填
environmentobject必填
statusExperimentStatus必填
resultobject必填
created_atstring<date-time>必填
updated_atstring<date-time>必填
CreateExperimentRunobject
字段类型
kindExperimentKind必填
namestring必填
factor_version_idstring | null可选
research_template_idstring | null可选
inputsobject可选
code_refstring | null可选
data_manifest_refstring | null可选
environmentobject可选
UpdateExperimentRunobject
字段类型
statusExperimentStatus必填
resultobject可选
InstrumentIdstring

Canonical MIC-prefixed ID for a supported mainland equity, ETF, or index.

字段类型
Decimalstring
字段类型
BarTimeframe1m | 5m | 15m | 30m | 1h | 1d | 1w | 1mo | 1q | 1y
字段类型
CacheStatushit | miss | mixed | bypass
字段类型
ResponseMetaobject
字段类型
request_idstring<uuid>必填
schema_versionstring必填
cache_statusCacheStatus必填
sourcesparkdata-market-data | sparkdata-control-plane必填
generated_atstring<date-time>必填
Instrumentobject
字段类型
instrument_idInstrumentId必填 · Canonical MIC-prefixed ID for a supported mainland equity, ETF, or index.
symbolstring必填
namestring | null必填
company_namestring | null必填
micXSHG | XSHE | XBSE必填
asset_classequity | etf | index必填
currencystring必填
timezonestring必填
statusstring必填
industrystring | null必填
conceptsstring[]必填
provider_dataProviderData必填
ProviderDataobject
字段类型
operationstring必填 · 公开数据源契约或字典服务中的准确 operation 名称。
rawobject必填 · 生成该记录时使用的完整上游 envelope、单行或多行数据，不做裁剪。
Capabilitydiscovery | entities | market_data | fundamentals | ownership | events | analytics | economy | content
字段类型
ContractDataTypestring | string_array | number | number_array | date | date_array
字段类型
InputContractobject
字段类型
namestring必填 · SparkData 接受的公开参数名。
upstream_namestring必填 · 发送给真实上游的准确字段名。
display_namestring必填
data_typeContractDataType必填
descriptionstring必填
requiredboolean必填
enum_groupstring | null必填 · 工作簿将输入标记为枚举时使用的实时字典组。
enum_declarationstring | null必填 · 工作簿中未经修改的枚举声明。
fixed_valuestring | null必填 · 工作簿标记为固定传、由 SparkData 自动补入的值。
OutputContractobject
字段类型
namestring必填
display_namestring必填
data_typeContractDataType必填
descriptionstring必填
OperationContractobject
字段类型
api_idinteger必填
sheet_namestring必填
display_namestring必填
operationstring必填
descriptionstring必填
methodstring必填
pathstring必填
capabilityCapability必填
last_modifiedstring必填
inputsInputContract[]必填
outputsOutputContract[]必填
OperationContractsResponseobject
字段类型
metaResponseMeta必填
dataOperationContract[]必填
AggregateQueryobject
字段类型
operationstring必填 · 区分大小写的 Excel operation 名称，例如 FinancialStatement。
parametersobject可选 · 准确的 Excel 输入字段名和值；未声明字段会被拒绝。
EnumResolutionobject
字段类型
fieldstring必填
group_namestring必填
inputobject必填
codestring必填
captionstring | null必填
provider_dataProviderData必填
AggregateDataobject
字段类型
api_idinteger必填
capabilityCapability必填
operationstring必填
resolved_parametersobject必填 · 补入固定值并完成枚举解析后实际发送给上游的请求。
enum_resolutionsEnumResolution[]必填
provider_dataProviderData必填
AggregateResponseobject
字段类型
metaResponseMeta必填
dataAggregateData必填
PriceLevelobject
字段类型
priceDecimal必填
sizeDecimal必填
Quoteobject
字段类型
instrument_idInstrumentId必填 · Canonical MIC-prefixed ID for a supported mainland equity, ETF, or index.
event_timestring<date-time>必填
last_priceDecimal必填
previous_closeDecimal必填
openDecimal必填
highDecimal必填
lowDecimal必填
changeDecimal | null必填
change_percentDecimal | null必填
volumeDecimal必填
turnoverDecimal必填
trade_statusstring必填
bid_levelsPriceLevel[]必填
ask_levelsPriceLevel[]必填
provider_dataProviderData必填
Barobject
字段类型
instrument_idInstrumentId必填 · Canonical MIC-prefixed ID for a supported mainland equity, ETF, or index.
event_timestring<date-time>必填 · 区间的 UTC 起始时间。
trading_datestring | null必填 · 上游交易日或周期结束日；派生日内 K 线为 null。
timeframeBarTimeframe必填
openDecimal必填
highDecimal必填
lowDecimal必填
closeDecimal必填
previous_closeDecimal | null必填
volumeDecimal必填
turnoverDecimal | null必填
trade_countinteger | null必填
suspendedboolean必填
adjustmentraw | forward | backward必填 · ETF 与指数 K 线只接受 raw。
aggregation_sourceprovider | snapshot_derived | daily_derived必填
provider_dataProviderData必填
StreamControlobject
字段类型
control_typestream_end | heartbeat | reconnect必填
request_idstring<uuid>必填
event_timestring<date-time>必填
records_sentinteger可选
MarketEventQuote | StreamControl
字段类型
BarStreamRecordBar | StreamControl
字段类型
AgentContextobject
字段类型
instrument_idInstrumentId必填 · Canonical MIC-prefixed ID for a supported mainland equity, ETF, or index.
instrumentInstrument必填
latest_quoteQuote | null必填
barsBar[]必填
upstream_operationsstring[]必填
AgentContextResponseobject
字段类型
metaResponseMeta必填
dataAgentContext必填
DatasetsResponseobject
字段类型
metaResponseMeta必填
dataDatasetDefinition[]必填
DatasetDetailResponseobject
字段类型
metaResponseMeta必填
dataDatasetDetail必填
DataReadinessResponseobject
字段类型
metaResponseMeta必填
dataDatasetReadiness[]必填
ResearchTemplatesResponseobject
字段类型
metaResponseMeta必填
dataResearchTemplate[]必填
FactorResponseobject
字段类型
metaResponseMeta必填
dataFactorDefinition必填
FactorsResponseobject
字段类型
metaResponseMeta必填
dataFactorDefinition[]必填
FactorVersionResponseobject
字段类型
metaResponseMeta必填
dataFactorVersion必填
FactorVersionsResponseobject
字段类型
metaResponseMeta必填
dataFactorVersion[]必填
ExperimentRunResponseobject
字段类型
metaResponseMeta必填
dataExperimentRun必填
ExperimentRunsResponseobject
字段类型
metaResponseMeta必填
dataExperimentRun[]必填
InstrumentResponseobject
字段类型
metaResponseMeta必填
dataInstrument必填
InstrumentResponseObjectobject
字段类型
metaResponseMeta必填
dataInstrument必填
BarsResponseobject
字段类型
metaResponseMeta必填
dataBar[]必填
QuotesResponseobject
字段类型
metaResponseMeta必填
dataQuote[]必填
MeResponseobject
字段类型
metaResponseMeta必填
dataobject必填
InvalidParameterobject
字段类型
namestring必填
reasonstring必填
Problemobject
字段类型
typestring<uri-reference>必填
titlestring必填
statusinteger必填
detailstring必填
request_idstring<uuid>必填
codestring必填
invalid_parametersInvalidParameter[]必填

准备让 Agent 使用真实市场数据？

领取 API Key，安装 Skill，然后直接提出你的研究问题。

立即开始↗下载 OpenAPI YAML