ANBIMA APIdata.anbima.com.br ↗

"""ANBIMA Data API - SDK Usage Example

Search Brazilian financial market data: funds, debentures, datasets, and events.
"""
from parse_apis.anbima_data_api import Anbima, DebentureNotFound

client = Anbima()

# List available datasets on the platform
for dataset in client.datasets.list(limit=3):
    print(dataset.titulo, "|", dataset.categoria_ativo, "| available:", dataset.disponivel)

# Search debentures and drill into detail for the first result
deb = client.debenturesummaries.search(query="AALM", limit=1).first()
if deb:
    print(f"\nDebenture: {deb.codigo_b3} | {deb.emissor} | matures {deb.data_vencimento}")
    detail = deb.details()
    print(f"  Emission volume: {detail.emissao.volume}")
    if detail.pu_historico:
        print(f"  Historical PU par: {detail.pu_historico.pu_par}")

# Search investment funds by name
for fund in client.funds.search(query="bradesco", limit=3):
    print(f"\nFund: {fund.fundo.nome_comercial} ({fund.fundo.status})")
    if fund.classe:
        print(f"  Category: {fund.classe.categoria_anbima} | Type: {fund.classe.tipo_anbima}")
    if fund.perfil_complementar:
        print(f"  12m return: {fund.perfil_complementar.rentabilidade_doze_meses}")

# Retrieve historical periodic data for a fund
for record in client.fundperiodicdatas.get(query="itau", limit=3):
    print(f"\nDaily: {record.date} | share: {record.value} | patrimony: {record.valor_patrimonio_liquido}")

# Browse private securities events calendar
for event in client.securityevents.list(limit=5):
    print(f"\nEvent: {event.evento} | {event.codigo_b3} | {event.data_evento} | {event.valor}")

# Typed error handling for a missing debenture
try:
    bad = client.debenturesummaries.search(query="ZZZZ99", limit=1).first()
    if bad:
        bad.details()
except DebentureNotFound as exc:
    print(f"\nNot found: {exc.code}")

print("\nExercised: datasets.list, debenturesummaries.search, deb.details, funds.search, fundperiodicdatas.get, securityevents.list")