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

Ottieni fino a 200 titoli in movimento da un elenco predefinito di Yahoo Finance, per impostazione predefinita i maggiori rialzi del giorno. Ogni titolo include prezzo, variazione, variazione percentuale, volume, capitalizzazione di mercato e intervallo a 52 settimane. screener accetta nomi di elenchi in maiuscolo per azioni, criptovalute, società private e fondi. Un elenco non è una raccomandazione.

Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su yahoo_finance e action impostato su trending. 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 Trending legge uno degli elenchi di mercato predefiniti di Yahoo Finance, scelto con screener, e restituisce una riga per strumento: ticker, nome, prezzo e valuta, variazione di prezzo e percentuale, volume, capitalizzazione di mercato, borsa, rapporto prezzo/utili e intervallo a 52 settimane. Se ometti screener, ottieni i titoli con il maggior rialzo della giornata. Trader, autori di newsletter e app fintech la usano per vedere cosa si sta muovendo, popolare le watchlist e alimentare i riepiloghi di mercato giornalieri.

Gli elenchi coprono azioni (rialzi, ribassi, più scambiate, più vendute allo scoperto, small cap e temi di crescita), criptovalute, società private e fondi, e i loro nomi vanno scritti in maiuscolo, come DAY_LOSERS o MOST_ACTIVES. Leggi currency ed exchange su ogni riga invece di presumere un unico mercato. change_percent è già una percentuale, mentre change è la variazione nella valuta del prezzo stesso. Nulla di tutto ciò costituisce consulenza finanziaria.

Prompt per l'AI

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

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 trending, e inserisci i parametri in params.
- Nessun parametro obbligatorio.
- Parametri facoltativi:
  - screener: Indica la chiave in maiuscolo della lista predefinita per l'azione trending di Yahoo Finance.
  - limit: Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 200. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. (predefinito: 10)
- Restituisce un elenco di record. Campi principali di ogni record: id, symbol, name, price, change, change_percent, volume, market_cap, currency, exchange, pe_ratio, fifty_two_week_range.
- Esempio di corpo della richiesta:
{
  "platform": "yahoo_finance",
  "action": "trending",
  "params": {}
}
- 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ìtrendingIdentificativo della funzionalità, valore fisso.
screenerbody.paramsstringNo-Indica la chiave in maiuscolo della lista predefinita per l'azione trending di Yahoo Finance. Gli screener azionari supportati includono DAY_GAINERS (predefinito), DAY_LOSERS, MOST_ACTIVES, MOST_SHORTED_STOCKS, UNDERVALUED_GROWTH_STOCKS, GROWTH_TECHNOLOGY_STOCKS, AGGRESSIVE_SMALL_CAPS e SMALL_CAP_GAINERS; le liste crypto includono ALL_CRYPTOCURRENCIES_US, DAY_GAINERS_CRYPTOCURRENCIES, DAY_LOSERS_CRYPTOCURRENCIES e MOST_ACTIVES_CRYPTOCURRENCIES; le liste di società private includono HIGHEST_VALUATION_PRIVATE_COMPANY, WEEK_GAINERS_PRIVATE_COMPANY, RECENTLY_FUNDED_PRIVATE_COMPANY e MOST_FUNDED_PRIVATE_COMPANY; le liste di fondi includono TOP_MUTUAL_FUNDS, DAY_GAINERS_MUTUAL_FUNDS, PORTFOLIO_ANCHORS, SOLID_LARGE_GROWTH_FUNDS, SOLID_MIDCAP_GROWTH_FUNDS, CONSERVATIVE_FOREIGN_FUNDS e HIGH_YIELD_BOND. La disponibilità di una categoria non garantisce dati aggiornati né costituisce consulenza finanziaria.
limitbody.paramsinteger (1–200)No10Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 200. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. I valori più alti restituiscono 422 prima di qualsiasi addebito.

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": "trending",
  "params": {}
}'

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); l'elenco conserva i primi 2. id, billing e quota cambiano a ogni chiamata, quindi ne viene mostrata solo la struttura.
json
{  "id": "req_…",  "platform": "yahoo_finance",  "action": "trending",  "results": [    {      "id": "PPLI",      "symbol": "PPLI",      "name": "People Incorporated",      "price": 40,      "change": 4.07,      "change_percent": 11.3276,      "volume": 3093055,      "market_cap": 2978557184,      "currency": "USD",      "exchange": "NasdaqGS",      "pe_ratio": 6.76819,      "fifty_two_week_range": "29.56 - 48.32",      "platform": "yahoo_finance"    },    {      "id": "ALM",      "symbol": "ALM",      "name": "Almonty Industries Inc.",      "price": 13.72,      "change": 1.32,      "change_percent": 10.6452,      "volume": 11512843,      "market_cap": 3957955840,      "currency": "USD",      "exchange": "NasdaqCM",      "pe_ratio": 62.363636,      "fifty_two_week_range": "5.435 - 24.41",      "platform": "yahoo_finance"    }  ],  "count": 10,  "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
idID univoco del record sulla piattaforma. È univoco solo all'interno di una piattaforma; gli ID possono ripetersi tra piattaforme diverse.
symbolMantiene il significato attribuito dalla piattaforma
nameNome dell'oggetto stesso, per le funzionalità relative ad account, prodotti e attività.
pricePrezzo come numero senza simbolo di valuta; vedi currency.
changeMantiene il significato attribuito dalla piattaforma
change_percentMantiene il significato attribuito dalla piattaforma
volumeMantiene il significato attribuito dalla piattaforma
market_capMantiene il significato attribuito dalla piattaforma
currencyCodice valuta del prezzo (ad esempio CNY, USD). Se price è presente ma currency è null, non dare per scontata una valuta.
exchangeMantiene il significato attribuito dalla piattaforma
pe_ratioMantiene il significato attribuito dalla piattaforma
fifty_two_week_rangeMantiene il significato attribuito dalla piattaforma
platformIdentificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok).

FAQ

#

Quali elenchi posso scegliere con screener?

#

Per le azioni: DAY_GAINERS (il valore predefinito), DAY_LOSERS, MOST_ACTIVES, MOST_SHORTED_STOCKS, UNDERVALUED_GROWTH_STOCKS, GROWTH_TECHNOLOGY_STOCKS, AGGRESSIVE_SMALL_CAPS e SMALL_CAP_GAINERS. Tra gli elenchi di criptovalute ci sono ALL_CRYPTOCURRENCIES_US e MOST_ACTIVES_CRYPTOCURRENCIES, tra quelli delle società private RECENTLY_FUNDED_PRIVATE_COMPANY e MOST_FUNDED_PRIVATE_COMPANY e tra quelli dei fondi TOP_MUTUAL_FUNDS e HIGH_YIELD_BOND. Scrivi ogni nome in maiuscolo, esattamente come indicato.

Come confronto change e change_percent?

#

change è la variazione di prezzo nella valuta della riga e change_percent la stessa variazione espressa in percentuale. Ordina per change_percent quando un elenco mescola strumenti economici e costosi, perché una grande variazione assoluta su un titolo dal prezzo elevato può essere piccola in termini percentuali, e controlla currency prima di sommare o confrontare change tra righe diverse.

Devo passare un ticker?

#

No. Questa funzionalità non ha parametri obbligatori: non inviare nulla per ottenere i titoli in rialzo della giornata, oppure imposta screener su un altro elenco. Per approfondire un titolo che hai trovato, passa il suo symbol a Yahoo Finance Historical prices, News o Options chains, ognuna delle quali legge un ticker per chiamata.

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: ritardi delle borse nelle classifiche dei ticker di tendenza ↗

    Le indicazioni ufficiali affermano che i ritardi dei dati variano a seconda della borsa e che i dati hanno scopo esclusivamente informativo. Questo illustra i limiti di mercato e di aggiornamento delle classifiche di tendenza; non dimostra che le classifiche dell'endpoint siano in tempo reale né che costituiscano consulenza finanziaria.

    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