Thesma docs
US financial, demographic, labor, and lending data through one API. Zero to first call in under five minutes.
Start here
Section titled “Start here” Quickstart Sign up, get a key, make your first call against SEC EDGAR. Under five minutes.
Authentication Both header formats (X-API-Key and Authorization: Bearer). Key format. Error shapes.
Rate limits Tier table, 429 shape, Retry-After. All datasets included on every tier.
API Reference Full endpoint reference, live-fetched from api.thesma.dev. Try it in the browser.
Datasets
Section titled “Datasets”Four US data verticals, exposed as standalone endpoints and enriched on SEC filings:
SEC EDGAR 10-K / 10-Q financials, Form 4 insider trades, 8-K events, 13F holdings, DEF 14A compensation. Every US public company on NYSE and NASDAQ, under both US-GAAP and IFRS.
US Census 26 demographic and economic metrics across 6 geographic levels (nation, state, county, place, census tract, metro area).
US BLS Industry employment, county wages, occupation wages, labor turnover, state unemployment. CES, QCEW, OEWS, JOLTS, LAUS.
US SBA 903,000+ 7(a) small-business loans by lender, county, state, and NAICS industry.
Recipes
Section titled “Recipes”Worked examples with curl and the Python SDK:
Enrich SEC filings with labor context The flagship cross-dataset recipe. ?include=labor_context adds BLS employment and wage data to any SEC financials response.
Fetch 5 years of annual financials Pull 5 years of annual income statements for a US public company with curl and the Python SDK.
Get a metro-area demographic profile Pull a full demographic profile for a US metropolitan statistical area — population, income, housing, education, employment. New York-Newark-Jersey City (CBSA 35620) as the worked example.
Industry employment trend Pull a 5-year monthly employment trend for a single NAICS industry. Pharmaceutical manufacturing (NAICS 3254) as the worked example.
County lending volume and charge-off rate Pull SBA 7(a) lending aggregates for a US county — volume, loan count, average size, charge-off rate, jobs supported. Los Angeles County (FIPS 06037) as the worked example.
Fetch 5 years of annual financials for an IFRS filer Pull Spotify's 5-year annual income-statement history in native EUR. Demonstrates IFRS-Full taxonomy, native-currency reporting, and the _reporting_notes metadata.
Clients
Section titled “Clients” Python SDK pip install thesma. Sync and async clients, pagination helpers, typed Pydantic models.
CLI Ships with the Python SDK. Resource-scoped commands. Env-var auth.
MCP server Hosted MCP at mcp.thesma.dev — connect from Claude Desktop, Cursor, or ChatGPT. 40+ tools.