Para desarrolladores
API de dividendos y datos de la bolsa española
Dividendos, calendario, cuentas anuales, resultados y ratios de las empresas del BME, por HTTP y en JSON, desde los registros oficiales de la CNMV. Cada cifra viaja con su procedencia: de qué documento sale, o por qué falta.
100 peticiones al día. La clave sale al momento, sin tarjeta.
Qué datos da
| Recurso | Qué devuelve |
|---|---|
GET /v1/issuers | Catálogo: los 123 valores del mercado continuo con ticker, ISIN, NIF y qué ejercicios hay de cada uno. |
GET /v1/issuers/{id}/dividends | Dividendos de una empresa: lo anunciado a la CNMV (con la frase de la que sale cada fecha), lo publicado por BME y lo estimado, con ventana y no con fecha. |
GET /v1/events | Calendario de dividendos de toda la bolsa española entre dos fechas, en una sola petición, y las fechas de presentación de resultados anunciadas. |
GET /v1/issuers/{id}/annual | Cuentas anuales desde 2016: ingresos, EBITDA, beneficio, BPA, deuda, flujo de caja, capex y dividendo por acción. |
GET /v1/issuers/{id}/results | Resultados por periodo: primer y segundo semestre, ejercicio y, cuando los hay, trimestres. |
GET /v1/issuers/{id}/ratios | Márgenes, ROE, deuda neta / EBITDA, payout y crecimientos, cada uno con su fórmula y sus entradas. |
GET /v1/us/dividends | Calendario de dividendos de EE. UU. (Nasdaq), por fecha ex-dividendo o por símbolo. |
GET /v1/market/dividends | Dividendos de cualquier otro valor por símbolo: NYSE, Londres (DGE.L)… |
{id} es el ticker (TEF.MC), el ISIN o el NIF del emisor.
De dónde sale cada cifra
Cuentas anuales y semestrales
El XBRL de la Información Pública Periódica que cada emisor deposita por ley en la CNMV. Cada cifra dice si es reportada, derivada (con su fórmula) o un hueco con motivo.
Dividendos anunciados
Las comunicaciones de Otra Información Relevante e Información Privilegiada de la CNMV. Cada fecha e importe trae la frase literal del anuncio.
Dividendos del mercado
El calendario de BME, en su propio bloque; si confirma un anuncio, el evento lo dice (confirmed_by_bme).
Estimaciones
Los pagos de años anteriores del mismo emisor: una ventana de fechas y el método, nunca un día presentado como anunciado.
Resultados trimestrales
El informe de resultados que la empresa registra en la CNMV, con el enlace al documento en cada periodo.
EE. UU. y otros mercados
El calendario de Nasdaq y, fuera de él, Yahoo Finance; cada fila dice de qué fuente sale.
Una respuesta de ejemplo
Los dividendos de un emisor, recortados. Las cifras son inventadas; la forma es la real. Una fecha anunciada trae la frase del anuncio (quote), y un dato que la empresa no dio sale como null con su motivo.
GET /v1/issuers/EJE.MC/dividends
Authorization: Bearer bmef_…
{
"issuer": { "ticker": "EJE.MC", "isin": "ES0000000001", "name": "Ejemplo Energía, S.A." },
"coverage": { "source": "cnmv_oir", "scanned_through": "2026-03-01", "stale": false },
"events": [{
"kind": "cash",
"status": "announced",
"amount_gross": { "value": 0.15, "currency": "EUR", "origin": "reported",
"quote": "0,15 euros brutos por acción" },
"ex_date": { "value": "2026-06-17", "origin": "reported",
"quote": "cotizará ex-dividendo el 17 de junio" },
"record_date": { "value": null, "reason": "no_reportado" },
"payment_date": { "value": "2026-06-19", "origin": "reported", "quote": "pago el 19 de junio" },
"confirmed_by_bme": false
}],
"estimates": [{
"for_year": 2026,
"payment_window": { "from": "2026-12-10", "to": "2026-12-22", "expected": "2026-12-16" },
"amount_gross": { "value": 0.15, "currency": "EUR", "origin": "estimated" },
"basis_years": 4
}]
}El calendario de dos meses, desde la terminal:
curl -H "Authorization: Bearer $CLAVE" \
"https://api.divr.es/v1/events?from=2026-11-01&to=2026-12-31"Úsala desde donde ya trabajas
- Dividendos en Google Sheets: una fórmula, =DIVIDENDOS("TEF.MC"), y el calendario de pagos.
- Dividendos en Excel: el calendario de dividendos en una tabla de Power Query.
- Dividendos en Python: calendario, cuentas anuales y ratios en pandas.
Para cualquier otra herramienta, la especificación OpenAPI se importa en Postman o genera un cliente en tu lenguaje.
Planes
- Clave al momento, sin tarjeta
- Todos los recursos de datos
- El contador vuelve a cero a las 00:00 UTC
Para cuando 100 al día se quedan cortas. Precio y condiciones aún sin decidir: déjanos tu correo en la página de la API y te avisamos una vez, cuando exista.
Avísame¿De dónde salen los datos?
De los registros oficiales: la CNMV (cuentas en XBRL y comunicaciones de los emisores) y el calendario de BME. No es un agregador: cada cifra lleva dentro su origen, y lo que no se sabe sale como hueco con motivo, nunca como cero.
¿Cuánto cuesta?
El plan gratuito da 100 peticiones al día, con la clave al momento y sin tarjeta. Un plan con más peticiones está en camino; su precio aún no está decidido.
¿Puedo usarla en mi web o mi app?
Para uso propio, sí. La nota legal de la CNMV autoriza el uso privado y los cálculos derivados; si quieres redistribuir los datos a terceros, escríbenos antes.
¿Es la misma fuente que usa Divr?
Sí. El calendario, las páginas de dividendos y los resultados de divr.es salen de esta API.
Lo mismo, con tus acciones.
- Bruto, retención y neto de cada cobro, en euros.
- Rentabilidad sobre tu precio medio de compra.
- Aviso antes de cada pago y resumen listo para la renta.
Divr es la app gratis para el seguimiento de tu cartera de dividendos.
Sin tarjeta. Sin conectar tu bróker.
