gauss314/skills

cboe-data

Datos de CBOE via APIs publicas: cotizaciones delayed de indices, futuros VX, charts intraday, most-active, market summary (equities + opciones), symbol lookup, futures products. Sin API key.

First seen Jun 5, 2026

Installation

$ npx skills add gauss314/skills --skill cboe-data

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from gauss314/skills · top by installs.

npx skills add gauss314/skills

Browse all from gauss314/skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 237
License LICENSE
Default branch main
Open issues 0
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

LicenseMIT

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 16,767 B
  • docs SUMMARY.md 208 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 239 installs

SKILL.md

CBOE — Datos de Mercado via API Publica

Skill para extraer datos de CBOE usando sus APIS publicas — sin API key, sin autenticacion.


⚠️ Aviso Legal

  • CBOE no tiene API publica oficial gratuita. Estos endpoints son publicos y pueden cambiar sin aviso.
  • Respetar los terminos de servicio del sitio. No hacer mas de 1 request/segundo.
  • Los datos son delayed (no en tiempo real). Delay aproximado:

- quote / intraday: ~15-20 min - historical: datos del dia anterior (actualizacion diaria) - options-chain: underlying ~15-20 min; datos de opciones individuales pueden ser end-of-day - summary / options-summary: 20 min (campo delay explicito en el response) - Los campos timestamp en el response indican la ultima actualizacion del cache


Scripts

Script Descripcion
[fetchcboe.py](./scripts/fetchcboe.py) Script principal: todos los endpoints disponibles

Uso rapido

# Cotizacion delayed de indices y stocks
python scripts/fetch_cboe.py quote _VIX
python scripts/fetch_cboe.py quote _SPX
python scripts/fetch_cboe.py quote _RUT
python scripts/fetch_cboe.py quote _OEX
python scripts/fetch_cboe.py quote _DJX
python scripts/fetch_cboe.py quote _XSP
python scripts/fetch_cboe.py quote _CBTX
python scripts/fetch_cboe.py quote _MBTX
python scripts/fetch_cboe.py quote _MXEF
python scripts/fetch_cboe.py quote _MXEA
python scripts/fetch_cboe.py quote GGAL
python scripts/fetch_cboe.py quote AAPL

# Datos historicos anuales (annual high/low, HV e IV a 30/60/90 dias)
python scripts/fetch_cboe.py historical _VIX
python scripts/fetch_cboe.py historical _SPX
python scripts/fetch_cboe.py historical GGAL
python scripts/fetch_cboe.py historical AAPL

# Chart intraday 1-min (hoy, 1-min bars con calls/puts volume)
python scripts/fetch_cboe.py intraday _VIX
python scripts/fetch_cboe.py intraday _SPX
python scripts/fetch_cboe.py intraday _RUT
python scripts/fetch_cboe.py intraday GGAL
python scripts/fetch_cboe.py intraday AAPL

# Futuros VX (VIX Futures chain)
python scripts/fetch_cboe.py futures VX
python scripts/fetch_cboe.py futures VXM       # Mini VIX Futures
python scripts/fetch_cboe.py futures VA        # S&P 500 Variance Futures
python scripts/fetch_cboe.py futures IBHY      # iBoxx High Yield Bond Futures
python scripts/fetch_cboe.py futures IBIG      # iBoxx IG Bond Futures

# Listado de todos los productos tradables en CBOE
python scripts/fetch_cboe.py products

# Busqueda de simbolos (todos los tickers con company name)
python scripts/fetch_cboe.py lookup
python scripts/fetch_cboe.py lookup --market edgx   # Por mercado especifico

# Resumen de mercado CBOE (volumen por mercado y tape)
python scripts/fetch_cboe.py summary

# Top 10 mas activos por mercado (la API siempre devuelve 10)
python scripts/fetch_cboe.py most-active              # BZX (default)
python scripts/fetch_cboe.py most-active --market edgx  # Mercado EDGX
python scripts/fetch_cboe.py most-active --market byx   # Mercado BYX
python scripts/fetch_cboe.py most-active --market edga  # Mercado EDGA

# Resumen de mercado opciones CBOE (volumen por exchange)
python scripts/fetch_cboe.py options-summary

# Opciones mas activas (calls/puts por categoria: all, index, equity)
python scripts/fetch_cboe.py options-most-active              # Top 25 (default)
python scripts/fetch_cboe.py options-most-active --limit 10   # Top 10
python scripts/fetch_cboe.py options-most-active --limit 50   # Top 50
python scripts/fetch_cboe.py options-most-active --limit 100  # Top 100

# Productos futuros tradables en CBOE
python scripts/fetch_cboe.py futures-products

# Cadena de opciones completa con greeks (stocks y ETFs)
python scripts/fetch_cboe.py options-chain GGAL
python scripts/fetch_cboe.py options-chain AAPL
python scripts/fetch_cboe.py options-chain BMA -o bma_chain.json

# Todos los datos de un simbolo
python scripts/fetch_cboe.py all _VIX
python scripts/fetch_cboe.py all _SPX

# Guardar output a archivo
python scripts/fetch_cboe.py quote _VIX -o vix_quote.json
python scripts/fetch_cboe.py futures VX -o vx_futures.json

# Modo silencioso (solo JSON)
python scripts/fetch_cboe.py quote _SPX -q

Endpoints disponibles

Modo Data Endpoint
quote Cotizacion delayed de indices y stocks (precio, cambio, IV30, OHLC) cdn.cboe.com/api/global/delayed_quotes/quotes/{symbol}.json
historical Datos historicos anuales (annual high/low, HV e IV 30/60/90) cdn.cboe.com/api/global/delayedquotes/historicaldata/{symbol}.json
intraday Chart intraday 1-min con volumen de opciones (calls/puts) cdn.cboe.com/api/global/delayed_quotes/charts/intraday/{symbol}.json
futures Cadena de futuros (vencimientos, settlement, OI) www-api.cboe.com/us/futures/api/data/?symbol={symbol}
products Todos los productos tradables (indices, futuros, opciones) www-api.cboe.com/tradable_products/data/
lookup Busqueda de simbolos (todos los tickers + company name) ww2.cboe.com/us/equities/marketstatistics/bookviewer2/symbollookup_data/
summary Resumen de mercado equities CBOE (volumen por mercado y tape A/B/C) www-api.cboe.com/us/equities/marketstatistics/summarylite/market/data/
most-active Top 10 mas activos por mercado (volumen, bid/ask, last) www-api.cboe.com/us/equities/marketstatistics/mostactive/data/10/
options-summary Resumen de mercado opciones CBOE (volumen por exchange) www-api.cboe.com/us/options/marketstatistics/summarylite/market/data/
options-most-active Top N opciones mas activas (calls/puts por categoria) www-api.cboe.com/us/options/marketstatistics/mostactive/data/?mkt=cone&limit={N}
futures-products Productos futuros tradables en CBOE (15 productos) www-api.cboe.com/us/futures/api/tradablefutureproducts_data/
options-chain Cadena de opciones completa con greeks (stocks y ETFs) cdn.cboe.com/api/global/delayed_quotes/options/{symbol}.json
options-directory Instrumentos listados con opciones por exchange (~5,500) www-api.cboe.com/us/options/symboldir/{exchange}/data/
all Todos los datos disponibles para un simbolo (quote + historical + intraday + futures si aplica) -

Simbolos disponibles

Quotes / Historical / Intraday (indices y stocks)

Funciona tanto para indices CBOE (prefijo _) como para stocks y ETFs (sin prefijo).

Simbolo Descripcion
_VIX CBOE Volatility Index
_SPX S&P 500 Index
_OEX S&P 100 Index
_RUT Russell 2000 Index
_DJX Dow Jones Industrial Average
_XSP Mini S&P 500 Index
_CBTX Cboe Bitcoin U.S. ETF Index
_MBTX Cboe Mini Bitcoin U.S. ETF Index
_MXEF MSCI Emerging Markets Index
_MXEA MSCI EAFE Index
GGAL Grupo Financiero Galicia
AAPL Apple Inc
TSLA Tesla Inc
SPY SPDR S&P 500 ETF
QQQ Invesco QQQ Trust
NVDA NVIDIA Corp

Cualquier ticker listado en CBOE funciona para quote, historical e intraday.

Futuros (via endpoint futures)

Simbolo Descripcion
VX VIX Futures
VXM Mini VIX Futures
VA S&P 500 Variance Futures
IBHY iBoxx High Yield Corporate Bond Futures
IBIG iBoxx Investment Grade Corporate Bond Futures
IEMD iBoxx Emerging Market Bond Index Futures

Consideraciones Tecnicas

Datos devueltos por quote

Funciona para indices (securitytype: "index") y stocks (securitytype: "stock").

Campo Tipo Descripcion
current_price float Precio actual
price_change float Cambio neto
pricechangepercent float Cambio porcentual
open float Apertura del dia
high float Maximo del dia
low float Minimo del dia
close float Ultimo precio (cierre)
prevdayclose float Cierre anterior
iv30 float Volatilidad implicita a 30 dias
iv30_change float Cambio en IV30
bid / ask float Bid/Ask (0.0 en indices, real en stocks)
volume int Volumen (0 en indices, real en stocks)
lasttradetime datetime Ultima operacion
tick string up / down / unchanged
security_type string index o stock

Datos devueltos por historical

Datos historicos anuales. Misma estructura para indices y stocks.

Campo Tipo Descripcion
annual_high float Maximo del ultimo ano
annual_low float Minimo del ultimo ano
hv30annualhigh float Historical Volatility 30d - maximo anual
hv30annuallow float Historical Volatility 30d - minimo anual
hv60annualhigh float Historical Volatility 60d - maximo anual
hv60annuallow float Historical Volatility 60d - minimo anual
hv90annualhigh float Historical Volatility 90d - maximo anual
hv90annuallow float Historical Volatility 90d - minimo anual
iv30annualhigh float Implied Volatility 30d - maximo anual
iv30annuallow float Implied Volatility 30d - minimo anual
iv60annualhigh float Implied Volatility 60d - maximo anual
iv60annuallow float Implied Volatility 60d - minimo anual
iv90annualhigh float Implied Volatility 90d - maximo anual
iv90annuallow float Implied Volatility 90d - minimo anual

Datos devueltos por intraday

Funciona para indices y stocks. Cada barra de 1-min contiene:

Campo Descripcion
datetime Timestamp de la barra
price.open Apertura
price.high Maximo
price.low Minimo
price.close Cierre
volume.stock_volume Volumen de acciones (0 en indices, real en stocks)
volume.calls_volume Volumen de opciones call
volume.puts_volume Volumen de opciones put
volume.totaloptionsvolume Volumen total de opciones

Datos devueltos por futures

Campo Descripcion
symbol Nombre del futuro (ej: VX/M6)
expiration Fecha de vencimiento
last_price Ultimo precio
settlement Settlement price
prev_settlement Settlement anterior
volume Volumen
prevopenint Open interest del dia anterior
change Cambio vs settlement anterior

Datos devueltos por lookup

Devuelve un array symbolsLookupData con todos los simbolos:

Campo Descripcion
name Ticker del simbolo
company_name Nombre completo de la empresa/ETF

Cobertura: ~15,000+ simbolos (acciones, ETFs, units, warrants).

Datos devueltos por summary

Resumen del mercado CBOE con volumen por mercado y tape:

Campo Descripcion
batsMarketData[].market Nombre del mercado (Cboe Total, BZX, BYX, EDGX, EDGA)
batsMarketData[].total.value Volumen total del mercado
batsMarketData[].tapea.value Volumen Tape A (NYSE)
batsMarketData[].tapeb.value Volumen Tape B (Regionals)
batsMarketData[].tapec.value Volumen Tape C (Nasdaq)
marketTotals Totales consolidados de todos los mercados
date Fecha de los datos
delay Minutos de delay

Datos devueltos por most-active

Cada elemento en data.{market} es un array con:

Indice Campo Descripcion
[0] symbol Ticker
[1] volume Volumen acumulado
[2] - (dato interno)
[3] bid Bid price
[4] ask Ask price
[5] - (dato interno)
[6] last_price Ultimo precio negociado
[7] price_change Cambio neto
[8] company_name Nombre de la empresa

Datos devueltos por options-summary

Resumen de mercado opciones CBOE con volumen por exchange:

Campo Descripcion
batsMarketData[].market Nombre del exchange (Cboe Options, C2, EDGX, BZX)
batsMarketData[].volume Volumen total del exchange
batsMarketData[].percent Market share porcentual
date Fecha de los datos
delay Minutos de delay

Datos devueltos por options-most-active

Devuelve 3 categorias (all, index, equity), cada una con arrays calls y puts:

Campo Descripcion
categories[].category Nombre de la categoria (all, index, equity)
categories[].calls[] Array de opciones call mas activas
categories[].puts[] Array de opciones put mas activas
calls/puts[].symbol Simbolo del underlying
calls/puts[].expires Fecha de expiracion
calls/puts[].strike Strike price
calls/puts[].volume Volumen del dia

--limit solo acepta: 10, 25, 50, 100. Cualquier otro valor es ignorado (default: 25).

Datos devueltos por futures-products

Lista de 15 productos futuros tradables en CBOE:

Campo Descripcion
underlying_root Simbolo raiz (VX, VXM, VA, IBHY, IBIG, IEMD, etc.)
title Nombre completo del producto
volume Volumen del dia anterior
open_interest Open interest
trading_dt Fecha de los datos de trading

Datos devueltos por options-chain

Cadena de opciones completa con greeks. Solo funciona para stocks y ETFs (no indices con prefijo _). Incluye el quote del simbolo + todos los contratos (calls y puts).

Campo Descripcion
data.options[] Array de todos los contratos de opciones
option Ticker del contrato (formato: ROOT + YYMMDD + C/P + strike*1000)
bid / ask Bid/Ask del contrato
iv Volatilidad implicita
delta / gamma / theta / vega / rho Greeks
theo Precio teorico
volume Volumen del dia
open_interest Open interest
lasttradeprice Ultimo precio negociado

Usar parseoptionticker(ticker) para decodificar el ticker en root, expiry, type (call/put), strike.

Datos devueltos por options-directory

Directorio de todos los instrumentos (stocks, ETFs, indices) que tienen opciones listadas en CBOE.

Campo Descripcion
underlying Ticker del instrumento
company_name Nombre completo de la empresa/ETF
pmm Primary Market Maker asignado
post_station Post/Station en el trading floor (solo Cboe Options)
gth_mm GTH Market Maker (solo Cboe Options)
prod_types Tipos de producto
cycles Ciclos de vencimiento

Flags:

  • --exchange cboe|edgx — Cboe Options (default) o EDGX Options
  • --sid X — Filtrar por letra inicial del company_name (A-Z). Sin filtro devuelve todos
  • --date YYYY-MM-DD — Fecha especifica. Sin fecha usa la mas reciente

Flags adicionales

Flag Descripcion
--market X Mercado para most-active o lookup (default: bzx, tambien: byx, edgx, edga)
--limit N Resultados por categoria para options-most-active (default: 25). Solo: 10, 25, 50, 100
--exchange X Exchange para options-directory (default: cboe). Valores: cboe, edgx
--sid X Letra inicial del company_name para options-directory (A-Z). Sin filtro devuelve todos
--date YYYY-MM-DD Fecha para options-directory. Sin fecha usa la mas reciente
-o archivo.json Guardar output a archivo
-q / --quiet Modo silencioso (solo JSON)

Rate limiting

No hay rate limiting documentado. Se recomienda:

  • Minimo 1 segundo entre requests
  • Usar -q para scripting

Manejo de errores

CBOE devuelve 403 Forbidden (no 404) para simbolos que no existen o endpoints que no aplican. El script maneja estos errores gracefulmente, registrando un warning y continuando.


Estructura del skill

skills/cboe-data/
├── SKILL.md                          # Este archivo (guia rapida)
├── references/
│   └── REFERENCE.md                  # Documentacion completa de todos los endpoints
└── scripts/
    └── fetch_cboe.py                 # Script principal

Documentacion detallada: Consultar [references/REFERENCE.md](./references/REFERENCE.md) para la documentacion exhaustiva de cada endpoint, estructuras JSON, ejemplos y consideraciones tecnicas.