Buscar Taxa Básica de Juros (SELIC) de um País por um Período Determinado

Nesta seção, você encontrará informações detalhadas sobre como buscar a taxa básica de juros (SELIC) de um país por meio da API da brapi. Este endpoint é a porta de entrada para obter informações atualizadas sobre a taxa básica de juros (SELIC) de um país por um período determinado. Saiba como usar os parâmetros de consulta, como country para escolher o país desejado e historical para mostrar dados históricos.

Endpoint

O endpoint que você deve utilizar para buscar a taxa básica de juros (SELIC) de um país por um período determinado é o seguinte:

GET /api/v2/prime-rate

Parâmetros da Solicitação

Para utilizar este endpoint, você precisa fornecer os seguintes parâmetros na solicitação:

country (opcional)

O parâmetro "county" é opcional e especifica o país do qual você deseja obter informações. Por padrão, o país é definido como brazil. Você pode consultar a lista de países disponíveis aqui (opens in a new tab).

Exemplo de uso: ?country=brazil

Isso facilita a busca por informações específicas de um país.

historical (opcional)

O parâmetro "historical" é um boolean (true ou false) opcional e especifica se você deseja obter informações históricas ou não. Por padrão, o histórico é false e você receberá apenas as informações mais recentes.

Exemplo de uso: ?historical=true

Isso permite que você obtenha informações de períodos anteriores.

start (opcional)

O parâmetro "start" é uma data opcional e especifica a data inicial do período desejado. O formato da data deve ser DD/MM/YYYY.

Exemplo de uso: ?start=01/01/2020

Isso permite que você obtenha informações de períodos anteriores.

end (opcional)

O parâmetro "end" é uma data opcional e especifica a data final do período desejado. O formato da data deve ser DD/MM/YYYY. Por padrão, o valor é a data atual.

Exemplo de uso: ?end=01/01/2022

Isso permite que você obtenha informações de períodos anteriores.

sortBy (opcional)

Este parâmetro permite que você ordene os resultados por um campo específico. Tem como padrão o valor date. Os valores aceitáveis são:

date - Data da informação
value - Valor da taxa básica de juros (SELIC)

Exemplo de uso: ?sortBy=date

sortOrder (opcional)

Este parâmetro determina se os filtro de sortBy será ordenado em ordem crescente ou decrescente. Tem como padrão o valor desc. Os valores aceitáveis são:

desc - Ordem decrescente
asc - Ordem crescente

Exemplo de uso: ?sortOrder=desc

token (obrigatório)

O token de autenticação é obrigatório e exclusivo para cada usuário. Você pode obtê-lo em https://brapi.dev/dashboard (opens in a new tab). A autenticação é necessária para acessar os recursos da API e garantir a segurança das suas solicitações.

Esta flexibilidade na definição de parâmetros permite que você ajuste suas solicitações para atender a uma variedade de necessidades, desde dados históricos até informações detalhadas sobre a taxa básica de juros (SELIC) de um país.

Exemplo de Solicitação

Para uma solicitação que busca os dados da taxa básica de juros (SELIC) do Brasil desde o início de dezembro de 2021 até o início de janeiro de 2022, ordenado pela data de forma decrescente, a solicitação ficaria assim:

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=eJGEyu8vVHctULdVdHYzQd"

Parâmetro	Valor
country	brazil
start	01/12/2021
end	01/01/2022
sortBy	date
sortOrder	desc
token	eJGEyu8vVHctULdVdHYzQd

Resposta da Solicitação

200 OK

A solicitação foi bem-sucedida.

{
  "prime-rate": [
    {
      "date": "01/01/2022",
      "value": "9.25",
      "epochDate": 1640995200000
    },
    {
      "date": "31/12/2021",
      "value": "9.25",
      "epochDate": 1640908800000
    },
    {
      "date": "30/12/2021",
      "value": "9.25",
      "epochDate": 1640822400000
    },
    {
      "date": "29/12/2021",
      "value": "9.25",
      "epochDate": 1640736000000
    },
    {
      "date": "28/12/2021",
      "value": "9.25",
      "epochDate": 1640649600000
    },
    {
      "date": "27/12/2021",
      "value": "9.25",
      "epochDate": 1640563200000
    },
    {
      "date": "26/12/2021",
      "value": "9.25",
      "epochDate": 1640476800000
    },
    {
      "date": "25/12/2021",
      "value": "9.25",
      "epochDate": 1640390400000
    },
    {
      "date": "24/12/2021",
      "value": "9.25",
      "epochDate": 1640304000000
    },
    {
      "date": "23/12/2021",
      "value": "9.25",
      "epochDate": 1640217600000
    },
    {
      "date": "22/12/2021",
      "value": "9.25",
      "epochDate": 1640131200000
    },
    {
      "date": "21/12/2021",
      "value": "9.25",
      "epochDate": 1640044800000
    },
    {
      "date": "20/12/2021",
      "value": "9.25",
      "epochDate": 1639958400000
    },
    {
      "date": "19/12/2021",
      "value": "9.25",
      "epochDate": 1639872000000
    },
    {
      "date": "18/12/2021",
      "value": "9.25",
      "epochDate": 1639785600000
    },
    {
      "date": "17/12/2021",
      "value": "9.25",
      "epochDate": 1639699200000
    },
    {
      "date": "16/12/2021",
      "value": "9.25",
      "epochDate": 1639612800000
    },
    {
      "date": "15/12/2021",
      "value": "9.25",
      "epochDate": 1639526400000
    },
    {
      "date": "14/12/2021",
      "value": "9.25",
      "epochDate": 1639440000000
    },
    {
      "date": "13/12/2021",
      "value": "9.25",
      "epochDate": 1639353600000
    },
    {
      "date": "12/12/2021",
      "value": "9.25",
      "epochDate": 1639267200000
    },
    {
      "date": "11/12/2021",
      "value": "9.25",
      "epochDate": 1639180800000
    },
    {
      "date": "10/12/2021",
      "value": "9.25",
      "epochDate": 1639094400000
    },
    {
      "date": "09/12/2021",
      "value": "9.25",
      "epochDate": 1639008000000
    },
    {
      "date": "08/12/2021",
      "value": "7.75",
      "epochDate": 1638921600000
    },
    {
      "date": "07/12/2021",
      "value": "7.75",
      "epochDate": 1638835200000
    },
    {
      "date": "06/12/2021",
      "value": "7.75",
      "epochDate": 1638748800000
    },
    {
      "date": "05/12/2021",
      "value": "7.75",
      "epochDate": 1638662400000
    },
    {
      "date": "04/12/2021",
      "value": "7.75",
      "epochDate": 1638576000000
    },
    {
      "date": "03/12/2021",
      "value": "7.75",
      "epochDate": 1638489600000
    },
    {
      "date": "02/12/2021",
      "value": "7.75",
      "epochDate": 1638403200000
    },
    {
      "date": "01/12/2021",
      "value": "7.75",
      "epochDate": 1638316800000
    }
  ]
}

400 Bad Request

A solicitação foi malformada, inválida ou não foi possível entender o que foi solicitado.

{
  "error": true,
  "message": "Something went wrong while fetching the data"
}

417 Expectation Failed

Não entendemos algum dos parametros passados.

{
  "error": true,
  "message": "this query value is not available, please use one of the following: asc,desc"
}

401 Unauthorized

O token de autenticação não foi informado ou é inválido.

{
  "error": true,
  "message": "O seu token é inválido, por favor, verifique o seu token em brapi.dev/dashboard"
}

/api/v2/inflation/available /api/v2/prime-rate/available