arrow_back Voltar para Requests
Requests · Exemplo 02RequestsPython
/ API pública + financeiro

Cotação do dólar.
Da API para o cálculo.

Busque automaticamente a última cotação PTAX disponível, identifique o fechamento do dólar e use o valor em uma conversão simples de USD para BRL.

status_codeJSONFallbackFinanceiro
Cotação do dólar via API
/ Por que usar Requests?

Uma API pode virar parte do processo.

Neste exemplo, Requests deixa de ser apenas um GET: ele consulta uma fonte pública, lida com indisponibilidade por data, seleciona o fechamento PTAX e entrega uma informação pronta para ser usada em outro processo.

http

Status HTTP

Diferencie respostas válidas, erros e dias em que a API não possui cotação disponível.

history

Fallback de datas

Recue automaticamente alguns dias até encontrar a última data com fechamento PTAX válido.

data_object

JSON

Transforme a resposta da API em objetos Python e selecione somente os campos necessários.

currency_exchange

PTAX

Identifique o boletim de fechamento e utilize uma cotação oficial de referência no cálculo.

timer

Timeout

Evite que integrações fiquem aguardando indefinidamente uma resposta de serviço externo.

verified

Validação

Confirme que o retorno contém cotações e o tipo de boletim esperado antes de seguir com o processo.

autorenew

Automação

A mesma consulta pode ser executada por rotinas agendadas, ETLs, relatórios ou outros sistemas.

account_tree

Uso corporativo

Alimente estimativas de compras, contratos, relatórios financeiros e processos com exposição cambial.

info

E quando não usar? Este exemplo é didático e usa uma API pública como fonte de referência. Em processos financeiros críticos, conciliação, faturamento ou decisões regulatórias, valide a fonte oficial, a regra de negócio e a cotação exigida pela sua empresa antes de automatizar.

01

Instale e importe

# No terminal, se ainda não tiver Requests: pip install requests import requests from datetime import date, timedelta
02

Procure uma data com cotação

for dias_atras in range(1, 8): data = date.today() - timedelta(days=dias_atras) url = f"https://brasilapi.com.br/api/cambio/v1/cotacao/USD/{data}" resposta = requests.get(url, timeout=10) if resposta.status_code == 200: dados = resposta.json() break
03

Escolha o fechamento PTAX

fechamentos = [ item for item in dados["cotacoes"] if item["tipo_boletim"] == "FECHAMENTO PTAX" ] ptax = fechamentos[-1] cotacao = ptax["cotacao_venda"]
04

Converta um valor

valor_usd = 1000 valor_brl = valor_usd * cotacao print(f"Data PTAX: {dados['data']}") print(f"Cotação de venda: R$ {cotacao:.4f}") print(f"US$ {valor_usd:,.2f} = R$ {valor_brl:,.2f}")

Uso corporativo

Esse padrão pode alimentar relatórios financeiros, estimativas de compras internacionais, custos de contratos e processos que precisam de uma cotação oficial de referência.