# EDGAR XBRL Frame — Cross-Sectional Financial Data for All US Public Companies

> EDGAR XBRL Frame — Cross-Sectional Financial Data for All US Public Companies is a paid API for AI agents from agent402.tools, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Returns a cross-sectional slice of a single XBRL financial concept (e.g. Revenues, Assets) for every US public company that reported it in a given period, sourced from SEC EDGAR's frames API.

## Facts

- Endpoint: GET https://agent402.tools/api/edgar-xbrl-frame
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/edgar-xbrl-frame-cross-sectional-financial-data-for-all-us-public-6acacf84
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yPgKLv_PIDaSzCAmVWyTT

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 edgar-xbrl-frame-cross-sectional-financial-data-for-all-us-public-6acacf84
```

Example prompt: Pull every US public company's Revenues in USD for CY2023Q1 from SEC EDGAR XBRL frames — I want to screen the full universe, up to 500 companies.

## When to prefer this

Use this endpoint when you need a cross-sectional, universe-wide snapshot of a single XBRL financial concept across all US public companies for a specific period — ideal for factor screens, peer comparisons, and quantitative research. Prefer this over company-specific EDGAR endpoints when you need market-wide data rather than drilling into a single issuer.

## Known failure modes

- Invalid or misspelled XBRL tag returns empty or 404 response
- Unsupported period format causes a 400 or empty result
- Unit mismatch (e.g. using 'USD' for a shares-based tag) returns no data
- Period with no filers returns an empty array
- Limit out of range (below 1 or above 2000) may return error or be clamped
- Taxonomy other than 'us-gaap' may not be supported or return sparse data

## How this service works

All US public companies that reported a given XBRL tag for a given period, in one call. Killer endpoint for cross-sectional screens: 'every issuer's Revenues for CY2023Q1' or 'every issuer's Assets as of CY2023Q4I (instantaneous)'. Period format: CY{YYYY} (annual), CY{YYYY}Q{1-4} (quarterly), or CY{YYYY}Q{1-4}I (instantaneous balance-sheet items). Source: data.sec.gov/api/xbrl/frames. ?taxonomy=us-gaap&tag=Revenues&unit=USD&period=CY2023Q1

## Output

A list of up to 2000 company records, each containing the company's CIK, name, reported XBRL value, unit, and the specific period covered — representing every US public filer that reported the requested concept in that period.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "tag",
      "unit",
      "period"
     ],
     "properties": {
      "tag": {
       "type": "string",
       "description": "XBRL concept tag, e.g. \"Revenues\", \"Assets\""
      },
      "unit": {
       "type": "string",
       "description": "Unit of measure, e.g. \"USD\", \"shares\", \"USD/shares\""
      },
      "limit": {
       "type": "number",
       "description": "Max companies to return, 1-2000 (default 200)"
      },
      "period": {
       "type": "string",
       "description": "CY{YYYY} (annual), CY{YYYY}Q{1-4} (quarterly), or CY{YYYY}Q{1-4}I (instantaneous balance-sheet)"
      },
      "taxonomy": {
       "type": "string",
       "description": "XBRL taxonomy, default \"us-gaap\""
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "taxonomy",
      "tag",
      "ccp",
      "uom",
      "label",
      "totalCompanies",
      "returned",
      "truncated",
      "data"
     ],
     "properties": {
      "ccp": {
       "type": "string"
      },
      "tag": {
       "type": "string"
      },
      "uom": {
       "type": "string"
      },
      "data": {
       "type": "array",
       "items": {
        "type": "object"
       }
      },
      "label": {
       "type": "string"
      },
      "returned": {
       "type": "integer"
      },
      "taxonomy": {
       "type": "string"
      },
      "truncated": {
       "type": "boolean"
      },
      "totalCompanies": {
       "type": "integer"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ccp": "CY2023Q1",
  "tag": "Revenues",
  "uom": "USD",
  "data": [
   {
    "cik": 320193,
    "end": "2023-04-01",
    "loc": "US-CA",
    "val": 94836000000,
    "accn": "0000320193-23-000064",
    "entityName": "Apple Inc."
   }
  ],
  "label": "Revenues",
  "returned": 1,
  "taxonomy": "us-gaap",
  "truncated": true,
  "totalCompanies": 1872
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/edgar-xbrl-frame-cross-sectional-financial-data-for-all-us-public-6acacf84/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)