跳转到主要内容
GET
读取股票研究结果
使用同一 Workspace 和仍允许来源 Endpoint 的 Key 访问带签名的 result_url。响应保留归一输出和实际 Charge;pending 不触发新执行。

查询参数

token
string
必填

result_url 中返回的不透明结果上下文。保持原样,并使用有权读取所列全部 Run 的 API Key 认证。

Required string length: 1 - 16384

响应

财务金额保留币种;比率与增长率保持原始小数(0.3 表示 30%)。宏观利率与股价 day_change_percent 是百分数。缺失字段为 null。Run completed_at 是取数时间,不能代替观察日期。

财务金额保留币种;比率与增长率保持原始小数(0.3 表示 30%)。宏观利率与股价 day_change_percent 是百分数。缺失字段为 null。Run completed_at 是取数时间,不能代替观察日期。

id
string
必填
run_url
string
必填

在控制台打开 Run,需要工作空间成员权限。

provider
string
必填
Pattern: ^[a-z0-9][a-z0-9-]*$
endpoint
string
必填
Pattern: ^\/.+$
endpoint_version
integer
必填
status
enum<string>
必填

QUEUED 或 RUNNING 表示仍在执行。COMPLETED 表示已有数据提供商响应,包括非 2xx 响应。FAILED 请读取 failure。STOPPED 表示分派前停止。charge_usd 与状态分别检查。

可用选项:
QUEUED,
RUNNING,
COMPLETED,
FAILED,
STOPPED
failure
object | null
必填

Run 失败原因,仅在 status 为 FAILED 时非 null。

input
object
必填
output
object
必填
provider_response
object | null
必填

仅在 status 为 COMPLETED 时非 null。

  • 2xx 响应:output 为任意结构的数据提供商原生 JSON;正文为空时为 null。
  • 非 2xx 响应:error 包含数据提供商错误正文,output 为 null。

两种正文均会移除敏感字段。

charge_usd
string | null
必填

所列 Run 的历史费用总和,包括重放或读取的 Run。所有 Run 结算前为 null。这不是当前请求的新增支出;request_charge 单独报告新增费用。失败也可能收费。

Pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$
charge_basis
object | null
必填

单个 Run 的计费依据;多个 Run 汇总时为 null。各项费用请查看 runs[].charge_basis。

stoppable
boolean
必填

当前是否可接受停止请求。不保证能在分派前停止 Run。

stop_requested_at
string<date-time> | null
必填

请求停止的时间。如果已开始分派,Run 仍可能继续。

created_at
string<date-time>
必填

ISO 8601 UTC 时间戳。

started_at
string<date-time> | null
必填

ISO 8601 UTC 时间戳。

completed_at
string<date-time> | null
必填

ISO 8601 UTC 时间戳。

task_id
string | null
必填
metadata
object
必填

已保存的追踪字段,可用于筛选 Run,不发送给数据提供商,不影响路由、价格或幂等。

  • 最多 20 个键:小写字母、数字和下划线,以字母开头,最长 40 个字符。
  • 值:长度为 1–500 的字符串。
  • user_id:终端用户的不透明 ID,不得使用邮箱或姓名。
action
enum<string>
必填
可用选项:
company,
income,
balance_sheet,
cash_flow,
segments,
metrics,
earnings,
guidance,
prices,
news,
screen,
macro
result_status
enum<string>
必填
可用选项:
success,
no_result,
error,
pending
error
object | null
必填
runs
object[]
必填
result_url
string
必填

通过认证读取规范化结果和总费用的只读 URL 路径,配合 API 服务地址使用。不创建 Run,也不恢复切换。GET /v1/runs/:id 仍返回原生单个 Run。

response_file
object

以 JSON 文件完整交付较大的 Provider 正文。Glasser 对接收的正文和序列化文件应用 32 MiB 的运行时资源保护。body_field 指明被替代的字段;output 为 null,或省略 provider_response.error。下载链接最多一小时后过期。在文件的 7 天可用期内,通过已认证的 Get Run 刷新链接。读取和下载不会再次执行 Run 或重复收费。state 为 link_pending 时,读取同一 Run 即可准备链接,不会再次执行或重复收费。链接授予临时读取权限,请仅与预期接收者分享。

review_invitation
object

每个 Run 至多出现一次,只在部分已完成 Run 的首次交付中出现。用完本次结果后,按 instruction 提交评价,然后继续任务。可选;不影响 Run 及其费用。

request_charge
object

当前请求的受理与费用证据。在同一件用户工作中保存 created_run_ids,每个已结算 Run 只计一次费用。更换 task_id 不会把幂等重放变成新 Run。读取结果的费用为零,受理列表为空。