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.
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.
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.