# 2s XBRL Frames — SEC EDGAR Cross-Company Financial Data

> 2s XBRL Frames — SEC EDGAR Cross-Company Financial Data is a paid API for AI agents from 2s.io, paid per call via x402, $0.00216/call, status unknown (last checked 2026-09-16).

Retrieves cross-company XBRL financial data for a given concept and period from SEC EDGAR, returning values ranked across all public filers.

## Facts

- Endpoint: GET https://2s.io/api/finance/xbrl-frames
- Price: $0.00216/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-xbrl-frames-sec-edgar-cross-company-financial-data-bafb2d16
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_z6-p8tnGZoQBcSzU63fEk

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 2s-xbrl-frames-sec-edgar-cross-company-financial-data-bafb2d16
```

Example prompt: Pull the top 25 US public companies by Revenues for annual period CY2023 in USD from SEC EDGAR XBRL frames, sorted descending.

## When to prefer this

Use this endpoint when you need cross-company financial benchmarking data directly from SEC EDGAR XBRL frames — e.g. ranking all public companies by a standard accounting concept (Revenues, Assets, NetIncomeLoss) for a specific annual or quarterly period. Prefer this over company-specific filing endpoints when you want population-level data across hundreds or thousands of filers in a single call.

## Known failure modes

- Invalid or unknown XBRL tag returns empty items array or error
- Unsupported period format (e.g. malformed CY string) causes bad request
- Unit mismatch (e.g. requesting shares for a USD-only concept) returns no results
- Limit out of range (outside 1–100) may cause validation error
- Taxonomy value other than 'us-gaap' or 'dei' may return no results
- SEC EDGAR upstream unavailability causes error or stale data

## How this service works

SEC EDGAR XBRL Frames — one financial concept reported by every public filer for a single period, for cross-company screening and comparison. Give an XBRL tag (e.g. Revenues, NetIncomeLoss, Assets), a unit (default USD), and a period (CY2023 for annual, CY2023Q1 for a quarter, CY2023Q4I for instant balance-sheet items), and get back every filer's value — company name, CIK, location, period start/end, and the reported value — sorted high to low (or asc). Returns the total filer count and the top N. Free, public-domain (SEC). Distinct from finance.company-facts (one company, many metrics): this is one metric across all companies. For ranking, peer comparison, and market-wide analysis.

## Output

Returns a ranked list of up to 100 public companies with their reported XBRL concept value (e.g. Revenues), CIK, entity name, reporting period start/end dates, accession number, and state location — plus metadata about the concept label, unit, period, and total number of filers.

## 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",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "required": [
      "tag",
      "period"
     ],
     "properties": {
      "tag": {
       "type": "string",
       "description": "XBRL concept, e.g. Revenues, NetIncomeLoss, Assets."
      },
      "sort": {
       "enum": [
        "desc",
        "asc"
       ],
       "type": "string",
       "description": "Sort by value (default desc)."
      },
      "unit": {
       "type": "string",
       "description": "Unit (default USD; e.g. USD-per-shares, shares)."
      },
      "limit": {
       "type": "integer",
       "description": "Max companies (1-100, default 25)."
      },
      "period": {
       "type": "string",
       "description": "CY2023 (annual), CY2023Q1 (quarter), CY2023Q4I (instant)."
      },
      "taxonomy": {
       "type": "string",
       "description": "Taxonomy (default us-gaap; or dei)."
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-xbrl-frames-sec-edgar-cross-company-financial-data-bafb2d16/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)