API de Cadenas de opciones de Yahoo Finance
Salud de la API
- Salud 24 h
- Normal
- Saludable / normal
- Disponible
- Limitada
- Casi sin servicio
Últimas 24 horas
Últimos 30 días
Obtiene cadenas de calls y puts para el símbolo indicado en keyword, con vencimientos y strikes disponibles. No ejecuta operaciones ni garantiza cotizaciones instantáneas.
Envía POST https://api.everyinfra.com/api/v1/social con platform igual a yahoo_finance y action igual a options. Precio $1.39 por 1.000 solicitudes ($0.001389 por llamada). Las llamadas fallidas y los resultados vacíos no se cobran. Síncrona. Para tareas lentas añade "mode": "async" al cuerpo, recibe un job_id y consúltalo.
Yahoo Finance Cadenas de opciones lee las opciones cotizadas sobre un símbolo, que pasas en keyword, y devuelve la cadena en un solo objeto: el symbol, todas las fechas de vencimiento en expiration_dates, todos los precios de ejercicio en strikes y los contratos en calls y puts. De cada contrato obtienes contract_symbol, strike, last_price, bid, ask, volume, open_interest, implied_volatility y el indicador in_the_money, que señala si está dentro del dinero. Lo usan analistas, investigadores cuantitativos y desarrolladores de herramientas financieras para revisar precios de ejercicio, seguir la volatilidad implícita y ver dónde se acumula el interés abierto.
Escribe el símbolo como lo muestra Yahoo Finance, por ejemplo AAPL, con su sufijo de mercado si lo tiene; los nombres de empresa no se buscan. No hay un parámetro para elegir vencimiento, así que comprueba en expiration a qué fecha pertenecen los contratos devueltos. last_price es el precio de la última operación, que en un contrato con poca actividad puede ser antiguo, mientras que bid y ask son los precios de compra y de venta publicados. Son datos de mercado, no recomendaciones de inversión.
Prompt para IA
#Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra Yahoo Finance: Cadenas de opciones (yahoo_finance/options).
Cómo funciona el endpoint:
- Solicitud: POST https://api.everyinfra.com/api/v1/social con la cabecera Authorization: Bearer <clave API>. Lee la clave de la variable de entorno EVERYINFRA_API_KEY y no la escribas en el código.
- En el cuerpo de la solicitud, pon platform en yahoo_finance y action en options, y los parámetros dentro de params.
- Parámetros obligatorios:
- keyword: Código de valor (ticker) de Yahoo Finance, como AAPL. No es una búsqueda por el nombre completo de la empresa.
- Devuelve un objeto. Campos principales: contract_symbol, strike, last_price, bid, ask, volume, open_interest, implied_volatility, in_the_money, expiration, symbol, expiration_dates; 15 campos en total, lista completa en https://api.everyinfra.com/api/v1/social/catalog?platform=yahoo_finance.
- Cuerpo de solicitud de ejemplo:
{
"platform": "yahoo_finance",
"action": "options",
"params": {
"keyword": "AAPL"
}
}
- Precio: $1.39 por 1.000 solicitudes; los resultados fallidos y vacíos no se cobran.
- Para decenas o cientos de objetivos, añade "mode": "async" al cuerpo: recibes un job_id al instante y consultas GET https://api.everyinfra.com/api/v1/jobs/{job_id} para obtener el resultado.
- Ante un 422, corrige la solicitud con los nombres de parámetros y los valores admitidos que sugiere el error; ante un 429 o un 503, espera lo que indique Retry-After y vuelve a intentarlo.
Antes de escribir código, pregúntame qué objetivos necesito, cuántos, qué campos y en qué formato quiero el resultado; luego confirma conmigo el plan y el coste aproximado.Parámetros de la solicitud
#| Nombre | Ubicación | Tipo | Obligatorio | Por defecto | Descripción |
|---|---|---|---|---|---|
Authorization | header | string | Sí | - | Bearer seguido de tu clave de API. Créala en la consola; nunca la pongas en una URL ni en un repositorio de código. |
platform | body | string | Sí | yahoo_finance | Identificador de la plataforma, valor fijo. |
action | body | string | Sí | options | Identificador de la capacidad, valor fijo. |
keyword | body.params | string | Sí | - | Código de valor (ticker) de Yahoo Finance, como AAPL. No es una búsqueda por el nombre completo de la empresa. Las acciones history, financials, news, analyst y options obtienen, respectivamente, cotizaciones históricas, datos financieros, noticias, informes de analistas y opciones para un único código de valor por llamada. Debes conservar el sufijo del mercado si lo hubiera. |
Ejemplos de código
#curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "yahoo_finance",
"action": "options",
"params": {
"keyword": "AAPL"
}
}'Definición OpenAPI (JSON)Los ejemplos leen la clave de la variable de entorno EVERYINFRA_API_KEY; el código copiado nunca contiene tu clave.
Ejemplo de respuesta
#{ "id": "req_…", "platform": "yahoo_finance", "action": "options", "results": { "symbol": "AAPL", "expiration_dates": [ "2026-09-28T00:00:00+00:00", "2026-09-30T00:00:00+00:00", "2026-10-02T00:00:00+00:00" ], "strikes": [ 250, 255, 265 ], "calls": [ { "contract_symbol": "AAPL260928C00250000", "strike": 250, "last_price": 89.85, "bid": 89.25, "ask": 92.7, "volume": 1, "open_interest": 1, "implied_volatility": 2.24365673461914, "in_the_money": true, "expiration": "2026-09-28T00:00:00+00:00" }, { "contract_symbol": "AAPL260928C00265000", "strike": 265, "last_price": 72.52, "bid": 74.05, "ask": 77.75, "volume": 4, "open_interest": 5, "implied_volatility": 1.9111332568359376, "in_the_money": true, "expiration": "2026-09-28T00:00:00+00:00" }, { "contract_symbol": "AAPL260928C00270000", "strike": 270, "last_price": 65.74, "bid": 69.05, "ask": 72.95, "volume": 2, "open_interest": 3, "implied_volatility": 1.84765701171875, "in_the_money": true, "expiration": "2026-09-28T00:00:00+00:00" } ], "puts": [ { "contract_symbol": "AAPL260928P00250000", "strike": 250, "last_price": 0.01, "bid": 0, "ask": 0.01, "volume": 7, "open_interest": 4, "implied_volatility": 1.0625046875000002, "in_the_money": false, "expiration": "2026-09-28T00:00:00+00:00" }, { "contract_symbol": "AAPL260928P00255000", "strike": 255, "last_price": 0.01, "bid": 0, "ask": 0.01, "volume": 2, "open_interest": 4, "implied_volatility": 1.000005, "in_the_money": false, "expiration": "2026-09-28T00:00:00+00:00" }, { "contract_symbol": "AAPL260928P00265000", "strike": 265, "last_price": 0.05, "bid": 0, "ask": 0.01, "volume": 36, "open_interest": 12, "implied_volatility": 0.87500125, "in_the_money": false, "expiration": "2026-09-28T00:00:00+00:00" } ], "platform": "yahoo_finance" }, "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
Campos de la respuesta
#Los datos están en results. La tabla lista los campos que puede tener cada registro; los valores que la plataforma no muestra nunca se inventan.
| Campo | Significado |
|---|---|
contract_symbol | Conserva el significado de la plataforma |
strike | Conserva el significado de la plataforma |
last_price | Conserva el significado de la plataforma |
bid | Conserva el significado de la plataforma |
ask | Conserva el significado de la plataforma |
volume | Conserva el significado de la plataforma |
open_interest | Conserva el significado de la plataforma |
implied_volatility | Conserva el significado de la plataforma |
in_the_money | Conserva el significado de la plataforma |
expiration | Conserva el significado de la plataforma |
symbol | Conserva el significado de la plataforma |
expiration_dates | Conserva el significado de la plataforma |
strikes | Conserva el significado de la plataforma |
calls | Conserva el significado de la plataforma |
puts | Conserva el significado de la plataforma |
platform | Identificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok). |
Preguntas frecuentes
#¿Necesito una URL de Yahoo Finance para usar esta API?
#No. keyword recibe solo el símbolo tal como aparece en Yahoo Finance, por ejemplo AAPL, conservando el sufijo de mercado cuando lo tiene; no hace falta el enlace de ninguna página. Los nombres de empresa no se buscan y cada llamada lee un único símbolo. Para la cotización y los datos fundamentales del subyacente, pasa el mismo símbolo a Yahoo Finance Búsqueda.
¿Cómo elijo una fecha de vencimiento?
#No se elige en la solicitud: la capacidad solo recibe keyword y no tiene selector de vencimiento. La respuesta enumera todos los vencimientos disponibles en expiration_dates, y expiration indica a qué fecha pertenecen los contratos recibidos. Guarda esa fecha con cada fila para que las cadenas leídas en días distintos encajen al compararlas.
¿Cómo sé si un contrato tiene actividad?
#Mira volume, el volumen negociado, y open_interest, los contratos que siguen abiertos, y luego la distancia entre bid y ask. Poco volumen, poco interés abierto y un diferencial amplio indican que last_price puede estar desfasado. Trata con cautela la implied_volatility de esos contratos si construyes una curva de volatilidad; son datos para analizar, no una señal para operar.
Errores y facturación
#- 401
- Falta la clave o no es válida.
- 402
- Saldo insuficiente. Recarga primero.
- 422
- Nombre o valor de parámetro incorrecto. Corrígelo según las opciones indicadas en el error. Sin cargo.
- 429
- Se alcanzó el límite de solicitudes por minuto. Espera el tiempo indicado en Retry-After y vuelve a intentarlo.
- 503
- No se pudo completar. El cargo retenido vuelve a tu saldo. Si el resultado es incierto, compruébalo antes de reenviar.
- 200 vacío
- Sin datos. Sin cargo.
Referencias oficiales
#Solo sirven para contrastar objetos y términos. No implican autorización ni respaldo de la plataforma a EveryInfra.
- Yahoo Finance: sufijos de mercado y datos con demora ↗
Yahoo Finance documenta sufijos de mercados y diferentes demoras según la bolsa, y presenta los datos con fines informativos. Una cotización no debe presentarse como dato ejecutable en tiempo real ni como recomendación financiera.
Comprobado el 2026-09-05