{
"status": "ok",
"version": "0.1.0",
"uptime_seconds": 1385968.8,
"timestamp": "2026-10-14T19:50:43.691246+00:00"
}
curl --location --request GET 'https://zylalabs.com/api/13834/latin+america+trading+calendar+api/31797/health' --header 'Authorization: Bearer YOUR_API_KEY'
{
"exchanges": [
{
"code": "B3",
"name": "B3 - Brasil Bolsa Balcão",
"country": "Brasil",
"timezone": "America/Sao_Paulo"
},
{
"code": "BMV",
"name": "Bolsa Mexicana de Valores",
"country": "México",
"timezone": "America/Mexico_City"
},
{
"code": "BYMA",
"name": "Bolsas y Mercados Argentinos",
"country": "Argentina",
"timezone": "America/Argentina/Buenos_Aires"
}
]
}
curl --location --request GET 'https://zylalabs.com/api/13834/latin+america+trading+calendar+api/31798/list+exchanges' --header 'Authorization: Bearer YOUR_API_KEY'
{
"exchange": "BYMA",
"date": "2026-01-15",
"is_trading_day": true,
"reason": null,
"data_available": true,
"data_quality": {
"confidence": "low",
"stale": false,
"source": "cross_checked"
}
}
curl --location --request GET 'https://zylalabs.com/api/13834/latin+america+trading+calendar+api/31799/is+trading+day?exchange=BYMA&date=2026-01-15' --header 'Authorization: Bearer YOUR_API_KEY'
{
"exchange": "BYMA",
"from_date": "2026-01-15",
"next_trading_day": "2026-01-16",
"data_available": true,
"data_quality": {
"confidence": "low",
"stale": false,
"source": "cross_checked"
}
}
curl --location --request GET 'https://zylalabs.com/api/13834/latin+america+trading+calendar+api/31800/next+trading+day?exchange=BYMA&date=2026-01-15' --header 'Authorization: Bearer YOUR_API_KEY'
{
"exchange": "BYMA",
"year": 2026,
"data_available": true,
"last_verified": "2026-09-17",
"source": "https://www.byma.com.ar/mercado/calendario-bursatil",
"holidays": [
{
"date": "2026-01-01",
"name": "Año Nuevo",
"type": "civil_holiday"
},
{
"date": "2026-02-16",
"name": "Carnaval",
"type": "civil_holiday"
},
{
"date": "2026-02-17",
"name": "Carnaval",
"type": "civil_holiday"
},
{
"date": "2026-03-23",
"name": "Día no laborable con fines turísticos",
"type": "bridge_day"
},
{
"date": "2026-03-24",
"name": "Día Nacional de la Memoria por la Verdad y la Justicia",
"type": "civil_holiday"
},
{
"date": "2026-04-02",
"name": "Día del Veterano y de los Caídos en la Guerra de Malvinas",
"type": "civil_holiday"
},
{
"date": "2026-04-03",
"name": "Viernes Santo",
"type": "civil_holiday"
},
{
"date": "2026-05-01",
"name": "Día del Trabajador",
"type": "civil_holiday"
},
{
"date": "2026-05-25",
"name": "Día de la Revolución de Mayo",
"type": "civil_holiday"
},
{
"date": "2026-06-15",
"name": "Paso a la Inmortalidad del General Martín Miguel de Güemes (trasladado)",
"type": "civil_holiday"
},
{
"date": "2026-07-09",
"name": "Día de la Independencia",
"type": "civil_holiday"
},
{
"date": "2026-07-10",
"name": "Día no laborable con fines turísticos",
"type": "bridge_day"
},
{
"date": "2026-08-17",
"name": "Paso a la Inmortalidad del General José de San Martín",
"type": "civil_holiday"
},
{
"date": "2026-10-12",
"name": "Día del Respeto a la Diversidad Cultural",
"type": "civil_holiday"
},
{
"date": "2026-11-06",
"name": "Día del Bancario",
"type": "bridge_day"
},
{
"date": "2026-11-23",
"name": "Día de la Soberanía Nacional (trasladado)",
"type": "civil_holiday"
},
{
"date": "2026-12-07",
"name": "Día no laborable con fines turísticos",
"type": "bridge_day"
},
{
"date": "2026-12-08",
"name": "Inmaculada Concepción de María",
"type": "civil_holiday"
},
{
"date": "2026-12-24",
"name": "Nochebuena",
"type": "bridge_day"
},
{
"date": "2026-12-25",
"name": "Navidad",
"type": "civil_holiday"
},
{
"date": "2026-12-31",
"name": "Sin rueda ni liquidación (cierre de año)",
"type": "market_closure"
}
],
"data_quality": {
"confidence": "low",
"stale": false,
"source": "cross_checked"
}
}
curl --location --request GET 'https://zylalabs.com/api/13834/latin+america+trading+calendar+api/31801/holidays?exchange=BYMA&year=2026' --header 'Authorization: Bearer YOUR_API_KEY'
{
"results": [
{
"id": "1",
"exchange": "BYMA",
"date": "2026-05-25",
"is_trading_day": false,
"reason": "Día de la Revolución de Mayo",
"data_available": true,
"data_quality": {
"confidence": "low",
"stale": false,
"source": "cross_checked"
},
"error": null
},
{
"id": "2",
"exchange": "B3",
"date": "2026-04-21",
"is_trading_day": false,
"reason": "Tiradentes",
"data_available": true,
"data_quality": {
"confidence": "high",
"stale": false,
"source": "cross_checked"
},
"error": null
},
{
"id": "3",
"exchange": "BMV",
"date": "2026-10-14",
"is_trading_day": true,
"reason": null,
"data_available": true,
"data_quality": {
"confidence": "high",
"stale": false,
"source": "cross_checked"
},
"error": null
}
]
}
curl --location --request POST 'https://zylalabs.com/api/13834/latin+america+trading+calendar+api/31802/is+batch+trading+day' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{
"items": [
{"id": "1", "exchange": "BYMA", "date": "2026-05-25"},
{"id": "2", "exchange": "B3", "date": "2026-04-21"},
{"id": "3", "exchange": "BMV", "date": "2026-10-14"}
]
}'
{
"exchange": "BYMA",
"from_date": "2026-01-07",
"days": 5,
"result_date": "2026-01-14",
"data_quality": [
{
"year": 2026,
"data_available": true,
"confidence": "low",
"stale": false,
"source": "cross_checked"
}
]
}
curl --location --request GET 'https://zylalabs.com/api/13834/latin+america+trading+calendar+api/31803/add+business+days?exchange=BYMA&date=2026-01-07&days=5' --header 'Authorization: Bearer YOUR_API_KEY'
{
"exchange": "BYMA",
"from_date": "2026-01-01",
"to_date": "2026-01-31",
"business_days": 21,
"data_quality": [
{
"year": 2026,
"data_available": true,
"confidence": "low",
"stale": false,
"source": "cross_checked"
}
]
}
curl --location --request GET 'https://zylalabs.com/api/13834/latin+america+trading+calendar+api/31804/business+days+between?exchange=BYMA&from=2026-01-01&to=2026-01-31' --header 'Authorization: Bearer YOUR_API_KEY'
Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a Calendário de Negócios da América Latina API basta incluir seu token Bearer no cabeçalho Authorization.
| Cabeçalho | Descrição |
|---|---|
Authorization
|
Obrigatório
Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.
|
Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento. O teste gratuito inclui até 50 requisições.
Indica se uma data é um dia de negociação para os mercados da LatAm (BYMA, B3, BMV); retorna o próximo dia de negociação, lista feriados anuais e calcula dias úteis entre datas
Cada ponto final retorna dados específicos relacionados aos dias de negociação, feriados e dias úteis para bolsas de valores da América Latina Por exemplo o ponto final "É Dia de Negociação" indica se uma data específica é um dia de negociação enquanto o ponto final "Feriados" lista os feriados para uma bolsa específica e um ano
Os campos-chave incluem "exchange" (código da bolsa), "date" (data específica), "is_trading_day" (booleano), "next_trading_day" (próxima data de negociação) e "holidays" (lista de datas de feriado) Esses campos ajudam os usuários a entender os cronogramas de negociação e os impactos dos feriados
Os parâmetros variam de acordo com o endpoint Para "É Dia de Negociação" você precisa de "bolsa" e "data" O endpoint "Adicionar Dias Úteis" requer "data_de" e "dias" Os usuários podem personalizar solicitações especificando a bolsa e as datas relevantes
Os dados são originados de bolsas de valores oficiais na América Latina, incluindo BYMA, B3 e BMV. A API mantém a precisão dos dados atualizando regularmente as informações com base em anúncios das bolsas e calendários verificados
Casos de uso típicos incluem aplicações financeiras que requerem validação de dias de negociação, programação de feriados para estratégias de negociação e cálculo de dias úteis para processos de liquidação. Esses dados são essenciais para traders e analistas financeiros
Se os resultados forem parciais ou vazios os usuários devem verificar o campo "data_available" Se for falso isso indica que os dados podem não estar atualizados ou verificados Os usuários podem implementar lógica de fallback para lidar com esses casos como reexibir pedidos ou usar dados em cache
BYMA (Argentina) B3 (Brasil) e BMV (México) O ano calendário de 2026 está disponível agora cada ano subsequente é adicionado assim que a bolsa publica seu calendário oficial
Cada calendário é verificado em relação a uma fonte secundária independente Cada resposta inclui um bloco de `qualidade_dados` (`método_verificação`, `confiança`, `última_verificação`, `obsoleto`) para que você possa ver quão confiáveis são os dados
Alto: fontes primárias e secundárias concordam meio: diferenças menores, explicadas, como fechamentos de meio dia que os calendários civis não listam baixo: uma lacuna conhecida na fonte oficial, sinalizada na resposta
Use `/v1/business-days-between` (inclusive ambos os pontos finais) ou `/v1/add-business-days` (aceita valores negativos) Para verificar muitas datas de uma só vez, use o endpoint em lote (até 1.000 por solicitação)