Catálogo de minerais com produção e reservas por país
Lista as commodities minerais cobertas (lítio, cobre, nióbio, cobalto, terras raras, grafita, ferro, ouro, fosfato, potássio e outras), com nome em português, grupo, período coberto, se é mineral crítico e o maior produtor do ano mais recente. Use para descobrir a chave do mineral antes de pedir o ranking de países ou a série. A busca ignora acento, então 'litio', 'lítio' e 'lithium' chegam na mesma linha. `top_producer_share_pct` sai nulo quando a participação não é calculável para nenhum país da commodity.
In: header
Query Parameters
1001 <= value <= 1000Busca por nome em português, chave ou nome em inglês. Ignora acento.
true = só minerais da lista de críticos do USGS.
Grupo exato: Metais básicos, Metais preciosos, Metais ferrosos e ligas, Terras raras e críticos, Minerais industriais, Fertilizantes, Materiais de construção, Energia.
Response Body
curl -X GET "https://api.databolsa.com/v1/minerals?cursor=string&limit=100&search=string&critical=true&group=string"{
"data": [
{
"mineral": "string",
"label": "string",
"commodity_usgs": "string",
"group": "string",
"is_critical": true,
"first_year": 0,
"last_year": 0,
"countries": 0,
"has_production": true,
"has_reserves": true,
"units": "string",
"countries_withheld": 0,
"top_producer": "string",
"top_producer_share_pct": 0,
"edition": "string",
"edition_year": 0
}
],
"meta": {
"next_cursor": "string",
"count": 0,
"total": 0,
"subject": {
"property1": "string",
"property2": "string"
}
}
}{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string"
}Ranking de países produtores e detentores de reservas de um mineral
Responde 'quem produz mais' e 'quem tem as maiores reservas': ranking de países produtores com a participação no total mundial, para lítio, cobre, nióbio, cobalto, terras raras, grafita, ferro, ouro, fosfato, potássio e as demais commodities do catálogo. Use `statistic=production` para produção do ano e `statistic=reserves` para reservas. É a rota certa para perguntas como 'quanto do nióbio do mundo vem do Brasil', 'quem domina a produção de terras raras' ou 'quais países concentram as reservas de lítio'. Como ler o resultado sem errar: - `share_of_world_pct` é NULO quando a participação não pode ser calculada, e `share_basis` diz o motivo. Nunca trate ausência como zero. O motivo mais sutil é `incomparable_basis`: existe total mundial, mas os países reportam bases diferentes, como nas reservas de boro, em que a Turquia declara boratos refinados, o Chile ulexita e a China óxido bórico equivalente. Não são somáveis, e é por isso que o próprio USGS marca o total como `XX`. - `meta.countries_withheld` acima de zero significa ranking INCOMPLETO: o USGS reteve o valor de países onde ele revelaria dado proprietário de empresa, então os shares não somam 100%. - `meta.is_estimate` verdadeiro significa que o ano é estimativa do USGS, não realizado. - Quando a commodity tem mais de um agregado (cobre tem produção de mina e produção de refino, com totais mundiais distintos), o ranking usa um recorte só e informa os outros em `meta.available_details`; troque com `?detail=`. - Em `statistic=reserves` o número é ESTIMATIVA GEOLÓGICA AGREGADA POR PAÍS publicada pelo USGS. Não é reserva provada ou provável declarada por companhia sob SEC S-K 1300, JORC ou NI 43-101, não tem a mesma auditoria e não deve ser comparada com o relatório técnico de uma mineradora.
Curvas de juros de mercado por vértice (DI, pré, IPCA+, implícita)
Um ponto por vértice de prazo, em % a.a. `di` vem dos juros futuros; as demais são curvas de referência de mercado. Complementa a getYieldCurve (que é a régua do Tesouro Direto, um ponto por título). ATENÇÃO: `tenor_days` é em dias CORRIDOS (o vértice de 1 ano-calendário fica em ~365-374 dias, não em 252) — para comparar prazos entre curvas use `tenor_years`, que normaliza a convenção.