SEC API
Factor Data API
Factor returns, history, valuations, extreme moves, portfolio attribution, hedging, optimization, and model analysis through one API surface. Built for agents and applications that need compact payloads, proof-gated freshness, and factor workflows that are ready to wire into portfolio and model products.
Try it now
One curl to see it work.
curl "https://api.secapi.ai/v1/factors/history/VALUE?range=1y&response_mode=compact&include=series,trust" \
-H "x-api-key: $SECAPI_API_KEY" \
-H "secapi-version: 2026-03-19"Capabilities
Built for factor workflows, not just raw returns.
Factor History
Single-factor 1D through MAX windows with row-level history metadata, summary windows, and compact chart/table payloads.
Extreme Moves And Pairs
Find unusual factor moves and pair divergences for homepage, dashboard, alerting, and agent-monitor workflows.
Valuation Signals
Use factor valuations and valuation-stock drilldowns to find opportunity sets through the lens of style, sector, and industry factors.
Portfolio Attribution
Explain submitted holdings with factor exposures, contributions, alpha, benchmark context, and compact trust metadata.
Hedge And Optimizer
Generate bounded hedge candidates and optimizer outputs for factor-neutral, drawdown-aware, and regime-aware workflows.
Agent-Native Interfaces
Use the same workflow through REST, generated SDKs, CLI commands, and hosted MCP tools with compact defaults.
Launch contract
Claims stay tied to proof, not aspiration.
The launch factor surface is centered on U.S. market, style, sector, and industry workflows. Public 2015+ history claims apply to non-exempt launch-core factors and are gated on returned coverage, freshness, model version, and methodology metadata for the factor being requested. `EARNINGS_REVISIONS` is explicitly short-history exempt in the launch proof.
- Use `response_mode=compact` for agent and UI defaults.
- Add `include=series` when a chart or table needs the full series.
- Add `include=trust` when the answer cites freshness, methodology, materialization, or degraded-state details.
Launch proof
Factor claims are tied to dated proof artifacts.
Launch-core factor count, non-exempt history depth, short-history exemptions, and freshness claims are derived from the live ClickHouse metadata proof artifact and guarded by market-calendar-aware validation.
coverage
Launch-core factor keys with proof
Public factor keys that pass the launch metadata proof gate for coverage, freshness, model/version metadata, and methodology URL.
| Provider | Value | Notes |
|---|---|---|
| SEC API | 49 keys | 49 / 49 ready |
coverage
Non-exempt factor history market-day coverage
Market-calendar sessions covered by the checked-in launch proof from the 2015 launch floor through the latest complete market day for non-exempt launch-core factors.
| Provider | Value | Notes |
|---|---|---|
| SEC API | 2,876 market days | 2015-01-02 through 2026-06-11; EARNINGS_REVISIONS is short-history exempt |
freshness
Factor latest-market-day lag
Maximum market-day lag across launch-core factors in the live ClickHouse metadata proof artifact.
| Provider | Value | Notes |
|---|---|---|
| SEC API | 0 market days | latest complete market day |
Developer paths
Wire the surface where your application already lives.
Migrate from FactorsToday
Map factor-history, valuation, portfolio, optimizer, dashboard, and bulk-download workflows onto SEC API endpoints.
Factor quickstart
Copy REST, SDK, CLI, and MCP examples for history, valuations, portfolio analysis, and optimizer workflows.
Factor API reference
Open the generated operation pages for catalog, returns, history, sparklines, extremes, valuations, exposures, and bulk downloads.
Portfolio API reference
Use submitted holdings for analysis, attribution, hedging, optimization, and stress testing.
Start building
Get started with 250 included calls, then pay as you go. No card required to begin.