data912-market-data

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Data912 Market Data

Data912 市场数据

Query Data912's public market API for Argentina and USA market data snapshots, historical bars, and EOD derivatives analytics.

通过Data912的公开市场API查询阿根廷和美国的市场数据快照、历史K线以及盘后衍生品分析数据。

API Overview

API概述

Base URL:
```
https://data912.com
```
Auth: None required (public API)
Format: JSON responses
Source note: Data912 describes this API as educational/hobby data and explicitly not real-time.
Caching note: Server metadata indicates roughly 2-hour Cloudflare caching.

基础URL：
```
https://data912.com
```
身份验证：无需验证（公开API）
格式：JSON响应
数据源说明：Data912说明本API提供的是教育/兴趣用途数据，明确并非实时数据。
缓存说明：服务器元数据显示，数据通过Cloudflare进行约2小时的缓存。

Endpoint Groups

端点分组

1. Live Market Panels

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
```

Example:

bash

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

```
/live/mep
```
（美元MEP）
```
/live/ccl
```
（美元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
```

示例：

bash

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

2. Historical OHLC

2. 历史OHLC数据

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

Example:

bash

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

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

示例：

bash

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

3. EOD Derivatives Analytics

3. 盘后衍生品分析

```
/eod/volatilities/{ticker}
```
```
/eod/option_chain/{ticker}
```

Examples:

bash

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

```
/eod/volatilities/{ticker}
```
```
/eod/option_chain/{ticker}
```

示例：

bash

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

Out of Scope for This Skill

本工具适用范围外

Do not use
```
/contact
```
in this skill. Keep this skill focused on market data retrieval and interpretation.

本工具中请勿使用
```
/contact
```
端点，需聚焦于市场数据的获取和解读。

Key Fields

核心字段

Panel Fields (

/live/*

)

面板字段（

/live/*

）

```
symbol
```
: instrument ticker/symbol
```
px_bid
```
,
```
q_bid
```
: bid price and bid size
```
px_ask
```
,
```
q_ask
```
: ask price and ask size
```
c
```
: last/close-like traded value
```
pct_change
```
: percentage variation
```
v
```
: volume
```
q_op
```
: operations count (when provided)

```
symbol
```
：金融工具代码/标识
```
px_bid
```
、
```
q_bid
```
：买价和买量
```
px_ask
```
、
```
q_ask
```
：卖价和卖量
```
c
```
：最新成交价/类收盘价
```
pct_change
```
：涨跌幅
```
v
```
：成交量
```
q_op
```
：交易笔数（若提供）

Historical Fields (

/historical/*/{ticker}

)

历史数据字段（

/historical/*/{ticker}

）

```
date
```
: date string
```
o
```
,
```
h
```
,
```
l
```
,
```
c
```
: OHLC values
```
v
```
: volume
```
dr
```
: daily return
```
sa
```
: additional numeric metric provided by source

```
date
```
：日期字符串
```
o
```
、
```
h
```
、
```
l
```
、
```
c
```
：OHLC数值
```
v
```
：成交量
```
dr
```
：日收益率
```
sa
```
：数据源提供的额外数值指标

Volatility Metrics (

/eod/volatilities/{ticker}

)

波动率指标（

/eod/volatilities/{ticker}

）

IV term structure:
```
iv_s_term
```
,
```
iv_m_term
```
,
```
iv_l_term
```
IV percentiles:
```
iv_*_percentile
```
HV term structure:
```
hv_s_term
```
,
```
hv_m_term
```
,
```
hv_l_term
```
HV percentiles:
```
hv_*_percentile
```
Relative-value ratios:
```
iv_hv_*_ratio
```
,
```
iv_fair_iv_ratio
```
Fair value reference:
```
fair_iv
```
,
```
fair_iv_percentile
```

隐含波动率（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
```

Option Chain Fields (

/eod/option_chain/{ticker}

)

期权链字段（

/eod/option_chain/{ticker}

）

Contract context:
```
opex
```
,
```
s_symbol
```
,
```
type
```
,
```
k
```
Market data:
```
bid
```
,
```
ask
```
,
```
c
```
,
```
oi
```
Greeks:
```
delta
```
,
```
gamma
```
,
```
theta
```
,
```
vega
```
,
```
rho
```
Valuation/probabilities:
```
fair_value
```
,
```
fair_iv
```
,
```
itm_prob
```
,
```
intrinsic
```
,
```
otm
```
Horizon context:
```
r_days
```
,
```
r_tdays
```
,
```
hv_2m
```
,
```
hv_1yr
```

合约信息：
```
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
```

Workflow

工作流程

Identify intent and select endpoint group:
- FX/panel snapshot ->
```
/live/*
```
- Time series/evolution ->
```
/historical/*/{ticker}
```
- Options/risk analytics ->
```
/eod/*/{ticker}
```
Validate required input:
- For historical/EOD endpoints, require a ticker symbol.
- If ticker is missing, ask for it before querying.
Fetch data with
curl -s
and parse with
```
jq
```
.
Handle empty arrays:
- If response is
```
[]
```
  , report: "No data currently available for this endpoint/ticker."
Present an actionable summary:
- Start with a short snapshot.
- Then include relevant detail fields requested by the user.
Keep context clear:
- Remind users this is educational/non-real-time data.
- Avoid turning output into trading advice.

识别用户意图并选择对应端点分组：
- 外汇/面板快照 ->
```
/live/*
```
- 时间序列/走势分析 ->
```
/historical/*/{ticker}
```
- 期权/风险分析 ->
```
/eod/*/{ticker}
```
验证必填输入：
- 对于历史数据/盘后分析端点，需提供金融工具代码。
- 若缺少代码，需先向用户询问再进行查询。
使用
```
curl -s
```
获取数据，并通过
```
jq
```
解析。
处理空数组响应：
- 若响应为
```
[]
```
  ，需告知用户：“当前该端点/代码暂无可用数据。”
提供实用的总结内容：
- 先展示简短的数据快照。
- 再包含用户请求的相关详细字段。
明确数据背景：
- 提醒用户本数据为教育用途/非实时数据。
- 请勿将输出内容转化为交易建议。

Error Handling

错误处理

429 Too Many Requests:
- Most market endpoints publish
```
120 req/min
```
  .
- Back off and retry after a short delay; avoid burst loops.
422 Validation Error:
- Usually invalid/missing path input such as ticker formatting.
- Re-check symbol and endpoint before retrying.
Network/timeout failures:
- Retry a small number of times (for example, 2 retries with delay).
- If still failing, return a clear failure message and the endpoint attempted.

429 请求过于频繁：
- 多数市场数据端点限制为
```
120次请求/分钟
```
  。
- 需暂停并短暂延迟后重试；避免循环发起突发请求。
422 验证错误：
- 通常是路径输入无效或缺失，比如代码格式错误。
- 重试前需重新检查代码和端点是否正确。
网络/超时错误：
- 可重试少量次数（例如，延迟后重试2次）。
- 若仍失败，需返回清晰的错误信息以及尝试访问的端点。

Presenting Results

结果展示

When returning results to the user:

Lead with a concise snapshot (what moved, where, and magnitude).
For panel requests, compare bid/ask/last and
```
% change
```
.
For historical requests, summarize trend windows and notable jumps.
For vol/options requests, highlight percentiles and IV/HV relationships.
Explicitly mention the data is educational/non-real-time.
Do not provide financial recommendations.

向用户返回结果时：

先展示简洁的数据快照（包括变动标的、市场以及变动幅度）。
对于面板请求，对比买价/卖价/最新价以及涨跌幅。
对于历史数据请求，总结趋势区间和显著的价格波动。
对于波动率/期权请求，突出显示百分位以及IV/HV的关系。
明确说明本数据为教育用途/非实时数据。
请勿提供金融建议。

OpenAPI Spec

OpenAPI 规范

For the full schema and endpoint definitions, see references/openapi-spec.json.

完整的 schema 和端点定义，请查看references/openapi-spec.json。

data912-market-data

Original

Translation

Data912 Market Data

Data912 市场数据

API Overview

API概述

Endpoint Groups

端点分组

1. Live Market Panels

1. 实时市场面板

2. Historical OHLC

2. 历史OHLC数据

3. EOD Derivatives Analytics

3. 盘后衍生品分析

Out of Scope for This Skill

本工具适用范围外

Key Fields

核心字段

Panel Fields (
`/live/*`
)

面板字段（
`/live/*`
）

Historical Fields (
`/historical/*/{ticker}`
)

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

Volatility Metrics (
`/eod/volatilities/{ticker}`
)

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

Option Chain Fields (
`/eod/option_chain/{ticker}`
)

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

Workflow

工作流程

Error Handling

错误处理

Presenting Results

结果展示

OpenAPI Spec

OpenAPI 规范

data912-market-data

Original

Translation

Data912 Market Data

Data912 市场数据

API Overview

API概述

Endpoint Groups

端点分组

1. Live Market Panels

1. 实时市场面板

2. Historical OHLC

2. 历史OHLC数据

3. EOD Derivatives Analytics

3. 盘后衍生品分析

Out of Scope for This Skill

本工具适用范围外

Key Fields

核心字段

Panel Fields (/live/*)

面板字段（/live/*）

Historical Fields (/historical/*/{ticker})

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

Volatility Metrics (/eod/volatilities/{ticker})

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

Option Chain Fields (/eod/option_chain/{ticker})

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

Workflow

工作流程

Error Handling

错误处理

Presenting Results

结果展示

OpenAPI Spec

OpenAPI 规范

Panel Fields (
`/live/*`
)

面板字段（
`/live/*`
）

Historical Fields (
`/historical/*/{ticker}`
)

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

Volatility Metrics (
`/eod/volatilities/{ticker}`
)

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

Option Chain Fields (
`/eod/option_chain/{ticker}`
)

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