Ficha de um mineral
Perfil da commodity mineral: nome em português, grupo, se está na lista de minerais críticos do USGS, anos cobertos, unidades, quantos países aparecem e o maior produtor com sua participação. Ponto de entrada antes do ranking de países e da série histórica.
In: header
Path Parameters
Chave do mineral, ex.: lithium, copper, niobium_columbium, rare_earths.
^[A-Za-z0-9_]+$2 <= length <= 64Response Body
curl -X GET "https://api.databolsa.com/v1/minerals/string"{
"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
}{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string"
}Série histórica de ajuste diário
Ajuste por (pregão, contrato), do mais recente para o mais antigo. Para série comparável no tempo, filtre por `contract` — sem isso a mesma data traz vários vencimentos, o que serve para volume mas engana como preço.
Série longa de produção e reservas de minerais, por país e ano
Formato longo: uma linha por mineral, país, recorte e ano. É a rota para perguntas por PAÍS, do tipo 'quais minerais o Brasil produz' ou 'o que o Brasil tem de reservas', com `?country=BRA`, e também para a série histórica de um mineral com `?mineral=lithium&from=2021&to=2025`. Cada linha carrega o valor, a sentinela publicada quando não há valor (`value_raw`, `value_flag_reason`), a participação no total mundial com o motivo quando ela não existe (`share_of_world_pct` nulo + `share_basis`) e a edição da publicação. Edições diferentes não formam série comparável: o USGS reestima anos anteriores a cada safra. As linhas de total mundial ficam de fora por default. Sobre `reserves`: é estimativa geológica agregada por país, não reserva provada sob SEC S-K 1300, JORC ou NI 43-101.