API de Dados Fiscais do Tesouro dos EUA

API REST gratuita e aberta do Departamento do Tesouro dos EUA para dados financeiros federais. Nenhuma chave de API ou registro é necessário.

URL Base: https://api.fiscaldata.treasury.gov/services/api/fiscal_service

Navegue pelo catálogo de conjuntos de dados atual através da pesquisa de conjuntos de dados. Verifique os caminhos dos endpoints no Guia Rápido de API de cada conjunto de dados — os caminhos mudam com o tempo.

Instalação

uv pip install requests pandas

Início Rápido

import requests
import pandas as pd

BASE_URL = "https://api.fiscaldata.treasury.gov/services/api/fiscal_service"

# Get the current national debt (Debt to the Penny)
resp = requests.get(f"{BASE_URL}/v2/accounting/od/debt_to_penny", params={
    "sort": "-record_date",
    "page[size]": 1
}, timeout=30)
resp.raise_for_status()
data = resp.json()["data"][0]
print(f"Total public debt as of {data['record_date']}: ${float(data['tot_pub_debt_out_amt']):,.0f}")

# Preview Treasury exchange-rate rows for recent quarters (first page only)
resp = requests.get(f"{BASE_URL}/v1/accounting/od/rates_of_exchange", params={
    "fields": "country_currency_desc,exchange_rate,record_date,effective_date",
    "filter": "record_date:gte:2024-01-01",
    "sort": "-record_date",
    "page[size]": 100
}, timeout=30)
resp.raise_for_status()
df = pd.DataFrame(resp.json()["data"])

Autenticação

Nenhuma é necessária. A API é totalmente aberta e gratuita.

Parâmetros Principais

Operadores de filtro: lt, lte, gt, gte, eq, in

# Multiple filters separated by comma
"filter=country_currency_desc:in:(Canada-Dollar,Mexico-Peso),record_date:gte:2024-01-01"

Principais Conjuntos de Dados e Endpoints

Dívida

Declarações Diárias e Mensais

Taxas de Juros e Câmbio

Interpretação da taxa de câmbio: As Taxas de Relatório do Tesouro são unidades de moeda estrangeira por USD, portanto, divida um valor em moeda estrangeira pela taxa para obter USD (e multiplique USD para obter moeda estrangeira). Estas são taxas de relatório do governo, não cotações de negociação em tempo real. Preserve ambos record_date e effective_date, e verifique as emendas antes de aplicar uma taxa a um período de relatório.

Títulos e Leilões

Títulos de Poupança

Estrutura da Resposta

{
  "data": [...],
  "meta": {
    "count": 100,
    "total-count": 3790,

…