# NetNest Design SEC Financial History API

> NetNest Design SEC Financial History API is a paid API for AI agents from api.netnestdesign.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-29).

Returns the historical time series of a single financial metric (e.g. revenue, net income, EPS, cash flow) from SEC filings for a given ticker, newest first, with up to 200 periods by year, quarter, or TTM.

## Facts

- Endpoint: GET https://api.netnestdesign.com/v1/history/:ticker/:metric?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/netnest-design-sec-financial-history-api-4715fc92
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lv1GoS_kEe3xkTD0oxd7k

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability netnest-design-sec-financial-history-api-4715fc92
```

Example prompt: Pull the full quarterly revenue history for Apple (AAPL) from SEC filings — I want all available periods going back as far as possible, with the filing dates and links to each 10-Q or 10-K.

## When to prefer this

Choose this endpoint when you need a time-series history of a single financial metric for a publicly traded US company, rather than the latest snapshot. It is ideal for trend analysis, charting, modeling, or backtesting where multiple periods and SEC provenance links are required. Prefer it over snapshot endpoints when the user asks about 'history', 'trend', 'over time', or 'all quarters/years'.

## Known failure modes

- Invalid or unknown ticker symbol returns an error or empty result
- Unsupported metric name returns an error
- Ticker exists but has fewer than the requested periods (returns what is available)
- Delisted or very small companies may have incomplete filing history
- Network timeout on large history requests (200 periods)

## How this service works

Financial history of one metric from SEC filings, newest first: revenue history, net income history, EPS history, cash flow history and more, by year, quarter or trailing twelve months. Up to 200 periods, each with its 10-K or 10-Q, filing date and SEC link.

## Output

An ordered list of up to 200 historical data points for the requested metric, each including the period label (year, quarter, or TTM), the metric value, the filing type (10-K or 10-Q), the filing date, and a direct link to the SEC filing. Data is returned newest first.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/netnest-design-sec-financial-history-api-4715fc92/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.netnestdesign.com](https://www.zero.xyz/host/api.netnestdesign.com/llms.txt)