AgentSkillsCN

data912-market-data

查询Data912市场数据端点，获取阿根廷与美国市场的行情数据。当用户询问MEP/CCL报价、实时阿根廷市场行情（股票、期权、CEDEARs、票据、公司债、债券）、美国市场行情（ADR、股票）、按交易代码的历史OHLC序列、美国期权链，或波动率/风险指标时，可使用此功能。此外，当用户提及“Data912”“MEP”“CCL”“CEDEARs”“期权链”“历史K线”“OHLC”“隐含波动率”“历史波动率”或“波动率百分位数”，并期待通过API获取市场快照时，也可使用此功能。

SKILL.md
--- frontmatter
name: data912-market-data
description: >
  Query Data912 market data endpoints for Argentina and USA instruments.
  Use when the user asks for MEP/CCL quotes, live Argentine market panels
  (stocks, options, cedears, notes, corporate debt, bonds), USA panels (ADRs, stocks),
  OHLC historical series by ticker, USA option chains, or volatility/risk metrics.
  Also use when the user mentions "Data912", "mep", "ccl", "cedears", "option chain",
  "historical bars", "OHLC", "implied volatility", "historical volatility", or
  "volatility percentiles" and expects API-backed market snapshots.

Data912 Market Data

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

API Overview

  • •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.

Endpoint Groups

1. Live Market Panels

  • •/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]'

2. Historical OHLC

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

Example:

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

3. EOD Derivatives Analytics

  • •/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]'

Out of Scope for This Skill

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

Key Fields

Panel Fields (/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)

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

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

Volatility Metrics (/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

Option Chain Fields (/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

Workflow

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

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.

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.

OpenAPI Spec

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