- SIE - API

El API del Sistema de Información Económica permite consultar las series de tiempo de todos los indicadores disponibles en este repositorio. Esta herramienta está orientada a desarrolladores o analistas que requieren la automatización del proceso de extracción de información económica publicada por el Banco de México.

A partir del 24 de marzo de 2023, para utilizar el API se requiere usar el protocolo TLS 1.3, como se indica en el Comunicado de Prensa.

1.5.0

07/02/2023

Documentación: Actualización y uso de TLS 1.3.

1.4.0

23/01/2020

Consulta de series versionadas.

1.3.4

15/01/2020

Parámetros incrementos y decimales.

1.3.3

05/09/2019

Documentación: contacto, obsolecencia de DgieWS, y TLS 1.2.

1.3.2

11/06/2019

Mejoras y corrección de errores menores.
Soporte para CORS.

1.3.1

24/08/2018

Mejoras y corrección de errores menores.

1.2.0

21/08/2018

Mejoras y corrección de errores menores.

1.1.3

17/08/2017

Documentación en inglés.

1.1.2

24/07/2017

Se permite recibir el token por parámetro, además de la opción de enviarlo como header.

Obtener token de consulta

Salvedad de uso del API

Todas las solicitudes que se realicen al API requieren enviar un token de consulta, por lo cual el primer paso es obtener el token que identificará las peticiones enviadas.

Obtener token

El token que se genera es una cadena de 64 caracteres. Este debe ser enviado cada vez que se realice una consulta al API, a través de un Header HTTP o un parámetro:

Bmx-Token: e3980208bf01ec653aba9aee3c2d6f70f6ae8b066d2545e379b9e0ef92e9de25

token=e3980208bf01ec653aba9aee3c2d6f70f6ae8b066d2545e379b9e0ef92e9de25

Obtener identificador de serie de tiempo

Con este identificador ahora es posible consultar las series de tiempo. A continuación se debe identificar la o las series que se desean consultar. Para esto es necesario consultar el Catálogo de series. Existe la opción de navegar a través de las estructuras de información hasta encontrar la serie deseada. El catálogo de series en su vista principal muestra el catálogo de sectores. Y seleccionando alguno de los sectores, se puede acceder a alguna de las estructuras de información que agrupan a las series de tiempo. Por ejemplo, si se requiere la información de la TIIE a 28 días se debe navegar de la siguiente forma:

Seleccionar el sector "Tasas y precios de referencia".

Luego, en la lista de estructuras de este sector, se localiza la estructura en "Tasas de interés bancarias y costos de captación > Información diaria > Tasas de interés en el mercado de dinero".

En la estructura de información es posible localizar la serie de tiempo y seleccionarla para obtener su identificador y algunos de sus metadatos.

Consultar API

Con el identificador de serie es posible consultar información de ella como:

Por ejemplo para obtener el dato más reciente de la TIIE a 28 días se debe realizar la siguiente petición

GET /SieAPIRest/service/v1/series/SF43783/datos/oportuno HTTP/1.1
Accept: application/json
Bmx-Token: e3980208bf01ec653aba9aee3c2d6f70f6ae8b066d2545e379b9e0ef92e9de25
Accept-Encoding: gzip

Esta petición lo que pretende es obtener el dato oportuno de la serie de tiempo con identificador SF43783 (TIIE a 28 días). Solicita la información en formato JSON (además también es posible obtener la información en JSONP y XML). También se envía el token en el header Bmx-Token. Por último se especifica que se requiere la información comprimida, para optimizar los tiempos de transferencia de datos.

De esta petición se obtiene la siguiente respuesta:

HTTP/1.1 200 OK
Content-Encoding: gzip
Content-Type: application/json;charset=UTF-8

{
  "bmx": {
    "series": [
      {
        "idSerie": "SF43783",
        "titulo": "TIIE a 28 días Tasa de interés en por ciento anual",
        "datos": [
          {
            "fecha": "31/01/2023",
            "dato": "10.8162"
          }
        ]
      }
    ]
  }
}

Al realizar peticiones al API, es importante tomar en cuenta que existen límites en el número de consultas. Más detalles aquí.

SIE API

Novedades