LOGO

{Documentación de la API}


Aprende a utilizar nuestra plataforma para acceder a la información del mercado bursátil Mexicano.


[Consulta también la documentación en Swagger: https://app.swaggerhub.com/apis-docs/DataBursatil/DataBursatil]

{ Información Básica }

¿Qué es una API?

Una API es una interfase hospedada en un servidor, que le permite a su usuario realizar consultas personalizadas de forma rápida y eficiente. No tiene las limitaciones de una aplicación web o de escritorio, ya que quien hace la solicitud solo descarga la información que necesita. Las APIs están en todos lados, muchas veces los usuarios no interactúan de forma directa con ellas, pero cada vez que usas la app de tu banco, cada vez que revisas tus redes sociales o visitas una página web, seguramente las estás utilizando.

De esta forma, acceder a la información bursátil por medio de una API, es una de las mejores opciones, que te permite descargar directamente información para que puedas realizar tus análisis, seguir tendencias del mercado o estar informado del contexto bursátil y económico de México.


¿Qué es el formato JSON?

Es un formato estándar para intercambio de datos. Se utiliza principalmente en las comunicaciones entre servidores y clientes. Al contener solo datos puros, sin un formato y con una denominación predefinida, su aplicación está muy extendida entre la mayoría de los lenguajes de programación y todo tipo de aplicaciones (incluyendo Excel).

De esta forma, todo el contenido que el usuario descargue de la API será en este formato. Otorgando flexibilidad al usuario para manipular y analizar todo el contenido de DataBursatil.

Ejemplo en JSON:

			
		  {"Emisora": "GRUPO FINANCIERO BANORTE, S.A.B DE C.V.",
		   "Bolsa": "Bolsa Mexicana de Valores",
		   "Tipo Valor": "ACCIONES DE EMPRESAS COMERCIALES, INDUSTRIALES Y DE SERVICIOS",
		   "Estatus": "ACTIVA"}
		  
		

Especificaciones técnicas

Toda la información disponible es accesible a través de una sola API. Se basa en el esquema REST, tiene URL orientadas a recursos, devuelve respuestas codificadas en JSON y códigos de respuesta HTTP estándar. 14 diferentes endpoints permiten a los usuarios realizar consultas especializadas.


Endpoints disponibles:

Endpoint Contenido que devuelve la API
/emisoras Buscar y obtén información general de las emisoras solicitadas y sus respectivas series.
/precios Obtén información de mercado básica de la emisora y serie solicitada.
/intradia Obtén información de mercado de la emisora y serie solicitada.
/intradia-plus Obtén información de mercado completa de la emisora y serie solicitada..
/cotizaciones Información de mercado completa, personalizando los campos solicitados y hasta 50 emisoras y series a la vez.
/top Principales emisoras por alzas, bajas, operaciones, volumen y/o importe operado.
/historicos Precios históricos al cierre del cada día de la emisora y serie especificada.
/financieros Estados financieros (Situación financiera, Flujos de efectivo y Resultados) de la emisora y periodo especificados.
/descargas Obtén hechos al cierre del dia o valuaciónes de Mercado de Dinero.
/dividendos Dividendo más reciente e histórico de pagos de la emisora y serie seleccionada.
/indices Último precio, anterior, máximo, mínimo, cambio porcentual, cambio en unidades y volumen de los principales índices bursátiles internacionales.
/tasas Tasas de mercado de dinero en México.
/divisas Último precio, cambio porcentual y monetario de los principales cruces de divisas.
/commodities Último precio, cambio monetario y porcentual de los principales commodities de hidrocarburos.
/noticias Principales noticias del día con énfasis en negocios y mercados financieros.
/cables Cables noticiosos de emisoras mexicanas y noticias recientes de economía y negocios en general.
/creditos Consulta de créditos disponibles para del token especificado.

Todas las solicitudes empiezan con la URL: https://api.databursatil.com/v1/

Cualquier solicitud por HTTP será redireccionada a HTTPS. El uso del www antes de api.databursatil.com/v1/ no afecta la solicitud.

El orden de los parámetros no afecta el resultado de la API.

La API solo acepta solicitudes usando el método GET, cualquier otro método será rechazado por el servidor arrojando un error 403.

{ Cómo ejecutar una consulta }

Navegador web

Puedes ejecutar tus consultas desde la barra de direcciones de tu navegador, de la misma forma en que ingresarías una página de internet. Cualquier navegador reciente es compatible. Firefox de forma nativa añade un formato para lectura de humanos. En Chrome y derivados, recomendamos la extensión JSON Viewer para agregar un formato visual más agradable.


Excel

Existen dos formas principales de ejecutar solicitudes en Excel. La primera es usando la fórmula =WEBSERVICE para versiones en ingĺés o =SERVICIOWEB para versiones en español.
Un ejemplo es la siguiente fórmula: (es importante ingresar un token válido para que la fórmula funcione)

			
=SERVICIOWEB("https://api.databursatil.com/v1/precios?emisora_serie=AMXB&token=TU_TOKEN&bolsa=BMV,BIVA")
		  
		

El resultado será una celda con la información del Endpoint descargado en texto. Para recargar los datos, puedes volver a ejecutar la fórmula o tecleando: Ctrl+Alt+F9

Descarga aquí un ejemplo en Excel aplicando la fórmula mencionada.

La segunda opción, es por medio de solicitudes de descarga de datos en Excel, para esto, contamos con el manual completo en esta misma página más abajo (ir). Este proceso requiere algunos pasos adicionales, pero la manipulación de datos es más eficiente, por lo cual, es nuestra recomendación para realizar análisis en Excel.


Hojas de cálculo de Google

Google Sheets tiene una fórmula similar a Excel para descarga de datos por medio de URL llamada =IMPORTDATA, solo existe en inglés.
Un ejemplo es la siguiente fórmula: (es importante ingresar un token válido para que la fórmula funcione)

			
=IMPORTDATA("https://api.databursatil.com/v1/precios?emisora_serie=AMXB&token=TU_TOKEN&bolsa=BMV,BIVA")
		  
		

Lenguajes de programación

Tal vez sea la forma más eficiente y nativa para trabajar con API en JSON. En nuestra página principal, podrás encontrar ejemplos para 7 lenguajes de programación distintos en dónde se explica cómo ejecutar solicitudes de la API.
Recomendamos los siguientes videos en Youtube para profundizar sobre cómo realizar consultas:

Python: link
R: link
PHP: link
Ruby: link
Java: link
JavaScript: link
Go: link

Software especializado

También podrás realizar tus consultas utilizando programas que han sido diseñados para consumo de APIs. Nosotros recomendamos tres: Postman , Hoppscotch y Insomnia. Ambos programas te permitirán ejecutar tus solicitudes desde un entorno diseñado para este propósito.

{ Alcance de la información }

Mercado de Capitales

La API permite acceder de forma gratuita a los precios de instrumentos que coticen en la Bolsa Mexicana de Valores y la Bolsa Institucional de Valores. Incluye el mercado local y global (antes llamado SIC). Los precios de todos los instrumentos se expresan en Pesos Mexicanos, a menos que se especifique lo contrario.

Endpoint Mercado Local Mercado Global
/emisoras SI SI
/precios SI SI
/intradia SI SI
/intradia-plus SI SI
/cotizaciones SI SI
/top SI SI
/historicos SI SI
/financieros SI NO
/dividendos SI NO
/indices SI SI

Mercado de Dinero

Se incluyen las tasas diarias publicadas por Banxico.


Mercado de Cambios (Forex)

La API permite el acceso a los principales cruces de divisas contra el Peso Mexicano y otras divisas internacionales.


Commodities

Se muestra la cotización diaria de los principales commodities de hidrocarburos internacionales, expresados en dólares Estadounidenses, a menos que se especifique lo contrario.


Noticias

Muestra los principales titulares de noticias sobre economía y finanzas de México e internacionales.

{ Estatus }

El estado operativo (estatus) en tiempo real de la API y de la página web podrá ser consultado en el siguiente subdominio:

De igual forma, el siguiente correo electrónico está disponible para reportes sobre estatus de la API, bugs y/o errores encontrados:

[email protected]

{ Versiones }

La versión actual de la API se encuentra en su versión 1 (v1). Si nuevas versiones son añadidas en un futuro, las anteriores y nuevas rutas seguirán disponibles para ofrecer una retrocompatibilidad, a reserva de que se especifique lo contrario.

La versión está definida en la ruta de cada URL:

{ Método de autenticación }

Token

Para acceder a la información disponible en la API es necesario ingresar un token como parámetro. Este token corresponde a una serie de 30 caracteres alfanuméricos definidos de forma única e intransferible para cada usuario. Lo puedes consultar en tu Dashboard (requiere inicio de sesión).

Cada solicitud requiere del método de verificación, de lo contrario, la API devuelve un error por ausencia o incorrección del token. La declaración del token se realiza utilizando el parámetro con el mismo nombre dentro de la url, este es un ejemplo: &token=2435ac3c571b796f7ea8c8e2e88154.

Mantén tu token en secreto y no lo compartas o publiques en repositorios o scripts a donde terceros puedan acceder, de lo contrario consumirán tus créditos. El uso indebido del token causará su bloqueo temporal o permanente. En caso de que lo necesites, en tu Dashboard podrás renovar tu token (límite de 1 vez por semana) o desactivarlo cuantas veces lo requieras y por el tiempo que desees. Si está desactivado, cualquier consulta a la API es rechazada.

{ Créditos }

El mecaniso para limitar la cantidad de solicitudes que puede realizar un usuario es por medio de consumo de créditos por solicitud realizada. Cada usuario tiene asignados 250,000 créditos mensuales para realizar consultas a la API. Esta cantidad ha sido determinada para que cada usuario pueda acceder de forma equitativa al contenido de la API, cumpliendo con sus necesidades de información de mercado sin sobrecargar nuestros servidores (recuerda que no tenemos fin de lucro y el costo de los servidores es cubierto por nosotros mismos

La API no cuenta con contenido exclusivo para usuarios de pago, ya que nuestra filosofía es que todos los interesados en el mercado bursátil deben tener la posibilidad de acceder a la información disponible de forma fácil, gratuita y al menor costo posible.

Una solicitud exitosa genera un consumo en créditos, los cuales son utilizados para moderar y medir el acceso a la API. El costo está definido en la sección de créditos de cada endpoint, ya sea en esquema fijo o variable. Los créditos disponibles pueden ser consultados en tu Dashboard o utilizando el endpoint de consulta de créditos.

Una vez terminados los créditos, el acceder a la API genera un código de error, hasta que los créditos sean restablecidos por el sistema o incrementados por el usuario. El restablecimiento automático de todos los usuarios ocurre el primer día natural de cada mes a las 00:01 horas de la Ciudad de México.

{ Códigos de Error }

Cuando la API recibe algún parámetro incorrecto o ha ocurrido algún error, los siguientes mensajes pueden ser mostrados.

Cada Endpoint tiene el apartado de "catálogo de errores" que permite conocer de forma específica los errores para cada punto de acceso.


Errores de autenticación:

Se solucionan atendiendo el mensaje del mismo error.

Código Mensaje
401 "Error": "Es necesario ingresar el parámetro '&token=' y un token válido para ejecutar la consulta. ¿Dudas? Revisa la documentación: https://databursatil.com/docs.html#auth"
401 "Error": "Longitud del token no válida. ¿Dudas? Revisa la documentación: https://databursatil.com/docs.html#auth"
401 "Error": "Token no registrado. Crea una cuenta y accede a tu token: https://databursatil.com/nuevo_usuario.php"
401 "Error": "Token desactivado. Actívalo desde tu Dashboard: https://databursatil.com/dashboard.php"
401 "Error": "Token suspendido. Dudas o aclaraciones: [email protected]"
401 "Error": "Créditos insuficientes. Opcionalmente, puedes incrementarlos desde: https://databursatil.com/incrementar_creditos.php"

Errores generados por el servidor:

Nuestro equipo detecta estos errores y los corrige a la brevedad posible.

Código Mensaje
500 "Error": "Desconocido ID: MEX1000"
500 "Error": "Desconocido ID: MEX1001"
500 "Error": "Desconocido ID: MEX1002"
500 "Error": "Desconocido ID: MEX1003"
500 "Error": "Desconocido ID: MEX1004"
500 "Error": "Desconocido ID: MEX1005"
500 "Error": "Desconocido ID: MEX1006"
500 "Error": "Desconocido ID: MEX1007"
500 "Error": "Desconocido ID: MEX1008"
500 "Error": "Desconocido ID: MEX1009"
500 "Error": "Desconocido ID: MEX1010"
500 "Error": "Desconocido ID: MEX1011"
500 "Error": "Desconocido ID: MEX1012"
500 "Error": "Desconocido ID: MEX1013"
500 "Error": "Desconocido ID: MEX1014"
500 "Error": "Desconocido ID: MEX1015"
500 "Error": "Desconocido ID: MEX1016"
500 "Error": "Desconocido ID: MEX1017"

{Endpoints}


17 puntos de acceso están disponibles para tu consulta dentro de la API

{ Emisoras }

GET https://api.databursatil.com/v1/emisoras

Buscar y obtén información general de las emisoras solicitadas y sus respectivas series.

Parámetros

Parámetro Exigibilidad Uso
token Requerido Método de autenticación
letra Opcional Permite filtrar por la letra o palabra ingresada
mercado Opcional Opciones disponibles: "local" y/o "global". Pueden ser agregadas ambas siendo separadas por coma

mercado=: "local" se refiere a las emisoras del mercado nacional, "global" se refiere a todas las emisoras del mercado global (antes llamado SIC).

Respuesta

Llave Estado Tipado Concepto
(consecutivo) Fijo Número entero Consecutivo por Emisora
Emisora Fijo Texto Clave de pizzarra de la emisora
(consecutivo) Fijo Número entero Consecutivo por Serie
Serie Fijo Texto Serie de la emisora
Razon Social Fijo Texto Razón social de la emisora
ISIN Fijo Texto ISIN de la emisora
Bolsa Fijo Texto Bolsa de origen de la emisora
Tipo Valor Descripcion Fijo Texto Descripción larga del tipo valor
Tipo Valor ID Fijo Texto ID del tipo valor
Estatus Fijo Texto Situación de la emisora
Acciones en Circulacion Fijo Número entero Número de acciónes en circulación
Rango Historicos Fijo Texto Rango de historicos disponibles
Rango Financieros Fijo Texto Fechas de financieros disponibles

Catálogo de errores:

Generados por el usuario. Se solucionan atendiendo el mensaje del mismo error.

Código Mensaje
400 Error: Error al momento de procesar el mercado. Solo hay dos opciones disponibles, juntas o por separado: 'local' y/o 'global'.

Generados por procesamientos de datos. Se solucionan intentando con otro parámetro: fecha, emisora, serie, etc.

Código Mensaje
400 Error: La búsqueda no arrojó ningún resultado.
400 Error: Error al momento de procesar las emisoras

Errores de autenticación: Disponibles consultando la referencia códigos de error

Temporalidad

Actualizado de forma diaria

Consumo de créditos

1 crédito por emisora


Ejemplo 1

La solicitud sin los parámetros letra= y mercado= devuelve todos los valores listados, lo cual considera aproximadamente de 3,600 emisoras con sus series

			
			https://api.databursatil.com/v1/emisoras?token=TU_TOKEN
			
		

Respuesta de la API

		
			{"0":{
			     "0JN9": {
			              "O": {
			                   "Serie": "N",
			                   "Razon Social": "DSV A/S",
			                   "ISIN": "DK0060079531",
			                   "Bolsa": "LONDON STOCK EXCHANGE",
			                   "Tipo Valor Descripcion": "ACCIONES DEL SISTEMA INTERNACIONAL DE COTIZACIONES",
			                   "Tipo Valor ID": "1A",
			                   "Estatus": "ACTIVA",
			                   "Acciones en Circulacion": 190000000,
			                   "Rango Historicos": "2015/04/09 - 2023/09/13",
			                   "Rango Financieros": "null"}}},
			 "1":{
			     "0QBO": {
			              "O": {
			                   "Serie": "N",
			                   "Razon Social": "COLOPLAST A/S",
			                   "ISIN": "DK0060448595",
			                   "Bolsa": "LONDON STOCK EXCHANGE",
			                   "Tipo Valor Descripcion": "ACCIONES DEL SISTEMA INTERNACIONAL DE COTIZACIONES",
			                   "Tipo Valor ID": "1A",
			                   "Estatus": "ACTIVA",
			                   "Acciones en Circulacion": 198000000,
			                   "Rango Historicos": "2015/04/09 - 2023/09/13",
			                   "Rango Financieros": "null"}}},
			 "2":{
			     "0R87": {
			              "O": {
			                   "Serie": "N",
			                   "Razon Social": "ASSA ABLOY AB",
			                   "ISIN": "SE0007100581",
			                   "Bolsa": "LONDON STOCK EXCHANGE",
			                   "Tipo Valor Descripcion": "ACCIONES DEL SISTEMA INTERNACIONAL DE COTIZACIONES",
			                   "Tipo Valor ID": "1A",
			                   "Estatus": "ACTIVA",
			                   "Acciones en Circulacion": 1055050365,
			                   "Rango Historicos": "2014/12/17 - 2023/09/13",
			                   "Rango Financieros": "null"}}},
			 "3":{
			     "1093": {
			              "O": {
			                   "Serie": "N",
			                   "Razon Social": "CSPC PHARMACEUTICAL GROUP LIMITED",
			                   "ISIN": "HK1093012172",
			                   "Bolsa": "HONG KONG STOCK EXCHANGE",
			                   "Tipo Valor Descripcion": "ACCIONES DEL SISTEMA INTERNACIONAL DE COTIZACIONES",
			                   "Tipo Valor ID": "1A",
			                   "Estatus": "ACTIVA",
			                   "Acciones en Circulacion": 11973769732,
			                   "Rango Historicos": "2021/08/18 - 2023/09/13",
			                   "Rango Financieros": "null"}}}}
		
		

Ejemplo 2

La solicitud filtra por todas las emisoras y sus series que inicien con la letra "H" y que sean del mercado local.

			
			https://api.databursatil.com/v1/emisoras?token=TU_TOKEN&letra=H&mercado=local
			
		

Respuesta de la API

		
			{"0":{
			     "HCITY": {
			              "O": {
			                   "Serie": "*",
			                   "Razon Social": "HOTELES CITY EXPRESS, S.A.B. DE C.V.",
			                   "ISIN": "MX01HC000001",
			                   "Bolsa": "BMV",
			                   "Tipo Valor Descripcion": "ACCIONES DE EMPRESAS COMERCIALES, INDUSTRIALES Y DE SERVICIOS",
			                   "Tipo Valor ID": "1",
			                   "Estatus": "ACTIVA",
			                   "Acciones en Circulacion": 408268713,
			                   "Rango Historicos": "2013/06/17 - 2023/09/13",
			                   "Rango Financieros": "1T_2017, 1T_2018, 1T_2019, 1T_2020, 1T_2021, 1T_2022, 1T_2023, 2T_2016, 2T_2017, 2T_2018, 2T_2019,
								    2T_2020, 2T_2021, 2T_2022, 2T_2023, 3T_2016, 3T_2017, 3T_2018, 3T_2019, 3T_2020, 3T_2021, 3T_2022,
								    4T_2016, 4T_2017, 4T_2018, 4T_2019, 4T_2020, 4T_2021, 4T_2022"}}},
			 "1":{
			     "HERDEZ": {
			              "O": {
			                   "Serie": "*",
			                   "Razon Social": "GRUPO HERDEZ, S.A.B. DE C.V.",
			                   "ISIN": "MX01HE010008",
			                   "Bolsa": "BMV",
			                   "Tipo Valor Descripcion": "ACCIONES DE EMPRESAS COMERCIALES, INDUSTRIALES Y DE SERVICIOS",
			                   "Tipo Valor ID": "1",
			                   "Estatus": "ACTIVA",
			                   "Acciones en Circulacion": 390761484,
			                   "Rango Historicos": "2010/01/05 - 2023/09/13",
			                   "Rango Financieros": "1T_2017, 1T_2018, 1T_2019, 1T_2020, 1T_2021, 1T_2022, 1T_2023, 2T_2016, 2T_2017, 2T_2018, 2T_2019,
								    2T_2020, 2T_2021, 2T_2022, 2T_2023, 3T_2016, 3T_2017, 3T_2018, 3T_2019, 3T_2020, 3T_2021, 3T_2022,
								    4T_2016, 4T_2017, 4T_2018, 4T_2019, 4T_2020, 4T_2021, 4T_2022"}}},
			 "2":{
			     "HIMEXSA": {
			              "O": {
			                   "Serie": "A",
			                   "Razon Social": "HIMEXSA, S.A.B. DE C.V.",
			                   "ISIN": "MX01HI070008",
			                   "Bolsa": "BMV",
			                   "Tipo Valor Descripcion": "ACCIONES DE EMPRESAS COMERCIALES, INDUSTRIALES Y DE SERVICIOS",
			                   "Tipo Valor ID": "1",
			                   "Estatus": "SUSPENDIDA",
			                   "Acciones en Circulacion": 139440000,
			                   "Rango Historicos": "2010/01/05 - 2018/02/14",
			                   "Rango Financieros": "1T_2017, 1T_2018, 1T_2019, 2T_2016, 2T_2017, 2T_2018, 3T_2016, 3T_2017, 3T_2018, 4T_2016,
								    4T_2017, 4T_2018"}}},
			              "1": {
			                   "Serie": "B",
			                   "Razon Social": "HIMEXSA, S.A.B. DE C.V.",
			                   "ISIN": "MX01HI070008",
			                   "Bolsa": "BMV",
			                   "Tipo Valor Descripcion": "ACCIONES DE EMPRESAS COMERCIALES, INDUSTRIALES Y DE SERVICIOS",
			                   "Tipo Valor ID": "1",
			                   "Estatus": "SUSPENDIDA",
			                   "Acciones en Circulacion": 9337,
			                   "Rango Historicos": "2010/01/05 - 2018/02/14",
			                   "Rango Financieros": "1T_2017, 1T_2018, 1T_2019, 2T_2016, 2T_2017, 2T_2018, 3T_2016, 3T_2017, 3T_2018, 4T_2016,
								    4T_2017, 4T_2018"}}}}
		
		

{ Precios }

GET https://api.databursatil.com/v1/precios

Obtén información de mercado básica de la emisora y serie solicitada.

Parámetros

Parámetro Exigibilidad Uso
token Requerido Método de autenticación
emisora_serie Requerido Especifica la emisora con serie de la cual se solicitan las cotizaciones
bolsa Requerido Especifica el origen de las cotizaciones. Solo existen dos opciones disponibles: "BMV" y/o "BIVA"

bolsa= solo admite dos opciones: "BMV" y/o "BIVA". Se puede solicitar ambos al mismo tiempo separados por coma.

Respuesta

Llave Estado Tipado Concepto
bolsa Fijo Decimal Bolsa origen de los datos mostrados
ultimo Fijo Decimal Último hecho de la emisora
ppp Fijo Decimal Precio Promedio ponderado
cambio% Fijo Decimal Cambio porcentual con base en el precio de apertura
cambio$ Fijo Decimal Cambio monetario con base en el precio de apertura
tiempo Fijo Texto Fecha y hora de los datos en formato: YYYY-MM-DD hh:mm:ss

Catálogo de errores:

Generados por el usuario. Se solucionan atendiendo el mensaje del mismo error.

Código Mensaje
400 Error: Es necesario ingresar el parámetro '&emisora_serie=' y una emisora con serie válida para ejecutar la consulta.
400 Error: Es necesario ingresar una emisora con serie válida.
400 Error: Es necesario ingresar el parámetro '&bolsa=' y al menos una de las dos bolsas disponibles para ejecutar la consulta: 'BMV' o 'BIVA'.
400 Error: Es necesario ingresar al menos una de las dos bolsas disponibles: 'BMV' y/o 'BIVA'.

Generados por procesamientos de datos. Se solucionan intentando con otro parámetro: fecha, emisora, serie, etc.

Código Mensaje
400 Error: Error al momento de elegir la bolsa
400 Error: No existe la bolsa seleccionada. Las opciones disponibles son: 'BMV' y/o 'BIVA'.
400 Error: Emisora y/o serie desconocida. También puedes consultar el Endpoint /emisoras para buscar emisoras y sus series.

Errores de autenticación: Disponibles consultando la referencia códigos de error

Temporalidad

Información con 20 minutos de retraso

Consumo de créditos

1 crédito por bolsa solicitada


Ejemplo 1

			
https://api.databursatil.com/v1/precios?token=TU_TOKEN&emisora_serie=AMXB&bolsa=BMV,BIVA
			
		

Respuesta de la API

			
		  {"BMV": {
			  "ultimo": 19.86,
			  "ppp": 19.81,
			  "cambio%": -0.25,
			  "cambio$": -0.05,
			  "tiempo": "2022-03-10 03:00:00"},
		  "BIVA": {
			  "ultimo": 19.85,
			  "ppp": 0.0,
			  "cambio%": -0.05,
			  "cambio$": -0.01,
			  "tiempo": "2022-03-10 03:09:00"}}
		  
		

Ejemplo 2

			
https://api.databursatil.com/v1/precios?token=TU_TOKEN&emisora_serie=AMXB&bolsa=BIVA
			
		

Respuesta de la API

			
		  {"BIVA": {
			  "ultimo": 19.85,
			  "ppp": 0.0,
			  "cambio%": -0.05,
			  "cambio$": -0.01,
			  "tiempo": "2022-03-10 03:09:00"}}
		  
		

{ Intradia }

GET https://api.databursatil.com/v1/intradia

Obtén información de mercado de la emisora y serie solicitada.

Parámetros

Parámetro Exigibilidad Uso
token Requerido Método de autenticación
emisora_serie Requerido Especifica la emisora con serie de la cual se solicitan las cotizaciones
bolsa Requerido Especifica el origen de las cotizaciones. Solo existen dos opciones disponibles: "BMV" y/o "BIVA"

bolsa= solo admite dos opciones: "BMV" y/o "BIVA". Se puede solicitar ambos al mismo tiempo separados por coma.

Respuesta

Llave Estado Tipado Concepto
bolsa Fijo Decimal Bolsa origen de los datos mostrados
ultimo Fijo Decimal Último hecho de la emisora
ppp Fijo Decimal Precio Promedio ponderado
anterior Fijo Decimal Precio anterior de la emisora
maximo Fijo Decimal Precio máximo en la sesión de la emisora
minimo Fijo Decimal Precio mínimo en la sesión de la emisora
cambio% Fijo Decimal Cambio porcentual con base en el precio de apertura
cambio$ Fijo Decimal Cambio monetario con base en el precio de apertura
tiempo Fijo Texto Fecha y hora de los datos en formato: YYYY-MM-DD hh:mm:ss

Catálogo de errores:

Generados por el usuario. Se solucionan atendiendo el mensaje del mismo error.

Código Mensaje
400 Error: Es necesario ingresar el parámetro '&emisora_serie=' y una emisora con serie válida para ejecutar la consulta.
400 Error: Es necesario ingresar una emisora con serie válida.
400 Error: Es necesario ingresar el parámetro '&bolsa=' y al menos una de las dos bolsas disponibles para ejecutar la consulta: 'BMV' o 'BIVA'.
400 Error: Es necesario ingresar al menos una de las dos bolsas disponibles: 'BMV' y/o 'BIVA'.

Generados por procesamientos de datos. Se solucionan intentando con otro parámetro: fecha, emisora, serie, etc.

Código Mensaje
400 Error: Error al momento de elegir la bolsa
400 Error: No existe la bolsa seleccionada. Las opciones disponibles son: 'BMV' y/o 'BIVA'.
400 Error: Emisora y/o serie desconocida. También puedes consultar el Endpoint /emisoras para buscar emisoras y sus series.

Errores de autenticación: Disponibles consultando la referencia códigos de error

Temporalidad

Información con 20 minutos de retraso

Consumo de créditos

2 créditos por bolsa solicitada


Ejemplo 1

			
https://api.databursatil.com/v1/intradia?token=TU_TOKEN&emisora_serie=AMXB&bolsa=BMV,BIVA
			
		

Respuesta de la API

			
		  {"BMV": {
			  "ultimo": 19.86,
			  "ppp": 19.81,
			  "anterior": 19.86,
			  "maximo": 20.03,
			  "minimo": 19.79,
			  "cambio%": -0.25,
			  "cambio$": -0.05,
			  "tiempo": "2022-03-10 03:00:00"},
		  "BIVA": {
			  "ultimo": 19.85,
			  "ppp": 0.0,
			  "anterior": 19.86,
			  "maximo": 20.02,
			  "minimo": 19.79,
			  "cambio%": -0.05,
			  "cambio$": -0.01,
			  "tiempo": "2022-03-10 03:09:00"}}
		  
		

Ejemplo 2

			
https://api.databursatil.com/v1/intradia?token=TU_TOKEN&emisora_serie=AMXB&bolsa=BIVA
			
		

Respuesta de la API

			
		  {"BIVA": {
			  "ultimo": 19.85,
			  "ppp": 0.0,
			  "anterior": 19.86,
			  "maximo": 20.02,
			  "minimo": 19.79,
			  "cambio%": -0.05,
			  "cambio$": -0.01,
			  "tiempo": "2022-03-10 03:09:00"}}
		  
		

{ Intradia Plus }

GET https://api.databursatil.com/v1/intradia-plus

Obtén información de mercado completa de la emisora y serie solicitada.

Parámetros

Parámetro Exigibilidad Uso
token Requerido Método de autenticación
emisora_serie Requerido Especifica la emisora con serie de la cual se solicitan las cotizaciones
bolsa Requerido Especifica el origen de las cotizaciones. Solo existen dos opciones disponibles: "BMV" y/o "BIVA"

El parámetro bolsa= solo admite dos opciones: "BMV" y/o "BIVA". Se puede solicitar ambos al mismo tiempo separados por coma.

Respuesta

Llave Estado Tipado Concepto
bolsa Fijo Decimal Bolsa origen de los datos mostrados
ultimo Fijo Decimal Último hecho de la emisora
ppp Fijo Decimal Precio Promedio ponderado
anterior Fijo Decimal Precio anterior de la emisora
maximo Fijo Decimal Precio máximo en la sesión de la emisora
minimo Fijo Decimal Precio mínimo en la sesión de la emisora
cambio% Fijo Decimal Cambio porcentual con base en el precio de apertura
cambio$ Fijo Decimal Cambio monetario con base en el precio de apertura
volumen Fijo Decimal Acciones negociadas por la emisora
operaciones Fijo Decimal Número de operaciones negociadas por la emisora
importe Fijo Decimal Importe operado por la emisora
tiempo Fijo Texto Fecha y hora de los datos en formato: YYYY-MM-DD hh:mm:ss

Catálogo de errores:

Generados por el usuario. Se solucionan atendiendo el mensaje del mismo error.

Código Mensaje
400 Error: Es necesario ingresar el parámetro '&emisora_serie=' y una emisora con serie válida para ejecutar la consulta.
400 Error: Es necesario ingresar una emisora con serie válida.
400 Error: Es necesario ingresar el parámetro '&bolsa=' y al menos una de las dos bolsas disponibles para ejecutar la consulta: 'BMV' o 'BIVA'.
400 Error: Es necesario ingresar al menos una de las dos bolsas disponibles: 'BMV' y/o 'BIVA'.

Generados por procesamientos de datos. Se solucionan intentando con otro parámetro: fecha, emisora, serie, etc.

Código Mensaje
400 Error: Error al momento de elegir la bolsa
400 Error: No existe la bolsa seleccionada. Las opciones disponibles son: 'BMV' y/o 'BIVA'.
400 Error: Emisora y/o serie desconocida. También puedes consultar el Endpoint /emisoras para buscar emisoras y sus series.

Errores de autenticación: Disponibles consultando la referencia códigos de error

Temporalidad

Información con 20 minutos de retraso

Consumo de créditos

3 créditos por bolsa solicitada


Ejemplo 1

			
https://api.databursatil.com/v1/intradia-plus?token=TU_TOKEN&emisora_serie=AMXB&bolsa=BMV,BIVA
			
		

Respuesta de la API

			
		  {"BMV": {
			  "ultimo": 19.86,
			  "ppp": 19.81,
			  "anterior": 19.86,
			  "maximo": 20.03,
			  "minimo": 19.79,
			  "cambio%": -0.25,
			  "cambio$": -0.05,
			  "volumen": 2535288.0,
			  "operaciones": 8826.0,
			  "importe": 117520843.46,
			  "tiempo": "2022-03-10 03:00:00"},
		  "BIVA": {
			  "ultimo": 19.85,
			  "ppp": 0.0,
			  "anterior": 19.86,
			  "maximo": 20.02,
			  "minimo": 19.79,
			  "cambio%": -0.05,
			  "cambio$": -0.01,
			  "volumen": 135392.0,
			  "operaciones": 834.0,
			  "importe": 6308470.57,
			  "tiempo": "2022-03-10 03:09:00"}}
		  
		

Ejemplo 2

			
https://api.databursatil.com/v1/intradia-plus?token=TU_TOKEN&emisora_serie=AMXB&bolsa=BIVA
			
		

Respuesta de la API

			
		  {"BIVA": {
			  "ultimo": 19.85,
			  "ppp": 0.0,
			  "anterior": 19.86,
			  "maximo": 20.02,
			  "minimo": 19.79,
			  "cambio%": -0.05,
			  "cambio$": -0.01,
			  "volumen": 135392.0,
			  "operaciones": 834.0,
			  "importe": 6308470.57,
			  "tiempo": "2022-03-10 03:09:00"}}
		  
		

{ Cotizaciones }

GET https://api.databursatil.com/v1/cotizaciones

Información de mercado completa, personalizando los campos solicitados y hasta 50 emisoras y series a la vez.

Parámetros

Parámetro Exigibilidad Uso
token Requerido Método de autenticación
emisora_serie Requerido Especifica la emisora con serie de la cual se solicitan las cotizaciones
bolsa Requerido Especifica el origen de las cotizaciones. Solo existen dos opciones disponibles: "BMV" y/o "BIVA"
concepto Requerido Especifica los conceptos solicitados, opciones disponibles: 'U','P','A','MA','MI','CP','CM','V','O', y/o 'I'

emisora_serie admite desde 1 emisora con serie hasta 50. Separar por coma en caso de ingresar más de 1.

bolsa solo admite dos opciones: "BMV" y/o "BIVA". Se puede solicitar ambos al mismo tiempo separados por coma.

Llave Estado Tipado Concepto
U Fijo Decimal Último hecho de la emisora
P Fijo Decimal Precio Promedio ponderado
A Fijo Decimal Precio anterior de la emisora
X Fijo Decimal Precio máximo en la sesión de la emisora
N Fijo Decimal Precio mínimo en la sesión de la emisora
C Fijo Decimal Cambio porcentual con base en el precio de apertura
M Fijo Decimal Cambio monetario con base en el precio de apertura
V Fijo Decimal Acciones negociadas por la emisora
O Fijo Decimal Número de operaciones negociadas por la emisora
I Fijo Decimal Importe operado por la emisora
F Fijo Texto Fecha y hora de los datos en formato: YYYY-MM-DD hh:mm:ss

Catálogo de errores:

Generados por el usuario. Se solucionan atendiendo el mensaje del mismo error.

Código Mensaje
400 Error: Es necesario ingresar el parámetro '&emisora_serie=' y una emisora con serie válida para ejecutar la consulta.
400 Error: Es necesario ingresar una emisora con serie válida.
400 Error: Es necesario ingresar el parámetro '&bolsa=' y al menos una de las dos bolsas disponibles para ejecutar la consulta: 'BMV' o 'BIVA'.
400 Error: Es necesario ingresar al menos una de las dos bolsas disponibles: 'BMV' y/o 'BIVA'.
400 Error: Es necesario ingresar el parametro 'concepto=' y al menos una de las opciones disponibles para ejecutar la consulta: 'U','P','A','MA','MI','CP','CM','V','O', y/o 'I'.
400 Error: El limite es hasta 50 emisoras y series por solicitud.

Generados por procesamientos de datos. Se solucionan intentando con otro parámetro: fecha, emisora, serie, etc.

Código Mensaje
400 Error: Error al momento de elegir la bolsa
400 Error: No existe la bolsa seleccionada. Las opciones disponibles son: 'BMV' y/o 'BIVA'.
400 Error: Emisora y/o serie desconocida. También puedes consultar el Endpoint /emisoras para buscar emisoras y sus series.

Errores de autenticación: Disponibles consultando la referencia códigos de error

Temporalidad

Información con 20 minutos de retraso

Consumo de créditos

1 crédito por concepto solicitado


Ejemplo 1

			
				https://api.databursatil.com/v1/cotizaciones?token=TU_TOKEN&emisora_serie=AAPL*,GOOG*&bolsa=BMVconcepto=U
			
		

Respuesta de la API

	
		{"AAPL*": {
			"BMV": {
				"U": 4335.0,
				"F": "2024-09-12 14:07:00"}},
		"GOOG*": {
			"BMV": {
				"U": 3054.98,
				"F": "2024-09-12 14:07:00"}}}
			
		

Ejemplo 2

			
https://api.databursatil.com/v1/cotizaciones?token=TU_TOKEN&emisora_serie=AAPL*,GOOG*&bolsa=BMV,BIVAconcepto=U,P,A,X,N,C,M,V,O,I
			
		

Respuesta de la API

			
		{"AAPL*": {
			"BMV": {
				"U": 4335.0,
				"P": 4344.0,
				"A": 4400.0,
				"X": 4408.0,
				"N": 4335.0,
				"C": -1.27,
				"M": -56.0,
				"V": 2875.0,
				"O": 140.0,
				"I": 12515870.54,
				"F": "2024-09-12 14:07:00"},
			"BIVA": {
				"U": 4335.0,
				"P": 4344.0,
				"A": 4417.35,
				"X": 4392.72,
				"N": 4335.0,
				"C": -1.86,
				"M": -82.35,
				"V": 1147.0,
				"O": 118.0,
				"I": 5006173.66,
				"F": "2024-09-12 14:04:00"}},
		"GOOG*": {
			"BMV": {
				"U": 3054.98,
				"P": 3030.39,
				"A": 3002.95,
				"X": 3054.99,
				"N": 3015.0,
				"C": 0.91,
				"M": 27.44,
				"V": 5381.0,
				"O": 115.0,
				"I": 16278901.6,
				"F": "2024-09-12 14:07:00"},
			"BIVA": {
				"U": 3040.0,
				"P": 0.0,
				"A": 3018.5,
				"X": 3048.0,
				"N": 3015.0,
				"C": 0.71,
				"M": 21.5,
				"V": 175.0,
				"O": 8826.0,
				"I": 531902.7,
				"F": "2024-09-12 09:00:00"}}}
			
			

{ Top }

GET https://api.databursatil.com/v1/top

Obtén cotizaciones por principales alzas, bajas, operaciones, importe operado o volumen, así como por mercado y bolsa.

Parámetros

Parámetro Exigibilidad Uso
token Requerido Método de autenticación
variables Requerido Especifica el tipo de filtro requerido. Opciones disponibles: "suben", "bajan", "importe", "volumen" y/u "operaciones"
bolsa Requerido Especifica el origen de las cotizaciones. Solo existen dos opciones disponibles: "BMV" o "BIVA"
cantidad Requerido Especifica la cantidad de emisoras solicitadas por filtro declarado
mercado Requerido Especifica el mercado de las cotizaciones. Solo existen dos opciones disponibles: "local" o "global"
Llave Estado Tipado Concepto
SUBEN Fijo Llave Contiene las emisoras filtradas por incremento porcentual
BAJAN Fijo Llave Contiene las emisoras filtradas por caída porcentual
VOLUMEN Fijo Llave Contiene las emisoras filtradas por mayor volumen operado
IMPORTE Fijo Llave Contiene las emisoras filtradas por mayor importe operado
OPERACIONES Fijo Llave Contiene las emisoras filtradas por mayor operaciones realizadas
[consecutivo] Fijo Llave Consecutivo
emisora_serie Fijo Decimal Clave de pizzarra de la emisora con serie
ultimo Fijo Decimal Último hecho de la emisora
volumen Fijo Decimal Acciones negociadas por la emisora

Catálogo de errores:

Generados por el usuario. Se solucionan atendiendo el mensaje del mismo error.

Código Mensaje
400 Error: Es necesario ingresar el parametro '&variables=' y al menos una de las 5 opciones disponibles para ejecutar la consulta: 'suben', 'bajan','volumen','importe' u 'operaciones'.
400 Error: Es necesario ingresar al menos una de las 5 opciones disponibles: 'suben', 'bajan','volumen','importe' u 'operaciones'.
400 Error: Es necesario ingresar el parámetro '&bolsa=' y solo una de las 2 bolsas disponibles para ejecutar la consulta: 'BMV' o 'BIVA'.
400 Error: Es necesario ingresar solo una de las 2 bolsas disponibles: 'BMV' o 'BIVA'.
400 Error: Es necesario ingresar el parámetro '&mercado=' y solo uno de los 2 mercados disponibles para ejecutar la consulta: 'local' o 'global'.
400 Error: Es necesario ingresar solo uno de los 2 mercados disponibles: 'local' o 'global'.
400 Error: Es necesario ingresar el parámetro '&cantidad=' y un número entero con un rango entre 1 y 50 para ejecutar la consulta.
400 Error: Solo son válidos números enteros con un rango del 1 hasta el 50.

Generados por procesamientos de datos. Se solucionan intentando con otro parámetro: fecha, emisora, serie, etc.

Código Mensaje
400 Error: Error al momento de ingresar parámetros.
400 Error: Error en la cantidad de emisora y series solicitadas.
400 Error: Error al momento de elegir parámetros.
400 Error: La solicitud no generó ningún resultado. Antes de la apertura del mercado, días feriados o fines de semana, este Endpoint no tiene información por mostrar.

Errores de autenticación: Disponibles consultando la referencia códigos de error

Temporalidad

Información con 20 minutos de retraso

Consumo de créditos

1 crédito por emisora-serie solicitada


Ejemplo 1

			
https://api.databursatil.com/v1/top?token=TU_TOKEN&variables=suben,bajan,importe,volumen,operaciones&bolsa=BMV&cantidad=2&mercado=local
			
		

Respuesta de la API

			
		  {"SUBEN": {
			  "0": {
			        "emisora_serie": LABB,
			        "ultimo": 15.7,
			        "cambio%": 5.18},
			  "1": {
			        "emisora_serie": SORIANAB,
			        "ultimo": 24.99,
			        "cambio%": 4.17}},
		  "BAJAN": {
			  "0": {
			        "emisora_serie": VALUEGFO,
			        "ultimo": 95.0,
			        "cambio%": -7.19},
			  "1": {
			        "emisora_serie": HOMEX*,
			        "ultimo": 0.03,
			        "cambio%": -7.14}},
		  "VOLUMEN": {
			  "0": {
			        "emisora_serie": AMXB,
			        "ultimo": 17.02,
			        "volumen": 75799421},
			  "1": {
			        "emisora_serie": CEMEXCPO,
			        "ultimo": 7.62,
			        "volumen": 28160928}},
		  "IMPORTE": {
			  "0": {
			        "emisora_serie": AMXB,
			        "ultimo": 17.02,
			        "importe": 1293506536.56},
			  "1": {
			        "emisora_serie": WALMEX*,
			        "ultimo": 72.95,
			        "importe": 870686951.55}},
		  "OPERACIONES": {
			  "0": {
			        "emisora_serie": GENTERA*,
			        "ultimo": 17.32,
			        "operaciones": 24104},
			  "1": {
			        "emisora_serie": WALMEX*,
			        "ultimo": 72.95,
			        "operaciones": 22862}}}
		  
		


Ejemplo 2

			
https://api.databursatil.com/v1/top?token=TU_TOKEN&variables=suben,bajan&bolsa=BMV&cantidad=2&mercado=local
			
		

Respuesta de la API

			
		  {"SUBEN": {
			  "0": {
			        "emisora_serie": LABB,
			        "ultimo": 15.7,
			        "cambio%": 5.18},
			  "1": {
			        "emisora_serie": SORIANAB,
			        "ultimo": 24.99,
			        "cambio%": 4.17}},
		  "BAJAN": {
			  "0": {
			        "emisora_serie": VALUEGFO,
			        "ultimo": 95.0,
			        "cambio%": -7.19},
			  "1": {
			        "emisora_serie": HOMEX*,
			        "ultimo": 0.03,
			        "cambio%": -7.14}}}
		  
		

{ Historicos }

GET https://api.databursatil.com/v1/historicos

Obtén precios históricos al cierre de la emisora y serie solicitada.

Parámetros

Parámetro Exigibilidad Uso
token Requerido Método de autenticación
inicio Requerido Fecha inicial del rango de precios solicitados en formato: AAA-MM-DD
final Requerido Fecha final del rango de precios solicitados en formato: AAA-MM-DD
emisora_serie Requerido Especifica la emisora con serie de la cual se solicitan las cotizaciones
Llave Valor Estado Tipado Concepto
fecha 0, 1 Fijo Fecha (Date) Fecha del día de referencia
0 precio Fijo Decimal Precio al cierre de la emisora el día de referencia
1 importe Fijo Decimal Importe operado de la emisora el día de referencia

Catálogo de errores:

Generados por el usuario. Se solucionan atendiendo el mensaje del mismo error.

Código Mensaje
400 Error: Es necesario ingresar el parámetro '&emisora_serie=' y una emisora con serie válida para ejecutar la consulta.
400 Error: Es necesario ingresar una emisora con serie válida.
400 Error: Es necesario ingresar el parámetro '&inicio=' y una fecha en formato: AAAA-MM-DD.
400 Error: Es necesario ingresar el parámetro '&final=' y una fecha en formato: AAAA-MM-DD.
400 Error: Formato de fecha no válido. El correcto es: AAAA-MM-DD.

Generados por procesamientos de datos. Se solucionan intentando con otro parámetro: fecha, emisora, serie, etc.

Código Mensaje
400 Error: La fecha inicial no puede ser mayor a la final.
400 Error: La búsqueda no arrojó ningún resultado. Recuerda que el formato de fecha correcto es: AAAA-MM-DD.
400 Error: Emisora y/o serie desconocida. También puedes consultar el Endpoint /emisoras para buscar emisoras y sus series.

Errores de autenticación: Disponibles consultando la referencia códigos de error

Temporalidad

Al cierre de las operaciones de cada día hábil

Consumo de créditos

1 crédito por día solicitado


Ejemplo

			
https://api.databursatil.com/v1/historicos?token=TU_TOKEN&inicio=2020-01-10&final=2020-01-15&emisora_serie=CEMEXCPO
			
		

Respuesta de la API

			
		  {"2020/01/10": [
			  7.18,
			  186727302.52],
		   "2020/01/13": [
			  7.15,
			  249928702.71],
		   "2020/01/14": [
			  7.12,
			  232931339.17],
		   "2020/01/15": [
			  6.95,
			  201492286.14]}
		  
		

{ Estados Financieros }

GET https://api.databursatil.com/v1/financieros

Estados financieros (Situacion financiera, Flujos de efectivo y Resultados) del periodo y emisora solicitada.

Llave Estado Tipado Concepto
posicion Variable Decimal Cuentas del Estado de Situacion Financiera
flujos Variable Decimal Cuentas del Estado de Flujo de Efectivo
resultado_trimestre Variable Decimal Cuentas del Estado de Resultados por trimestre
resultado_acumulado Variable Decimal Cuentas del Estado de Resultados por trimestre acumulado

Query

Para ejecutar la solicitud, son necesarios los siguientes parámetros:

Parámetro Exigibilidad Uso
token Requerido Método de autenticación
emisora Requerido Especifica la emisora (sin serie) de la cual se solicitan los estados financieros
periodo Requerido Especifica el periodo solicitado de los estados financieros. Por ejemplo: '1T_2020' (primer trimestre del 2020)
financieros Requerido Especifica la lista de estados financieros solicitados

Notas

Parámetro financieros=: Permite 4 opciones distintas "posicion", "flujos", "resultado_trimestre", y/o "resultado_acumulado". No requiere ejecutar las 4 opciones al mismo tiempo ni el órden de estos.
La API regresa la información de la fecha solicitada y el mismo periodo del año anterior.

Catálogo de errores:

Generados por el usuario. Se solucionan atendiendo el mensaje del mismo error.

Código Mensaje
400 Error: Es necesario ingresar el parámetro '&emisora=' y una emisora sin serie válida para ejecutar la consulta.
400 Error: Es necesario ingresar una emisora sin serie válida.
400 Error: Es necesario ingresar el parámetro '&periodo=' y un periodo válido para ejecutar la consulta. Por ejemplo: '1T_2020' (primer trimestre del 2020).
400 Error: Es necesario ingresar un periodo válido para ejecutar la consulta. Por ejemplo: '1T_2020' (primer trimestre del 2020).
400 Error: Es necesario ingresar el parámetro '&financieros=' y al menos una de las 4 opciones disponibles para ejecutar la consulta: 'posicion', 'flujos', 'resultado_trimestre' y/o 'resultado_acumulado'.
400 Error: Es necesario ingresar al menos una de las 4 opciones disponibles para ejecutar la consulta: 'posicion', 'flujos', 'resultado_trimestre' y/o 'resultado_acumulado'.

Generados por procesamientos de datos. Se solucionan intentando con otro parámetro: fecha, emisora, serie, etc.

Código Mensaje
400 Error: Error al momento de cargar la información.
400 Error: Emisora y/o serie desconocida. También puedes consultar el Endpoint /emisoras para buscar emisoras y sus series.

Errores de autenticación: Disponibles consultando la referencia códigos de error

Temporalidad

Información actualizada cada trimestre

Consumo de créditos

500 créditos por solicitud

Ejemplo

			
https://api.databursatil.com/v1/financieros?token=TU_TOKEN&emisora=AMX&periodo=2T_2021&financieros=posicion,resultado_trimestre
		
		

Respuesta de la API

			
		  {"posicion": {
			  "2021-06-30": {
			  "CashAndCashEquivalents": [
			  	"Efectivo y equivalentes de efectivo" ,
			  	39993054000],
			  "TradeAndOtherCurrentReceivables": [
			  	"Clientes y otras cuentas por cobrar" ,
			  	168668851000],
			  "CurrentTaxAssetsCurrent": [
			  	"Impuestos por recuperar" ,
			  	37138689000],
			  "OtherCurrentFinancialAssets": [
			  	"Otros activos financieros" ,
			  	72032254000],
			  "Inventories": [
			  	"Inventarios" ,
			  	31699417000],
			  "CurrentBiologicalAssets": [
			  	"Activos biológicos" ,
			  	0],
			  "OtherCurrentNonfinancialAssets": [
			  	"Otros activos no financieros" ,
			  	15386455000]}},
		  "resultado_trimestre": {
			  "2021-04-01_2021-06-30": {
			  "Revenue": [
			  	"Ingresos" ,
			  	252507320000],
			  "CostOfSales": [
			  	"Costo de ventas" ,
			  	156280043000],
			  "GrossProfit": [
			  	"Utilidad bruta" ,
			  	96227277000],
			  "DistributionCosts": [
			  	"Gastos de administración" ,
			  	15286812000],
			  "OtherIncome": [
			  	"Otros ingresos" ,
			  	0]}}}
		  
		

{ Descargas }

GET https://api.databursatil.com/v1/descargas

Valuaciones del mercado de dinero mexicano así como hechos al cierre del día.

Llave Estado Tipado Concepto
hechos Fijo Texto Hechos al cierre del día.
guber Fijo Texto Valuaciones diarias de mercado de dinero gubernamental.

Query

Para ejecutar la solicitud, son necesarios los siguientes parámetros:

Parámetro Exigibilidad Uso
token Requerido Método de autenticación
archivo Requerido Describe cuál documento se desea descargar. Solo hay dos opciones disponibles: "hechos" o "guber".
fecha Requerido Especifica la fecha del archivo que se desea descargar en formato YYYY-MM-DD.

Notas

Las fechas de los archivos solo están disponibles en días hábiles bancarios en México.

Catálogo de errores:

Generados por el usuario. Se solucionan atendiendo el mensaje del mismo error.

Código Mensaje
400 Error: Es necesario ingresar el parámetro '&fecha=' y una fecha en formato: AAAA-MM-DD.
400 Error: Formato de fecha no válido. El correcto es: AAAA-MM-DD.
400 Error: Es necesario ingresar el parámetro '&archivo=' y solo una de las 2 opciones disponibles para ejecutar la consulta: 'guber' o 'hechos'.

Generados por procesamientos de datos. Se solucionan intentando con otro parámetro: fecha, emisora, serie, etc.

Código Mensaje
400 Error: Error al momento de elegir el tipo de archivo.
400 Error: Error al momento de procesar el tipo de archivo. Solo hay dos opciones disponibles: 'guber' o 'hechos'.

Errores de autenticación: Disponibles consultando la referencia códigos de error

Temporalidad

Información actualizada cada día hábil después de las 17 h

Consumo de créditos

Para "guber": 500 créditos por solicitud.

Para "hechos": 10,000 créditos por solicitud.
¿Por qué? El peso promedio de cada 7 zip es de 3 MB lo cual nos genera más costos en ancho de banda que el resto de endpoints más ligeros.

Ejemplo 1

			
https://api.databursatil.com/v1/descargas?token=TU_TOKEN&archivo=hechos&fecha=2023-09-20
		
		

Respuesta de la API

El descargable es un 7 zip que contiene un CSV.

		hechos_ejemplo
		

Ejemplo 2

			
https://api.databursatil.com/v1/descargas?token=TU_TOKEN&archivo=guber&fecha=2023-09-20
		
		

Respuesta de la API

El descargable es un CSV.

		guber_ejemplo
		

{ Dividendos }

GET https://api.databursatil.com/v1/dividendos

Dividendo más reciente e histórico de pagos de la emisora y serie seleccionada.

Llave Estado Tipado Concepto
reciente Fijo Texto Contiene información del dividendo(s) más reciente o vigente
historico Fijo Texto Contiene el histórico de dividendos pagados realizados o efectuados
AAAA-MM-DD Fijo Fecha (Date) Fecha de pago del dividendo
pago Fijo Decimal Monto por acción decretado por la emisora a pagar o canjear
tipo Fijo Texto Define el tipo de dividendo a pagar o canjear
divisa Fijo Texto Divisa del importe por pagar o canjear
fechaexcupon Fijo Fecha (Date) Fecha ex-cupón

Query

Para ejecutar la solicitud, son necesarios los siguientes parámetros:

Parámetro Exigibilidad Uso
token Requerido Método de autenticación
emisora_serie Requerido Especifica la emisora con serie de la cual se solicitan los dividendos

Catálogo de errores:

Generados por el usuario. Se solucionan atendiendo el mensaje del mismo error.

Código Mensaje
400 Error: Es necesario ingresar el parámetro '&emisora_serie=' y una emisora con serie válida para ejecutar la consulta.
400 Error: Es necesario ingresar una emisora con serie válida.

Generados por procesamientos de datos. Se solucionan intentando con otro parámetro: fecha, emisora, serie, etc.

Código Mensaje
400 Error: No hay dividendos registrados para la emisora elegida.
400 Error: Emisora y/o serie desconocida. También puedes consultar el Endpoint /emisoras para buscar emisoras y sus series.

Errores de autenticación: Disponibles consultando la referencia códigos de error

Temporalidad

Al cierre de las operaciones de cada día hábil

Consumo de créditos

5 créditos por emisora solicitada

Ejemplo

			
https://api.databursatil.com/v1/dividendos?token=TU_TOKEN&emisora_serie=ALFAA
			
		

Respuesta de la API

			
		  {"reciente": {
			   "2022-03-16": {
					 "pago":0.04,	
					 "tipo":"DIVIDENDO EN EFECTIVO",
					 "divisa":"MXN",
					 "fechaexcupon":"2022-03-14"}
				 },
		  "historico": {
			   "2018-03-09": {
					 "pago":0.0332,	
					 "tipo":"DIVIDENDO EN EFECTIVO"},
			   "2019-03-11": {
					 "pago":0.02,	
					 "tipo":"DIVIDENDO EN EFECTIVO"},
			   "2019-09-12": {
					 "pago":0.02,	
					 "tipo":"DIVIDENDO EN EFECTIVO"},
			   "2020-03-09": {
					 "pago":0.02,	
					 "tipo":"DIVIDENDO EN EFECTIVO"},
			   "2021-01-05": {
					 "pago":0.0051,	
					 "tipo":"DIVIDENDO EN EFECTIVO"},
			   "2021-04-07": {
					 "pago":0.02,	
					 "tipo":"DIVIDENDO EN EFECTIVO"},
			   "2022-03-16": {
					 "pago":0.04,	
					 "tipo":"DIVIDENDO EN EFECTIVO"}
				 }
			}
		  
		

{ Índices }

GET https://api.databursatil.com/v1/indices

Último precio, anterior, máximo, mínimo, cambio porcentual, cambio en unidades y volumen de los principales índices bursátiles internacionales.

Llave Estado Tipado Concepto
(tipo) Fijo Texto Nombre corto del índice
nombre Fijo Texto (String) Nombre largo del índice
ultimo Fijo Decimal Último precio del índice
apertura Fijo Decimal Precio de apertura del índice
maximo Fijo Decimal Precio máximo en la sesión del índice
minimo Fijo Decimal Precio mínimo en la sesión del índice
cambio% Fijo Decimal Cambio porcentual con base en el precio de cierre anterior
cambio$ Fijo Decimal Cambio en puntos con base en el precio de cierre anterior
volumen Fijo Decimal Volumen en la sesión del índice
cambioytd% Fijo Decimal Cambio porcentual con base en el precio de cierre del año anterior
tiempo Fijo Texto (String) Fecha y hora de los datos en formato: YYYY-MM-DD hh:mm:ss

Query

Para ejecutar la solicitud, son necesarios los siguientes parámetros:

Parámetro Exigibilidad Uso
token Requerido Método de autenticación

Catálogo de errores:

Generados por procesamientos de datos. Se solucionan intentando con otro parámetro: fecha, emisora, serie, etc.

Código Mensaje
400 Error: Error al momento de obtener la información

Errores de autenticación: Disponibles consultando la referencia códigos de error

Temporalidad

Información con 20 minutos de retraso

Consumo de créditos

11 créditos por solicitud

Ejemplo

			
https://api.databursatil.com/v1/indices?token=TU_TOKEN
			
		

Respuesta de la API

			
		  {"IPC": {
			  "nombre": "Indice de Precios Y Cotizaciones",
			  "último": 47272.11,
			  "anterior": 47711.02,
			  "maximo": 47754.32,
			  "minimo": 46992.75,
			  "cambio%": -0.95,
			  "cambio$": -452.13,
			  "volumen": 87461423,
			  "cambioytd%": -11.2635,
			  "tiempo": "2022-08-26 15:00:00"},
		  "FTSEBIVA": {
			  "nombre": "Indice FTSE BIVA",
			  "último": 980.91,
			  "anterior": 991.34,
			  "maximo": 991.34,
			  "minimo": 974.69,
			  "cambio%": -1.05,
			  "cambio$": -10.43,
			  "volumen":  0,
			  "cambioytd%": -10.9284,
			  "tiempo": "2022-08-26 15:00:00"}}
		  
		

{ Tasas }

GET https://api.databursatil.com/v1/tasas

Tasas del mercado de dinero.

Llave Estado Tipado Concepto
tasa Fijo Decimal Tasa en procentaje
tiempo Fijo Texto Fecha y hora de los datos en formato: YYYY-MM-DD hh:mm:ss

Query

Para ejecutar la solicitud, son necesarios los siguientes parámetros:

Parámetro Exigibilidad Uso
token Requerido Método de autenticación

Catálogo de errores:

Generados por procesamientos de datos. Se solucionan intentando con otro parámetro: fecha, emisora, serie, etc.

Código Mensaje
400 Error: Error al momento de obtener la información

Errores de autenticación: Disponibles consultando la referencia códigos de error

Temporalidad

De forma diaria cada hora

Consumo de créditos

5 créditos por solicitud

Ejemplo

			
https://api.databursatil.com/v1/tasas?token=TU_TOKEN
			
		

Respuesta de la API

			
		  {"CETE 28": {
			  "tasa": 6.16},
		   "Tasa Objetivo": {
			  "tasa": 6.0},
		   "TIIE 28": {
			  "tasa": 6.2375},
		   "tiempo": "2021-12-16 3:10:00"}
		  
		

{ Divisas }

GET https://api.databursatil.com/v1/divisas

Último precio y cambio porcentual de los principales cruces de divisas.

Llave Estado Tipado Concepto
precio Fijo Decimal Precio al cierre de la emisora el día de referencia
cambio% Fijo Decimal Cambio porcentual del cierre anterior
cambio$ Fijo Decimal Cambio monetario del cierre anterior

Query

Para ejecutar la solicitud, son necesarios los siguientes parámetros:

Parámetro Exigibilidad Uso
token Requerido Método de autenticación

Catálogo de errores:

Generados por procesamientos de datos. Se solucionan intentando con otro parámetro: fecha, emisora, serie, etc.

Código Mensaje
400 Error: Error al momento de obtener la información

Errores de autenticación: Disponibles consultando la referencia códigos de error

Temporalidad

De forma diaria cada hora

Consumo de créditos

3 créditos por solicitud

Ejemplo

			
https://api.databursatil.com/v1/divisas?token=TU_TOKEN
			
		

Respuesta de la API

			
		  {"USDMXN": {
			  "precio": 20.9404,
			  "cambio%": 0.23,
			  "cambio$": 0.0484},
		   "EURMXN": {
			  "precio": 23.016,
			  "cambio%": -0.53,
			  "cambio$": -0.1219}}
		  
		

{ Commodities }

GET https://api.databursatil.com/v1/commodities

Último precio, cambio monetario, porcentual, porcentaje de cambio semanal, mensual y anual de los mercados internacionales de Metales, Industriales, Agricultura, Ganaderos, Energía, Electricidad e Índices.

Llave Estado Tipado Concepto
(tipo) Fijo Texto (String) Commodity de referencia
anual Fijo Decimal Variación porcentual anual
tiempo Fijo Texto (String) Fecha de la última actualización
unidad Fijo Texto (String) Unidad de medida del commodity
cambio$ Fijo Decimal Cambio monetario del cierre anterior
cambio% Fijo Decimal Cambio porcentual del cierre anterior
ultimo Fijo Decimal Último precio del commodity de referencia
mensual Fijo Decimal Variación porcentual mensual
semanal Fijo Decimal Variación porcentual semanal

Query

Para ejecutar la solicitud, son necesarios los siguientes parámetros:

Parámetro Exigibilidad Uso
token Requerido Método de autenticación

Catálogo de errores:

Generados por procesamientos de datos. Se solucionan intentando con otro parámetro: fecha, emisora, serie, etc.

Código Mensaje
400 Error: Error al momento de obtener la información

Errores de autenticación: Disponibles consultando la referencia códigos de error

Temporalidad

De forma diaria cada 10 minutos

Consumo de créditos

10 créditos por solicitud

Ejemplo

			
https://api.databursatil.com/v1/commodities?token=TU_TOKEN
			
		

Respuesta de la API

			
		  {"metales": {
		  	"Oro": {
				  "anual": 30.23,
				  "tiempo": "2024/09/09",
				  "ultimo": 2502.52,
				  "unidad": "USD por Onza Troy",
				  "cambio$": 15.51,
				  "cambio%": 0.62,
				  "mensual": 1.09,
				  "semanal": 0.21},
		  	"Acero": {
				"anual": -20.52,
				"tiempo": "2024/09/09",
				"ultimo": 2940,
				"unidad": "CNY por Tonelada",
				"cambio$": 15.51,
				"cambio%": 0.62,
				"mensual": 1.09,
				"semanal": 0.21},
		  	"Cobre": {
				"anual": 7.98,
				"tiempo": "2024/09/09",
				"ultimo": 4.0829,
				"unidad": "USD por Libra",
				"cambio$": 0.0774,
				"cambio%": 1.93,
				"mensual": 0.35,
				"semanal": 2.25},
		  	"Litio": {
				"anual": -63.84,
				"tiempo": "2024/09/09",
				"ultimo": 72500,
				"unidad": "CNY por Tonelada",
				"cambio$": 1500,
				"cambio%": -2.03,
				"mensual": -8.81,
				"semanal": -3.33},
		  	"Plata": {
				"anual": 22.77,
				"tiempo": "2024/09/09",
				"ultimo": 28.324,
				"unidad": "USD por Onza Troy",
				"cambio$": 0.395,
				"cambio%": 1.41,
				"mensual": 1.12,
				"semanal": -0.69}}}
		  
	  

{ Noticias }

GET https://api.databursatil.com/v1/noticias

Principales titulares de negocios y economía.

Llave Estado Tipado Concepto
Número consecutivo Fijo Decimal Número consecutivo de la noticia
titular Fijo Texto Titular de la noticia
contenido Fijo Texto Contenido de la noticia
fuente Fijo Texto Fuente de la noticia

Query

Para ejecutar la solicitud, son necesarios los siguientes parámetros:

Parámetro Exigibilidad Uso
token Requerido Método de autenticación

Catálogo de errores:

Generados por procesamientos de datos. Se solucionan intentando con otro parámetro: fecha, emisora, serie, etc.

Código Mensaje
400 Error: Error al momento de obtener la información

Errores de autenticación: Disponibles consultando la referencia códigos de error

Temporalidad

De forma diaria cada hora

Consumo de créditos

50 créditos por solicitud

Ejemplo

			
https://api.databursatil.com/v1/noticias?token=TU_TOKEN
			
		

Respuesta de la API

			
		  {"0": {
		      "titular":"Inflación EUA escala a 7.9% anual en febrero --mayor en 40 años-- por presiones gasolinas",
		      "contenido":"La inflación en Estados Unidos alcanzó niveles no vistos en 40 años...",
		      "fuente":"https://www.sentidocomun.com.mx/articulo.phtml?id=105912"},
		   "1": {
		      "titular":"BCE perfila adelantar fin de compras de activos pese a incertidumbre por guerra",
		      "contenido":"El Consejo de Gobierno del Banco Central Europeo sorprendió a los analistas...",
		      "fuente":"https://www.sentidocomun.com.mx/articulo.phtml?id=105910"},
		   "2": {
		      "titular":"Putin pensó que Ucrania caería rápido. Batalla en un aeropuerto probó lo contrario",
		      "contenido":"El fuego de las ametralladoras atravesó a Anatoliy Kharchenko...",
		      "fuente":"https://www.sentidocomun.com.mx/articulo.phtml?id=105925"},
		   "3": {
		      "titular":"Inflación tiene su peor febrero en 20 años, sube presión hawkish para Banco de México",
		      "contenido":"La inflación en México frenó en febrero varios meses de desaceleración...",
		      "fuente":"https://www.sentidocomun.com.mx/articulo.phtml?id=105867"}}
		  
		

{ Cables }

GET https://api.databursatil.com/v1/cables

Cables noticiosos de emisoras mexicanas y noticias recientes de economía y negocios en general.

Llave Estado Tipado Concepto
ID de categoría Variable Texto Contiene la categoría que se haya solicitado
Consecutivo Fijo Texto Consecutivo de la noticia dentro de la categoría solicitada
fuente Fijo Texto Fuente de la noticia
titular Fijo Texto Contenido de la noticia

Query

Para ejecutar la solicitud, son necesarios los siguientes parámetros:

Parámetro Exigibilidad Uso
token Requerido Método de autenticación
categorias Opcional Permite filtrar por categorias. Opciones disponibles: "boletines", "top", "valuaciones", "flash", y/o "generales".

Catálogo de errores:

Generados por procesamientos de datos. Se solucionan intentando con otro parámetro: fecha, emisora, serie, etc.

Código Mensaje
400 Error: Es necesario ingresar al menos una de las 5 opciones disponibles: 'boletines', 'top', 'valuaciones', 'flash', 'generales'
400 Error: Error al momento de obtener la información

Errores de autenticación: Disponibles consultando la referencia códigos de error

Temporalidad

De forma diaria cada hora

Consumo de créditos

20 créditos por solicitud

Ejemplo

			
https://api.databursatil.com/v1/cables?token=TU_TOKEN
			
		

Respuesta de la API

			
		{"BOLETINES": {
 			  "0": {
			      "fuente":"https://finanzasenlinea.infosel.com/multiva1/MultNotaAbierta.asp?id=577780",
			      "titular":"15:43 (HOTEL) BOLETIN DE PRENSA"},
			   "1": {
			      "fuente":"https://finanzasenlinea.infosel.com/multiva1/MultNotaAbierta.asp?id=577515",
			      "titular":"08:41 (GSANBOR) BOLETIN DE PRENSA},
			   "2": {
			      "fuente":"https://finanzasenlinea.infosel.com/multiva1/MultNotaAbierta.asp?id=577417",
			      "titular":"07:01 (MINSA) BOLETIN DE PRENSA},
			   "3": {
			      "fuente":"https://finanzasenlinea.infosel.com/multiva1/MultNotaAbierta.asp?id=577418,
			      "titular":"07:01 (UNIFIN) BOLETIN DE PRENSA}}}
		  
		

{ Créditos }

GET https://api.databursatil.com/v1/creditos

Créditos disponibles del token ingresado.

Llave Estado Tipado Concepto
disponibles Fijo String Créditos disponibles al momento de la consulta

Query

Para ejecutar la solicitud, son necesarios los siguientes parámetros:

Parámetro Exigibilidad Uso
token Requerido Método de autenticación

Temporalidad

Tiempo real

Consumo de créditos

1 por solicitud

Ejemplo

			
https://api.databursatil.com/v1/creditos?token=TU_TOKEN
			
		

Respuesta de la API

			
		  {"Disponibles": 75}
		  
		

{Guías}


Conoce algunas guías de usuario que tenemos disponibles.

{Descarga desde Excel}

Excel tiene un apartado que permite descargar información personalizada desde internet para manipularla directo en la hoja de cálculo. Ya no más "copy" y "paste".

Descarga y Parsing

1.- Abre un nuevo libro en Excel.

Paso 0

2.- Dirígete a la pestaña de "Datos", da clic en "Nueva Consulta", luego en "Desde otras fuentes" y selecciona "Desde una web":

Paso 1

3.- Deberás ingresar los datos completos de la URL que deseas descargar en la hoja de cálculo. Para este ejemplo veremos la descarga de precios históricos, pero para el resto de los Endpoints disponibles el proceso es muy similar. Se puede ingresar la URL en modo "básico" pero, recomendamos el modo avanzado, ya que te permite ingresarla por partes:

Paso 2

4.- Se abrirá una ventana nueva. Selecciona la pestaña de "Convertir" y después "En tabla":

Paso 3

5.- Los precios e importes se encuentran dentro de una lista por cada día, por lo que tendremos que convertirlos para que nos muestre el precio e importe por separado. Para esto, seleccionamos la columna de valores, damos clic en "Extraer valores", desplegamos el combo y seleccionamos por "Coma":

Paso 4

6.- Clic izquierdo en la columna de valores y seleccionar "Duplicar columna":

Paso 5

7.- Seleccionamos la primera columna de valores, después seleccionamos la pestaña de "Transformar", seleccionamos "Extraer", posteriormente "Texto antes del delimitador" y colocamos una coma (,) dentro del campo de texto:

Paso 6

8.- Repetimos el proceso con la segunda columna de valores, pero ahora seleccionamos "Texto después del delimitador":

Paso 7

9.- Ahora seleccionamos la columna de fechas, seleccionamos "Fecha" y damos clic en "Parsing". Convertirá las fechas en un formato reconocido por Excel:

Paso 8

10.- Finalmente, seleccionamos la pestaña de "Inicio" y luego en "Cerrar y guardar":

Paso 9

11.- Ahora ya tenemos la información convertida en una hoja de Excel para su análisis o manipulación. Excel permite modificar la URL, así que puedes cambiar los rangos de fechas y no repetir todos los pasos antes realizados.

Paso 10

12.- Para actualizar la información descargada, en caso de que utilices Endpoints en tiempo real o diferido, selecciona la pestaña "Datos" y luego en "Actualizar todo":

Paso 11

13.- Si deseas automatizar la actualización cada cierto tiempo, por ejemplo, cada 5 minutos, puedes usar el siguiente código en VBA:

			
		  Sub SaveWb()
		  	ThisWorkbook.RefreshAll
		  	ThisWorkbook.Save
		  	Application.OnTime Now + TimeValue("00:05:00"), "SaveWb"
		  End Sub