S SPARKDATA
EN
菜单

API 文档与在线试运行

让你的 Agent直接读懂市场。

这里只展示客户可调用的行情、证券资料、Agent 数据与大模型调用能力。查看参数与返回字段，或直接在当前页面运行示例。

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

大模型 · OpenAI 兼容接口

base_url: https://spark-data.cn/v1 · model: qwen3.8-max

复用 SparkData API Key。账户每天共享 100,000 Token，北京时间零点重置；输入与输出合计，与数据 API 请求额度独立。支持 JSON 和 SSE。max_completion_tokens 限制推理与最终输出合计，默认 1,024，最大 8,192；max_tokens 是其别名。

curl 'https://spark-data.cn/v1/chat/completions' \
  -H "Authorization: Bearer $SPARKDATA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "qwen3.8-max",
  "messages": [
    {
      "role": "user",
      "content": "Hello"
    }
  ],
  "max_completion_tokens": 128
}'

发出第一条可信行情请求

使用领取到的 API Key 完成 Bearer 认证；在试运行中选择 API Key，即可查看真实结果。

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
公开操作
39
公开路径
34
公开对象
82
OPENAPI
3.1

大模型LLM

复用 SparkData API Key 的 OpenAI 兼容模型接口，按账户每日 Token 独立计量。

2 个接口
GET/v1/models列出当前 Key 可调用的大模型

Requires llm:invoke. Does not consume market-data request allowance or model tokens.

操作 ID
listModels
认证
账户 API Key

参数

此操作没有参数。

返回结果

200

OpenAI-compatible model list.

application/json · object
401

OpenAI-style error. Local budget exhaustion uses daily_token_limit_exceeded and Retry-After; provider failures have upstream-prefixed codes.

application/json · object
403

OpenAI-style error. Local budget exhaustion uses daily_token_limit_exceeded and Retry-After; provider failures have upstream-prefixed codes.

application/json · object
503

OpenAI-style error. Local budget exhaustion uses daily_token_limit_exceeded and Retry-After; provider failures have upstream-prefixed codes.

application/json · object

成功响应字段

对象类型object
文本string必填

对象类型的值。示例: 示例文本

返回数据data
对象列表object[]必填

返回数据的值。示例: […]

cURL
curl --request GET \
  'https://spark-data.cn/v1/models' \
  --header "Authorization: Bearer $SPARKDATA_API_KEY"
POST/v1/chat/completions创建聊天补全，支持 JSON 和 SSE

使用 SparkData API Key 调用 qwen3.8-max。输入与输出 Token 合计按账户每天限额，独立于行情 API 请求次数。支持多轮文本、函数工具和 JSON 输出参数；最多生成一个结果。max_completion_tokens 限制推理与最终输出合计，默认 1,024，最大 8,192；max_tokens 作为同义别名。stream=true 返回 SSE；stream_options.include_usage=true 返回用量事件。

操作 ID
createChatCompletion
认证
账户 API Key

参数

此操作没有参数。

请求体

必填

application/json · ChatCompletionRequest
模型名称model
文本string必填

模型名称的值。示例: qwen3.8-max

对话消息messages
对象列表object[]必填

对话消息的值。示例: [{"role":"user","content":"Hello"}]

最大输出用量max_completion_tokens
整数integer可选

最大输出用量的值。示例: 128

最大输出用量max_tokens
整数integer可选

Alias for the complete output budget; cannot be supplied together with max_completion_tokens.示例: 128

流式返回stream
是 / 否boolean可选

流式返回的值。示例: false

流式选项stream_options
对象object可选

流式选项的值。示例: {…}

结果数量n
整数integer可选

结果数量的值。示例: 1

随机程度temperature
数字number可选

随机程度的值。示例: 0.7

采样范围top_p
数字number可选

采样范围的值。示例: 1

停止词stop
可选值列表string | string[]可选

停止词的值。示例: […]

工具定义tools
对象列表object[]可选

工具定义的值。示例: […]

工具选择tool_choice
可选值string | object可选

工具选择的值。示例: string

并行工具调用parallel_tool_calls
是 / 否boolean可选

并行工具调用的值。示例: true

输出格式response_format
对象object可选

输出格式的值。示例: {…}

启用思考enable_thinking
是 / 否boolean可选

启用思考的值。示例: true

{
  "model": "qwen3.8-max",
  "messages": [
    {
      "role": "user",
      "content": "Introduce yourself in one sentence."
    }
  ],
  "max_completion_tokens": 1024,
  "stream": false
}

返回结果

200

JSON completion or SSE chunks ending with data [DONE]. An interrupted stream ends with an error event without a success marker. include_usage may produce an empty choices array in the final usage chunk.

application/json · ChatCompletion / text/event-stream · string
400

OpenAI-style error. Local budget exhaustion uses daily_token_limit_exceeded and Retry-After; provider failures have upstream-prefixed codes.

application/json · object
401

OpenAI-style error. Local budget exhaustion uses daily_token_limit_exceeded and Retry-After; provider failures have upstream-prefixed codes.

application/json · object
403

OpenAI-style error. Local budget exhaustion uses daily_token_limit_exceeded and Retry-After; provider failures have upstream-prefixed codes.

application/json · object
413

OpenAI-style error. Local budget exhaustion uses daily_token_limit_exceeded and Retry-After; provider failures have upstream-prefixed codes.

application/json · object
429

OpenAI-style error. Local budget exhaustion uses daily_token_limit_exceeded and Retry-After; provider failures have upstream-prefixed codes.

application/json · object
502

OpenAI-style error. Local budget exhaustion uses daily_token_limit_exceeded and Retry-After; provider failures have upstream-prefixed codes.

application/json · object
503

OpenAI-style error. Local budget exhaustion uses daily_token_limit_exceeded and Retry-After; provider failures have upstream-prefixed codes.

application/json · object

成功响应字段

记录编号id
文本string必填

记录编号的值。示例: 使用已有记录的编号

对象类型object
文本string必填

对象类型的值。示例: 示例文本

创建时间created
整数integer必填

创建时间的值。示例: 1

模型名称model
文本string必填

模型名称的值。示例: qwen3.8-max

生成结果choices
对象列表object[]必填

生成结果的值。示例: […]

调用用量usage
对象object可选

调用用量的值。示例: {…}

cURL
curl --request POST \
  'https://spark-data.cn/v1/chat/completions' \
  --header "Authorization: Bearer $SPARKDATA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"model":"qwen3.8-max","messages":[{"role":"user","content":"Introduce yourself in one sentence."}],"max_completion_tokens":1024,"stream":false}'

证券资料Instruments

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

1 个接口
GET/v1/instruments/{instrument_id}获取规范化股票、ETF 或指数资料

根据证券代码查看名称、交易市场和证券类型等基本资料。

操作 ID
getInstrument
认证
账户 API Key

参数

证券代码instrument_id地址参数
证券代码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

服务暂不可用，请稍后重试

application/problem+json · Problem

成功响应字段

响应信息meta
对象（ResponseMeta）ResponseMeta必填

响应信息的值。示例: {…}

请求编号meta.request_id
记录编号（UUID）string<uuid>必填

请求编号的值。示例: 使用已有记录的编号

数据格式版本meta.schema_version
文本string必填

数据格式版本的值。示例: 示例文本

缓存状态meta.cache_status
对象（CacheStatus）CacheStatus必填

缓存状态的值。示例: {…}

数据标识meta.source
可选值sparkdata-market-data | sparkdata-control-plane必填

数据标识的值。示例: sparkdata-market-data

响应时间meta.generated_at
日期时间（ISO 8601）string<date-time>必填

响应时间的值。示例: 2026-09-30T15:00:00+08:00

返回数据data
对象（Instrument）Instrument必填

返回数据的值。示例: {…}

证券代码data.instrument_id
证券代码InstrumentId必填

Canonical MIC-prefixed ID for a supported mainland equity, ETF, or index.示例: XSHG:600519

证券代码data.symbol
文本string必填

证券代码的值。示例: 600519

名称data.name
文本（可为空）string | null必填

名称的值。示例: 示例名称

Company namedata.company_name
文本（可为空）string | null必填

Company name的值。示例: 示例文本

交易所代码data.mic
可选值XSHG | XSHE | XBSE必填

交易所代码的值。示例: XSHG

资产类型data.asset_class
可选值equity | etf | index必填

资产类型的值。示例: equity

币种data.currency
文本string必填

币种的值。示例: CNY

时区data.timezone
文本string必填

时区的值。示例: Asia/Shanghai

状态data.status
文本string必填

状态的值。示例: 示例文本

Industrydata.industry
文本（可为空）string | null必填

Industry的值。示例: 示例文本

Conceptsdata.concepts
文本列表string[]必填

Concepts的值。示例: […]

扩展数据data.provider_data
对象（ProviderData）ProviderData必填

扩展数据的值。示例: {…}

接口名称data.provider_data.operation
文本string必填

数据目录中的接口名称，区分大小写。示例: FinancialStatement

原始结果data.provider_data.raw
对象object必填

该记录对应的原始数据结果。示例: {…}

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

参数

证券代码列表symbols查询参数
证券代码列表InstrumentId[]必填

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

开始时间start查询参数
日期时间（ISO 8601）string<date-time>必填

UTC 闭区间起始时间。示例: 2026-09-01T00:00:00+08:00

结束时间end查询参数
日期时间（ISO 8601）string<date-time>必填

UTC 开区间结束时间，范围受租户限额约束。示例: 2026-09-30T23:59:59+08:00

K线周期timeframe查询参数
K线周期BarTimeframe可选

K线周期的值。示例: 1d

复权方式adjustment查询参数
可选值raw | forward | backward可选

All snapshot-derived intraday bars accept `raw` only. ETF and index bars also accept `raw` only for daily and longer periods. Equity daily and longer bars support upstream adjustments.示例: raw

行情方式feed查询参数
可选值auto | realtime | delayed可选

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

排序方向sort查询参数
可选值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

服务暂不可用，请稍后重试

application/problem+json · Problem

成功响应字段

响应信息meta
对象（ResponseMeta）ResponseMeta必填

响应信息的值。示例: {…}

请求编号meta.request_id
记录编号（UUID）string<uuid>必填

请求编号的值。示例: 使用已有记录的编号

数据格式版本meta.schema_version
文本string必填

数据格式版本的值。示例: 示例文本

缓存状态meta.cache_status
对象（CacheStatus）CacheStatus必填

缓存状态的值。示例: {…}

数据标识meta.source
可选值sparkdata-market-data | sparkdata-control-plane必填

数据标识的值。示例: sparkdata-market-data

响应时间meta.generated_at
日期时间（ISO 8601）string<date-time>必填

响应时间的值。示例: 2026-09-30T15:00:00+08:00

返回数据data
对象（Bar）列表Bar[]必填

返回数据的值。示例: […]

证券代码data[].instrument_id
证券代码InstrumentId必填

Canonical MIC-prefixed ID for a supported mainland equity, ETF, or index.示例: XSHG:600519

Event timedata[].event_time
日期时间（ISO 8601）string<date-time>必填

区间的 UTC 起始时间。示例: 2026-09-30T15:00:00+08:00

交易日期data[].trading_date
文本（可为空）string | null必填

交易日期或周期结束日期；日内 K 线此字段可为空。示例: 示例文本

K线周期data[].timeframe
K线周期BarTimeframe必填

K线周期的值。示例: 1d

开盘价data[].open
对象（Decimal）Decimal必填

开盘价的值。示例: {…}

最高价data[].high
对象（Decimal）Decimal必填

最高价的值。示例: {…}

最低价data[].low
对象（Decimal）Decimal必填

最低价的值。示例: {…}

收盘价data[].close
对象（Decimal）Decimal必填

收盘价的值。示例: {…}

前收盘价data[].previous_close
对象（Decimal）（可为空）Decimal | null必填

前收盘价的值。示例: {…}

成交量data[].volume
对象（Decimal）Decimal必填

成交量的值。示例: {…}

成交额data[].turnover
对象（Decimal）（可为空）Decimal | null必填

成交额的值。示例: {…}

成交笔数data[].trade_count
整数（可为空）integer | null必填

成交笔数的值。示例: 1

Suspendeddata[].suspended
是 / 否boolean必填

Suspended的值。示例: true

复权方式data[].adjustment
可选值raw | forward | backward必填

All snapshot-derived intraday bars accept `raw` only. ETF and index bars also accept `raw` only for daily and longer periods. Equity daily and longer bars support upstream adjustments.示例: raw

Aggregation sourcedata[].aggregation_source
可选值provider | snapshot_derived | daily_derived必填

Aggregation source的值。示例: provider

扩展数据data[].provider_data
对象（ProviderData）ProviderData必填

扩展数据的值。示例: {…}

接口名称data[].provider_data.operation
文本string必填

数据目录中的接口名称，区分大小写。示例: FinancialStatement

原始结果data[].provider_data.raw
对象object必填

该记录对应的原始数据结果。示例: {…}

cURL
curl --request GET \
  'https://spark-data.cn/v1/market-data/bars?symbols=XSHG%3A600570%2CXSHE%3A000001&start=2026-11-03T16%3A25%3A51.708Z&end=2026-11-10T16%3A25%3A51.708Z&timeframe=1d' \
  --header "Authorization: Bearer $SPARKDATA_API_KEY"
GET/v1/market-data/quotes/latest获取多只股票、ETF 或指数的最新行情

按证券代码查询最新价格、成交量等行情。symbols 支持用逗号分隔多个代码。

操作 ID
getLatestQuotes
认证
账户 API Key

参数

证券代码列表symbols查询参数
证券代码列表InstrumentId[]必填

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

行情方式feed查询参数
可选值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

服务暂不可用，请稍后重试

application/problem+json · Problem

成功响应字段

响应信息meta
对象（ResponseMeta）ResponseMeta必填

响应信息的值。示例: {…}

请求编号meta.request_id
记录编号（UUID）string<uuid>必填

请求编号的值。示例: 使用已有记录的编号

数据格式版本meta.schema_version
文本string必填

数据格式版本的值。示例: 示例文本

缓存状态meta.cache_status
对象（CacheStatus）CacheStatus必填

缓存状态的值。示例: {…}

数据标识meta.source
可选值sparkdata-market-data | sparkdata-control-plane必填

数据标识的值。示例: sparkdata-market-data

响应时间meta.generated_at
日期时间（ISO 8601）string<date-time>必填

响应时间的值。示例: 2026-09-30T15:00:00+08:00

返回数据data
对象（Quote）列表Quote[]必填

返回数据的值。示例: […]

证券代码data[].instrument_id
证券代码InstrumentId必填

Canonical MIC-prefixed ID for a supported mainland equity, ETF, or index.示例: XSHG:600519

Event timedata[].event_time
日期时间（ISO 8601）string<date-time>必填

Event time的值。示例: 2026-09-30T15:00:00+08:00

最新价data[].last_price
对象（Decimal）Decimal必填

最新价的值。示例: {…}

前收盘价data[].previous_close
对象（Decimal）Decimal必填

前收盘价的值。示例: {…}

开盘价data[].open
对象（Decimal）Decimal必填

开盘价的值。示例: {…}

最高价data[].high
对象（Decimal）Decimal必填

最高价的值。示例: {…}

最低价data[].low
对象（Decimal）Decimal必填

最低价的值。示例: {…}

涨跌额data[].change
对象（Decimal）（可为空）Decimal | null必填

涨跌额的值。示例: {…}

涨跌幅data[].change_percent
对象（Decimal）（可为空）Decimal | null必填

涨跌幅的值。示例: {…}

成交量data[].volume
对象（Decimal）Decimal必填

成交量的值。示例: {…}

成交额data[].turnover
对象（Decimal）Decimal必填

成交额的值。示例: {…}

交易状态data[].trade_status
文本string必填

交易状态的值。示例: 示例文本

买盘档位data[].bid_levels
对象（PriceLevel）列表PriceLevel[]必填

买盘档位的值。示例: […]

价格data[].bid_levels[].price
对象（Decimal）Decimal必填

价格的值。示例: {…}

数量data[].bid_levels[].size
对象（Decimal）Decimal必填

数量的值。示例: {…}

卖盘档位data[].ask_levels
对象（PriceLevel）列表PriceLevel[]必填

卖盘档位的值。示例: […]

价格data[].ask_levels[].price
对象（Decimal）Decimal必填

价格的值。示例: {…}

数量data[].ask_levels[].size
对象（Decimal）Decimal必填

数量的值。示例: {…}

扩展数据data[].provider_data
对象（ProviderData）ProviderData必填

扩展数据的值。示例: {…}

接口名称data[].provider_data.operation
文本string必填

数据目录中的接口名称，区分大小写。示例: FinancialStatement

原始结果data[].provider_data.raw
对象object必填

该记录对应的原始数据结果。示例: {…}

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

参数

证券代码列表symbols查询参数
证券代码列表InstrumentId[]必填

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

行情方式feed查询参数
可选值auto | realtime | delayed可选

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

心跳间隔（秒）heartbeat_seconds查询参数
整数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

服务暂不可用，请稍后重试

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

一次获取研究所需的证券信息、行情与 K 线。

1 个接口
GET/v1/agent/context/{instrument_id}获取股票、ETF 或指数的行情与 K 线

返回证券资料、最新行情与 K 线。默认查询最近 365 个自然日，实际范围受当前账户额度限制。指定时间范围时，请同时提供 start 与 end。

操作 ID
getAgentContext
认证
账户 API Key

参数

证券代码instrument_id地址参数
证券代码InstrumentId必填

证券代码的值。示例: XSHG:600570

开始时间start查询参数
日期时间（ISO 8601）string<date-time>可选

UTC 闭区间起始时间，必须与 end 同时提供。示例: 2026-09-01T00:00:00+08:00

结束时间end查询参数
日期时间（ISO 8601）string<date-time>可选

UTC 开区间结束时间，必须与 start 同时提供。示例: 2026-09-30T23:59:59+08:00

K线周期timeframe查询参数
K线周期BarTimeframe可选

K线周期的值。示例: 1d

复权方式adjustment查询参数
可选值raw | forward | backward可选

All snapshot-derived intraday bars accept `raw` only. ETF and index bars also accept `raw` only for daily and longer periods. Equity daily and longer bars support upstream adjustments.示例: raw

排序方向sort查询参数
可选值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

服务暂不可用，请稍后重试

application/problem+json · Problem

成功响应字段

响应信息meta
对象（ResponseMeta）ResponseMeta必填

响应信息的值。示例: {…}

请求编号meta.request_id
记录编号（UUID）string<uuid>必填

请求编号的值。示例: 使用已有记录的编号

数据格式版本meta.schema_version
文本string必填

数据格式版本的值。示例: 示例文本

缓存状态meta.cache_status
对象（CacheStatus）CacheStatus必填

缓存状态的值。示例: {…}

数据标识meta.source
可选值sparkdata-market-data | sparkdata-control-plane必填

数据标识的值。示例: sparkdata-market-data

响应时间meta.generated_at
日期时间（ISO 8601）string<date-time>必填

响应时间的值。示例: 2026-09-30T15:00:00+08:00

返回数据data
对象（AgentContext）AgentContext必填

返回数据的值。示例: {…}

证券代码data.instrument_id
证券代码InstrumentId必填

Canonical MIC-prefixed ID for a supported mainland equity, ETF, or index.示例: XSHG:600519

证券信息data.instrument
对象（Instrument）Instrument必填

证券信息的值。示例: {…}

证券代码data.instrument.instrument_id
证券代码InstrumentId必填

Canonical MIC-prefixed ID for a supported mainland equity, ETF, or index.示例: XSHG:600519

证券代码data.instrument.symbol
文本string必填

证券代码的值。示例: 600519

名称data.instrument.name
文本（可为空）string | null必填

名称的值。示例: 示例名称

Company namedata.instrument.company_name
文本（可为空）string | null必填

Company name的值。示例: 示例文本

交易所代码data.instrument.mic
可选值XSHG | XSHE | XBSE必填

交易所代码的值。示例: XSHG

资产类型data.instrument.asset_class
可选值equity | etf | index必填

资产类型的值。示例: equity

币种data.instrument.currency
文本string必填

币种的值。示例: CNY

时区data.instrument.timezone
文本string必填

时区的值。示例: Asia/Shanghai

状态data.instrument.status
文本string必填

状态的值。示例: 示例文本

Industrydata.instrument.industry
文本（可为空）string | null必填

Industry的值。示例: 示例文本

Conceptsdata.instrument.concepts
文本列表string[]必填

Concepts的值。示例: […]

扩展数据data.instrument.provider_data
对象（ProviderData）ProviderData必填

扩展数据的值。示例: {…}

最新行情data.latest_quote
对象（Quote）（可为空）Quote | null必填

最新行情的值。示例: {…}

K线数据data.bars
对象（Bar）列表Bar[]必填

K线数据的值。示例: […]

证券代码data.bars[].instrument_id
证券代码InstrumentId必填

Canonical MIC-prefixed ID for a supported mainland equity, ETF, or index.示例: XSHG:600519

Event timedata.bars[].event_time
日期时间（ISO 8601）string<date-time>必填

区间的 UTC 起始时间。示例: 2026-09-30T15:00:00+08:00

交易日期data.bars[].trading_date
文本（可为空）string | null必填

交易日期或周期结束日期；日内 K 线此字段可为空。示例: 示例文本

K线周期data.bars[].timeframe
K线周期BarTimeframe必填

K线周期的值。示例: 1d

开盘价data.bars[].open
对象（Decimal）Decimal必填

开盘价的值。示例: {…}

最高价data.bars[].high
对象（Decimal）Decimal必填

最高价的值。示例: {…}

最低价data.bars[].low
对象（Decimal）Decimal必填

最低价的值。示例: {…}

收盘价data.bars[].close
对象（Decimal）Decimal必填

收盘价的值。示例: {…}

前收盘价data.bars[].previous_close
对象（Decimal）（可为空）Decimal | null必填

前收盘价的值。示例: {…}

成交量data.bars[].volume
对象（Decimal）Decimal必填

成交量的值。示例: {…}

成交额data.bars[].turnover
对象（Decimal）（可为空）Decimal | null必填

成交额的值。示例: {…}

成交笔数data.bars[].trade_count
整数（可为空）integer | null必填

成交笔数的值。示例: 1

Suspendeddata.bars[].suspended
是 / 否boolean必填

Suspended的值。示例: true

复权方式data.bars[].adjustment
可选值raw | forward | backward必填

All snapshot-derived intraday bars accept `raw` only. ETF and index bars also accept `raw` only for daily and longer periods. Equity daily and longer bars support upstream adjustments.示例: raw

Aggregation sourcedata.bars[].aggregation_source
可选值provider | snapshot_derived | daily_derived必填

Aggregation source的值。示例: provider

扩展数据data.bars[].provider_data
对象（ProviderData）ProviderData必填

扩展数据的值。示例: {…}

Upstream operationsdata.upstream_operations
文本列表string[]必填

Upstream operations的值。示例: […]

cURL
curl --request GET \
  'https://spark-data.cn/v1/agent/context/XSHG:600570' \
  --header "Authorization: Bearer $SPARKDATA_API_KEY"

数据目录Data Catalog

按分类查找数据接口，查看字段与使用范围。

4 个接口
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

服务暂不可用，请稍后重试

application/problem+json · Problem

成功响应字段

响应信息meta
对象（ResponseMeta）ResponseMeta必填

响应信息的值。示例: {…}

请求编号meta.request_id
记录编号（UUID）string<uuid>必填

请求编号的值。示例: 使用已有记录的编号

数据格式版本meta.schema_version
文本string必填

数据格式版本的值。示例: 示例文本

缓存状态meta.cache_status
对象（CacheStatus）CacheStatus必填

缓存状态的值。示例: {…}

数据标识meta.source
可选值sparkdata-market-data | sparkdata-control-plane必填

数据标识的值。示例: sparkdata-market-data

响应时间meta.generated_at
日期时间（ISO 8601）string<date-time>必填

响应时间的值。示例: 2026-09-30T15:00:00+08:00

返回数据data
对象（DatasetReadiness）列表DatasetReadiness[]必填

返回数据的值。示例: […]

Dataset iddata[].dataset_id
文本string必填

Dataset id的值。示例: 使用已有记录的编号

Contract statusdata[].contract_status
文本string必填

Contract status的值。示例: 示例文本

Delivery statusdata[].delivery_status
文本string必填

Delivery status的值。示例: 示例文本

Coverage statusdata[].coverage_status
文本string必填

Coverage status的值。示例: 示例文本

使用许可data[].rights_status
文本string必填

使用许可的值。示例: 示例文本

Watermarkdata[].watermark
可选值null | string必填

Watermark的值。示例: null

Operation countdata[].operation_count
整数integer必填

Operation count的值。示例: 1

采集时间data[].observed_at
日期时间（ISO 8601）string<date-time>必填

采集时间的值。示例: 2026-09-30T15:00:00+08:00

cURL
curl --request GET \
  'https://spark-data.cn/v1/data-readiness' \
  --header "Authorization: Bearer $SPARKDATA_API_KEY"
GET/v1/catalog/categories列出中英文产品分类

查看数据分类名称及其父级编号，用于构建可折叠的数据目录。

操作 ID
listCatalogCategories
认证
公开

参数

缓存校验标记If-None-Match请求头
文本string可选

缓存校验标记的值。示例: 示例文本

返回结果

200

Successful JSON response.

application/json · object
304

Public metadata is semantically unchanged; no response body.

400

请求无效

application/problem+json · Problem

成功响应字段

响应信息meta
对象object必填

响应信息的值。示例: {…}

返回数据data
对象（CatalogCategory）列表CatalogCategory[]必填

返回数据的值。示例: […]

cURL
curl --request GET \
  'https://spark-data.cn/v1/catalog/categories'
GET/v1/catalog/operations查找数据接口

按关键词、分类、资产类型或订阅范围查找接口。结果列出接口名称、查询地址、入参和返回字段。

操作 ID
listCatalogOperations
认证
公开

参数

搜索关键词q查询参数
文本string可选

搜索关键词的值。示例: 贵州茅台

数据分类category查询参数
文本string可选

数据分类的值。示例: 示例文本

资产类型asset查询参数
文本string可选

资产类型的值。示例: 示例文本

数据能力capability查询参数
文本string可选

数据能力的值。示例: 示例文本

适用套餐required_plan查询参数
文本string可选

适用套餐的值。示例: 示例文本

页码page查询参数
整数integer可选

页码的值。示例: 1

每页条数page_size查询参数
整数integer可选

每页条数的值。示例: 20

缓存校验标记If-None-Match请求头
文本string可选

缓存校验标记的值。示例: 示例文本

返回结果

200

Successful JSON response.

application/json · object
304

Public metadata is semantically unchanged; no response body.

400

请求无效

application/problem+json · Problem

成功响应字段

响应信息meta
对象object必填

响应信息的值。示例: {…}

返回数据data
对象（CatalogPage）CatalogPage必填

返回数据的值。示例: {…}

cURL
curl --request GET \
  'https://spark-data.cn/v1/catalog/operations'
GET/v1/catalog/operations/{id}查看具体数据接口与完整字段

根据目录中的接口编号查看查询说明、入参、返回字段及使用范围。

操作 ID
getCatalogOperation
认证
公开

参数

记录编号id地址参数
文本string必填

记录编号的值。示例: 使用已有记录的编号

缓存校验标记If-None-Match请求头
文本string可选

缓存校验标记的值。示例: 示例文本

返回结果

200

Successful JSON response.

application/json · object
304

Public metadata is semantically unchanged; no response body.

404

资源不存在

application/problem+json · Problem

成功响应字段

响应信息meta
对象object必填

响应信息的值。示例: {…}

返回数据data
对象（CatalogOperation）CatalogOperation必填

返回数据的值。示例: {…}

cURL
curl --request GET \
  'https://spark-data.cn/v1/catalog/operations/value'

研究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

服务暂不可用，请稍后重试

application/problem+json · Problem

成功响应字段

响应信息meta
对象（ResponseMeta）ResponseMeta必填

响应信息的值。示例: {…}

请求编号meta.request_id
记录编号（UUID）string<uuid>必填

请求编号的值。示例: 使用已有记录的编号

数据格式版本meta.schema_version
文本string必填

数据格式版本的值。示例: 示例文本

缓存状态meta.cache_status
对象（CacheStatus）CacheStatus必填

缓存状态的值。示例: {…}

数据标识meta.source
可选值sparkdata-market-data | sparkdata-control-plane必填

数据标识的值。示例: sparkdata-market-data

响应时间meta.generated_at
日期时间（ISO 8601）string<date-time>必填

响应时间的值。示例: 2026-09-30T15:00:00+08:00

返回数据data
对象（ResearchTemplate）列表ResearchTemplate[]必填

返回数据的值。示例: […]

研究模板编号data[].template_id
文本string必填

研究模板编号的值。示例: 使用已有记录的编号

版本data[].version
文本string必填

版本的值。示例: 示例文本

名称data[].name
文本string必填

名称的值。示例: 示例名称

说明data[].description
文本string必填

说明的值。示例: 示例文本

Required datasetsdata[].required_datasets
文本列表string[]必填

Required datasets的值。示例: […]

Required capabilitiesdata[].required_capabilities
对象（Capability）列表Capability[]必填

Required capabilities的值。示例: […]

Output formatsdata[].output_formats
可选值列表application/json | text/markdown | text/html[]必填

Output formats的值。示例: […]

Evidence requireddata[].evidence_required
是 / 否boolean必填

Evidence required的值。示例: true

Risk noticedata[].risk_notice
文本string必填

Risk notice的值。示例: 示例文本

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

服务暂不可用，请稍后重试

application/problem+json · Problem

成功响应字段

响应信息meta
对象（ResponseMeta）ResponseMeta必填

响应信息的值。示例: {…}

请求编号meta.request_id
记录编号（UUID）string<uuid>必填

请求编号的值。示例: 使用已有记录的编号

数据格式版本meta.schema_version
文本string必填

数据格式版本的值。示例: 示例文本

缓存状态meta.cache_status
对象（CacheStatus）CacheStatus必填

缓存状态的值。示例: {…}

数据标识meta.source
可选值sparkdata-market-data | sparkdata-control-plane必填

数据标识的值。示例: sparkdata-market-data

响应时间meta.generated_at
日期时间（ISO 8601）string<date-time>必填

响应时间的值。示例: 2026-09-30T15:00:00+08:00

返回数据data
对象（ExperimentRun）列表ExperimentRun[]必填

返回数据的值。示例: […]

记录编号data[].id
记录编号（UUID）string<uuid>必填

记录编号的值。示例: 使用已有记录的编号

Tenant iddata[].tenant_id
记录编号（UUID）string<uuid>必填

Tenant id的值。示例: 使用已有记录的编号

内容类型data[].kind
对象（ExperimentKind）ExperimentKind必填

内容类型的值。示例: {…}

名称data[].name
文本string必填

名称的值。示例: 示例名称

因子版本编号data[].factor_version_id
文本（可为空）string | null必填

因子版本编号的值。示例: 使用已有记录的编号

研究模板编号data[].research_template_id
文本（可为空）string | null必填

研究模板编号的值。示例: 使用已有记录的编号

输入设置data[].inputs
对象object必填

输入设置的值。示例: {…}

代码版本data[].code_ref
文本（可为空）string | null必填

代码版本的值。示例: 示例文本

Data manifest refdata[].data_manifest_ref
文本（可为空）string | null必填

Data manifest ref的值。示例: 示例文本

运行环境data[].environment
对象object必填

运行环境的值。示例: {…}

状态data[].status
对象（ExperimentStatus）ExperimentStatus必填

状态的值。示例: {…}

运行结果data[].result
对象object必填

运行结果的值。示例: {…}

创建时间data[].created_at
日期时间（ISO 8601）string<date-time>必填

创建时间的值。示例: 2026-09-30T15:00:00+08:00

更新时间data[].updated_at
日期时间（ISO 8601）string<date-time>必填

更新时间的值。示例: 2026-09-30T15:00:00+08:00

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
内容类型kind
对象（ExperimentKind）ExperimentKind必填

内容类型的值。示例: {…}

名称name
文本string必填

名称的值。示例: 示例名称

因子版本编号factor_version_id
文本（可为空）string | null可选

因子版本编号的值。示例: 使用已有记录的编号

研究模板编号research_template_id
文本（可为空）string | null可选

研究模板编号的值。示例: 使用已有记录的编号

输入设置inputs
对象object可选

输入设置的值。示例: {…}

代码版本code_ref
文本（可为空）string | null可选

代码版本的值。示例: 示例文本

Data manifest refdata_manifest_ref
文本（可为空）string | null可选

Data manifest ref的值。示例: 示例文本

运行环境environment
对象object可选

运行环境的值。示例: {…}

{
  "kind": "research",
  "name": "Console experiment"
}

返回结果

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

服务暂不可用，请稍后重试

application/problem+json · Problem

成功响应字段

响应信息meta
对象（ResponseMeta）ResponseMeta必填

响应信息的值。示例: {…}

请求编号meta.request_id
记录编号（UUID）string<uuid>必填

请求编号的值。示例: 使用已有记录的编号

数据格式版本meta.schema_version
文本string必填

数据格式版本的值。示例: 示例文本

缓存状态meta.cache_status
对象（CacheStatus）CacheStatus必填

缓存状态的值。示例: {…}

数据标识meta.source
可选值sparkdata-market-data | sparkdata-control-plane必填

数据标识的值。示例: sparkdata-market-data

响应时间meta.generated_at
日期时间（ISO 8601）string<date-time>必填

响应时间的值。示例: 2026-09-30T15:00:00+08:00

返回数据data
对象（ExperimentRun）ExperimentRun必填

返回数据的值。示例: {…}

记录编号data.id
记录编号（UUID）string<uuid>必填

记录编号的值。示例: 使用已有记录的编号

Tenant iddata.tenant_id
记录编号（UUID）string<uuid>必填

Tenant id的值。示例: 使用已有记录的编号

内容类型data.kind
对象（ExperimentKind）ExperimentKind必填

内容类型的值。示例: {…}

名称data.name
文本string必填

名称的值。示例: 示例名称

因子版本编号data.factor_version_id
文本（可为空）string | null必填

因子版本编号的值。示例: 使用已有记录的编号

研究模板编号data.research_template_id
文本（可为空）string | null必填

研究模板编号的值。示例: 使用已有记录的编号

输入设置data.inputs
对象object必填

输入设置的值。示例: {…}

代码版本data.code_ref
文本（可为空）string | null必填

代码版本的值。示例: 示例文本

Data manifest refdata.data_manifest_ref
文本（可为空）string | null必填

Data manifest ref的值。示例: 示例文本

运行环境data.environment
对象object必填

运行环境的值。示例: {…}

状态data.status
对象（ExperimentStatus）ExperimentStatus必填

状态的值。示例: {…}

运行结果data.result
对象object必填

运行结果的值。示例: {…}

创建时间data.created_at
日期时间（ISO 8601）string<date-time>必填

创建时间的值。示例: 2026-09-30T15:00:00+08:00

更新时间data.updated_at
日期时间（ISO 8601）string<date-time>必填

更新时间的值。示例: 2026-09-30T15:00:00+08:00

cURL
curl --request POST \
  'https://spark-data.cn/v1/experiment-runs' \
  --header "Authorization: Bearer $SPARKDATA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"kind":"research","name":"Console experiment"}'
GET/v1/experiment-runs/{run_id}获取一个实验追踪记录
操作 ID
getExperimentRun
认证
账户 API Key

参数

实验编号run_id地址参数
记录编号（UUID）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

服务暂不可用，请稍后重试

application/problem+json · Problem

成功响应字段

响应信息meta
对象（ResponseMeta）ResponseMeta必填

响应信息的值。示例: {…}

请求编号meta.request_id
记录编号（UUID）string<uuid>必填

请求编号的值。示例: 使用已有记录的编号

数据格式版本meta.schema_version
文本string必填

数据格式版本的值。示例: 示例文本

缓存状态meta.cache_status
对象（CacheStatus）CacheStatus必填

缓存状态的值。示例: {…}

数据标识meta.source
可选值sparkdata-market-data | sparkdata-control-plane必填

数据标识的值。示例: sparkdata-market-data

响应时间meta.generated_at
日期时间（ISO 8601）string<date-time>必填

响应时间的值。示例: 2026-09-30T15:00:00+08:00

返回数据data
对象（ExperimentRun）ExperimentRun必填

返回数据的值。示例: {…}

记录编号data.id
记录编号（UUID）string<uuid>必填

记录编号的值。示例: 使用已有记录的编号

Tenant iddata.tenant_id
记录编号（UUID）string<uuid>必填

Tenant id的值。示例: 使用已有记录的编号

内容类型data.kind
对象（ExperimentKind）ExperimentKind必填

内容类型的值。示例: {…}

名称data.name
文本string必填

名称的值。示例: 示例名称

因子版本编号data.factor_version_id
文本（可为空）string | null必填

因子版本编号的值。示例: 使用已有记录的编号

研究模板编号data.research_template_id
文本（可为空）string | null必填

研究模板编号的值。示例: 使用已有记录的编号

输入设置data.inputs
对象object必填

输入设置的值。示例: {…}

代码版本data.code_ref
文本（可为空）string | null必填

代码版本的值。示例: 示例文本

Data manifest refdata.data_manifest_ref
文本（可为空）string | null必填

Data manifest ref的值。示例: 示例文本

运行环境data.environment
对象object必填

运行环境的值。示例: {…}

状态data.status
对象（ExperimentStatus）ExperimentStatus必填

状态的值。示例: {…}

运行结果data.result
对象object必填

运行结果的值。示例: {…}

创建时间data.created_at
日期时间（ISO 8601）string<date-time>必填

创建时间的值。示例: 2026-09-30T15:00:00+08:00

更新时间data.updated_at
日期时间（ISO 8601）string<date-time>必填

更新时间的值。示例: 2026-09-30T15:00:00+08:00

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_id地址参数
记录编号（UUID）string<uuid>必填

实验编号的值。示例: 使用已有记录的编号

请求体

必填

application/json · UpdateExperimentRun
状态status
对象（ExperimentStatus）ExperimentStatus必填

状态的值。示例: {…}

运行结果result
对象object可选

运行结果的值。示例: {…}

{
  "status": "planned"
}

返回结果

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

服务暂不可用，请稍后重试

application/problem+json · Problem

成功响应字段

响应信息meta
对象（ResponseMeta）ResponseMeta必填

响应信息的值。示例: {…}

请求编号meta.request_id
记录编号（UUID）string<uuid>必填

请求编号的值。示例: 使用已有记录的编号

数据格式版本meta.schema_version
文本string必填

数据格式版本的值。示例: 示例文本

缓存状态meta.cache_status
对象（CacheStatus）CacheStatus必填

缓存状态的值。示例: {…}

数据标识meta.source
可选值sparkdata-market-data | sparkdata-control-plane必填

数据标识的值。示例: sparkdata-market-data

响应时间meta.generated_at
日期时间（ISO 8601）string<date-time>必填

响应时间的值。示例: 2026-09-30T15:00:00+08:00

返回数据data
对象（ExperimentRun）ExperimentRun必填

返回数据的值。示例: {…}

记录编号data.id
记录编号（UUID）string<uuid>必填

记录编号的值。示例: 使用已有记录的编号

Tenant iddata.tenant_id
记录编号（UUID）string<uuid>必填

Tenant id的值。示例: 使用已有记录的编号

内容类型data.kind
对象（ExperimentKind）ExperimentKind必填

内容类型的值。示例: {…}

名称data.name
文本string必填

名称的值。示例: 示例名称

因子版本编号data.factor_version_id
文本（可为空）string | null必填

因子版本编号的值。示例: 使用已有记录的编号

研究模板编号data.research_template_id
文本（可为空）string | null必填

研究模板编号的值。示例: 使用已有记录的编号

输入设置data.inputs
对象object必填

输入设置的值。示例: {…}

代码版本data.code_ref
文本（可为空）string | null必填

代码版本的值。示例: 示例文本

Data manifest refdata.data_manifest_ref
文本（可为空）string | null必填

Data manifest ref的值。示例: 示例文本

运行环境data.environment
对象object必填

运行环境的值。示例: {…}

状态data.status
对象（ExperimentStatus）ExperimentStatus必填

状态的值。示例: {…}

运行结果data.result
对象object必填

运行结果的值。示例: {…}

创建时间data.created_at
日期时间（ISO 8601）string<date-time>必填

创建时间的值。示例: 2026-09-30T15:00:00+08:00

更新时间data.updated_at
日期时间（ISO 8601）string<date-time>必填

更新时间的值。示例: 2026-09-30T15:00:00+08:00

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 '{"status":"planned"}'

因子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

服务暂不可用，请稍后重试

application/problem+json · Problem

成功响应字段

响应信息meta
对象（ResponseMeta）ResponseMeta必填

响应信息的值。示例: {…}

请求编号meta.request_id
记录编号（UUID）string<uuid>必填

请求编号的值。示例: 使用已有记录的编号

数据格式版本meta.schema_version
文本string必填

数据格式版本的值。示例: 示例文本

缓存状态meta.cache_status
对象（CacheStatus）CacheStatus必填

缓存状态的值。示例: {…}

数据标识meta.source
可选值sparkdata-market-data | sparkdata-control-plane必填

数据标识的值。示例: sparkdata-market-data

响应时间meta.generated_at
日期时间（ISO 8601）string<date-time>必填

响应时间的值。示例: 2026-09-30T15:00:00+08:00

返回数据data
对象（FactorDefinition）列表FactorDefinition[]必填

返回数据的值。示例: […]

记录编号data[].id
记录编号（UUID）string<uuid>必填

记录编号的值。示例: 使用已有记录的编号

Tenant iddata[].tenant_id
记录编号（UUID）string<uuid>必填

Tenant id的值。示例: 使用已有记录的编号

名称data[].name
文本string必填

名称的值。示例: 示例名称

说明data[].description
文本string必填

说明的值。示例: 示例文本

使用的数据集data[].input_datasets
文本列表string[]必填

使用的数据集的值。示例: […]

研究范围data[].universe_rule
文本string必填

研究范围的值。示例: 示例文本

创建时间data[].created_at
日期时间（ISO 8601）string<date-time>必填

创建时间的值。示例: 2026-09-30T15:00:00+08:00

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
名称name
文本string必填

名称的值。示例: 示例名称

说明description
文本string可选

说明的值。示例: 示例文本

使用的数据集input_datasets
文本列表string[]必填

使用的数据集的值。示例: […]

研究范围universe_rule
文本string必填

研究范围的值。示例: 示例文本

{
  "name": "Console factor",
  "input_datasets": [
    "cn-equity"
  ],
  "universe_rule": "Active A shares"
}

返回结果

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

服务暂不可用，请稍后重试

application/problem+json · Problem

成功响应字段

响应信息meta
对象（ResponseMeta）ResponseMeta必填

响应信息的值。示例: {…}

请求编号meta.request_id
记录编号（UUID）string<uuid>必填

请求编号的值。示例: 使用已有记录的编号

数据格式版本meta.schema_version
文本string必填

数据格式版本的值。示例: 示例文本

缓存状态meta.cache_status
对象（CacheStatus）CacheStatus必填

缓存状态的值。示例: {…}

数据标识meta.source
可选值sparkdata-market-data | sparkdata-control-plane必填

数据标识的值。示例: sparkdata-market-data

响应时间meta.generated_at
日期时间（ISO 8601）string<date-time>必填

响应时间的值。示例: 2026-09-30T15:00:00+08:00

返回数据data
对象（FactorDefinition）FactorDefinition必填

返回数据的值。示例: {…}

记录编号data.id
记录编号（UUID）string<uuid>必填

记录编号的值。示例: 使用已有记录的编号

Tenant iddata.tenant_id
记录编号（UUID）string<uuid>必填

Tenant id的值。示例: 使用已有记录的编号

名称data.name
文本string必填

名称的值。示例: 示例名称

说明data.description
文本string必填

说明的值。示例: 示例文本

使用的数据集data.input_datasets
文本列表string[]必填

使用的数据集的值。示例: […]

研究范围data.universe_rule
文本string必填

研究范围的值。示例: 示例文本

创建时间data.created_at
日期时间（ISO 8601）string<date-time>必填

创建时间的值。示例: 2026-09-30T15:00:00+08:00

cURL
curl --request POST \
  'https://spark-data.cn/v1/factors' \
  --header "Authorization: Bearer $SPARKDATA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"name":"Console factor","input_datasets":["cn-equity"],"universe_rule":"Active A shares"}'
GET/v1/factors/{factor_id}获取一个租户因子定义
操作 ID
getFactor
认证
账户 API Key

参数

因子编号factor_id地址参数
记录编号（UUID）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

服务暂不可用，请稍后重试

application/problem+json · Problem

成功响应字段

响应信息meta
对象（ResponseMeta）ResponseMeta必填

响应信息的值。示例: {…}

请求编号meta.request_id
记录编号（UUID）string<uuid>必填

请求编号的值。示例: 使用已有记录的编号

数据格式版本meta.schema_version
文本string必填

数据格式版本的值。示例: 示例文本

缓存状态meta.cache_status
对象（CacheStatus）CacheStatus必填

缓存状态的值。示例: {…}

数据标识meta.source
可选值sparkdata-market-data | sparkdata-control-plane必填

数据标识的值。示例: sparkdata-market-data

响应时间meta.generated_at
日期时间（ISO 8601）string<date-time>必填

响应时间的值。示例: 2026-09-30T15:00:00+08:00

返回数据data
对象（FactorDefinition）FactorDefinition必填

返回数据的值。示例: {…}

记录编号data.id
记录编号（UUID）string<uuid>必填

记录编号的值。示例: 使用已有记录的编号

Tenant iddata.tenant_id
记录编号（UUID）string<uuid>必填

Tenant id的值。示例: 使用已有记录的编号

名称data.name
文本string必填

名称的值。示例: 示例名称

说明data.description
文本string必填

说明的值。示例: 示例文本

使用的数据集data.input_datasets
文本列表string[]必填

使用的数据集的值。示例: […]

研究范围data.universe_rule
文本string必填

研究范围的值。示例: 示例文本

创建时间data.created_at
日期时间（ISO 8601）string<date-time>必填

创建时间的值。示例: 2026-09-30T15:00:00+08:00

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_id地址参数
记录编号（UUID）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

服务暂不可用，请稍后重试

application/problem+json · Problem

成功响应字段

响应信息meta
对象（ResponseMeta）ResponseMeta必填

响应信息的值。示例: {…}

请求编号meta.request_id
记录编号（UUID）string<uuid>必填

请求编号的值。示例: 使用已有记录的编号

数据格式版本meta.schema_version
文本string必填

数据格式版本的值。示例: 示例文本

缓存状态meta.cache_status
对象（CacheStatus）CacheStatus必填

缓存状态的值。示例: {…}

数据标识meta.source
可选值sparkdata-market-data | sparkdata-control-plane必填

数据标识的值。示例: sparkdata-market-data

响应时间meta.generated_at
日期时间（ISO 8601）string<date-time>必填

响应时间的值。示例: 2026-09-30T15:00:00+08:00

返回数据data
对象（FactorVersion）列表FactorVersion[]必填

返回数据的值。示例: […]

记录编号data[].id
记录编号（UUID）string<uuid>必填

记录编号的值。示例: 使用已有记录的编号

因子编号data[].factor_id
记录编号（UUID）string<uuid>必填

因子编号的值。示例: 使用已有记录的编号

版本号data[].version_number
整数integer必填

版本号的值。示例: 1

计算表达式data[].expression
文本string必填

计算表达式的值。示例: 示例文本

回看天数data[].lookback_days
整数integer必填

回看天数的值。示例: 1

复权方式data[].adjustment
可选值raw | forward | backward必填

复权方式的值。示例: raw

创建时间data[].created_at
日期时间（ISO 8601）string<date-time>必填

创建时间的值。示例: 2026-09-30T15:00:00+08:00

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_id地址参数
记录编号（UUID）string<uuid>必填

因子编号的值。示例: 使用已有记录的编号

请求体

必填

application/json · CreateFactorVersion
计算表达式expression
文本string必填

计算表达式的值。示例: 示例文本

回看天数lookback_days
整数integer必填

回看天数的值。示例: 1

复权方式adjustment
可选值raw | forward | backward可选

复权方式的值。示例: raw

{
  "expression": "return_20d",
  "lookback_days": 20
}

返回结果

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

服务暂不可用，请稍后重试

application/problem+json · Problem

成功响应字段

响应信息meta
对象（ResponseMeta）ResponseMeta必填

响应信息的值。示例: {…}

请求编号meta.request_id
记录编号（UUID）string<uuid>必填

请求编号的值。示例: 使用已有记录的编号

数据格式版本meta.schema_version
文本string必填

数据格式版本的值。示例: 示例文本

缓存状态meta.cache_status
对象（CacheStatus）CacheStatus必填

缓存状态的值。示例: {…}

数据标识meta.source
可选值sparkdata-market-data | sparkdata-control-plane必填

数据标识的值。示例: sparkdata-market-data

响应时间meta.generated_at
日期时间（ISO 8601）string<date-time>必填

响应时间的值。示例: 2026-09-30T15:00:00+08:00

返回数据data
对象（FactorVersion）FactorVersion必填

返回数据的值。示例: {…}

记录编号data.id
记录编号（UUID）string<uuid>必填

记录编号的值。示例: 使用已有记录的编号

因子编号data.factor_id
记录编号（UUID）string<uuid>必填

因子编号的值。示例: 使用已有记录的编号

版本号data.version_number
整数integer必填

版本号的值。示例: 1

计算表达式data.expression
文本string必填

计算表达式的值。示例: 示例文本

回看天数data.lookback_days
整数integer必填

回看天数的值。示例: 1

复权方式data.adjustment
可选值raw | forward | backward必填

复权方式的值。示例: raw

创建时间data.created_at
日期时间（ISO 8601）string<date-time>必填

创建时间的值。示例: 2026-09-30T15:00:00+08:00

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 '{"expression":"return_20d","lookback_days":20}'

在线 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

成功响应字段

名称name
文本string必填

名称的值。示例: 示例名称

说明description
文本string必填

说明的值。示例: 示例文本

Supported InterfacessupportedInterfaces
对象列表object[]必填

Supported Interfaces的值。示例: […]

版本version
文本string必填

版本的值。示例: 示例文本

Capabilitiescapabilities
对象object必填

Capabilities的值。示例: {…}

Default Input ModesdefaultInputModes
文本列表string[]必填

Default Input Modes的值。示例: […]

Default Output ModesdefaultOutputModes
文本列表string[]必填

Default Output Modes的值。示例: […]

Skillsskills
对象列表object[]必填

Skills的值。示例: […]

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

参数

Agent协议版本A2A-Version请求头
文本string必填

This interface supports A2A protocol version 1.0 only.示例: 示例文本

Agent扩展能力A2A-Extensions请求头
文本string可选

Comma-separated optional A2A extension URIs selected by the client.示例: 示例文本

会话安全校验值X-CSRF-Token请求头
文本string必填

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

请求体

必填

application/a2a+json · SendAgentMessageRequest
消息内容message
对象（AgentMessage）AgentMessage必填

消息内容的值。示例: {…}

消息编号message.messageId
记录编号（UUID）string<uuid>必填

消息编号的值。示例: 使用已有记录的编号

消息角色message.role
可选值ROLE_USER | ROLE_AGENT必填

消息角色的值。示例: user

Partsmessage.parts
对象（AgentPart）列表AgentPart[]必填

Parts的值。示例: […]

会话编号message.contextId
记录编号（UUID）string<uuid>可选

会话编号的值。示例: 使用已有记录的编号

任务编号message.taskId
记录编号（UUID）string<uuid>可选

任务编号的值。示例: 使用已有记录的编号

Configurationconfiguration
对象（AgentSendConfiguration）AgentSendConfiguration可选

Configuration的值。示例: {…}

Accepted Output Modesconfiguration.acceptedOutputModes
可选值列表text/markdown | application/json[]可选

Accepted Output Modes的值。示例: […]

历史消息条数configuration.historyLength
整数integer可选

历史消息条数的值。示例: 1

返回结果

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

服务暂不可用，请稍后重试

application/problem+json · Problem

成功响应字段

字段随具体接口而定，请查看调用示例或试运行结果。

cURL
curl --request POST \
  'https://spark-data.cn/v1/agent/a2a/message:send' \
  --cookie "$SPARKDATA_SESSION_COOKIE" \
  --header 'Content-Type: application/json' \
  --data '""'
POST/v1/agent/a2a/message:stream发送消息并流式接收 Task 生命周期事件

The first SSE data field is a Task envelope. Later fields contain statusUpdate or artifactUpdate. Public workflow steps are not private model reasoning.

操作 ID
streamAgentMessage
认证
用户会话 Cookie

参数

Agent协议版本A2A-Version请求头
文本string必填

This interface supports A2A protocol version 1.0 only.示例: 示例文本

Agent扩展能力A2A-Extensions请求头
文本string可选

Comma-separated optional A2A extension URIs selected by the client.示例: 示例文本

会话安全校验值X-CSRF-Token请求头
文本string必填

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

请求体

必填

application/a2a+json · SendAgentMessageRequest
消息内容message
对象（AgentMessage）AgentMessage必填

消息内容的值。示例: {…}

消息编号message.messageId
记录编号（UUID）string<uuid>必填

消息编号的值。示例: 使用已有记录的编号

消息角色message.role
可选值ROLE_USER | ROLE_AGENT必填

消息角色的值。示例: user

Partsmessage.parts
对象（AgentPart）列表AgentPart[]必填

Parts的值。示例: […]

会话编号message.contextId
记录编号（UUID）string<uuid>可选

会话编号的值。示例: 使用已有记录的编号

任务编号message.taskId
记录编号（UUID）string<uuid>可选

任务编号的值。示例: 使用已有记录的编号

Configurationconfiguration
对象（AgentSendConfiguration）AgentSendConfiguration可选

Configuration的值。示例: {…}

Accepted Output Modesconfiguration.acceptedOutputModes
可选值列表text/markdown | application/json[]可选

Accepted Output Modes的值。示例: […]

历史消息条数configuration.historyLength
整数integer可选

历史消息条数的值。示例: 1

返回结果

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

服务暂不可用，请稍后重试

application/problem+json · Problem

成功响应字段

字段随具体接口而定，请查看调用示例或试运行结果。

cURL
curl --request POST \
  'https://spark-data.cn/v1/agent/a2a/message:stream' \
  --cookie "$SPARKDATA_SESSION_COOKIE" \
  --header 'Content-Type: application/json' \
  --data '""'
GET/v1/agent/a2a/tasks列出当前登录用户拥有的 Agent Task
操作 ID
listAgentTasks
认证
用户会话 Cookie

参数

Agent协议版本A2A-Version请求头
文本string必填

This interface supports A2A protocol version 1.0 only.示例: 示例文本

会话编号contextId查询参数
记录编号（UUID）string<uuid>可选

会话编号的值。示例: 使用已有记录的编号

每页条数pageSize查询参数
整数integer可选

每页条数的值。示例: 50

返回结果

200

Owner-scoped Task page

application/a2a+json · AgentTaskList
400

请求无效

application/problem+json · Problem
401

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

application/problem+json · Problem
503

服务暂不可用，请稍后重试

application/problem+json · Problem

成功响应字段

字段随具体接口而定，请查看调用示例或试运行结果。

cURL
curl --request GET \
  'https://spark-data.cn/v1/agent/a2a/tasks' \
  --cookie "$SPARKDATA_SESSION_COOKIE"
GET/v1/agent/a2a/tasks/{id}获取一个权威的用户级 Task 快照
操作 ID
getAgentTask
认证
用户会话 Cookie

参数

Agent协议版本A2A-Version请求头
文本string必填

This interface supports A2A protocol version 1.0 only.示例: 示例文本

记录编号id地址参数
记录编号（UUID）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

服务暂不可用，请稍后重试

application/problem+json · Problem

成功响应字段

字段随具体接口而定，请查看调用示例或试运行结果。

cURL
curl --request GET \
  'https://spark-data.cn/v1/agent/a2a/tasks/value' \
  --cookie "$SPARKDATA_SESSION_COOKIE"
POST/v1/agent/a2a/tasks/{id}:subscribe续订一个运行中 Task 的流式事件
操作 ID
subscribeAgentTask
认证
用户会话 Cookie

参数

Agent协议版本A2A-Version请求头
文本string必填

This interface supports A2A protocol version 1.0 only.示例: 示例文本

Agent扩展能力A2A-Extensions请求头
文本string可选

Comma-separated optional A2A extension URIs selected by the client.示例: 示例文本

会话安全校验值X-CSRF-Token请求头
文本string必填

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

记录编号id地址参数
记录编号（UUID）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

服务暂不可用，请稍后重试

application/problem+json · Problem

成功响应字段

字段随具体接口而定，请查看调用示例或试运行结果。

cURL
curl --request POST \
  'https://spark-data.cn/v1/agent/a2a/tasks/value:subscribe' \
  --cookie "$SPARKDATA_SESSION_COOKIE"
POST/v1/agent/a2a/tasks/{id}:cancel取消一个运行中的用户级 Task
操作 ID
cancelAgentTask
认证
用户会话 Cookie

参数

Agent协议版本A2A-Version请求头
文本string必填

This interface supports A2A protocol version 1.0 only.示例: 示例文本

会话安全校验值X-CSRF-Token请求头
文本string必填

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

记录编号id地址参数
记录编号（UUID）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

服务暂不可用，请稍后重试

application/problem+json · Problem

成功响应字段

字段随具体接口而定，请查看调用示例或试运行结果。

cURL
curl --request POST \
  'https://spark-data.cn/v1/agent/a2a/tasks/value:cancel' \
  --cookie "$SPARKDATA_SESSION_COOKIE" \
  --header 'Content-Type: application/json' \
  --data '""'

资讯数据Content

查询新闻、公告、研报、政策与互动问答。

4 个接口
GET/v1/content/sources查看资讯分类

查看可查询的新闻、公告、研报、政策与互动问答分类。

操作 ID
listContentSources
认证
公开

参数

缓存校验标记If-None-Match请求头
文本string可选

缓存校验标记的值。示例: 示例文本

返回结果

200

Successful JSON response.

application/json · object
304

Public metadata is semantically unchanged; no response body.

400

请求无效

application/problem+json · Problem

成功响应字段

响应信息meta
对象object必填

响应信息的值。示例: {…}

返回数据data
对象（ContentSource）列表ContentSource[]必填

返回数据的值。示例: […]

cURL
curl --request GET \
  'https://spark-data.cn/v1/content/sources'
GET/v1/content/items读取当前账户的资讯索引

读取当前账户可访问的资讯，按发布时间排序。可用关键词与关联证券缩小范围。

操作 ID
listContentItems
认证
账户 API Key

参数

搜索关键词q查询参数
文本string可选

搜索关键词的值。示例: 贵州茅台

内容类型kind查询参数
文本string可选

内容类型的值。示例: 示例文本

接口名称operation查询参数
文本string可选

接口名称的值。示例: FinancialStatement

发布机构publisher查询参数
文本string可选

发布机构的值。示例: 示例文本

关联证券entity查询参数
文本string可选

关联证券的值。示例: 示例文本

开始时间start查询参数
文本string可选

开始时间的值。示例: 2026-09-01T00:00:00+08:00

结束时间end查询参数
文本string可选

结束时间的值。示例: 2026-09-30T23:59:59+08:00

下一页标记cursor查询参数
文本string可选

下一页标记的值。示例: 示例文本

每页条数page_size查询参数
整数integer可选

每页条数的值。示例: 20

返回结果

200

Successful JSON response.

application/json · object
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

服务暂不可用，请稍后重试

application/problem+json · Problem

成功响应字段

响应信息meta
对象object必填

响应信息的值。示例: {…}

返回数据data
对象（ContentPage）ContentPage必填

返回数据的值。示例: {…}

cURL
curl --request GET \
  'https://spark-data.cn/v1/content/items' \
  --header "Authorization: Bearer $SPARKDATA_API_KEY"
GET/v1/content/items/{id}查看资讯详情

根据资讯编号查看详情。正文显示取决于相应内容的使用许可。

操作 ID
getContentItem
认证
账户 API Key

参数

记录编号id地址参数
文本string必填

记录编号的值。示例: 使用已有记录的编号

返回结果

200

Successful JSON response.

application/json · object
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

服务暂不可用，请稍后重试

application/problem+json · Problem

成功响应字段

响应信息meta
对象object必填

响应信息的值。示例: {…}

返回数据data
对象（ContentItem）ContentItem必填

返回数据的值。示例: {…}

cURL
curl --request GET \
  'https://spark-data.cn/v1/content/items/value' \
  --header "Authorization: Bearer $SPARKDATA_API_KEY"
POST/v1/content/items/query查询一页最新资讯

按资讯接口与查询条件读取最新内容。查询结果可在当前账户内继续检索和查看。

操作 ID
queryContentItems
认证
账户 API Key

参数

此操作没有参数。

请求体

必填

application/json · AggregateQuery
接口名称operation
文本string必填

接口名称区分大小写，例如 FinancialStatement。示例: FinancialStatement

查询参数parameters
对象object可选

请使用接口说明列出的参数名称和值，不支持其他字段。示例: {…}

{
  "operation": "NewsInfoList",
  "parameters": {
    "pageNo": 1,
    "pageSize": 30
  }
}

返回结果

200

Successful JSON response.

application/json · object
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

服务暂不可用，请稍后重试

application/problem+json · Problem

成功响应字段

响应信息meta
对象object必填

响应信息的值。示例: {…}

返回数据data
对象（ContentItem）列表ContentItem[]必填

返回数据的值。示例: […]

cURL
curl --request POST \
  'https://spark-data.cn/v1/content/items/query' \
  --header "Authorization: Bearer $SPARKDATA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"operation":"NewsInfoList","parameters":{"pageNo":1,"pageSize":30}}'

细分数据接口Data Operations

按接口名称查询行情、财务、股权、宏观与其他数据。

1 个接口
POST/v1/data/operations/{operation}查询一个数据接口

将目录中的接口名称填写到 operation，查询条件放入 parameters。参数名称区分大小写；具体入参、返回字段与完整示例可在数据目录中查看。查询使用账户下的 API Key，并校验账户订阅与使用额度。

操作 ID
queryDataOperation
认证
账户 API Key

参数

接口名称operation地址参数
文本string必填

接口名称的值。示例: FinancialStatement

请求体

必填

application/json · object
查询参数parameters
对象object可选

查询参数的值。示例: {…}

{
  "parameters": {
    "stockObject": [
      "贵州茅台"
    ],
    "finStatementSubject": [
      "资产总计"
    ]
  }
}

返回结果

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

服务暂不可用，请稍后重试

application/problem+json · Problem

成功响应字段

响应信息meta
对象（ResponseMeta）ResponseMeta必填

响应信息的值。示例: {…}

请求编号meta.request_id
记录编号（UUID）string<uuid>必填

请求编号的值。示例: 使用已有记录的编号

数据格式版本meta.schema_version
文本string必填

数据格式版本的值。示例: 示例文本

缓存状态meta.cache_status
对象（CacheStatus）CacheStatus必填

缓存状态的值。示例: {…}

数据标识meta.source
可选值sparkdata-market-data | sparkdata-control-plane必填

数据标识的值。示例: sparkdata-market-data

响应时间meta.generated_at
日期时间（ISO 8601）string<date-time>必填

响应时间的值。示例: 2026-09-30T15:00:00+08:00

返回数据data
对象（AggregateData）AggregateData必填

返回数据的值。示例: {…}

接口编号data.api_id
整数integer必填

接口编号的值。示例: 使用已有记录的编号

数据能力data.capability
对象（Capability）Capability必填

数据能力的值。示例: {…}

接口名称data.operation
文本string必填

接口名称的值。示例: FinancialStatement

实际查询参数data.resolved_parameters
对象object必填

完成固定值补充与选项解析后的实际查询条件。示例: {…}

Enum resolutionsdata.enum_resolutions
对象（EnumResolution）列表EnumResolution[]必填

Enum resolutions的值。示例: […]

字段名称data.enum_resolutions[].field
文本string必填

字段名称的值。示例: 示例文本

Group namedata.enum_resolutions[].group_name
文本string必填

Group name的值。示例: 示例文本

Inputdata.enum_resolutions[].input
对象object必填

Input的值。示例: {…}

错误代码data.enum_resolutions[].code
文本string必填

错误代码的值。示例: 示例文本

Captiondata.enum_resolutions[].caption
文本（可为空）string | null必填

Caption的值。示例: 示例文本

扩展数据data.enum_resolutions[].provider_data
对象（ProviderData）ProviderData必填

扩展数据的值。示例: {…}

扩展数据data.provider_data
对象（ProviderData）ProviderData必填

扩展数据的值。示例: {…}

接口名称data.provider_data.operation
文本string必填

数据目录中的接口名称，区分大小写。示例: FinancialStatement

原始结果data.provider_data.raw
对象object必填

该记录对应的原始数据结果。示例: {…}

cURL
curl --request POST \
  'https://spark-data.cn/v1/data/operations/FinancialStatement' \
  --header "Authorization: Bearer $SPARKDATA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"parameters":{"stockObject":["贵州茅台"],"finStatementSubject":["资产总计"]}}'

订单与订阅Billing

查看年度报价、订阅有效期与支付订单。购买和订单管理使用登录会话。

6 个接口
GET/v1/billing/catalog查看年度订阅与当前报价

查看各套餐与单接口的年价，以及当前可用的支付方式。价格为空表示尚未定价，未开放的商品不能购买。

操作 ID
listBillingCatalog
认证
公开

参数

此操作没有参数。

返回结果

200

Published prices and channel availability.

application/json · object
default

Invalid input, forbidden origin or CSRF, stale version, duplicate operation, login throttling or unavailable dependency. No credential values are included.

application/problem+json · Problem

成功响应字段

响应信息meta
对象（ResponseMeta）ResponseMeta必填

响应信息的值。示例: {…}

返回数据data
对象（BillingCatalog）BillingCatalog必填

返回数据的值。示例: {…}

cURL
curl --request GET \
  'https://spark-data.cn/v1/billing/catalog'
GET/v1/tenants/{tenant_id}/billing/entitlements查看账户当前订阅与有效期

查看账户已付款且尚未到期的订阅，包括未来生效的续费。有效权限由账户下所有 API Key 共享。

操作 ID
getWorkspaceEntitlements
认证
用户会话 Cookie

参数

Tenant idtenant_id地址参数
记录编号（UUID）string<uuid>必填

Tenant id的值。示例: 使用已有记录的编号

返回结果

200

Current tenant billing information.

application/json · object
400

请求无效

application/problem+json · Problem
401

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

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
404

资源不存在

application/problem+json · Problem
default

Invalid input, forbidden origin or CSRF, stale version, duplicate operation, login throttling or unavailable dependency. No credential values are included.

application/problem+json · Problem

成功响应字段

响应信息meta
对象（ResponseMeta）ResponseMeta必填

响应信息的值。示例: {…}

返回数据data
对象（BillingEntitlements）BillingEntitlements必填

返回数据的值。示例: {…}

cURL
curl --request GET \
  'https://spark-data.cn/v1/tenants/TENANT_ID/billing/entitlements' \
  --cookie "$SPARKDATA_SESSION_COOKIE"
GET/v1/tenants/{tenant_id}/billing/orders查看账户支付订单

账户所有者可查看支付订单，每页最多返回 25 条。offset 用于读取后续记录。

操作 ID
listBillingOrders
认证
用户会话 Cookie

参数

Tenant idtenant_id地址参数
记录编号（UUID）string<uuid>必填

Tenant id的值。示例: 使用已有记录的编号

Offsetoffset查询参数
整数integer可选

Offset的值。示例: 0

返回结果

200

Current tenant billing information.

application/json · object
400

请求无效

application/problem+json · Problem
401

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

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
404

资源不存在

application/problem+json · Problem
default

Invalid input, forbidden origin or CSRF, stale version, duplicate operation, login throttling or unavailable dependency. No credential values are included.

application/problem+json · Problem

成功响应字段

响应信息meta
对象（ResponseMeta）ResponseMeta必填

响应信息的值。示例: {…}

返回数据data
对象（BillingOrders）BillingOrders必填

返回数据的值。示例: {…}

cURL
curl --request GET \
  'https://spark-data.cn/v1/tenants/TENANT_ID/billing/orders' \
  --cookie "$SPARKDATA_SESSION_COOKIE"
POST/v1/tenants/{tenant_id}/billing/orders创建年度订阅支付订单

账户所有者可选择商品和已开放的支付方式创建订单。使用商品目录中的价格版本，并提供登录会话安全校验和幂等请求标记。

操作 ID
createBillingOrder
认证
用户会话 Cookie

参数

Tenant idtenant_id地址参数
记录编号（UUID）string<uuid>必填

Tenant id的值。示例: 使用已有记录的编号

会话安全校验值X-CSRF-Token请求头
文本string必填

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

OriginOrigin请求头
对象（string<uri>）string<uri>必填

Origin的值。示例: {…}

Idempotency-KeyIdempotency-Key请求头
文本string必填

Idempotency-Key的值。示例: 示例文本

请求体

必填

application/json · object
订阅商品编号product_id
文本string必填

使用商品目录返回的商品编号，套餐以 plan: 开头，单接口以 api: 开头。示例: api:FinancialStatement

报价版本price_revision
整数integer必填

使用商品目录中的 revision 值，确保提交的是当前报价。示例: 1

支付方式payment_provider
可选值alipay | wechat必填

选择已开放的支付方式：alipay 为支付宝，wechat 为微信支付。示例: alipay

{
  "product_id": "api:FinancialStatement",
  "price_revision": 1,
  "payment_provider": "alipay"
}

返回结果

201

Persisted order; repeated requests return the same order.

application/json · object
400

请求无效

application/problem+json · Problem
401

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

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
404

资源不存在

application/problem+json · Problem
default

Invalid input, forbidden origin or CSRF, stale version, duplicate operation, login throttling or unavailable dependency. No credential values are included.

application/problem+json · Problem

成功响应字段

响应信息meta
对象（ResponseMeta）ResponseMeta必填

响应信息的值。示例: {…}

返回数据data
对象（BillingOrder）BillingOrder必填

返回数据的值。示例: {…}

cURL
curl --request POST \
  'https://spark-data.cn/v1/tenants/TENANT_ID/billing/orders' \
  --cookie "$SPARKDATA_SESSION_COOKIE" \
  --header 'Content-Type: application/json' \
  --data '{"product_id":"api:FinancialStatement","price_revision":1,"payment_provider":"alipay"}'
GET/v1/tenants/{tenant_id}/billing/orders/{order_id}查看订单并核对支付状态

查看订单金额、付款状态与订阅时间。refresh=true 会向支付渠道核对，网页显示不能作为付款证明。

操作 ID
getBillingOrder
认证
用户会话 Cookie

参数

Tenant idtenant_id地址参数
记录编号（UUID）string<uuid>必填

Tenant id的值。示例: 使用已有记录的编号

Order idorder_id地址参数
文本string必填

Order id的值。示例: 使用已有记录的编号

Refreshrefresh查询参数
是 / 否boolean可选

Reconcile pending orders with the payment channel.示例: false

返回结果

200

Current tenant billing information.

application/json · object
400

请求无效

application/problem+json · Problem
401

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

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
404

资源不存在

application/problem+json · Problem
default

Invalid input, forbidden origin or CSRF, stale version, duplicate operation, login throttling or unavailable dependency. No credential values are included.

application/problem+json · Problem

成功响应字段

响应信息meta
对象（ResponseMeta）ResponseMeta必填

响应信息的值。示例: {…}

返回数据data
对象（BillingOrder）BillingOrder必填

返回数据的值。示例: {…}

cURL
curl --request GET \
  'https://spark-data.cn/v1/tenants/TENANT_ID/billing/orders/value' \
  --cookie "$SPARKDATA_SESSION_COOKIE"
POST/v1/tenants/{tenant_id}/billing/orders/{order_id}/close关闭尚未支付的订单

核对付款状态后关闭未付款订单。已付款订单保持原状态，此操作不发起退款。

操作 ID
closeBillingOrder
认证
用户会话 Cookie

参数

Tenant idtenant_id地址参数
记录编号（UUID）string<uuid>必填

Tenant id的值。示例: 使用已有记录的编号

Order idorder_id地址参数
文本string必填

Order id的值。示例: 使用已有记录的编号

会话安全校验值X-CSRF-Token请求头
文本string必填

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

OriginOrigin请求头
对象（string<uri>）string<uri>必填

Origin的值。示例: {…}

返回结果

200

Authoritative current order status.

application/json · object
400

请求无效

application/problem+json · Problem
401

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

application/problem+json · Problem
403

API Key 缺少所需权限范围

application/problem+json · Problem
404

资源不存在

application/problem+json · Problem
default

Invalid input, forbidden origin or CSRF, stale version, duplicate operation, login throttling or unavailable dependency. No credential values are included.

application/problem+json · Problem

成功响应字段

响应信息meta
对象（ResponseMeta）ResponseMeta必填

响应信息的值。示例: {…}

返回数据data
对象（BillingOrder）BillingOrder必填

返回数据的值。示例: {…}

cURL
curl --request POST \
  'https://spark-data.cn/v1/tenants/TENANT_ID/billing/orders/value/close' \
  --cookie "$SPARKDATA_SESSION_COOKIE"

公开数据对象

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

82 公开对象
BillingProductobject
记录编号id
文本string必填

记录编号的值。示例: 使用已有记录的编号

内容类型kind
可选值plan | api必填

内容类型的值。示例: plan

接口名称operation
文本（可为空）string | null必填

接口名称的值。示例: FinancialStatement

Plan codeplan_code
可选值（可为空）free | plus | pro | null必填

Plan code的值。示例: free

Title zhtitle_zh
文本string必填

Title zh的值。示例: 示例文本

Title entitle_en
文本string必填

Title en的值。示例: 示例文本

年价（分）price_minor
整数（可为空）integer | null必填

年度价格，以人民币分为单位；59900 表示 599 元。null 表示未定价。示例: 59900

是否上架sale_enabled
是 / 否boolean必填

是否上架的值。示例: false

Revisionrevision
整数integer必填

Revision的值。示例: 1

BillingCatalogobject
币种currency
文本string必填

币种的值。示例: CNY

订阅月数period_months
整数integer必填

订阅月数的值。示例: 12

Productsproducts
对象（BillingProduct）列表BillingProduct[]必填

Products的值。示例: […]

Providersproviders
对象列表object[]必填

Providers的值。示例: […]

数据权限校验状态enforcement_enabled
是 / 否boolean必填

表示付费订阅是否开放；为 false 时不能创建支付订单。示例: false

BillingOrderobject
记录编号id
文本string必填

记录编号的值。示例: 使用已有记录的编号

Tenant idtenant_id
记录编号（UUID）string<uuid>必填

Tenant id的值。示例: 使用已有记录的编号

Productproduct
对象（BillingProduct）BillingProduct必填

Product的值。示例: {…}

数据标识provider
可选值alipay | wechat必填

数据标识的值。示例: alipay

订单金额（分）amount_minor
整数integer必填

本笔订单应付金额，以人民币分为单位。示例: 19900

币种currency
文本string必填

币种的值。示例: CNY

订阅月数period_months
整数integer必填

订阅月数的值。示例: 12

状态status
可选值pending | paid | closed | review必填

状态的值。示例: pending

支付二维码内容payment_code
文本（可为空）string | null必填

Provider payment payload: an RSA2-signed official Alipay page.pay cashier URL for embedding or opening, or a WeChat Native QR code_url. Null when creation is incomplete. Browser navigation is never proof of payment.示例: 示例文本

支付流水编号trade_id
文本（可为空）string | null必填

支付流水编号的值。示例: 使用已有记录的编号

创建时间created_at
日期时间（ISO 8601）string<date-time>必填

创建时间的值。示例: 2026-09-30T15:00:00+08:00

Expires atexpires_at
日期时间（ISO 8601）string<date-time>必填

Expires at的值。示例: 2026-09-30T15:00:00+08:00

Paid atpaid_at
文本（可为空）string | null必填

Paid at的值。示例: 示例文本

订阅生效时间entitlement_starts_at
文本（可为空）string | null必填

订阅生效时间的值。示例: 示例文本

订阅到期时间entitlement_ends_at
文本（可为空）string | null必填

订阅到期时间的值。示例: 示例文本

BillingOrdersobject
结果列表items
对象（BillingOrder）列表BillingOrder[]必填

结果列表的值。示例: […]

Offsetoffset
整数integer必填

Offset的值。示例: 1

Limitlimit
整数integer必填

Limit的值。示例: 1

TrialAccessobject
权限等级plan
可选值free | plus | pro必填

Free means trial access is disabled.示例: free

生效时间starts_at
日期时间（ISO 8601）string<date-time>必填

生效时间的值。示例: 2026-09-30T15:00:00+08:00

到期时间ends_at
日期时间（ISO 8601）string<date-time>必填

到期时间的值。示例: 2026-09-30T15:00:00+08:00

Revisionrevision
整数integer必填

Revision的值。示例: 1

BillingEntitlementsobject
测试权限trial
对象（TrialAccess）（可为空）TrialAccess | null必填

测试权限的值。示例: {…}

当前套餐effective_plan
可选值free | plus | pro必填

Highest active purchased or trial access.示例: free

数据权限校验状态enforcement_enabled
是 / 否boolean必填

表示付费订阅是否开放；为 false 时不能创建支付订单。示例: false

结果列表items
对象列表object[]必填

结果列表的值。示例: […]

CatalogCategoryobject
记录编号id
文本string必填

记录编号的值。示例: 使用已有记录的编号

Parent idparent_id
文本（可为空）string | null必填

Parent id的值。示例: 使用已有记录的编号

Name zhname_zh
文本string必填

Name zh的值。示例: 示例文本

Name enname_en
文本string必填

Name en的值。示例: 示例文本

CatalogOperationobject
数据能力capability
文本string可选

数据能力的值。示例: 示例文本

Legacy http pathlegacy_http_path
文本string可选

Deprecated compatibility carrier path.示例: 示例文本

记录编号id
文本string必填

记录编号的值。示例: 使用已有记录的编号

数据标识provider
文本string可选

数据标识的值。示例: 示例文本

Source idsource_id
整数integer必填

Source id的值。示例: 使用已有记录的编号

接口名称operation
文本string必填

接口名称的值。示例: FinancialStatement

Source groupsource_group
文本string可选

Source group的值。示例: 示例文本

Category idcategory_id
文本string必填

Category id的值。示例: 使用已有记录的编号

Title zhtitle_zh
文本string必填

Title zh的值。示例: 示例文本

Title entitle_en
文本string必填

Title en的值。示例: 示例文本

Description zhdescription_zh
文本string可选

Description zh的值。示例: 示例文本

Asset tagsasset_tags
文本列表string[]可选

Asset tags的值。示例: […]

适用套餐required_plan
可选值free | plus | pro可选

适用套餐的值。示例: free

Plan policy statusplan_policy_status
文本string必填

Plan policy status的值。示例: 示例文本

Http methodhttp_method
文本string可选

Http method的值。示例: 示例文本

Http pathhttp_path
文本string必填

Http path的值。示例: 示例文本

Contract statuscontract_status
文本string可选

Contract status的值。示例: 示例文本

Coverage statuscoverage_status
文本string必填

Coverage status的值。示例: 示例文本

使用许可rights_status
文本string必填

使用许可的值。示例: 示例文本

Watermarkwatermark
文本（可为空）string | null可选

Watermark的值。示例: 示例文本

Last verified atlast_verified_at
文本string可选

Last verified at的值。示例: 示例文本

数据格式版本schema_version
文本string可选

数据格式版本的值。示例: 示例文本

输入设置inputs
对象列表object[]必填

输入设置的值。示例: […]

输出设置outputs
对象列表object[]必填

输出设置的值。示例: […]

CatalogPageobject
结果列表items
对象（CatalogOperation）列表CatalogOperation[]必填

结果列表的值。示例: […]

总条数total
整数integer必填

总条数的值。示例: 1

页码page
整数integer必填

页码的值。示例: 1

每页条数page_size
整数integer必填

每页条数的值。示例: 20

数据格式版本schema_version
文本string必填

数据格式版本的值。示例: 示例文本

ContentSourceobject
接口名称operation
文本string必填

接口名称的值。示例: FinancialStatement

Name zhname_zh
文本string必填

Name zh的值。示例: 示例文本

Name enname_en
文本string必填

Name en的值。示例: 示例文本

内容类型kind
文本string必填

内容类型的值。示例: 示例文本

适用套餐required_plan
文本string必填

适用套餐的值。示例: 示例文本

使用许可rights_status
文本string必填

使用许可的值。示例: 示例文本

ContentItemobject
记录编号id
文本string必填

记录编号的值。示例: 使用已有记录的编号

数据标识source
文本string必填

数据标识的值。示例: 示例文本

关联接口source_operation
文本string必填

关联接口的值。示例: 示例文本

Source item idsource_item_id
文本（可为空）string | null可选

Source item id的值。示例: 使用已有记录的编号

内容类型kind
可选值news | announcement | research | qa | policy必填

内容类型的值。示例: news

标题title
文本string必填

标题的值。示例: 示例文本

结果摘要summary
文本（可为空）string | null可选

结果摘要的值。示例: 示例文本

正文body
文本（可为空）string | null可选

正文的值。示例: 示例文本

正文状态body_status
可选值available | restricted | link_only | missing必填

正文状态的值。示例: available

发布机构publisher
文本（可为空）string | null可选

发布机构的值。示例: 示例文本

原文链接source_url
文本（可为空）string | null可选

原文链接的值。示例: 示例文本

发布时间published_at
文本（可为空）string | null必填

发布时间的值。示例: 示例文本

发布日期published_date
文本（可为空）string | null必填

发布日期的值。示例: 示例文本

时间精度time_precision
可选值second | date | unknown必填

时间精度的值。示例: second

Ingested atingested_at
日期时间（ISO 8601）string<date-time>必填

Ingested at的值。示例: 2026-09-30T15:00:00+08:00

更新时间updated_at
日期时间（ISO 8601）string<date-time>可选

更新时间的值。示例: 2026-09-30T15:00:00+08:00

关联对象entities
文本列表string[]必填

关联对象的值。示例: […]

Revisionrevision
整数integer必填

Revision的值。示例: 1

Content hashcontent_hash
文本string可选

Content hash的值。示例: 示例文本

许可范围rights_scope
文本string必填

许可范围的值。示例: 示例文本

Normalizer versionnormalizer_version
文本string可选

Normalizer version的值。示例: 示例文本

ContentPageobject
结果列表items
对象（ContentItem）列表ContentItem[]必填

结果列表的值。示例: […]

下一页标记next_cursor
文本（可为空）string | null必填

下一页标记的值。示例: 示例文本

截至时间as_of
日期时间（ISO 8601）string<date-time>必填

截至时间的值。示例: 2026-09-30T15:00:00+08:00

每页条数page_size
整数integer必填

每页条数的值。示例: 20

LlmPolicyobject
Enabledenabled
是 / 否boolean必填

Enabled的值。示例: true

Tokens per daytokens_per_day
整数integer必填

Tokens per day的值。示例: 1

Max output tokensmax_output_tokens
整数integer必填

Max output tokens的值。示例: 1

Max concurrent requestsmax_concurrent_requests
整数integer必填

Max concurrent requests的值。示例: 1

ChatCompletionRequestobject
模型名称model
文本string必填

模型名称的值。示例: qwen3.8-max

对话消息messages
对象列表object[]必填

对话消息的值。示例: [{"role":"user","content":"Hello"}]

最大输出用量max_completion_tokens
整数integer可选

最大输出用量的值。示例: 128

最大输出用量max_tokens
整数integer可选

Alias for the complete output budget; cannot be supplied together with max_completion_tokens.示例: 128

流式返回stream
是 / 否boolean可选

流式返回的值。示例: false

流式选项stream_options
对象object可选

流式选项的值。示例: {…}

结果数量n
整数integer可选

结果数量的值。示例: 1

随机程度temperature
数字number可选

随机程度的值。示例: 0.7

采样范围top_p
数字number可选

采样范围的值。示例: 1

停止词stop
可选值列表string | string[]可选

停止词的值。示例: […]

工具定义tools
对象列表object[]可选

工具定义的值。示例: […]

工具选择tool_choice
可选值string | object可选

工具选择的值。示例: string

并行工具调用parallel_tool_calls
是 / 否boolean可选

并行工具调用的值。示例: true

输出格式response_format
对象object可选

输出格式的值。示例: {…}

启用思考enable_thinking
是 / 否boolean可选

启用思考的值。示例: true

ChatCompletionobject
记录编号id
文本string必填

记录编号的值。示例: 使用已有记录的编号

对象类型object
文本string必填

对象类型的值。示例: 示例文本

创建时间created
整数integer必填

创建时间的值。示例: 1

模型名称model
文本string必填

模型名称的值。示例: qwen3.8-max

生成结果choices
对象列表object[]必填

生成结果的值。示例: […]

调用用量usage
对象object可选

调用用量的值。示例: {…}

AgentCardobject
名称name
文本string必填

名称的值。示例: 示例名称

说明description
文本string必填

说明的值。示例: 示例文本

Supported InterfacessupportedInterfaces
对象列表object[]必填

Supported Interfaces的值。示例: […]

版本version
文本string必填

版本的值。示例: 示例文本

Capabilitiescapabilities
对象object必填

Capabilities的值。示例: {…}

Default Input ModesdefaultInputModes
文本列表string[]必填

Default Input Modes的值。示例: […]

Default Output ModesdefaultOutputModes
文本列表string[]必填

Default Output Modes的值。示例: […]

Skillsskills
对象列表object[]必填

Skills的值。示例: […]

SendAgentMessageRequestobject
消息内容message
对象（AgentMessage）AgentMessage必填

消息内容的值。示例: {…}

Configurationconfiguration
对象（AgentSendConfiguration）AgentSendConfiguration可选

Configuration的值。示例: {…}

SendAgentMessageResponseobject
Tasktask
对象（AgentTask）AgentTask必填

Task的值。示例: {…}

AgentSendConfigurationobject
Accepted Output ModesacceptedOutputModes
可选值列表text/markdown | application/json[]可选

Accepted Output Modes的值。示例: […]

历史消息条数historyLength
整数integer可选

历史消息条数的值。示例: 1

AgentMessageobject
消息编号messageId
记录编号（UUID）string<uuid>必填

消息编号的值。示例: 使用已有记录的编号

消息角色role
可选值ROLE_USER | ROLE_AGENT必填

消息角色的值。示例: user

Partsparts
对象（AgentPart）列表AgentPart[]必填

Parts的值。示例: […]

会话编号contextId
记录编号（UUID）string<uuid>可选

会话编号的值。示例: 使用已有记录的编号

任务编号taskId
记录编号（UUID）string<uuid>可选

任务编号的值。示例: 使用已有记录的编号

AgentPartobject | object

字段随具体接口而定，请查看调用示例或试运行结果。

AgentTaskStateTASK_STATE_SUBMITTED | TASK_STATE_WORKING | TASK_STATE_COMPLETED | TASK_STATE_FAILED | TASK_STATE_CANCELED

字段随具体接口而定，请查看调用示例或试运行结果。

AgentTaskStatusobject
运行状态state
对象（AgentTaskState）AgentTaskState必填

运行状态的值。示例: {…}

数据时间timestamp
日期时间（ISO 8601）string<date-time>必填

数据时间的值。示例: 2026-09-30T15:00:00+08:00

消息内容message
对象（AgentMessage）AgentMessage可选

消息内容的值。示例: {…}

AgentArtifactobject
Artifact IdartifactId
文本string必填

Artifact Id的值。示例: 示例文本

名称name
文本string必填

名称的值。示例: 示例名称

Partsparts
对象（AgentPart）列表AgentPart[]必填

Parts的值。示例: […]

Extensionsextensions
对象（string<uri>）列表string<uri>[]可选

Extensions的值。示例: […]

Metadatametadata
对象object可选

Metadata的值。示例: {…}

AgentTaskobject
记录编号id
记录编号（UUID）string<uuid>必填

记录编号的值。示例: 使用已有记录的编号

会话编号contextId
记录编号（UUID）string<uuid>必填

会话编号的值。示例: 使用已有记录的编号

状态status
对象（AgentTaskStatus）AgentTaskStatus必填

状态的值。示例: {…}

Artifactsartifacts
对象（AgentArtifact）列表AgentArtifact[]可选

Artifacts的值。示例: […]

Historyhistory
对象（AgentMessage）列表AgentMessage[]可选

History的值。示例: […]

Metadatametadata
对象object必填

Metadata的值。示例: {…}

AgentTaskListobject
Taskstasks
对象（AgentTask）列表AgentTask[]必填

Tasks的值。示例: […]

下一页标记nextPageToken
文本string可选

下一页标记的值。示例: 示例文本

IdentityProvideremail | phone | wechat

字段随具体接口而定，请查看调用示例或试运行结果。

DatasetDefinitionobject
Dataset iddataset_id
文本string必填

Dataset id的值。示例: 使用已有记录的编号

名称name
文本string必填

名称的值。示例: 示例名称

说明description
文本string必填

说明的值。示例: 示例文本

Marketsmarkets
文本列表string[]必填

Markets的值。示例: […]

Asset classesasset_classes
文本列表string[]必填

Asset classes的值。示例: […]

Operation countoperation_count
整数integer必填

Operation count的值。示例: 1

Capabilitiescapabilities
对象（Capability）列表Capability[]必填

Capabilities的值。示例: […]

Normalizationnormalization
可选值mixed | provider_envelope必填

Normalization的值。示例: mixed

使用许可rights_status
文本string必填

使用许可的值。示例: 示例文本

Freshnessfreshness
文本string必填

Freshness的值。示例: 示例文本

Contract versioncontract_version
文本string必填

Contract version的值。示例: 示例文本

DatasetDetailobject

字段随具体接口而定，请查看调用示例或试运行结果。

DatasetReadinessobject
Dataset iddataset_id
文本string必填

Dataset id的值。示例: 使用已有记录的编号

Contract statuscontract_status
文本string必填

Contract status的值。示例: 示例文本

Delivery statusdelivery_status
文本string必填

Delivery status的值。示例: 示例文本

Coverage statuscoverage_status
文本string必填

Coverage status的值。示例: 示例文本

使用许可rights_status
文本string必填

使用许可的值。示例: 示例文本

Watermarkwatermark
可选值null | string必填

Watermark的值。示例: null

Operation countoperation_count
整数integer必填

Operation count的值。示例: 1

采集时间observed_at
日期时间（ISO 8601）string<date-time>必填

采集时间的值。示例: 2026-09-30T15:00:00+08:00

ResearchTemplateobject
研究模板编号template_id
文本string必填

研究模板编号的值。示例: 使用已有记录的编号

版本version
文本string必填

版本的值。示例: 示例文本

名称name
文本string必填

名称的值。示例: 示例名称

说明description
文本string必填

说明的值。示例: 示例文本

Required datasetsrequired_datasets
文本列表string[]必填

Required datasets的值。示例: […]

Required capabilitiesrequired_capabilities
对象（Capability）列表Capability[]必填

Required capabilities的值。示例: […]

Output formatsoutput_formats
可选值列表application/json | text/markdown | text/html[]必填

Output formats的值。示例: […]

Evidence requiredevidence_required
是 / 否boolean必填

Evidence required的值。示例: true

Risk noticerisk_notice
文本string必填

Risk notice的值。示例: 示例文本

FactorDefinitionobject
记录编号id
记录编号（UUID）string<uuid>必填

记录编号的值。示例: 使用已有记录的编号

Tenant idtenant_id
记录编号（UUID）string<uuid>必填

Tenant id的值。示例: 使用已有记录的编号

名称name
文本string必填

名称的值。示例: 示例名称

说明description
文本string必填

说明的值。示例: 示例文本

使用的数据集input_datasets
文本列表string[]必填

使用的数据集的值。示例: […]

研究范围universe_rule
文本string必填

研究范围的值。示例: 示例文本

创建时间created_at
日期时间（ISO 8601）string<date-time>必填

创建时间的值。示例: 2026-09-30T15:00:00+08:00

CreateFactorDefinitionobject
名称name
文本string必填

名称的值。示例: 示例名称

说明description
文本string可选

说明的值。示例: 示例文本

使用的数据集input_datasets
文本列表string[]必填

使用的数据集的值。示例: […]

研究范围universe_rule
文本string必填

研究范围的值。示例: 示例文本

FactorVersionobject
记录编号id
记录编号（UUID）string<uuid>必填

记录编号的值。示例: 使用已有记录的编号

因子编号factor_id
记录编号（UUID）string<uuid>必填

因子编号的值。示例: 使用已有记录的编号

版本号version_number
整数integer必填

版本号的值。示例: 1

计算表达式expression
文本string必填

计算表达式的值。示例: 示例文本

回看天数lookback_days
整数integer必填

回看天数的值。示例: 1

复权方式adjustment
可选值raw | forward | backward必填

复权方式的值。示例: raw

创建时间created_at
日期时间（ISO 8601）string<date-time>必填

创建时间的值。示例: 2026-09-30T15:00:00+08:00

CreateFactorVersionobject
计算表达式expression
文本string必填

计算表达式的值。示例: 示例文本

回看天数lookback_days
整数integer必填

回看天数的值。示例: 1

复权方式adjustment
可选值raw | forward | backward可选

复权方式的值。示例: raw

ExperimentKindresearch | factor

字段随具体接口而定，请查看调用示例或试运行结果。

ExperimentStatusplanned | running | succeeded | failed | cancelled

字段随具体接口而定，请查看调用示例或试运行结果。

ExperimentRunobject
记录编号id
记录编号（UUID）string<uuid>必填

记录编号的值。示例: 使用已有记录的编号

Tenant idtenant_id
记录编号（UUID）string<uuid>必填

Tenant id的值。示例: 使用已有记录的编号

内容类型kind
对象（ExperimentKind）ExperimentKind必填

内容类型的值。示例: {…}

名称name
文本string必填

名称的值。示例: 示例名称

因子版本编号factor_version_id
文本（可为空）string | null必填

因子版本编号的值。示例: 使用已有记录的编号

研究模板编号research_template_id
文本（可为空）string | null必填

研究模板编号的值。示例: 使用已有记录的编号

输入设置inputs
对象object必填

输入设置的值。示例: {…}

代码版本code_ref
文本（可为空）string | null必填

代码版本的值。示例: 示例文本

Data manifest refdata_manifest_ref
文本（可为空）string | null必填

Data manifest ref的值。示例: 示例文本

运行环境environment
对象object必填

运行环境的值。示例: {…}

状态status
对象（ExperimentStatus）ExperimentStatus必填

状态的值。示例: {…}

运行结果result
对象object必填

运行结果的值。示例: {…}

创建时间created_at
日期时间（ISO 8601）string<date-time>必填

创建时间的值。示例: 2026-09-30T15:00:00+08:00

更新时间updated_at
日期时间（ISO 8601）string<date-time>必填

更新时间的值。示例: 2026-09-30T15:00:00+08:00

CreateExperimentRunobject
内容类型kind
对象（ExperimentKind）ExperimentKind必填

内容类型的值。示例: {…}

名称name
文本string必填

名称的值。示例: 示例名称

因子版本编号factor_version_id
文本（可为空）string | null可选

因子版本编号的值。示例: 使用已有记录的编号

研究模板编号research_template_id
文本（可为空）string | null可选

研究模板编号的值。示例: 使用已有记录的编号

输入设置inputs
对象object可选

输入设置的值。示例: {…}

代码版本code_ref
文本（可为空）string | null可选

代码版本的值。示例: 示例文本

Data manifest refdata_manifest_ref
文本（可为空）string | null可选

Data manifest ref的值。示例: 示例文本

运行环境environment
对象object可选

运行环境的值。示例: {…}

UpdateExperimentRunobject
状态status
对象（ExperimentStatus）ExperimentStatus必填

状态的值。示例: {…}

运行结果result
对象object可选

运行结果的值。示例: {…}

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_id
记录编号（UUID）string<uuid>必填

请求编号的值。示例: 使用已有记录的编号

数据格式版本schema_version
文本string必填

数据格式版本的值。示例: 示例文本

缓存状态cache_status
对象（CacheStatus）CacheStatus必填

缓存状态的值。示例: {…}

数据标识source
可选值sparkdata-market-data | sparkdata-control-plane必填

数据标识的值。示例: sparkdata-market-data

响应时间generated_at
日期时间（ISO 8601）string<date-time>必填

响应时间的值。示例: 2026-09-30T15:00:00+08:00

Instrumentobject
证券代码instrument_id
证券代码InstrumentId必填

Canonical MIC-prefixed ID for a supported mainland equity, ETF, or index.示例: XSHG:600519

证券代码symbol
文本string必填

证券代码的值。示例: 600519

名称name
文本（可为空）string | null必填

名称的值。示例: 示例名称

Company namecompany_name
文本（可为空）string | null必填

Company name的值。示例: 示例文本

交易所代码mic
可选值XSHG | XSHE | XBSE必填

交易所代码的值。示例: XSHG

资产类型asset_class
可选值equity | etf | index必填

资产类型的值。示例: equity

币种currency
文本string必填

币种的值。示例: CNY

时区timezone
文本string必填

时区的值。示例: Asia/Shanghai

状态status
文本string必填

状态的值。示例: 示例文本

Industryindustry
文本（可为空）string | null必填

Industry的值。示例: 示例文本

Conceptsconcepts
文本列表string[]必填

Concepts的值。示例: […]

扩展数据provider_data
对象（ProviderData）ProviderData必填

扩展数据的值。示例: {…}

ProviderDataobject
接口名称operation
文本string必填

数据目录中的接口名称，区分大小写。示例: FinancialStatement

原始结果raw
对象object必填

该记录对应的原始数据结果。示例: {…}

Capabilitydiscovery | entities | market_data | fundamentals | ownership | events | analytics | economy | content

字段随具体接口而定，请查看调用示例或试运行结果。

ContractDataTypestring | string_array | number | number_array | date | date_array

字段随具体接口而定，请查看调用示例或试运行结果。

InputContractobject
名称name
文本string必填

SparkData 接受的公开参数名。示例: 示例名称

Upstream nameupstream_name
文本string必填

接口接受的准确字段名称。示例: 示例文本

显示名称display_name
文本string必填

显示名称的值。示例: 示例文本

数据类型data_type
对象（ContractDataType）ContractDataType必填

数据类型的值。示例: {…}

说明description
文本string必填

说明的值。示例: 示例文本

是否必填required
是 / 否boolean必填

是否必填的值。示例: true

可选值字典enum_group
文本（可为空）string | null必填

该参数可使用的选项分类。示例: 示例文本

Enum declarationenum_declaration
文本（可为空）string | null必填

该字段可使用的选项。示例: 示例文本

固定值fixed_value
文本（可为空）string | null必填

系统自动补充的固定值，无需填写。示例: 示例文本

OutputContractobject
名称name
文本string必填

名称的值。示例: 示例名称

显示名称display_name
文本string必填

显示名称的值。示例: 示例文本

数据类型data_type
对象（ContractDataType）ContractDataType必填

数据类型的值。示例: {…}

说明description
文本string必填

说明的值。示例: 示例文本

OperationContractobject
接口编号api_id
整数integer必填

接口编号的值。示例: 使用已有记录的编号

Sheet namesheet_name
文本string必填

Sheet name的值。示例: 示例文本

显示名称display_name
文本string必填

显示名称的值。示例: 示例文本

接口名称operation
文本string必填

接口名称的值。示例: FinancialStatement

说明description
文本string必填

说明的值。示例: 示例文本

Methodmethod
文本string必填

Method的值。示例: 示例文本

Pathpath
文本string必填

Path的值。示例: 示例文本

数据能力capability
对象（Capability）Capability必填

数据能力的值。示例: {…}

Last modifiedlast_modified
文本string必填

Last modified的值。示例: 示例文本

输入设置inputs
对象（InputContract）列表InputContract[]必填

输入设置的值。示例: […]

输出设置outputs
对象（OutputContract）列表OutputContract[]必填

输出设置的值。示例: […]

OperationContractsResponseobject
响应信息meta
对象（ResponseMeta）ResponseMeta必填

响应信息的值。示例: {…}

返回数据data
对象（OperationContract）列表OperationContract[]必填

返回数据的值。示例: […]

AggregateQueryobject
接口名称operation
文本string必填

接口名称区分大小写，例如 FinancialStatement。示例: FinancialStatement

查询参数parameters
对象object可选

请使用接口说明列出的参数名称和值，不支持其他字段。示例: {…}

EnumResolutionobject
字段名称field
文本string必填

字段名称的值。示例: 示例文本

Group namegroup_name
文本string必填

Group name的值。示例: 示例文本

Inputinput
对象object必填

Input的值。示例: {…}

错误代码code
文本string必填

错误代码的值。示例: 示例文本

Captioncaption
文本（可为空）string | null必填

Caption的值。示例: 示例文本

扩展数据provider_data
对象（ProviderData）ProviderData必填

扩展数据的值。示例: {…}

AggregateDataobject
接口编号api_id
整数integer必填

接口编号的值。示例: 使用已有记录的编号

数据能力capability
对象（Capability）Capability必填

数据能力的值。示例: {…}

接口名称operation
文本string必填

接口名称的值。示例: FinancialStatement

实际查询参数resolved_parameters
对象object必填

完成固定值补充与选项解析后的实际查询条件。示例: {…}

Enum resolutionsenum_resolutions
对象（EnumResolution）列表EnumResolution[]必填

Enum resolutions的值。示例: […]

扩展数据provider_data
对象（ProviderData）ProviderData必填

扩展数据的值。示例: {…}

AggregateResponseobject
响应信息meta
对象（ResponseMeta）ResponseMeta必填

响应信息的值。示例: {…}

返回数据data
对象（AggregateData）AggregateData必填

返回数据的值。示例: {…}

PriceLevelobject
价格price
对象（Decimal）Decimal必填

价格的值。示例: {…}

数量size
对象（Decimal）Decimal必填

数量的值。示例: {…}

Quoteobject
证券代码instrument_id
证券代码InstrumentId必填

Canonical MIC-prefixed ID for a supported mainland equity, ETF, or index.示例: XSHG:600519

Event timeevent_time
日期时间（ISO 8601）string<date-time>必填

Event time的值。示例: 2026-09-30T15:00:00+08:00

最新价last_price
对象（Decimal）Decimal必填

最新价的值。示例: {…}

前收盘价previous_close
对象（Decimal）Decimal必填

前收盘价的值。示例: {…}

开盘价open
对象（Decimal）Decimal必填

开盘价的值。示例: {…}

最高价high
对象（Decimal）Decimal必填

最高价的值。示例: {…}

最低价low
对象（Decimal）Decimal必填

最低价的值。示例: {…}

涨跌额change
对象（Decimal）（可为空）Decimal | null必填

涨跌额的值。示例: {…}

涨跌幅change_percent
对象（Decimal）（可为空）Decimal | null必填

涨跌幅的值。示例: {…}

成交量volume
对象（Decimal）Decimal必填

成交量的值。示例: {…}

成交额turnover
对象（Decimal）Decimal必填

成交额的值。示例: {…}

交易状态trade_status
文本string必填

交易状态的值。示例: 示例文本

买盘档位bid_levels
对象（PriceLevel）列表PriceLevel[]必填

买盘档位的值。示例: […]

卖盘档位ask_levels
对象（PriceLevel）列表PriceLevel[]必填

卖盘档位的值。示例: […]

扩展数据provider_data
对象（ProviderData）ProviderData必填

扩展数据的值。示例: {…}

Barobject
证券代码instrument_id
证券代码InstrumentId必填

Canonical MIC-prefixed ID for a supported mainland equity, ETF, or index.示例: XSHG:600519

Event timeevent_time
日期时间（ISO 8601）string<date-time>必填

区间的 UTC 起始时间。示例: 2026-09-30T15:00:00+08:00

交易日期trading_date
文本（可为空）string | null必填

交易日期或周期结束日期；日内 K 线此字段可为空。示例: 示例文本

K线周期timeframe
K线周期BarTimeframe必填

K线周期的值。示例: 1d

开盘价open
对象（Decimal）Decimal必填

开盘价的值。示例: {…}

最高价high
对象（Decimal）Decimal必填

最高价的值。示例: {…}

最低价low
对象（Decimal）Decimal必填

最低价的值。示例: {…}

收盘价close
对象（Decimal）Decimal必填

收盘价的值。示例: {…}

前收盘价previous_close
对象（Decimal）（可为空）Decimal | null必填

前收盘价的值。示例: {…}

成交量volume
对象（Decimal）Decimal必填

成交量的值。示例: {…}

成交额turnover
对象（Decimal）（可为空）Decimal | null必填

成交额的值。示例: {…}

成交笔数trade_count
整数（可为空）integer | null必填

成交笔数的值。示例: 1

Suspendedsuspended
是 / 否boolean必填

Suspended的值。示例: true

复权方式adjustment
可选值raw | forward | backward必填

All snapshot-derived intraday bars accept `raw` only. ETF and index bars also accept `raw` only for daily and longer periods. Equity daily and longer bars support upstream adjustments.示例: raw

Aggregation sourceaggregation_source
可选值provider | snapshot_derived | daily_derived必填

Aggregation source的值。示例: provider

扩展数据provider_data
对象（ProviderData）ProviderData必填

扩展数据的值。示例: {…}

StreamControlobject
Control typecontrol_type
可选值stream_end | heartbeat | reconnect必填

Control type的值。示例: stream_end

请求编号request_id
记录编号（UUID）string<uuid>必填

请求编号的值。示例: 使用已有记录的编号

Event timeevent_time
日期时间（ISO 8601）string<date-time>必填

Event time的值。示例: 2026-09-30T15:00:00+08:00

Records sentrecords_sent
整数integer可选

Records sent的值。示例: 1

MarketEventQuote | StreamControl

字段随具体接口而定，请查看调用示例或试运行结果。

BarStreamRecordBar | StreamControl

字段随具体接口而定，请查看调用示例或试运行结果。

AgentContextobject
证券代码instrument_id
证券代码InstrumentId必填

Canonical MIC-prefixed ID for a supported mainland equity, ETF, or index.示例: XSHG:600519

证券信息instrument
对象（Instrument）Instrument必填

证券信息的值。示例: {…}

最新行情latest_quote
对象（Quote）（可为空）Quote | null必填

最新行情的值。示例: {…}

K线数据bars
对象（Bar）列表Bar[]必填

K线数据的值。示例: […]

Upstream operationsupstream_operations
文本列表string[]必填

Upstream operations的值。示例: […]

AgentContextResponseobject
响应信息meta
对象（ResponseMeta）ResponseMeta必填

响应信息的值。示例: {…}

返回数据data
对象（AgentContext）AgentContext必填

返回数据的值。示例: {…}

DatasetsResponseobject
响应信息meta
对象（ResponseMeta）ResponseMeta必填

响应信息的值。示例: {…}

返回数据data
对象（DatasetDefinition）列表DatasetDefinition[]必填

返回数据的值。示例: […]

DatasetDetailResponseobject
响应信息meta
对象（ResponseMeta）ResponseMeta必填

响应信息的值。示例: {…}

返回数据data
对象（DatasetDetail）DatasetDetail必填

返回数据的值。示例: {…}

DataReadinessResponseobject
响应信息meta
对象（ResponseMeta）ResponseMeta必填

响应信息的值。示例: {…}

返回数据data
对象（DatasetReadiness）列表DatasetReadiness[]必填

返回数据的值。示例: […]

ResearchTemplatesResponseobject
响应信息meta
对象（ResponseMeta）ResponseMeta必填

响应信息的值。示例: {…}

返回数据data
对象（ResearchTemplate）列表ResearchTemplate[]必填

返回数据的值。示例: […]

FactorResponseobject
响应信息meta
对象（ResponseMeta）ResponseMeta必填

响应信息的值。示例: {…}

返回数据data
对象（FactorDefinition）FactorDefinition必填

返回数据的值。示例: {…}

FactorsResponseobject
响应信息meta
对象（ResponseMeta）ResponseMeta必填

响应信息的值。示例: {…}

返回数据data
对象（FactorDefinition）列表FactorDefinition[]必填

返回数据的值。示例: […]

FactorVersionResponseobject
响应信息meta
对象（ResponseMeta）ResponseMeta必填

响应信息的值。示例: {…}

返回数据data
对象（FactorVersion）FactorVersion必填

返回数据的值。示例: {…}

FactorVersionsResponseobject
响应信息meta
对象（ResponseMeta）ResponseMeta必填

响应信息的值。示例: {…}

返回数据data
对象（FactorVersion）列表FactorVersion[]必填

返回数据的值。示例: […]

ExperimentRunResponseobject
响应信息meta
对象（ResponseMeta）ResponseMeta必填

响应信息的值。示例: {…}

返回数据data
对象（ExperimentRun）ExperimentRun必填

返回数据的值。示例: {…}

ExperimentRunsResponseobject
响应信息meta
对象（ResponseMeta）ResponseMeta必填

响应信息的值。示例: {…}

返回数据data
对象（ExperimentRun）列表ExperimentRun[]必填

返回数据的值。示例: […]

InstrumentResponseobject
响应信息meta
对象（ResponseMeta）ResponseMeta必填

响应信息的值。示例: {…}

返回数据data
对象（Instrument）Instrument必填

返回数据的值。示例: {…}

InstrumentResponseObjectobject
响应信息meta
对象（ResponseMeta）ResponseMeta必填

响应信息的值。示例: {…}

返回数据data
对象（Instrument）Instrument必填

返回数据的值。示例: {…}

BarsResponseobject
响应信息meta
对象（ResponseMeta）ResponseMeta必填

响应信息的值。示例: {…}

返回数据data
对象（Bar）列表Bar[]必填

返回数据的值。示例: […]

QuotesResponseobject
响应信息meta
对象（ResponseMeta）ResponseMeta必填

响应信息的值。示例: {…}

返回数据data
对象（Quote）列表Quote[]必填

返回数据的值。示例: […]

MeResponseobject
响应信息meta
对象（ResponseMeta）ResponseMeta必填

响应信息的值。示例: {…}

返回数据data
对象object必填

返回数据的值。示例: {…}

InvalidParameterobject
名称name
文本string必填

名称的值。示例: 示例名称

原因reason
文本string必填

原因的值。示例: 示例文本

Problemobject
Typetype
对象（string<uri-reference>）string<uri-reference>必填

Type的值。示例: {…}

标题title
文本string必填

标题的值。示例: 示例文本

状态status
整数integer必填

状态的值。示例: 1

详细说明detail
文本string必填

详细说明的值。示例: 示例文本

请求编号request_id
记录编号（UUID）string<uuid>必填

请求编号的值。示例: 使用已有记录的编号

错误代码code
文本string必填

错误代码的值。示例: 示例文本

Purchase product idpurchase_product_id
文本string可选

Optional annual subscription to purchase when code is feature_not_purchased.示例: 使用已有记录的编号

Invalid parametersinvalid_parameters
对象（InvalidParameter）列表InvalidParameter[]必填

Invalid parameters的值。示例: […]

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

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

立即开始↗下载 OpenAPI YAML