# SEC EDGAR XBRL Concept Time Series

> SEC EDGAR XBRL Concept Time Series is a paid API for AI agents from sec-edgar-data.frcompanycheck.workers.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-12).

Retrieves a time series of XBRL financial concept values (e.g. NetIncomeLoss, Revenue) for a given company CIK from SEC EDGAR filings

## Facts

- Endpoint: GET https://sec-edgar-data.frcompanycheck.workers.dev/v1/sec/concept/%7Bid%7D/%7Btag%7D?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sec-edgar-xbrl-concept-time-series-3e4718be
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hdibJq7h0e3BGU4jrZDUv

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 sec-edgar-xbrl-concept-time-series-3e4718be
```

Example prompt: Can you pull the full history of Apple's net income from SEC EDGAR filings? Apple's CIK is 320193 and the XBRL concept is us-gaap:NetIncomeLoss.

## When to prefer this

Choose this endpoint when you need structured time-series data for a specific XBRL financial concept (e.g. net income, revenue, EPS) for a specific public company, identified by CIK. It is ideal for investment research, financial modeling, or building charts of fundamental metrics over time. It requires no API key or account — only a USDC micropayment per call — making it well-suited for AI agents operating autonomously. Prefer this over scraping SEC HTML pages or using paid financial data vendors when you want raw, source-of-truth XBRL data directly from the regulator's database at low cost.

## Known failure modes

- Unknown CIK — company not found in EDGAR returns an error (not charged)
- Invalid or unsupported XBRL tag returns an error (not charged)
- Company has no XBRL data for the requested concept (empty values array)
- SEC EDGAR upstream rate limit or temporary unavailability
- Malformed tag format (missing namespace prefix like us-gaap:)

## How this service works

SEC EDGAR data for AI agents, paid per call in USDC via x402 (no account, no API key): ticker/CIK lookup, company profiles, recent filings (10-K, 10-Q, 8-K, Form 4…) with document links, key annual XBRL fundamentals and any XBRL concept time series. Public SEC data, cached, fetched under SEC fair-access rules. Errors are never charged.

## Output

Returns a JSON object containing the company CIK, the XBRL concept tag requested, the unit of measure (e.g. USD, shares), and an array of reported values each with a start date, end date, filing form type (10-K, 10-Q, etc.), and the numeric value reported in that period.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "cik": 320193,
  "tag": "us-gaap:NetIncomeLoss",
  "unit": "USD",
  "values": [
   {
    "end": "2025-09-27",
    "form": "10-K",
    "start": "2024-09-29",
    "value": 112010000000
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sec-edgar-xbrl-concept-time-series-3e4718be/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from sec-edgar-data.frcompanycheck.workers.dev](https://www.zero.xyz/host/sec-edgar-data.frcompanycheck.workers.dev/llms.txt)
