[ blog · comparison ]9 min read

API dei fondamentali aziendali: stato patrimoniale, flusso di cassa e operazioni degli insider per agenti finanziari

Sarah ChoyPubblicato il 16 giugno 20269 min di lettura

I prezzi ti dicono cosa pensa il mercato; i fondamentali ti dicono se ha ragione. Ecco un'API di fondamentali modellata per gli agenti di IA — bilanci, dividendi e operazioni degli insider in un unico endpoint — e come si confronta con SEC EDGAR grezzo e con i fornitori di API di bilanci.

In breve

•Fondamentali = lo strato del 'l'azienda è davvero in salute?': stato patrimoniale, conto economico, flusso di cassa, dividendi, transazioni degli insider.
•Puoi farne il parsing gratis da SEC EDGAR (XBRL), ma normalizzare XBRL tra diversi filer e periodi è ingegneria reale e continua — ed è solo statunitense e al ritmo dei filing, non modellato per le query.
•Financials Search di API Pick restituisce tutti e cinque i fondamentali delle società statunitensi dietro un unico endpoint POST — 200 crediti/chiamata, solo-se-va-a-buon-fine — pre-modellati per il ragionamento di un LLM.
•Le transazioni degli insider (Form 4) e lo storico dei dividendi sono i segnali sottoutilizzati: economici da recuperare qui, faticosi da assemblare da EDGAR.
•Combina Financials con SEC Filings (testo qualitativo di 10-K/10-Q) e Markets (prezzo) per una visione ancorata completa.

Il prezzo è opinione; i fondamentali sono evidenza

Una chiamata di dati di mercato dice al tuo agente quanto costa un'azione. Non può dirti se l'azienda dietro sta crescendo, sta affogando nei debiti o viene venduta in silenzio dai suoi stessi dirigenti. Questo è lo strato dei fondamentali — ed è dove un agente di ricerca passa da "cita i prezzi" a "si forma un'opinione".

Cinque dataset portano la maggior parte del segnale: lo stato patrimoniale, il conto economico, il rendiconto finanziario, lo storico dei dividendi e le transazioni degli insider.

La tassa di EDGAR

Tutto questo è pubblico e gratuito su SEC EDGAR. Il problema è XBRL. Il JSON di company-facts è enorme e incoerente: lo stesso concetto è etichettato in modo diverso tra filer, le rettifiche intorbidiscono lo storico e devi mappare una tassonomia dispersa su uno schema pulito prima che qualcosa a valle possa usarla. I dati degli insider (Form 4) e i dividendi sono tipi di filing separati di cui fai il parsing per conto loro. Farlo una volta per un ticker è un fine settimana; farlo in modo affidabile per un agente che interroga qualsiasi azienda è una pipeline mantenuta.

I fondamentali come un unico strumento

Financials Search restituisce stati patrimoniali, conti economici, flussi di cassa, dividendi e transazioni degli insider per le società quotate statunitensi dietro un unico endpoint POST — 200 crediti per chiamata, solo-se-va-a-buon-fine, pre-modellati per un LLM.

import httpx, os
API, HEADERS = "https://api.apipick.com/v1", {"x-api-key": os.environ["APIPICK_KEY"]}

def fundamentals(query: str):
    return httpx.post(f"{API}/search/financials", headers=HEADERS,
                      json={"query": query}).json()["results"]

fundamentals("Apple latest balance sheet and cash flow")
fundamentals("recent insider transactions at Meta")
fundamentals("Microsoft revenue and net income trend")

EDGAR vs. fornitore vs. suite

	Fare il parsing di SEC EDGAR	Fornitore di API di bilanci	API Pick Financials
Costo	Gratis + ingegneria	Abbonamento	200 crediti/chiamata, solo se va a buon fine
Setup	Pipeline di normalizzazione di XBRL	Integrare endpoint tipizzati	Un endpoint, una forma
Copertura	USA, organizzato per filing	Profonda, storico lungo	Fondamentali USA + insider + dividendi
Stile di query	Per filing/concetto	Parametri tipizzati	Linguaggio naturale
Ideale per	Una tantum / controllo totale	Fondamentali come prodotto	Agenti finanziari (uno strumento tra tanti)

Il quadro completo

I fondamentali si combinano naturalmente con SEC Filings Search per il lato qualitativo (fattori di rischio, MD&A, linguaggio delle earnings call) e con Markets Search per il prezzo. Insieme sono la spina dorsale dell'agente di ricerca sugli investimenti. Una chiave, JSON dall'inizio alla fine, solo-se-va-a-buon-fine. Inizia gratis con 100 crediti, senza carta.

Domande frequenti

Non posso semplicemente ottenere i fondamentali gratis da SEC EDGAR?

Puoi — i dati company-facts e XBRL di EDGAR sono gratuiti e autorevoli. Il costo è l'ingegneria: i tag XBRL variano tra filer e periodi, le rettifiche complicano lo storico e devi mappare migliaia di concetti della tassonomia su uno schema pulito prima che un modello (o un grafico) possa usarli. Inoltre è solo statunitense e organizzato per filing, non per domanda. Per un'azienda ogni tanto, EDGAR va bene. Per un agente che interroga molte aziende in linguaggio naturale, un'API normalizzata fa risparmiare settimane.

Cosa è coperto — ed è solo statunitense?

Stati patrimoniali, conti economici, rendiconti finanziari, storico dei dividendi e transazioni degli insider per le società quotate statunitensi. Sono fondamentali statunitensi; per gli emittenti non statunitensi useresti una fonte diversa. Per il testo del filing in sé (fattori di rischio del 10-K, MD&A del 10-Q, earnings call), usa l'endpoint separato SEC Filings Search.

Perché vale la pena evidenziare le transazioni degli insider e i dividendi?

Sono ad alto segnale e fastidiosi da assemblare da soli. L'acquisto/vendita degli insider (Form 4 della SEC) è un segnale comportamentale molto osservato; lo storico dei dividendi conta per gli screen di reddito e di qualità. Entrambi richiedono il parsing di tipi di filing specifici da EDGAR. Qui sono campi di prima classe nello stesso endpoint dei bilanci.

Come si confronta con i fornitori di API di bilanci?

I fornitori dedicati (ad es. le API di bilanci) offrono endpoint profondi e tipizzati e uno storico lungo — ottimi se i fondamentali sono tutto il tuo prodotto. L'angolazione di API Pick è diversa: i fondamentali come uno strumento tra tanti all'interno di una suite (mercati, SEC, dati economici, notizie) dietro un'unica chiave, modellati per le query di un agente, fatturati solo-se-va-a-buon-fine. Se stai costruendo un agente finanziario invece di un prodotto di fondamentali, la suite-in-un'unica-forma è la strada più rapida.

Questo è una consulenza di investimento?

No. Sono dati finanziari pubblici strutturati per la ricerca e l'ancoraggio degli agenti. Informa l'analisi di una persona qualificata o di un agente supervisionato; non è una consulenza e non deve guidare il trading automatizzato senza responsabilità umana e controlli del rischio.