# SEC EDGAR XBRL Fundamentals Lookup

> SEC EDGAR XBRL Fundamentals Lookup is a paid API for AI agents from x402-datashop-production.up.railway.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Retrieves as-filed XBRL financial facts for any SEC-registered company from the EDGAR companyconcept API, grouped by unit with period and filing metadata.

## Facts

- Endpoint: GET https://x402-datashop-production.up.railway.app/v1/us/sec-fundamentals
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sec-edgar-xbrl-fundamentals-lookup-5480bf6f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HGBSXHAodlvAfI9w9bT7T

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-fundamentals-lookup-5480bf6f
```

Example prompt: Pull the 10 most recent Revenues figures (us-gaap) from SEC EDGAR for Apple — their CIK is 320193.

## When to prefer this

Use this endpoint when you need official, as-filed financial fundamentals for any SEC-registered public company, tied directly to specific SEC filings with form type and date provenance. Prefer this over market data APIs when you need audited, filed figures rather than estimated or consensus data, or when you need historical per-filing granularity with XBRL taxonomy precision.

## Known failure modes

- Invalid or unknown CIK returns an error or empty result
- Unrecognized XBRL tag (e.g. misspelled concept) returns no facts
- Limit out of range (>40 or <1) may return an error or be clamped
- Company has not filed XBRL data for the requested concept (older filers or certain form types)
- Taxonomy mismatch (using us-gaap tag with dei taxonomy) returns empty results
- EDGAR upstream API downtime causes 502/503 responses; 12h cache may serve stale data

## How this service works

As-filed XBRL fundamentals for any SEC-registered company, straight from the EDGAR companyconcept API (updated as filings are accepted). Query: ?cik=320193 (Apple) &tag=Revenues|Assets|NetIncomeLoss|EntityCommonStockSharesOutstanding... &taxonomy=us-gaap|dei (default us-gaap) &limit=N most recent facts per unit (1-40, default 8). Each fact carries period, value, fiscal year/period, form type and filing date, grouped by unit (USD, shares...). Served with a 12h cache.

## Output

An array of financial facts grouped by reporting unit (e.g. USD, shares), each containing: the numeric value, the reporting period (start/end dates), fiscal year and period, SEC form type (10-K, 10-Q, etc.), and the filing date. Results are limited to the N most recent facts per unit as specified.

## 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": [
      "cik",
      "tag"
     ],
     "properties": {
      "cik": {
       "type": "string",
       "description": "SEC Central Index Key, 1-10 digits (e.g. 320193 = Apple)"
      },
      "tag": {
       "type": "string",
       "description": "XBRL concept, e.g. Revenues, Assets, NetIncomeLoss"
      },
      "limit": {
       "type": "string",
       "default": "8",
       "description": "Most recent facts per unit (1-40)"
      },
      "taxonomy": {
       "enum": [
        "us-gaap",
        "dei"
       ],
       "type": "string",
       "default": "us-gaap"
      }
     }
    }
   },
   "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-fundamentals-lookup-5480bf6f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-datashop-production.up.railway.app](https://www.zero.xyz/host/x402-datashop-production.up.railway.app/llms.txt)