Investidor10 APIinvestidor10.com.br ↗

"""Investidor10 SDK — Brazilian stock market data walkthrough."""
from parse_apis.investidor10_api import Investidor10, Ticker, TickerNotFound

client = Investidor10()

# List top stocks by market cap — limit caps total items fetched.
for stock in client.stocksummaries.list(limit=3):
    print(stock.ticker, stock.name, stock.dividend_yield, stock.setor)

# Drill down into one stock's full details via .details() navigation.
summary = client.stocksummaries.list(limit=1).first()
if summary:
    detail = summary.details()
    print(detail.ticker, detail.price, detail.company_id)
    for div in detail.dividends[:2]:
        print(div.tipo, div.data_com, div.valor)

# Fetch a stock directly by ticker and get price history.
petr4 = client.stocks.get(ticker=Ticker.PETR4)
history = petr4.price_history(days=30)
for pt in history.real[:3]:
    print(pt.created_at, pt.price)

# Get historical indicators for the same stock.
indicators = petr4.indicators(years=5)
for name, values in indicators.indicators.items():
    if values:
        print(name, values[0].year, values[0].value)
    break

# Search for assets by query.
results = client.searchresults.search(query="VALE3", limit=3)
for r in results:
    print(r.name, r.type, r.price, r.variation_direction)

# Typed error handling: catch a not-found ticker.
try:
    client.stocks.get(ticker="XYZW99")
except TickerNotFound as exc:
    print(f"Ticker not found: {exc.ticker}")

# List FIIs (real estate investment funds).
for fii in client.fiisummaries.list(limit=3):
    print(fii.ticker, fii.name, fii.dividend_yield, fii.liquidez_diaria)

print("exercised: stocksummaries.list / details / stocks.get / price_history / indicators / searchresults.search / fiisummaries.list")