API de fundamentales de empresas: balance, flujo de caja y operaciones de insiders para agentes financieros
Los precios te dicen lo que el mercado piensa; los fundamentales te dicen si tiene razón. Aquí está una API de fundamentales conformada para agentes de IA — estados financieros, dividendos y operaciones de insiders en un solo endpoint — y cómo se compara con SEC EDGAR en crudo y con los proveedores de API de estados.
Resumen
- •Fundamentales = la capa de '¿está sano el negocio de verdad?': balance, cuenta de resultados, flujo de caja, dividendos, transacciones de insiders.
- •Puedes parsearlo gratis desde SEC EDGAR (XBRL), pero normalizar XBRL entre filers y periodos es ingeniería real y continua — y es solo de EE. UU. y al ritmo de los filings, no conformado para consultas.
- •Financials Search de API Pick devuelve los cinco fundamentales de empresas de EE. UU. detrás de un solo endpoint POST — 200 créditos/llamada, solo-si-acierta — preconformados para el razonamiento de un LLM.
- •Las transacciones de insiders (Form 4) y el histórico de dividendos son las señales infrautilizadas: baratas de traer aquí, dolorosas de ensamblar desde EDGAR.
- •Combina Financials con SEC Filings (texto cualitativo de 10-K/10-Q) y Markets (precio) para una vista anclada completa.
El precio es opinión; los fundamentales son evidencia
Una llamada de datos de mercado le dice a tu agente cuánto cuesta una acción. No puede decirte si el negocio que hay detrás está creciendo, ahogándose en deuda o siendo vendido en silencio por sus propios directivos. Esa es la capa de fundamentales — y es donde un agente de research pasa de "cita precios" a "se forma una opinión".
Cinco datasets cargan con la mayor parte de la señal: el balance, la cuenta de resultados, el estado de flujo de caja, el histórico de dividendos y las transacciones de insiders.
El impuesto de EDGAR
Todo esto es público y gratuito en SEC EDGAR. La pega es XBRL. El JSON de company-facts es enorme e inconsistente: el mismo concepto se etiqueta de forma distinta entre filers, las reformulaciones enturbian el histórico y tienes que mapear una taxonomía desperdigada a un schema limpio antes de que nada aguas abajo pueda usarla. Los datos de insiders (Form 4) y los dividendos son tipos de filing aparte que parseas por su cuenta. Hacer esto una vez para un ticker es un fin de semana; hacerlo de forma fiable para un agente que consulta cualquier empresa es un pipeline mantenido.
Fundamentales como una sola herramienta
Financials Search devuelve balances, cuentas de resultados, flujo de caja, dividendos y transacciones de insiders de empresas cotizadas de EE. UU. detrás de un solo endpoint POST — 200 créditos por llamada, solo-si-acierta, preconformados para 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. proveedor vs. suite
| Parsear SEC EDGAR | Proveedor de API de estados | API Pick Financials | |
|---|---|---|---|
| Coste | Gratis + ingeniería | Suscripción | 200 créditos/llamada, solo si acierta |
| Puesta en marcha | Pipeline de normalización de XBRL | Integrar endpoints tipados | Un endpoint, una forma |
| Cobertura | EE. UU., organizado por filing | Profunda, historial largo | Fundamentales de EE. UU. + insiders + dividendos |
| Estilo de consulta | Por filing/concepto | Parámetros tipados | Lenguaje natural |
| Mejor para | Puntual / control total | Fundamentales como el producto | Agentes financieros (una herramienta de muchas) |
La foto completa
Los fundamentales se combinan de forma natural con SEC Filings Search para el lado cualitativo (factores de riesgo, MD&A, lenguaje de las earnings calls) y con Markets Search para el precio. Juntos son la columna vertebral del agente de investigación de inversiones. Una clave, JSON de principio a fin, solo-si-acierta. Empieza gratis con 100 créditos, sin tarjeta.
Preguntas frecuentes
¿No puedo simplemente obtener los fundamentales gratis desde SEC EDGAR?
Puedes — los datos de company-facts y XBRL de EDGAR son gratuitos y autoritativos. El coste es la ingeniería: las etiquetas XBRL varían entre filers y periodos, las reformulaciones complican el histórico y tienes que mapear miles de conceptos de la taxonomía a un schema limpio antes de que un modelo (o un gráfico) pueda usarlos. Además es solo de EE. UU. y está organizado por filing, no por pregunta. Para una empresa de vez en cuando, EDGAR está bien. Para un agente que consulta muchas empresas en lenguaje natural, una API normalizada ahorra semanas.
¿Qué cubre — y es solo de EE. UU.?
Balances, cuentas de resultados, estados de flujo de caja, histórico de dividendos y transacciones de insiders de empresas cotizadas de EE. UU. Son fundamentales de EE. UU.; para emisores no estadounidenses usarías una fuente distinta. Para el texto del filing en sí (factores de riesgo del 10-K, MD&A del 10-Q, earnings calls), usa el endpoint aparte SEC Filings Search.
¿Por qué merece la pena destacar las transacciones de insiders y los dividendos?
Son de alta señal y molestas de ensamblar uno mismo. La compra/venta de insiders (Form 4 de la SEC) es una señal de comportamiento muy vigilada; el histórico de dividendos importa para los screens de renta y de calidad. Ambos requieren parsear tipos de filing concretos de EDGAR. Aquí son campos de primera clase en el mismo endpoint que los estados financieros.
¿Cómo se compara esto con los proveedores de API de estados financieros?
Los proveedores dedicados (p. ej. las API de estados financieros) dan endpoints profundos y tipados e historial largo — geniales si los fundamentales son todo tu producto. El ángulo de API Pick es distinto: los fundamentales como una herramienta más dentro de una suite (mercados, SEC, económicos, noticias) detrás de una sola clave, conformados para consultas de un agente, facturados solo-si-acierta. Si estás construyendo un agente financiero en lugar de un producto de fundamentales, la suite-en-una-sola-forma es la vía más rápida.
¿Esto es asesoramiento de inversión?
No. Son datos financieros públicos estructurados para research y anclaje de agentes. Informa el análisis de una persona cualificada o de un agente supervisado; no es asesoramiento y no debe impulsar trading automatizado sin responsabilidad humana y controles de riesgo.
APIs usadas en este artículo
Sarah Choy es la CEO de API Pick. Escribe sobre cómo construir APIs listas para producción para agentes de IA y flujos de trabajo con LLMs.