XBRL Growth and CAGR API: Annual XBRL metrics with YoY change and 3y/5y CAGR precomputed — SEC XBRL
Annual XBRL metrics with YoY change and 3y/5y CAGR precomputed per company — revenue, earnings, assets and more. Skips period alignment, restatement duplicates and the growth math.
$0.05 per call — pay with prepaid card credits (Authorization: Bearer ck_live_…, packs from $1) or with USDC over x402: call it, get 402 with the price, retry signed. Failed calls are never charged.
How do you call it?
GET /v1/sec/xbrl/growth — product id
sec_xbrl_growth. Over MCP, call answerpool_get with
product_id=sec_xbrl_growth.
curl "https://answerpool.io/v1/sec/xbrl/growth?ticker=NVDA"
# with a prepaid credit key
curl -H "Authorization: Bearer ck_live_..." "https://answerpool.io/v1/sec/xbrl/growth?ticker=NVDA"
Live call: https://answerpool.io/v1/sec/xbrl/growth?ticker=NVDA · JSON sample: /v1/samples/sec_xbrl_growth
What does the answer look like?
A representative response, the same static sample served at /v1/samples/sec_xbrl_growth.
as_of | 2026-09-03T14:00:00Z |
|---|---|
cik | 0001045810 |
unavailable | (empty) |
method | sec_xbrl_growth_rules_v1 |
note | Annual (10-K) XBRL points only, deduplicated per fiscal year end; CAGR needs the full span or it is null. Reported figures as filed, not restated. |
disclaimer | Derived from public SEC EDGAR filings; not investment advice. |
refresh_after | 2026-09-17T11:15:00.000Z |
metrics
| metric | tag | unit | latest_value | latest_period_end | years_covered | growth_1y_pct | cagr_3y_pct | cagr_5y_pct | annual_points |
|---|---|---|---|---|---|---|---|---|---|
| revenue | RevenueFromContractWithCustomerExcludingAssessedTax | USD | 130497000000.0 | 2025-01-26 | 6 | 114.2 | 69.4 | 55.1 | {"period_end":"2025-01-26","value":130497000000.0,"change_pct":114.2} |
The same sample as raw JSON
{
"as_of": "2026-09-03T14:00:00Z",
"cik": "0001045810",
"metrics": [
{
"metric": "revenue",
"tag": "RevenueFromContractWithCustomerExcludingAssessedTax",
"unit": "USD",
"latest_value": 130497000000.0,
"latest_period_end": "2025-01-26",
"years_covered": 6,
"growth_1y_pct": 114.2,
"cagr_3y_pct": 69.4,
"cagr_5y_pct": 55.1,
"annual_points": [
{
"period_end": "2025-01-26",
"value": 130497000000.0,
"change_pct": 114.2
}
]
}
],
"unavailable": [],
"method": "sec_xbrl_growth_rules_v1",
"note": "Annual (10-K) XBRL points only, deduplicated per fiscal year end; CAGR needs the full span or it is null. Reported figures as filed, not restated.",
"disclaimer": "Derived from public SEC EDGAR filings; not investment advice.",
"refresh_after": "2026-09-17T11:15:00.000Z"
}How fresh is it, and where does the data come from?
The fastest source behind this answer can change every 15 minutes, so every response carries a refresh_after timestamp — right now it would be 2026-09-17T11:15:00.000Z. Schedule the next call on that value rather than on a guess.
- SEC EDGAR (US federal public domain) — upstream:
https://efts.sec.gov
Method version 0.1.0 ·
serving cache 1 day ·
every response carries a result_id you can resolve at
/v1/provenance.
When should you use it?
You need multi-year growth rates for one company from filed figures.
What you skip building
- companyfacts JSON wrangling
- period alignment
- CAGR arithmetic
- restatement duplicates
When should you not use it?
A single metric's raw points (/v1/sec/xbrl/concept, free) or a cross-company snapshot (/v1/sec/xbrl/compare).
Where else can you find this?
- Catalog entry (JSON, free)
- OpenAPI schema — input and output types, prices, the 402 flow
- llms.txt — every product in one plain-text document