Taxa Básica de Juros (SELIC)

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 e end para consultar um intervalo específico.
  • Ordenação: Ordene os resultados por data ou valor com os parâmetros sortBy e sortOrder.
  • 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"
GET
/api/v2/prime-rate
AuthorizationBearer <token>

Autenticação via header HTTP Authorization. Use o formato Authorization: Bearer SEU_TOKEN. Obtenha seu token.

In: header

Query Parameters

country?string

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.

Default"brazil"
historical?boolean

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.

Defaultfalse
start?string

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.

Formatdate
end?string

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.

Formatdate
sortBy?string

Opcional. Campo pelo qual os resultados serão ordenados. Por padrão, ordena por date (data).

Default"date"
Value in"date" | "value"
sortOrder?string

Opcional. Define se a ordenação será crescente (asc) ou decrescente (desc). Por padrão, é desc (decrescente).

Default"desc"
Value in"asc" | "desc"
token?string

Obrigatório caso não esteja adicionado como header "Authorization". Seu token de autenticação pessoal da API Brapi.

Formas de Envio:

  1. Query Parameter: Adicione ?token=SEU_TOKEN ao final da URL.
  2. 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"
}