API Yahoo Finance Catene di opzioni

POST

Stato di salute dell'API

Operatività nelle ultime 24 ore
Normale
  • Buono / normale
  • Disponibile
  • Limitato
  • Quasi del tutto inattivo
Normale

Ultime 24 ore

Ultimi 30 giorni

Analizza la catena delle opzioni di un ticker di Yahoo Finance, con call e put che mostrano strike, ultimo prezzo, bid, ask, volume, open interest e volatilità implicita. Non esiste un parametro per la scadenza, quindi controlla expiration per la data restituita e expiration_dates per l'elenco completo.

Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su yahoo_finance e action impostato su options. Prezzo $1.39 per 1.000 richieste ($0.001389 per chiamata). Le chiamate non riuscite e i risultati vuoti non vengono addebitati. Sincrona. Per i job più lenti, aggiungi "mode": "async" al corpo della richiesta, recupera il job_id ed esegui il polling.

Yahoo Finance Options chains legge le opzioni quotate per un ticker, passato come keyword, e restituisce la catena come un unico oggetto: il symbol, tutte le date di scadenza in expiration_dates, tutti i livelli di strike in strikes e i contratti in calls e puts. Per ogni contratto ottieni contract_symbol, strike, last_price, bid, ask, volume, open_interest, implied_volatility e un indicatore in_the_money. Trader di opzioni, ricercatori quantitativi e sviluppatori fintech la usano per analizzare gli strike, seguire la volatilità implicita e vedere dove si accumula l'open interest.

Passa il ticker esattamente come lo scrive Yahoo Finance, ad esempio AAPL, mantenendo l'eventuale suffisso di mercato; i nomi delle aziende non vengono cercati. Non esiste un parametro per scegliere una scadenza, quindi controlla expiration per sapere a quale data appartengono i contratti restituiti e considera expiration_dates come il calendario completo. last_price è l'ultima negoziazione, che su un contratto poco scambiato può risalire a parecchio tempo prima, mentre bid e ask mostrano la situazione del mercato al momento della chiamata.

Prompt per l'AI

#
Aiutami a scrivere uno script di raccolta dei dati con l'endpoint Yahoo Finance Catene di opzioni di EveryInfra (yahoo_finance/options).

Come funziona l'endpoint:
- Richiesta: POST https://api.everyinfra.com/api/v1/social con l'header Authorization: Bearer <chiave API>. Leggi la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY e non scriverla mai direttamente nel codice.
- Nel corpo della richiesta imposta platform su yahoo_finance e action su options, e inserisci i parametri in params.
- Parametri obbligatori:
  - keyword: Indica un singolo ticker Yahoo Finance (ad es. AAPL), mantenendo i suffissi di borsa necessari. Non esegue ricerche full-text per nome dell'azienda.
- Restituisce un oggetto. Campi principali: contract_symbol, strike, last_price, bid, ask, volume, open_interest, implied_volatility, in_the_money, expiration, symbol, expiration_dates; 15 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=yahoo_finance.
- Esempio di corpo della richiesta:
{
  "platform": "yahoo_finance",
  "action": "options",
  "params": {
    "keyword": "AAPL"
  }
}
- Prezzo: $1.39 per 1.000 richieste; le richieste non riuscite e i risultati vuoti non vengono addebitati.
- Per decine o centinaia di target, aggiungi "mode": "async" al corpo: ricevi subito un job_id ed esegui il polling su GET https://api.everyinfra.com/api/v1/jobs/{job_id} per ottenere il risultato.
- In caso di 422, correggi la richiesta usando i nomi dei parametri e i valori consentiti suggeriti nell'errore; in caso di 429 o 503, attendi il tempo indicato da Retry-After e riprova.

Prima di scrivere il codice, chiedimi quali target mi servono, quanti, quali campi e quale formato di output voglio; poi conferma con me il piano e il costo indicativo.

Parametri della richiesta

#
NomePosizioneTipoObbligatorioPredefinitoDescrizione
AuthorizationheaderstringSì-Bearer seguito dalla tua chiave API. Creala nella console; non inserirla mai in un URL o in un repository di codice.
platformbodystringSìyahoo_financeIdentificativo della piattaforma, valore fisso.
actionbodystringSìoptionsIdentificativo della funzionalità, valore fisso.
keywordbody.paramsstringSì-Indica un singolo ticker Yahoo Finance (ad es. AAPL), mantenendo i suffissi di borsa necessari. Non esegue ricerche full-text per nome dell'azienda. Le azioni history, financials, news, analyst e options elaborano un ticker per richiesta per recuperare dati storici di mercato, bilanci, notizie, copertura degli analisti o catene di opzioni.

Esempi di codice

#
bash
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"
  }
}'

Definizione OpenAPI (JSON)Gli esempi leggono la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY; il codice copiato non contiene mai la tua chiave.

Esempio di risposta

#
Acquisita il September 26, 2026 at 08:56 (UTC) chiamando questa API con i parametri dell'esempio di codice qui sopra. results e count sono la risposta reale di quella chiamata, da cui sono state rimosse le informazioni personali (nomi, handle, avatar, link ai profili, recapiti). id, billing e quota cambiano a ogni chiamata, quindi ne viene mostrata solo la struttura.
json
{  "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": { … }}

Campi della risposta

#

I dati di business si trovano in results. La tabella elenca i campi che un record può contenere; i valori che la piattaforma non mostra non vengono mai inventati.

CampoSignificato
contract_symbolMantiene il significato attribuito dalla piattaforma
strikeMantiene il significato attribuito dalla piattaforma
last_priceMantiene il significato attribuito dalla piattaforma
bidMantiene il significato attribuito dalla piattaforma
askMantiene il significato attribuito dalla piattaforma
volumeMantiene il significato attribuito dalla piattaforma
open_interestMantiene il significato attribuito dalla piattaforma
implied_volatilityMantiene il significato attribuito dalla piattaforma
in_the_moneyMantiene il significato attribuito dalla piattaforma
expirationMantiene il significato attribuito dalla piattaforma
symbolMantiene il significato attribuito dalla piattaforma
expiration_datesMantiene il significato attribuito dalla piattaforma
strikesMantiene il significato attribuito dalla piattaforma
callsMantiene il significato attribuito dalla piattaforma
putsMantiene il significato attribuito dalla piattaforma
platformIdentificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok).

FAQ

#

Come scelgo una data di scadenza?

#

Non puoi sceglierla nella richiesta: la funzionalità accetta solo keyword, senza alcun selettore di scadenza. La risposta elenca tutte le scadenze disponibili in expiration_dates, e expiration indica a quale data appartengono i contratti restituiti. Salva quella data con ogni riga, così le catene lette in giorni diversi restano allineate quando le confronti.

Cosa devo passare come keyword?

#

Un solo ticker, scritto esattamente come appare su Yahoo Finance, ad esempio AAPL, mantenendo il suffisso di mercato se il simbolo ne ha uno. I nomi delle aziende non vengono cercati e ogni chiamata legge un solo ticker. Per vedere la quotazione e i fondamentali del sottostante, passa lo stesso simbolo alla funzionalità Yahoo Finance Search.

Come capisco se un contratto è scambiato attivamente?

#

Guarda volume, il volume degli scambi, e open_interest, i contratti ancora aperti, poi la differenza tra bid e ask. Volume scarso, open interest basso e spread ampio indicano che last_price potrebbe non essere aggiornato e che il contratto potrebbe essere difficile da negoziare vicino a quel prezzo. Usa con cautela la implied_volatility di questi contratti quando costruisci una curva di volatilità.

Errori e addebiti

#
401
Chiave mancante o non valida.
402
Saldo insufficiente. Effettua prima una ricarica.
422
Nome o valore del parametro non valido. Correggilo seguendo i suggerimenti dell'errore. Nessun addebito.
429
Raggiunto il limite di richieste al minuto. Attendi il tempo indicato da Retry-After, poi riprova.
503
Impossibile completare. L'importo trattenuto torna sul tuo saldo. Se l'esito è incerto, verificalo prima di riprovare.
Risposta 200 vuota
Nessun dato. Nessun addebito.

Errori

Riferimenti ufficiali

#

Usati solo per verificare oggetti e terminologia. Non implicano alcuna autorizzazione o approvazione di EveryInfra da parte della piattaforma.

  • Yahoo Finance: suffissi dei ticker, ritardi delle borse e uso delle informazioni ↗

    Le indicazioni ufficiali spiegano che i suffissi dei ticker e i ritardi dei dati variano a seconda della borsa, e stabiliscono che i dati hanno scopo esclusivamente informativo. Questo chiarisce i limiti relativi ai simboli dei ticker e all'aggiornamento dei dati di mercato; non dimostra che questo endpoint supporti il trading in tempo reale.

    Verificato il 2026-09-05

Le nostre statistiche di visita interne sono sempre attive. Google Analytics viene caricato solo se scegli «Consenti analisi». Informativa sulla privacy