bme-fundamentals — API de datos fundamentales de las empresas del BME

Probar ahora

Peticiones de verdad, desde tu navegador, contra este mismo despliegue.

esperando

// Elige un recurso y pulsa Lanzar.
// Si el servicio aún no tiene emisores cargados responderá
// issuer_not_ingested — y eso también es una respuesta honesta.

La respuesta lleva la procedencia dentro

Una cifra no puede existir sin decir de dónde sale. O apunta al hecho del que salió, o declara la fórmula, o dice por qué está vacía.

Reportada

"revenue": {
  "value": 41315000000,
  "origin": "reported",
  "fact_id": "f_7d21…",
  "concept": "I1010"
}

Apunta al hecho exacto del documento. Se puede abrir el XBRL y verlo.

Hueco con motivo

"gross_profit": {
  "value": null,
  "reason": "no_existe_en_taxonomia"
}

Lista cerrada: no_existe_en_taxonomia, no_reportado, no_aplica_al_emisor, error_de_parseo. Un parser roto y una cifra que España no publica no son el mismo hueco.

Derivada

"ebitda": {
  "value": 13100000000,
  "origin": "derived",
  "formula": "operating_income
              + d_and_a"
}

Si se calculó, dice con qué. Nada aparece sin explicar cómo llegó ahí.

Nació de un `$0`

El proveedor anterior servía ceros donde no había dato. Beneficio bruto y resultado de explotación llegaban como ceros perfectamente formados. El problema no era la falta de datos: era que los datos malos parecían buenos.

Aquí un cero sólo existe si viene de un documento, y un hueco es un hueco con motivo escrito.

Fuente oficial, no agregador

Los documentos salen de la Información Pública Periódica de la CNMV — el XBRL que cada emisor está obligado por ley a depositar. No de una web scrapeada, ni de un PDF leído con IA.

Los informes ESEF se usan sólo para contrastar: ningún valor servido sale de ahí.

Cinco recursos

Todo bajo Authorization: Bearer, el catálogo incluido.

GET /v1/issuers El catálogo: quién hay, qué cobertura tiene cada uno y por qué no hay datos cuando no los hay.
GET /v1/issuers/{id}/annual La serie anual. {id} es ticker, ISIN o NIF.
GET /v1/issuers/{id}/dividends Los dividendos con fecha: ex-date y fecha de pago, cada uno con la frase del anuncio de la que salió. En un bloque aparte, los estimados a partir de los años anteriores — que dan ventana, no fecha.
GET /v1/events El calendario cruzado: qué se paga entre dos fechas, en todos los emisores. ?from=&to=, por defecto los próximos 90 días.
GET /v1/issuers/{id}/facts Los hechos crudos del XBRL. Reservada: responde 501 hasta que exista.

Cobertura, sin maquillar

El catálogo enseña también lo que no funciona. Un catálogo que sólo enseñara lo que funciona sería inútil justo el día que algo falla.

118emisores con NIF y fuente en la CNMV

5valores sin emisor: issuer_no_source, permanente

4fines de fuente escritos a mano, no deducidos

2021 →años con contraste ESEF disponible

Cinco errores, y ninguno ambiguo

Dos 404 distintos, porque permanente y transitorio no se reintentan igual.

issuer_unknown404Ese identificador no es de ningún emisor conocido.

issuer_no_source404Se sabe quién es y nunca tendrá datos aquí. Permanente.

issuer_not_ingested404Conocido, con fuente, aún sin cargar. Transitorio: reintentar sirve.

unauthorized401Falta la clave o no vale.

internal_error500Falló. Nunca un 200 parcial.

Pedir una clave

Se emiten a mano. Este formulario deja tu petición en la bandeja del operador y no concede nada al pulsarlo.