# SEC EDGAR XBRL Concept Time-Series

> SEC EDGAR XBRL Concept Time-Series is a paid API for AI agents from api.agentstools.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns a cited time-series of values for a single financial line-item (e.g. revenue, net income) from SEC EDGAR XBRL filings, for a given company and concept.

## Facts

- Endpoint: GET https://api.agentstools.dev/edgar/concept
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sec-edgar-xbrl-concept-time-series-6ebe475a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_iU48wgxOWkAJzbgmFXdQ_

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-6ebe475a
```

Example prompt: Pull the last 8 annual revenue figures for Apple (ticker AAPL) from SEC EDGAR XBRL filings, each cited to its source filing.

## When to prefer this

Use this endpoint when you need a clean, cited time-series for a specific financial line-item (e.g. revenue, net income, EPS) for a single company directly from SEC EDGAR XBRL data, especially when you need filing-level citations and normalized values. Prefer over full financial statement endpoints when you only need one concept. Better than scraping investor relations pages or using aggregator APIs when SEC-cited provenance is required.

## Known failure modes

- Unknown ticker or CIK returns 404 or empty result
- Unrecognized concept name returns error or no data
- Company has no XBRL filings (e.g. foreign private issuers) returns empty
- Requesting more than 12 periods returns validation error
- Missing required concept parameter returns 400 bad request

## How this service works

Cited time-series for a single financial line-item from SEC EDGAR XBRL. Give a ticker or CIK plus a concept (a canonical name like revenue or netIncome, or a raw us-gaap tag) and get the normalized period values, each cited to its filing. Cheap granular pull.

## Output

A time-series array of normalized period values for the requested financial concept, each entry annotated with its source SEC filing citation (accession number, form type, period of report), covering up to 12 recent annual or quarterly periods.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "concept"
     ],
     "properties": {
      "cik": {
       "type": "string",
       "description": "SEC EDGAR CIK, any zero-padding accepted"
      },
      "freq": {
       "enum": [
        "annual",
        "quarterly"
       ],
       "type": "string",
       "description": "Reporting frequency, default annual"
      },
      "ticker": {
       "type": "string",
       "description": "Stock ticker symbol, e.g. AAPL"
      },
      "concept": {
       "type": "string",
       "description": "Canonical line name like revenue, or a raw us-gaap tag"
      },
      "periods": {
       "type": "integer",
       "maximum": 12,
       "minimum": 1,
       "description": "Number of recent periods to return, default 8"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

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