Point-in-time fundamentals API

Production fundamentals, timed correctly.

CapraFeed serves SEC fundamentals with explicit availability semantics, restatement-aware versioning, and an inspectable concept layer. Access is designed around billed workspaces, not anonymous traffic.

Read docs Access model

Workspace-scoped access · usage metering · invoice-ready accounts

Example stable surface

GET /v1/fundamentals

ids=AAPL
metrics=revenue
period=FY
fiscalYear=2023
asOf=2024-02-01T00:00:00Z
availability=market

acceptedAt 2023-11-02T22:08:27Z

marketAvailableAt 2023-11-03T13:30:00Z

Access model

Built for paid API access.

The account boundary is the workspace. Human users join workspaces. API keys, usage, billing, and audit history attach there.

Accounts

Workspace billing

One billed workspace can have multiple users, roles, and active keys.

Keys

Machine access

Issue live and test keys per workspace. Reveal once, scope tightly, rotate cleanly.

Usage

Metered cleanly

Requests and quotas roll up at the workspace level, not the browser session.

Billing

Invoice ready

Plans, invoices, payment methods, and cancellation belong in a billing portal.

The public rollout recommendation lives in /docs/access_model.md.

Read access model

Data contract

Small surface. Explicit behavior.

Two clocks

acceptedAt and marketAvailableAt stay first-class.

Restatements stay explicit

latest and original are controls, not hidden assumptions.

Mapping stays visible

/concepts exposes metrics, derivations, units, and source tags directly.

Stable endpoints

The current public surface.

GET/fundamentals

Point-in-time numerical facts with period, cutoff, availability, and versioning controls.

GET/periods

Filing-period discovery with amendment linkage and PIT ticker resolution.

GET/concepts

Canonical concept catalog with derivation rules and taxonomy links.

GET/health

Service status, storage information, and active table counts.