{ Documentación de la API }
Aprende a utilizar nuestra plataforma para acceder a la información del mercado bursátil Mexicano.
{ 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 API 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:
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:
Version 2
| Endpoint | Contenido que devuelve la API |
|---|---|
| /v2/emisoras | Información general de las emisoras solicitadas y sus respectivas series. |
| /v2/intradia | Precios diarios durante la jornada bursátil de la emisora-serie(s) solicitadas. |
| /v2/cotizaciones | Precios más recientes de la emisora-serie(s) solicitadas. |
| /v2/top | Principales emisoras-series por alzas, bajas, operaciones, volumen y/o importe operado. |
| /v2/historicos | Precios históricos al cierre del cada día de la emisora y serie especificada. |
| /v2/financieros | Estados financieros (Situación financiera, Flujos de efectivo y Resultados) de la emisora y periodo especificados. |
| /v2/indices | Precios más recientes de los principales índices bursátiles internacionales. |
| /v2/tasas | Tasas de mercado de dinero en México. |
| /v2/divisas | Precios más recientes de los principales cruces de divisas. |
| /v2/commodities | Precios más recientes de las principales commodities. |
| /v2/noticias | Principales noticias del día con énfasis en negocios y mercados financieros. |
| /v2/cables | Cables noticiosos de emisoras mexicanas y noticias recientes de economía y negocios en general. |
| /v2/descargas | Hechos al cierre del día o valuaciónes de instrumentos del Mercado de Dinero en México. |
| /v2/hechos | Hechos filtrados por el día y la emisoras-series(s) solicitadas. |
| /v2/creditos | Créditos disponibles del token especificado. |
Todas las solicitudes empiezan con la URL: https://api.databursatil.com agregando la versión solicitada /v2/
Cualquier solicitud por HTTP será redireccionada a HTTPS. El uso del www antes de api.databursatil.com 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/v2/cotizaciones?token=TU_TOKEN&concepto=U,P,A,X,N,C,M,V,O,I&emisora_serie=GFNORTEO&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/v2/cotizaciones?token=TU_TOKEN&concepto=U,P,A,X,N,C,M,V,O,I&emisora_serie=GFNORTEO&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:
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 |
|---|---|---|
| /v2/emisoras | SI | SI |
| /v2/intradia | SI | SI |
| /v2/cotizaciones | SI | SI |
| /v2/top | SI | SI |
| /v2/historicos | SI | SI |
| /v2/financieros | SI | NO |
| /v2/indices | SI | SI |
| /v2/descargas | SI | SI |
| /v2/hechos | SI | SI |
| /v1/emisoras | SI | SI |
| /v1/precios | SI | SI |
| /v1/intradia | SI | SI |
| /v1/intradia-plus | SI | SI |
| /v1/cotizaciones | SI | SI |
| /v1/top | SI | SI |
| /v1/historicos | SI | SI |
| /v1/financieros | SI | NO |
| /v1/dividendos | SI | NO |
| /v1/indices | SI | SI |
Mercado de Dinero
Se incluyen las tasas diarias publicadas por Banxico.
Mercado de Divisas
La API permite el acceso a los principales cruces de divisas contra el Peso Mexicano y otras divisas internacionales.
Materias Primas
Se muestra la cotización diaria de las 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 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 2 (V2).
La versión está definida en la ruta de cada URL:
- Versión v2: (actual)
https://api.databursatil.com/v2/ - Versión v1: (obsoleta)
https://api.databursatil.com/v1/ - Versión beta: (obsoleta)
https://api.databursatil.com/beta/ - Versión alfa: (obsoleta)
https://api.databursatil.com/alfa/
{ 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. 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.
Cada usuario tiene asignados 200,000 créditos mensuales para realizar consultas a la API. Sin importar el endpoint cada solicitud exitosa a la API consume por cada KiB (1024 bytes) de datos transmitidos, solo 1 crédito. Así de simple.
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.
{ Version 2 }
15 puntos de acceso están disponibles para tu consulta dentro de la API
{ Emisoras V2 }
GET https://api.databursatil.com/v2/emisoras
Información general de las emisoras filtradas y sus respectivas series.
Parámetros de la solicitud:
| Parámetro | Exigibilidad | Descripción |
|---|---|---|
| token | Requerido | Método de autenticación |
| letra | Opcional | Filtra las emisoras por la letra o palabra completa ingresada |
| mercado | Opcional | Permite segmentar la búsqueda solo a un tipo de mercado. Opciones disponibles: "local" y/o "global". Pueden ser agregadas ambas siendo separadas por coma. "local" se refiere a las emisoras del mercado nacional, "global" se refiere a todas las emisoras del mercado global (antes llamado SIC). |
Respuesta de la API:
| Llave | Tipado | Descripción |
|---|---|---|
| [Emisora] | Texto | Clave de pizzarra (ticker) de la emisora |
| [Serie] | Texto | Serie de la emisora |
| razon_social | Texto | Razón social de la emisora |
| isin | Texto | ISIN de la emisora y serie |
| bolsa | Texto | Bolsa origen de los precios |
| tipo_valor_descripcion | Texto | Descripción larga del tipo valor |
| tipo_valor_id | Texto | ID del tipo valor |
| estatus | Texto | Situación de la emisora |
| acciones_en_circulacion | Número entero | Número de acciones en circulación |
| rango_historicos | Texto | Rango de fechas de precios historicos disponibles |
| rango_financieros | Texto | Fechas de estados financieros disponibles |
| dividendos | JSON | Detalle de dividendos pagados y próximo |
| reciente | Texto | Contiene información del dividendo(s) más reciente o vigente |
| historico | Texto | Contiene el histórico de dividendos pagados realizados o efectuados |
| AAAA-MM-DD | Fecha | Fecha de pago del dividendo |
| pago | Decimal | Monto de pago o canje por acción decretado por la emisora. |
| tipo | Texto | Define el tipo de dividendo a pagar o canjear |
| divisa | Texto | Divisa del importe por pagar o canjear |
| fechaexcupon | Fecha | Fecha ex-cupón |
Ejemplo:
https://api.databursatil.com/v2/emisoras?token=TU_TOKEN&letra=H&mercado=local
Respuesta del ejemplo:
Otros ejemplos:
https://api.databursatil.com/v2/emisoras?token=TU_TOKEN&mercado=local&letra=AC
https://api.databursatil.com/v2/emisoras?token=TU_TOKEN&mercado=global
https://api.databursatil.com/v2/emisoras?token=TU_TOKEN&letra=NFLX
https://api.databursatil.com/v2/emisoras?token=TU_TOKEN&mercado=local
https://api.databursatil.com/v2/emisoras?token=TU_TOKEN
{ Intradia V2 }
GET https://api.databursatil.com/v2/intradia
Historico de cotizaciones durante la jornada bursatil.
Parámetros de la solicitud:
| Parámetro | Exigibilidad | Descripción |
|---|---|---|
| token | Requerido | Método de autenticación |
| emisora_serie | Requerido | Emisora con serie de la cual se solicitan las cotizaciones. Se pueden agregar separando por comas hasta 10 emisoras con serie. |
| bolsa | Requerido | Origen de las cotizaciones. Solo existen dos opciones disponibles: "BMV" y/o "BIVA". |
| intervalo | Requerido | Frecuencia de las cotizaciones. Opciones disponibles: 1m (1 minuto), 5m (5 minutos) o 1h (1 hora). |
| inicio | Requerido | Fecha inicial de las cotizaciones en formato AAAA-MM-DD |
| final | Requerido | Fecha final de las cotizaciones en formato AAAA-MM-DD |
Respuesta de la API:
| Llave | Tipado | Descripción |
|---|---|---|
| [Emisora con Serie] | Texto | Clave de pizzarra (ticker) de la emisora |
| AAAA-MM-DD hh:mm:ss | Decimal | Cotización de la fecha específica |
Ejemplo:
https://api.databursatil.com/v2/intradia?token=TU_TOKEN&emisora_serie=ALSEA*,GFNORTEO&bolsa=BMV&intervalo=1h&inicio=2025-05-09&final=2025-05-09
Respuesta del ejemplo:
Otros ejemplos:
https://api.databursatil.com/v2/intradia?token=TU_TOKEN&emisora_serie=WALMEX*,AMXB,GMEXICOB,GFNORTEO,FEMSAUBD,AC*,GFINBURO,GCARSOA1,GAPB,ASURB,BIMBOA&bolsa=BMV&intervalo=1h&inicio=2025-05-09&final=2025-05-09
https://api.databursatil.com/v2/intradia?token=TU_TOKEN&emisora_serie=ALSEA*,ALFAA&bolsa=BMV&intervalo=1m&inicio=2025-05-28&final=2025-05-28
https://api.databursatil.com/v2/intradia?token=TU_TOKEN&emisora_serie=ALSEA*,CEMEXCPO&bolsa=BIVA&intervalo=5m&inicio=2025-05-09&final=2025-05-09
https://api.databursatil.com/v2/intradia?token=TU_TOKEN&emisora_serie=ALSEA*,CEMEXCPO&bolsa=BIVA&intervalo=1m&inicio=2025-05-09&final=2025-05-09
https://api.databursatil.com/v2/intradia?token=TU_TOKEN&emisora_serie=ALSEA*&bolsa=BMV&intervalo=1h&inicio=2024-12-19&final=2024-12-20
{ Cotizaciones V2 }
GET https://api.databursatil.com/v2/cotizaciones
Precios más recientes de la emisora y series solicitadas
Parámetros de la solicitud:
| Parámetro | Exigibilidad | Descripción |
|---|---|---|
| token | Requerido | Método de autenticación |
| emisora_serie | Requerido | Emisora con serie de la cual se solicitan las cotizaciones. Se pueden agregar separando por comas hasta 50 emisoras con serie. |
| concepto | Requerido | Se debe elegir al menos uno de los siguientes conceptos de precios (u,p,a,x,n,c,m,v,o,i): u=ultimo, p=ppp, a=anterior, x=maximo, n=minimo, c=cambioporciento, m=cambiopesos, v=volumenoperado, o=operaciones, i=importeacumulado |
| bolsa | Requerido | Origen de las cotizaciones. Opciones disponibles: "BMV" y/o "BIVA" |
Respuesta de la API:
| Llave | Tipado | Descripción |
|---|---|---|
| [Emisora con Serie] | Texto | Clave de pizzarra (ticker) de la emisora |
| bolsa | Texto | Cotizaciones de la bolsa elegida |
| u | Decimal | Último precio |
| p | Decimal | Precio Promedio Ponderado |
| a | Decimal | Precio anterior |
| x | Decimal | Precio máximo |
| n | Decimal | Precio Mínimo |
| c | Decimal | Cambio por ciento |
| m | Decimal | Cambio monetario |
| v | Decimal | Volumen operado |
| o | Decimal | Número de operaciones |
| i | Decimal | Importe acumulado |
| f | Texto | Fecha de los precios |
Ejemplo:
https://api.databursatil.com/v2/intradia?token=TU_TOKEN&emisora_serie=AC*,ALFAA&concepto=u,p,a,x,n,c,m,v,o,i&bolsa=bmv,biva
Respuesta del ejemplo:
Otro ejemplo:
https://api.databursatil.com/v2/cotizaciones?token=TU_TOKEN&concepto=O&emisora_serie=AC*,ALFAA,ALSEA*,AMXB,ASURB,BBAJIOO,BIMBOA,BOLSAA,CEMEXCPO,CHDRAUIB,CUERVO*,FEMSAUBD,GAPB,GCC*,GENTERA*,GFINBURO,GFNORTEO,GMEXICOB,GRUMAB,KIMBERA,KOFUBL,LABB,LACOMERUBC,LIVEPOLC-1,MEGACPO,OMAB,ORBIA*,PENOLES*,PINFRA*,TLEVISACPO,VESTA*,WALMEX*&bolsa=BMV,BIVA
https://api.databursatil.com/v2/cotizaciones?token=TU_TOKEN&concepto=P&emisora_serie=GFNORTEO&bolsa=BMV,BIVA
https://api.databursatil.com/v2/cotizaciones?token=TU_TOKEN&concepto=O&emisora_serie=GFNORTEO&bolsa=BIVA
https://api.databursatil.com/v2/cotizaciones?token=TU_TOKEN&concepto=U,P,A,X,N,C,M,V,O,I&emisora_serie=AC*,GAPB&bolsa=BMV
{ Top V2 }
GET https://api.databursatil.com/v2/top
Obtén cotizaciones por principales alzas, bajas, operaciones, importe operado o volumen, así como por mercado y bolsa.
Parámetros de la solicitud:
| Parámetro | Exigibilidad | Descripción |
|---|---|---|
| token | Requerido | Método de autenticación |
| variables | Requerido | Especifica el tipo de ranking requerido. Opciones disponibles: "suben", "bajan", "importe", "volumen" y/u "operaciones". Se puede elegir más de uno separando por coma. |
| bolsa | Requerido | Especifica el origen de las cotizaciones. Solo existen dos opciones disponibles: "BMV" o "BIVA". Solo ingresar una. |
| cantidad | Requerido | Especifica la cantidad de emisoras solicitadas por filtro declarado. Minimo de 1 y máximo de 50. |
| mercado | Requerido | Especifica el mercado de las cotizaciones. Solo existen dos opciones disponibles: "local" o "global". Solo ingresar una. |
| inicio | Requerido | Fecha inicial de las cotizaciones en formato AAAA-MM-DD |
| final | Requerido | Fecha final de las cotizaciones en formato AAAA-MM-DD |
Respuesta de la API:
| Llave | Tipado | Descripción |
|---|---|---|
| suben | Llave | Contiene las emisoras filtradas por incremento porcentual |
| bajan | Llave | Contiene las emisoras filtradas por caída porcentual |
| volumen | Llave | Contiene las emisoras filtradas por mayor volumen operado |
| importe | Llave | Contiene las emisoras filtradas por mayor importe operado |
| operaciones | Llave | Contiene las emisoras filtradas por mayor operaciones realizadas |
| e | Decimal | Emisora con serie en el top |
| u | Decimal | Último hecho de la emisora |
| c | Decimal | Acciones negociadas por la emisora |
| f | Decimal | Fecha en formato AAAA-MM-DD correspondiente al top |
Ejemplo:
https://api.databursatil.com/v2/top?token=TU_TOKEN&variables=suben,bajan,importe,volumen,operaciones&bolsa=BMV&cantidad=2&mercado=local&inicio=2025-06-06&final=2025-06-06
Respuesta del ejemplo:
Otros ejemplos:
https://api.databursatil.com/v2/top?token=TU_TOKEN&variables=suben,bajan,importe,volumen,operaciones&bolsa=BMV&cantidad=2&mercado=local&inicio=2025-06-06&final=2025-06-06
https://api.databursatil.com/v2/top?token=TU_TOKEN&variables=suben&bolsa=BMV&cantidad=20&mercado=local&inicio=2025-06-06&final=2025-06-06
https://api.databursatil.com/v2/top?token=TU_TOKEN&variables=bajan&bolsa=BIVA&cantidad=5&mercado=local&inicio=2025-06-06&final=2025-06-06
{ Historicos V2 }
GET https://api.databursatil.com/v2/historicos
Obtén precios históricos al cierre de la emisora y serie solicitada
Parámetros de la solicitud:
| Parámetro | Exigibilidad | Descripción |
|---|---|---|
| token | Requerido | Método de autenticación |
| emisora_serie | Requerido | Especifica la emisora con serie de la cual se solicitan las cotizaciones. Solo permite 1 emisora con serie. |
| 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 |
Respuesta de la API:
| Valor | Tipado | Concepto |
|---|---|---|
| [fecha] | Fecha | Fecha en formato AAAA-MM-DD del día de referencia |
| precio | Decimal | Precio al cierre de la emisora el día de referencia |
| importe | Decimal | Importe operado de la emisora el día de referencia |
Ejemplo:
https://api.databursatil.com/v2/historicos?token=TU_TOKEN&inicio=2025-06-01&final=2025-06-07&emisora_serie=ALSEA*
Respuesta del ejemplo:
Otros ejemplos:
https://api.databursatil.com/v2/historicos?token=TU_TOKEN&inicio=2025-01-01&final=2025-06-07&emisora_serie=GCARSOA1
https://api.databursatil.com/v2/historicos?token=TU_TOKEN&inicio=2025-01-01&final=2025-06-07&emisora_serie=AAPL*
https://api.databursatil.com/v2/historicos?token=TU_TOKEN&inicio=2025-01-01&final=2025-06-07&emisora_serie=NFLX*
{ Estados Financieros V2 }
GET https://api.databursatil.com/v2/financieros
Estados financieros del periodo y emisora solicitada
Parámetros de la solicitud:
| 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_2025' (primer trimestre del 2025) |
| financieros | Requerido | Especifica la lista de estados financieros solicitados. Opciones disponibles: "posicion", "flujos", "resultado_trimestre" y/o "resultado_acumulado". Se puede elegir multiples separadosm por coma. posicion=Estado de Situacion Financiera, flujos=Estado de Flujo de Efectivo, resultado_trimestre=Estado de Resultados por trimestre, resultado_acumulado=Estado de Resultados por trimestre acumulado |
Respuesta de la API:
| Llave | Tipado | Descripción |
|---|---|---|
| [estado financiero] | Texto | Contenido del estado financiero seleccionado |
| AAAA-MM-DD | Fecha | Fecha del estado financiero seleccionado |
| [cuenta contable en inglés] | Texto | Cuenta contable específica del estado financiero |
| [cuenta contable en español] | Texto | Cuenta contable específica del estado financiero |
| [monto] | Entero | Cantidad monetaria de la cuenta contable |
Ejemplo:
https://api.databursatil.com/v2/financieros?token=TU_TOKEN&emisora=WALMEX&periodo=1T_2023&financieros=resultado_trimestre
Respuesta del ejemplo:
Otros ejemplos:
https://api.databursatil.com/v2/financieros?token=TU_TOKEN&emisora=NEMAK&periodo=2T_2024&financieros=flujos,posicion,resultado_trimestre,resultado_acumulado
https://api.databursatil.com/v2/financieros?token=TU_TOKEN&emisora=ALSEA&periodo=1T_2022&financieros=posicion,flujos,resultado_trimestre,resultado_acumulado
https://api.databursatil.com/v2/financieros?token=TU_TOKEN&emisora=KIMBER&periodo=2T_2023&financieros=posicion
https://api.databursatil.com/v2/financieros?token=TU_TOKEN&emisora=WALMEX&periodo=1T_2023&financieros=resultado_trimestre
{ Índices V2 }
GET https://api.databursatil.com/v2/indices
Precios de los principales índices bursátiles
Parámetros de la solicitud:
| Parámetro | Exigibilidad | Descripción |
|---|---|---|
| token | Requerido | Método de autenticación |
| ticker | Opcional | Filtrar por índice seleccionado. Para ingresar multiples es separado por comas |
Respuesta de la API:
| Llave | Tipado | Concepto |
|---|---|---|
| [indice] | Texto | Nombre corto del índice (ticker) |
| nombre | Texto | Nombre largo del índice |
| u | Decimal | Último precio del índice |
| a | Decimal | Precio de apertura del índice |
| x | Decimal | Precio máximo en la sesión del índice |
| n | Decimal | Precio mínimo en la sesión del índice |
| c | Decimal | Cambio porcentual con base en el precio de cierre anterior |
| m | Decimal | Cambio en puntos con base en el precio de cierre anterior |
| v | Decimal | Volumen en la sesión del índice |
| ytdp | Decimal | Cambio porcentual con base en el precio de cierre del año anterior |
| f | Fecha | Fecha y hora de los datos en formato: YYYY-MM-DD hh:mm:ss |
Ejemplo:
https://api.databursatil.com/v2/indices?token=TU_TOKEN
Respuesta del ejemplo:
Otros ejemplos:
https://api.databursatil.com/v2/indices?token=TU_TOKEN&ticker=IPC,FTSEBIVA
https://api.databursatil.com/v2/indices?token=TU_TOKEN&ticker=SP500
{ Tasas V2 }
GET https://api.databursatil.com/v2/tasas
Tasas del mercado de dinero
Parámetros de la solicitud:
| Parámetro | Exigibilidad | Descripción |
|---|---|---|
| token | Requerido | Método de autenticación |
| ticker | Opcional | Filtrar por tasa seleccionada. Para ingresar multiples es separado por comas |
Respuesta de la API:
| Llave | Tipado | descripcion |
|---|---|---|
| [tasa] | Texto | Tasa de mercado de dinero |
| t | Decimal | Tasa expresada en número decimal |
| f | Fecha | Fecha de actualización en formato YYYY-MM-DD |
Ejemplo:
https://api.databursatil.com/v2/tasas?token=TU_TOKEN
Respuesta del ejemplo:
Otros ejemplos:
https://api.databursatil.com/v2/tasas?token=TU_TOKEN&ticker=CETE28
https://api.databursatil.com/v2/tasas?token=TU_TOKEN&ticker=TIIE91,Tasa_Objetivo
{ Divisas V2 }
GET https://api.databursatil.com/v2/divisas
Precios de los principales cruces de divisas
Parámetros de la solicitud:
| Parámetro | Exigibilidad | Descripción |
|---|---|---|
| token | Requerido | Método de autenticación |
| ticker | Opcional | Filtrar por divisa seleccionada. Para ingresar multiples es separado por comas |
Respuesta de la API:
| Llave | Tipado | descripcion |
|---|---|---|
| [cruce de divisa] | Texto | Cruce de divisa |
| u | Decimal | Tipo de cambio |
| c | Decimal | Cambio por ciento |
| m | Decimal | Cambio monetario |
| f | Fecha | Fecha de actualización en formato YYYY-MM-DD |
Ejemplo:
https://api.databursatil.com/v2/divisas?token=TU_TOKEN
Respuesta del ejemplo:
Otros ejemplos:
https://api.databursatil.com/v2/divisas?token=TU_TOKEN&ticker=EURMXN
https://api.databursatil.com/v2/divisas?token=TU_TOKEN&ticker=USDMXN,EURMXN
{ Commodities V2 }
GET https://api.databursatil.com/v2/commodities
Precios de los principales cruces de commodities
Parámetros de la solicitud:
| Parámetro | Exigibilidad | Descripción |
|---|---|---|
| token | Requerido | Método de autenticación |
| ticker | Opcional | Filtrar por divisa seleccionada. Para ingresar multiples es separado por comas |
Respuesta de la API:
| Llave | Tipado | descripcion |
|---|---|---|
| [commodity] | Texto | Nombre del commodity |
| ytd | Decimal | Cambio porcentual del año en curso |
| yoy | Decimal | Cambio porcentual del año en curso versus año anterior |
| t | Fecha | Fecha de actualización en formato AAAA-MM-DD |
| u | Decimal | Último precio |
| x | Texto | Unidad de medida del commodity |
| m | Decimal | Cambio monetario |
| p | Decimal | Cambio por ciento |
| l | Decimal | Cambio porcentual del mes en curso |
| s | Decimal | Cambio porcentual de la semana en curso |
| f | Fecha | Fecha de actualización en formato YYYY-MM-DD |
Ejemplo:
https://api.databursatil.com/v2/commodities?token=TU_TOKEN
Respuesta del ejemplo:
Otros ejemplos:
https://api.databursatil.com/v2/commodities?token=TU_TOKEN&ticker=paladio
https://api.databursatil.com/v2/commodities?token=TU_TOKEN&ticker=uranio,oro
{ Noticias V2 }
GET https://api.databursatil.com/v2/noticias
Principales titulares de negocios y economía.
Parámetros de la solicitud:
| Parámetro | Exigibilidad | Uso |
|---|---|---|
| token | Requerido | Método de autenticación |
Respuesta de la API:
| Llave | Tipado | Concepto |
|---|---|---|
| n | Texto | Titular de la noticia |
| c | Texto | Contenido de la noticia |
| f | Texto | Fuente de la noticia |
Ejemplo:
https://api.databursatil.com/v2/noticias?token=TU_TOKEN
Respuesta del ejemplo:
{ Cables V2 }
GET https://api.databursatil.com/v2/cables
Cables noticiosos de emisoras mexicanas y noticias recientes de economía y negocios en general.
Parámetros de la solicitud:
| 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". Para ingresar multiples es separado por comas |
Respuesta de la API:
| Llave | Tipado | Concepto |
|---|---|---|
| [categoria] | Texto | Contiene la categoría que se haya solicitado |
| f | Texto | Fuente del cable |
| t | Texto | Contenido del cable |
Ejemplo:
https://api.databursatil.com/v2/cables?token=TU_TOKEN
Respuesta del ejemplo:
Otros ejemplos:
https://api.databursatil.com/v2/cables?token=TU_TOKEN&categorias=top
https://api.databursatil.com/v2/cables?token=TU_TOKEN&categorias=generales,valuaciones
https://api.databursatil.com/v2/cables?token=TU_TOKEN&categorias=boletines,top,valuaciones,flash,generales
{ Descargas V2 }
GET https://api.databursatil.com/v2/descargas
Valuaciones del mercado de dinero mexicano así como hechos al cierre del día.
Parámetros de la solicitud:
| 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". "hechos" son el contenido de hechos al cierre de la jornada bursátil y "guber" son valuaciones de instrumentos de mercado de dinero gubernamental mexicano. |
| fecha | Requerido | Especifica la fecha del archivo que se desea descargar en formato YYYY-MM-DD. Las fechas de los archivos solo están disponibles en días hábiles bancarios en México. |
Respuesta de la API:
| Archivo | Tipado | Concepto |
|---|---|---|
| hechos | 7z que contiene CSV | Hechos al cierre del día. |
| guber | CSV | Valuaciones diarias de mercado de dinero gubernamental. |
Ejemplo 1:
https://api.databursatil.com/v2/descargas?token=TU_TOKEN&archivo=hechos&fecha=2025-06-02
Respuesta del ejemplo:
Ejemplo 2:
https://api.databursatil.com/v2/descargas?token=TU_TOKEN&archivo=guber&fecha=2025-06-02
Respuesta del ejemplo:
{ Hechos V2 }
GET https://api.databursatil.com/v2/hechos
Filtra los hechos de la jornada por emisora y serie
Parámetros de la solicitud:
| Parámetro | Exigibilidad | Descripción |
|---|---|---|
| token | Requerido | Método de autenticación |
| emisora_serie | Requerido | Especifica la emisora con serie de la cual se solicitan las cotizaciones. Limitado a 10 emisoras con serie. |
| fecha | Requerido | Fecha especifica a filtrar hechos al cierre |
| horai | Requerido | Hora inicial para filtrar en formato HH:MM |
| horaf | Requerido | Hora final para filtrar en formato HH:MM |
Respuesta de la API:
| Llave | Tipado | Descripción |
|---|---|---|
| u | Decimal | Último hecho |
| v | Entero | Volumen hecho |
| cc | Texto | Casa compra |
| cv | Texto | Casa vende |
| h | Hora | Hora del hecho en formato HH:MM:SS |
| id | Texto | ID del hecho |
| i | Decimal | Importe del hecho |
| l | Texto | Plazo de liquidación |
Ejemplo:
https://api.databursatil.com/v2/hechos?token=TU_TOKEN&fecha=2025-01-24&emisora_serie=GFNORTEO&horai=09:00&horaf=09:05
1
Otros ejemplos:
https://api.databursatil.com/v2/hechos?token=TU_TOKEN&fecha=2025-06-02&emisora_serie=GFNORTEO,ASURB&horai=10:00&horaf=10:10
https://api.databursatil.com/v2/hechos?token=TU_TOKEN&fecha=2025-06-02&emisora_serie=GFNORTEO,ASURB&horai=10:00&horaf=10:10
https://api.databursatil.com/v2/hechos?token=TU_TOKEN&fecha=2025-06-02&emisora_serie=AMXB,WALMEX*&horai=12%3A00&horaf=12:01
{ Créditos V2 }
GET https://api.databursatil.com/v2/creditos
Créditos disponibles del token ingresado.
Parámetros de la solicitud:
| Parámetro | Exigibilidad | Descripción |
|---|---|---|
| token | Requerido | Método de autenticación |
Respuesta de la API:
| Llave | Tipado | Descripción |
|---|---|---|
| disponibles | String | Créditos disponibles al momento de la consulta |
Ejemplo
https://api.databursatil.com/v2/creditos?token=TU_TOKEN
Respuesta del ejemplo:
{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