Taxa Básica de Juros
Endpoints para consulta de Taxas Básicas de Juros (SELIC) de diferentes países.
Permite a obtenção de taxas atuais e séries históricas das taxas básicas de juros, com personalização por país, período e opções de ordenação.
Buscar Taxa Básica de Juros (SELIC) de um País por um Período Determinado
Obtenha informações atualizadas sobre a taxa básica de juros (SELIC) de um país por um período determinado.
Funcionalidades:
- Seleção por País: Especifique o país desejado usando o parâmetro
country
(padrão: brazil). - Período Customizado: Defina datas de início e fim com
start
eend
para consultar um intervalo específico. - Ordenação: Ordene os resultados por data ou valor com os parâmetros
sortBy
esortOrder
. - Dados Históricos: Solicite o histórico completo ou apenas o valor mais recente com o parâmetro
historical
.
Autenticação:
Requer token de autenticação via token
(query) ou Authorization
(header).
Exemplo de Requisição:
Taxa de juros do Brasil entre dezembro/2021 e janeiro/2022:
curl -X GET "https://brapi.dev/api/v2/prime-rate?country=brazil&start=01/12/2021&end=01/01/2022&sortBy=date&sortOrder=desc&token=SEU_TOKEN"
Autenticação via header HTTP Authorization
. Use o formato Authorization: Bearer SEU_TOKEN
. Obtenha seu token.
In: header
Query Parameters
Opcional. O país do qual você deseja obter informações sobre a taxa básica de juros. Por padrão, o país é definido como brazil. Você pode consultar a lista de países disponíveis através do endpoint /api/v2/prime-rate/available
.
"brazil"
Opcional. Define se os dados históricos serão retornados. Se definido como true
, retorna a série histórica completa. Se false
(padrão) ou omitido, retorna apenas o valor mais recente.
false
Opcional. Data inicial do período para busca no formato DD/MM/YYYY. Útil quando historical=true
para restringir o período da série histórica.
date
Opcional. Data final do período para busca no formato DD/MM/YYYY. Por padrão é a data atual. Útil quando historical=true
para restringir o período da série histórica.
date
Opcional. Campo pelo qual os resultados serão ordenados. Por padrão, ordena por date
(data).
"date"
"date" | "value"
Opcional. Define se a ordenação será crescente (asc
) ou decrescente (desc
). Por padrão, é desc
(decrescente).
"desc"
"asc" | "desc"
Obrigatório caso não esteja adicionado como header "Authorization". Seu token de autenticação pessoal da API Brapi.
Formas de Envio:
- Query Parameter: Adicione
?token=SEU_TOKEN
ao final da URL. - HTTP Header: Inclua o header
Authorization: Bearer SEU_TOKEN
na sua requisição.
Ambos os métodos são aceitos, mas pelo menos um deles deve ser utilizado. Obtenha seu token em brapi.dev/dashboard.
Response Body
curl -X GET "https://brapi.dev/api/v2/prime-rate?country=brazil&start=2019-08-24&end=2019-08-24&sortBy=date&sortOrder=asc&token=string"
{
"prime-rate": [
{
"date": "01/01/2022",
"value": "9.25",
"epochDate": 1640995200000
}
]
}
{
"error": true,
"message": "Something went wrong while fetching the data"
}
{
"error": true,
"message": "O seu token é inválido, por favor, verifique o seu token em brapi.dev/dashboard"
}
{
"error": true,
"message": "this query value is not available, please use one of the following: asc,desc"
}