{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	Información general de la(s) emisora(s) solicitada(s).
/precios	Último precio, precio promedio ponderado, cambio porcentual y monetario de la emisora, serie y bolsa especificada.
/intradia	Último precio, precio promedio ponderado, anterior, máximo, mínimo, cambio porcentual y monetario de la emisora, serie y bolsa especificada.
/intradia-plus	Último precio, precio promedio ponderado, anterior, máximo, mínimo, volumen, operaciones, importe, cambio porcentual y monetario de la emisora, serie y bolsa especificada.
/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.
/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.
/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
/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:

• https://status.databursatil.com

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), sin embargo, nuevas versiones serán añadidas en un futuro, por lo que 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:

• Versión alfa: (obsoleta) https://api.databursatil.com/alfa/
• Versión beta: (obsoleta) https://api.databursatil.com/beta/
• Versión v1: (actual) https://api.databursatil.com/v1/

{Método de autentificació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"

{Endpoints}

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

{Emisoras}

Contenido

Permite buscar, filtrar y obtener información general de las emisoras solicitadas y sus respectivas series.

Llave	Estado	Variable	Concepto
(tipo)	Fijo	Integer (Número entero)	Contiene una emisora y su(s) serie(s)
Emisora	Fijo	Texto (String)	Clave de pizzarra de la emisora
(tipo)	Fijo	Integer (Número entero)	Contiene una serie de la emisora selecionada
Serie	Fijo	Texto (String)	Serie(es) de la emisora
Razon Social	Fijo	Texto (String)	Razón social de la emisora
ISIN	Fijo	Texto (String)	ISIN de la emisora
Bolsa	Fijo	Texto (String)	Bolsa de origen de la emisora
Tipo Valor Descripcion	Fijo	Texto (String)	Descripción larga del tipo valor
Tipo Valor ID	Fijo	Texto (String)	ID del tipo valor
Estatus	Fijo	Texto (String)	Situación de la emisora
Acciones en Circulacion	Fijo	Integer (Número entero)	Número de acciónes en circulación
Rango Historicos	Fijo	Texto (String)	Rango de historicos disponibles
Rango Financieros	Fijo	Texto (String)	Fechas de financieros disponibles

Query

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

Parámetro	Exigibilidad	Formato	Uso
token	Requerido	token=	Método de autenticación
letra	Opcional	letra=	Permite filtrar por la letra o palabra ingresada
mercado	Opcional	mercado=	Solo existen dos opciones disponibles: "local" o "global"

Notas

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

Parámetro: letra=: No se debe ingresar emisora con serie, solo emisora. De lo contrario, la API arrojará un error de "Emisora desconocida".

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 semanal (emisoras nuevas y/o modificaciones)

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}

Contenido

Último precio, precio promedio ponderado, cambio porcentual y monetario de la emisora, serie y bolsa solicitada.

Llave	Estado	Variable	Concepto
bolsa	Fijo	Decimal (Float)	Origen de los datos mostrados
ultimo	Fijo	Decimal (Float)	Último hecho de la emisora
ppp	Fijo	Decimal (Float)	Precio Promedio ponderado
cambio%	Fijo	Decimal (Float)	Cambio porcentual con base en el precio de apertura
cambio$	Fijo	Decimal (Float)	Cambio monetario con base en el precio de apertura
tiempo	Fijo	Texto (String)	Fecha y hora de la información en formato: YYYY-MM-DD hh:mm:ss

Query

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

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

Notas

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

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}

Contenido

Último precio, precio promedio ponderado, anterior, máximo, mínimo, cambio porcentual y monetario de la emisora, serie y bolsa solicitada.

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

Query

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

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

Notas

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

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}

Contenido

Último precio, precio promedio ponderado, anterior, máximo, mínimo, volumen, operaciones, importe, cambio porcentual y monetario de la emisora, serie y bolsa solicitada.

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

Query

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

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

Notas

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

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"}}
		  
		

{Top}

Contenido

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

Llave	Estado	Variable	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
[tipo]	Fijo	Llave	Contiene información de la emisora en turno
emisora_serie	Fijo	Decimal (Float)	Clave de pizzarra de la emisora con serie
ultimo	Fijo	Decimal (Float)	Último hecho de la emisora
volumen	Fijo	Decimal (Float)	Acciones negociadas por la emisora

Query

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

Parámetro	Exigibilidad	Formato	Uso
token	Requerido	token=	Método de autenticación
variables	Requerido	variables=	Especifica el tipo de filtro requerido. Opciones disponibles: "suben", "bajan", "importe", "volumen" y/u "operaciones"
bolsa	Requerido	bolsa=	Especifica el origen de las cotizaciones. Solo existen dos opciones disponibles: "BMV" o "BIVA"
cantidad	Requerido	cantidad=	Especifica la cantidad de emisoras solicitadas por filtro declarado
mercado	Requerido	mercado=	Especifica el mercado de las cotizaciones. Solo existen dos opciones disponibles: "local" o "global"

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}

Contenido

Precios históricos al cierre de la emisora y serie solicitada.

Llave	Valor	Estado	Variable	Concepto
fecha	0, 1	Fijo	Fecha (Date)	Fecha del día de referencia
0	precio	Fijo	Decimal (Float)	Precio al cierre de la emisora el día de referencia
1	importe	Fijo	Decimal (Float)	Importe operado de la emisora el día de referencia

Query

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

Parámetro	Exigibilidad	Formato	Uso
token	Requerido	token=	Método de autenticación
inicio	Requerido	inicio=	Fecha inicial del rango de precios solicitados en formato: AAA-MM-DD
final	Requerido	final=	Fecha final del rango de precios solicitados en formato: AAA-MM-DD
emisora_serie	Requerido	emisora_serie=	Especifica la emisora con serie de la cual se solicitan las cotizaciones

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}

Contenido

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

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

Query

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

Parámetro	Exigibilidad	Formato	Uso
token	Requerido	token=	Método de autenticación
emisora	Requerido	emisora=	Especifica la emisora (sin serie) de la cual se solicitan los estados financieros
periodo	Requerido	periodo=	Especifica el periodo solicitado de los estados financieros. Por ejemplo: '1T_2020' (primer trimestre del 2020)
financieros	Requerido	financieros=	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}

Contenido

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

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

Query

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

Parámetro	Exigibilidad	Formato	Uso
token	Requerido	token=	Método de autenticación
archivo	Requerido	archivo=	Describe cuál documento se desea descargar. Solo hay dos opciones disponibles: "hechos" o "guber".
fecha	Requerido	fecha=	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.

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.

{Dividendos}

Contenido

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

Llave	Estado	Variable	Concepto
reciente	Fijo	Texto (String)	Contiene información del dividendo(s) más reciente o vigente
historico	Fijo	Texto (String)	Contiene el histórico de dividendos pagados realizados o efectuados
AAAA-MM-DD	Fijo	Fecha (Date)	Fecha de pago del dividendo
pago	Fijo	Decimal (Float)	Monto por acción decretado por la emisora a pagar o canjear
tipo	Fijo	Texto (String)	Define el tipo de dividendo a pagar o canjear
divisa	Fijo	Texto (String)	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	Formato	Uso
token	Requerido	token=	Método de autenticación
emisora_serie	Requerido	emisora_serie=	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}

Contenido

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

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

Query

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

Parámetro	Exigibilidad	Formato	Uso
token	Requerido	token=	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}

Contenido

Tasas del mercado de dinero.

Llave	Estado	Variable	Concepto
tasa	Fijo	Decimal (Float)	Tasa en procentaje
tiempo	Fijo	Texto (String)	Fecha y hora de la información en formato: YYYY-MM-DD hh:mm:ss

Query

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

Parámetro	Exigibilidad	Formato	Uso
token	Requerido	token=	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}

Contenido

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

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

Query

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

Parámetro	Exigibilidad	Formato	Uso
token	Requerido	token=	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 } (Materias Primas)

Contenido

Último precio, cambio monetario y porcentual de los principales commodities de hidrocarburos.

Llave	Estado	Variable	Concepto
(tipo)	Fijo	Texto (String)	Commodity de referencia
ultimo	Fijo	Decimal (Float)	Último precio del commodity de referencia
cambio$	Fijo	Decimal (Float)	Cambio monetario del cierre anterior
cambio%	Fijo	Decimal (Float)	Cambio porcentual del cierre anterior

Query

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

Parámetro	Exigibilidad	Formato	Uso
token	Requerido	token=	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

10 créditos por solicitud

Ejemplo

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

Respuesta de la API

			
		  {"hidrocarburos": {
		  	"Gasoline": {
				  "ultimo": 3.465,
				  "cambio%": 0.036,
				  "cambio$": 1.04},
		  	"WTI Crude": {
				  "ultimo": 96.69,
				  "cambio%": 0.27,
				  "cambio$": 0.28},
		  	"Brent Crude": {
				  "ultimo": 107.04,
				  "cambio%": -0.1,
				  "cambio$": -0.09},
		  	"Natural Gas": {
				  "ultimo": 8.124,
				  "cambio%": -0.01,
				  "cambio$": -0.12},
		  	"Opec Basket": {
				  "ultimo": 108.11,
				  "cambio%": -1.24,
				  "cambio$": -1.13},
		  	"Mexican Basket": {
				  "ultimo": 95.55,
				  "cambio%": 1.94,
				  "cambio$": 2.07}}}
		  
	  

{Noticias}

Contenido

Principales titulares de negocios y economía.

Llave	Estado	Variable	Concepto
Número consecutivo	Fijo	Decimal (Float)	Número consecutivo de la noticia
titular	Fijo	Texto (String)	Titular de la noticia
contenido	Fijo	Texto (String)	Contenido de la noticia
fuente	Fijo	Texto (String)	Fuente de la noticia

Query

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

Parámetro	Exigibilidad	Formato	Uso
token	Requerido	token=	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}

Contenido

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

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

Query

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

Parámetro	Exigibilidad	Formato	Uso
token	Requerido	token=	Método de autenticación
categorias	Opcional	categorias=	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 disponibles}

Contenido

Créditos disponibles del token ingresado.

Llave	Estado	Variable	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	Formato	Uso
token	Requerido	token=	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.

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

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:

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

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":

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

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:

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

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

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

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.

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":

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