# x402stock Company Facts (SEC EDGAR)

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

Retrieves structured SEC EDGAR financial fact data for a public US company by ticker symbol, searchable by taxonomy and keyword.

## Facts

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

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-company-facts-sec-edgar-d5493cfc
```

Example prompt: Pull the latest SEC EDGAR facts for Apple (AAPL) related to revenue — search for 'revenue' within the us-gaap taxonomy and return up to 10 results.

## When to prefer this

Use this endpoint when you need structured, auditable financial data directly from SEC EDGAR XBRL filings — ideal for retrieving specific accounting line items (revenue, net income, assets) by GAAP/IFRS tag, verifying reported figures from official filings, or building financial analysis on top of regulatory disclosures. Prefer this over market data endpoints when you need filing-sourced figures rather than real-time prices.

## Known failure modes

- Invalid or unknown ticker returns an empty result or 404
- No facts matching the search/taxonomy filter returns count 0 and empty facts array
- Ticker for a non-SEC-registered entity (e.g. foreign company not cross-listed) may return no data
- Payment failure via x402/USDC results in 402 response before data is returned
- limit parameter out of range (<=0 or >500) returns a validation error

## 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

A JSON object containing the company's CIK, entity name, ticker, data source (sec_edgar), as-of timestamp, and an array of matching financial facts — each with XBRL tag, taxonomy, human-readable label, unit, latest reported value, filing form type, fiscal year, fiscal period, period end date, and filed date.

## 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": [
      "limit"
     ],
     "properties": {
      "limit": {
       "type": "integer",
       "default": 50,
       "maximum": 500,
       "exclusiveMinimum": 0
      },
      "search": {
       "type": "string"
      },
      "taxonomy": {
       "type": "string"
      }
     },
     "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": [
        "entity_name",
        "cik",
        "taxonomy",
        "search",
        "total_facts",
        "count",
        "facts"
       ],
       "properties": {
        "cik": {
         "type": "string"
        },
        "count": {
         "type": "number"
        },
        "facts": {
         "type": "array",
         "items": {
          "type": "object",
          "required": [
           "tag",
           "taxonomy",
           "label",
           "unit",
           "latest_value",
           "end",
           "fiscal_year",
           "fiscal_period",
           "form",
           "filed"
          ],
          "properties": {
           "end": {
            "type": "string"
           },
           "tag": {
            "type": "string"
           },
           "form": {
            "type": "string"
           },
           "unit": {
            "anyOf": [
             {
              "type": "string"
             },
             {
              "type": "null"
             }
            ]
           },
           "filed": {
            "type": "string"
           },
           "label": {
            "anyOf": [
             {
              "type": "string"
             
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "cik": "0000320193",
   "count": 1,
   "facts": [
    {
     "end": "2026-03-28",
     "tag": "RevenueFromContractWithCustomerExcludingAssessedTax",
     "form": "10-Q",
     "unit": "USD",
     "filed": "2026-05-01",
     "label": "Revenue from Contract with Customer, Excluding Assessed Tax",
     "taxonomy": "us-gaap",
     "fiscal_year": 2026,
     "latest_value": 111184000000,
     "fiscal_period": "Q2"
    }
   ],
   "search": "revenue",
   "taxonomy": "us-gaap",
   "entity_name": "Apple Inc.",
   "total_facts": 12
  },
  "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-company-facts-sec-edgar-d5493cfc/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)