Thesma Python SDK

Python SDK for the Thesma API -- developer-friendly access to US-GAAP and IFRS financial data from SEC EDGAR — every US-listed public company on NYSE and NASDAQ.

Installation

pip install thesma

Quickstart

from thesma import ThesmaClient

client = ThesmaClient(api_key="gd_live_...")

# List companies
companies = client.companies.list()
for company in companies:
    print(company.ticker, company.name)

# Get financial statements
financials = client.financials.get("0000320193", statement="income", period="annual")

# IFRS filers return native-currency financials with taxonomy metadata
spot = client.financials.get("0001639920", statement="income", period="annual")
print(spot.data.taxonomy)                         # "ifrs-full"
print(spot.data.currency)                         # "EUR"
print(spot.data.reporting_notes.presentation_format)  # "by_nature" | "by_function" | "unknown"
print(spot.data.reporting_notes.ifrs_18_applied)  # True | False

Async usage

from thesma import AsyncThesmaClient

async with AsyncThesmaClient(api_key="gd_live_...") as client:
    companies = await client.companies.list()

CLI

export THESMA_API_KEY=gd_live_...
thesma companies list
thesma financials list AAPL --period annual --format json

Typed responses

response.taxonomy, response.currency, and response.reporting_notes.presentation_format are declared as typed attributes on FinancialStatementResponse — callers get IDE autocomplete and mypy-checked access instead of reaching into .model_extra for the IFRS-01 fields.

Documentation

Full documentation is available at docs.thesma.dev.

License

MIT