API pública
La misma información que ves en el sitio, en JSON: fondos, compartimentos, carteras, valores y quién los tiene. Todo procede de las declaraciones a la CNMV.
Base y clave
La base es https://api.iberfunds.com y hace falta una clave. Se envía como cabecera X-API-Key o como ?key= en la URL — lo que te venga mejor; manda una de las dos, no las dos.
curl -H "X-API-Key: TU_CLAVE" \ "https://api.iberfunds.com/search/funds?q=bbva&limit=5"
La clave es gratis. Pídela escribiendo a [email protected] y cuéntanos para qué la quieres — no hace falta más, y no la usamos para nada que no sea eso.
No está ahí para esconder los datos: son públicos y el sitio los enseña. Está para poder ver que alguien se está llevando el corpus entero y cortarle a él sin cortar a todos.
Límites
Todos los endpoints tienen un tope: las búsquedas devuelven como mucho 100 resultados y el resto entre 50 y 500 según el caso. También hay un límite de velocidad por IP, del orden de dos peticiones por segundo con margen para ráfagas.
Si necesitas más, escríbenos antes de intentarlo a base de reintentos: casi siempre hay una forma mejor de pedir lo que buscas, y si no la hay, nos interesa saberlo.
Los endpoints principales
/status | Si la API está viva y de cuándo son los datos. |
/search/funds?q= | Buscar fondos por nombre o gestora. |
/search/securities?q= | Buscar valores por nombre o ISIN. |
/compartments/{id} | Un compartimento: identidad, última declaración y hermanos. |
/compartments/{id}/holdings | Su cartera en un periodo. |
/securities/{isin} | Un valor y qué fondos lo llevan. |
/securities/{isin}/ownership | Cómo ha cambiado esa propiedad entre periodos. |
/rankings/funds | Fondos ordenados por patrimonio. |
/market/overview | El agregado del mercado. |
El identificador de un compartimento puede ser su id numérico, su ISIN o su cnmv_compartment_id. Todas las respuestas vienen envueltas en { "data": … }.
Si lo que quieres es leerlo
Cualquier página del sitio tiene su versión en Markdown: pon /md/ delante de la ruta y la tienes en texto plano, sin clave. Por ejemplo /md/fondos. Está pensado para que un agente o un modelo lo lea sin tener que atravesar el HTML.
Qué puedes hacer con los datos
Las condiciones son las mismas que rigen el resto del sitio y están en el aviso legal: cita y enlaza lo que quieras indicando que procede de Iberfunds sobre declaraciones a la CNMV; no reproduzcas el conjunto de forma sistemática ni lo presentes como propio.
Y lo de siempre, que aquí importa más porque no hay una página delante que lo matice: esto no es asesoramiento financiero y no garantizamos que las cifras sean exactas. Si vas a construir algo encima, comprueba contra la declaración original lo que sea importante.