data912-market-data

Data912 市场数据

查询 Data912 公共市场 API，获取阿根廷和美国市场数据快照、历史行情柱以及 EOD 衍生品分析数据。

API 概览

• 基础 URL：https://data912.com
• 身份验证：无需验证（公共 API）
• 格式：JSON 响应
• 来源说明：Data912 将此 API 描述为教育／业余用途数据，并明确说明并非实时数据。
• 缓存说明：服务器元数据显示，Cloudflare 缓存时间约为 2 小时。

端点组

1. 实时市场面板

• /live/mep（USD MEP）
• /live/ccl（USD CCL）
• /live/arg_stocks
• /live/arg_options
• /live/arg_cedears
• /live/arg_notes
• /live/arg_corp
• /live/arg_bonds
• /live/usa_adrs
• /live/usa_stocks

示例：

curl -s "https://data912.com/live/arg_stocks" | jq '.[0:5]'

2. 历史 OHLC

• /historical/stocks/{ticker}
• /historical/cedears/{ticker}
• /historical/bonds/{ticker}

示例：

curl -s "https://data912.com/historical/stocks/GGAL" | jq '.[0:10]'

3. EOD 衍生品分析

• /eod/volatilities/{ticker}
• /eod/option_chain/{ticker}

示例：

curl -s "https://data912.com/eod/volatilities/AAPL" | jq '.'
curl -s "https://data912.com/eod/option_chain/AAPL" | jq '.[0:10]'

此技能不涵盖的内容

• 请勿在此技能中使用 /contact。此技能仅用于市场数据检索和解读。

关键字段

面板字段（/live/*）

• symbol：工具代码／符号
• px_bid、q_bid：买入价和买入数量
• px_ask、q_ask：卖出价和卖出数量
• c：类似最新成交价／收盘价的交易值
• pct_change：百分比变动
• v：成交量
• q_op：交易次数（如有提供）

历史字段（/historical/*/{ticker}）

• date：日期字符串
• o、h、l、c：OHLC 值
• v：成交量
• dr：日收益率
• sa：来源提供的其他数值指标

波动率指标（/eod/volatilities/{ticker}）

• IV 期限结构：iv_s_term、iv_m_term、iv_l_term
• IV 百分位数：iv_*_percentile
• HV 期限结构：hv_s_term、hv_m_term、hv_l_term
• HV 百分位数：hv_*_percentile
• 相对价值比率：iv_hv_*_ratio、iv_fair_iv_ratio
• 公允价值参考：fair_iv、fair_iv_percentile

期权链字段（/eod/option_chain/{ticker}）

• 合约信息：opex、s_symbol、type、k
• 市场数据：bid、ask、c、oi
• 希腊值：delta、gamma、theta、vega、rho
• 估值／概率：fair_value、fair_iv、itm_prob、intrinsic、otm
• 时间范围信息：r_days、r_tdays、hv_2m、hv_1yr

工作流

1. 识别意图并选择端点组：
   • 外汇／面板快照 -> /live/*
   • 时间序列／变化趋势 -> /historical/*/{ticker}
   • 期权／风险分析 -> /eod/*/{ticker}
2. 验证必需输入：
   • 对于历史和 EOD 端点，需要提供工具代码。
   • 如果缺少工具代码，请先询问，然后再查询。
3. 使用 curl -s 获取数据，并用 jq 解析。
4. 处理空数组：
   • 如果响应为 []，请报告：“此端点／工具代码当前没有可用数据。”
5. 提供可执行的摘要：
   • 先给出简短快照。
   • 然后列出用户要求的相关详细字段。
6. 明确说明背景：
   • 提醒用户这些是教育／非实时数据。
   • 避免将输出变成交易建议。

错误处理

• 429 请求过多：
  • 大多数市场端点的限额为 120 req/min。
  • 暂停片刻后重试；避免突发循环请求。
• 422 验证错误：
  • 通常是路径输入无效／缺失，例如工具代码格式不正确。
  • 重试前请重新检查符号和端点。
• 网络／超时故障：
  • 少量重试（例如间隔一段时间重试 2 次）。
  • 如果仍然失败，请清楚说明故障，并指出尝试过的端点。

呈现结果

向用户返回结果时：

• 开头简要概述变化情况（变动内容、位置和幅度）。
• 对于面板请求，对比买价、卖价、最新价和 % change。
• 对于历史请求，总结趋势时间段和显著跳变。
• 对于波动率／期权请求，重点说明百分位数以及隐含波动率／历史波动率之间的关系。
• 明确说明数据仅供教育用途，且非实时。
• 不提供财务建议。

OpenAPI 规范

完整的架构和端点定义请参见 references/openapi-spec.json。