# x402stock SEC EDGAR Concept Data API

> x402stock SEC EDGAR Concept Data API is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-08).

Retrieves historical SEC EDGAR financial concept (XBRL taxonomy tag) time-series data for a given stock ticker, such as revenue or earnings reported in 10-K/10-Q filings.

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/concept/%7Bticker%7D
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-08
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-sec-edgar-concept-data-api-7c33f2f5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZE7u4uYKAkhRR6NgrRU0t

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 x402stock-sec-edgar-concept-data-api-7c33f2f5
```

Example prompt: Pull the historical revenue series for AAPL from SEC EDGAR using the us-gaap taxonomy, limiting to the 8 most recent periods — I want to see what Apple reported each quarter.

## When to prefer this

Use this endpoint when you need structured, historical financial statement data (XBRL concepts) directly sourced from SEC EDGAR filings — ideal for fundamental analysis, financial modeling, or auditing reported figures for US public companies. Prefer this over market data endpoints when you need the actual reported accounting values (revenue, EPS, net income, assets) across fiscal periods rather than real-time prices or estimates.

## Known failure modes

- Invalid or unknown ticker returns empty series or 404
- Requested XBRL tag does not exist for the given taxonomy — returns empty data
- taxonomy parameter set to unsupported value — may return error or empty result
- limit exceeds maximum of 100 — returns validation error
- Ticker has no SEC filings (non-US or private company) — returns no data
- Payment failure via x402/USDC results in 402 response blocking data access

## How this service works

Pay-per-call market and economic data API for AI agents: US stocks, ETFs and options, forex, crypto and on-chain perps, energy commodities, US and global macro (Fed, CPI, jobs, GDP, Treasury, World Bank), SEC filings, congressional trades, and market sentiment. No API keys, no accounts. Pay per request in USDC via x402 on Base.

## Output

Returns a JSON object with the ticker, source (sec_edgar), as-of timestamp, and a data object containing the XBRL tag name, taxonomy, human-readable label, unit (e.g. USD), count of data points, and an array of time-series entries each with value, start/end dates, fiscal year, fiscal period, SEC form type, filing date, frame, and accession number.

## 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",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "taxonomy",
      "limit"
     ],
     "properties": {
      "tag": {
       "type": "string"
      },
      "limit": {
       "type": "integer",
       "default": 8,
       "maximum": 100,
       "exclusiveMinimum": 0
      },
      "taxonomy": {
       "type": "string",
       "default": "us-gaap"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "ticker",
      "data",
      "source",
      "as_of"
     ],
     "properties": {
      "data": {
       "type": "object",
       "required": [
        "tag",
        "taxonomy",
        "label",
        "unit",
        "count",
        "series"
       ],
       "properties": {
        "tag": {
         "type": "string"
        },
        "unit": {
         "anyOf": [
          {
           "type": "string"
          },
          {
           "type": "null"
          }
         ]
        },
        "count": {
         "type": "number"
        },
        "label": {
         "anyOf": [
          {
           "type": "string"
          },
          {
           "type": "null"
          }
         ]
        },
        "series": {
         "type": "array",
         "items": {
          "type": "object",
          "required": [
           "value",
           "start",
           "end",
           "fiscal_year",
           "fiscal_period",
           "form",
           "filed",
           "frame",
           "accession"
          ],
          "properties": {
           "end": {
            "type": "string"
           },
           "form": {
            "type": "string"
           },
           "filed": {
            "type": "string"
           },
           "frame": {
            "anyOf":
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "tag": "RevenueFromContractWithCustomerExcludingAssessedTax",
   "unit": "USD",
   "count": 1,
   "label": "Revenue from Contract with Customer, Excluding Assessed Tax",
   "series": [
    {
     "end": "2026-03-28",
     "form": "10-Q",
     "filed": "2026-05-01",
     "frame": "CY2026Q1",
     "start": "2025-12-28",
     "value": 111184000000,
     "accession": "0000320193-26-000013",
     "fiscal_year": 2026,
     "fiscal_period": "Q2"
    }
   ],
   "taxonomy": "us-gaap"
  },
  "as_of": "2026-05-01T00:00:00.000Z",
  "source": "sec_edgar",
  "ticker": "AAPL"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-sec-edgar-concept-data-api-7c33f2f5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402stock.xyz](https://www.zero.xyz/host/x402stock.xyz/llms.txt)