# AnswerPool XBRL Frame

> AnswerPool XBRL Frame is a paid API for AI agents from answerpool.io, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Rank all SEC filers on a single XBRL financial metric for a given period, returning top-N entity values and the total filer count.

## Facts

- Endpoint: GET https://answerpool.io/v1/sec/xbrl/frame
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/answerpool-xbrl-frame-4b1b1456
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_C2r21joUBr1KIaHtQvBSm

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 answerpool-xbrl-frame-4b1b1456
```

Example prompt: Pull the top 50 SEC filers ranked by Revenues for CY2024Q1 — I want entity names, their reported values, and the total number of filers that reported that metric.

## When to prefer this

Use this endpoint when you need a whole-market financial ranking on a single XBRL metric without building or maintaining a bulk XBRL data pipeline. It is ideal for market screening, competitive benchmarking, and sector analysis where you want to see how all SEC filers stack up on one standardized financial concept for a specific calendar period. Prefer it over company-specific XBRL endpoints when the goal is cross-company comparison rather than deep-diving a single filer.

## Known failure modes

- Invalid metric name returns an error or empty result if no XBRL tag matches
- Invalid period format (must match CY####, CY####Q#, or CY####Q#I) returns a validation error
- Period with no available XBRL frame data returns empty top array
- Limit outside 1–200 range returns a validation error
- Payment failure (x402) blocks the request if USDC funds are insufficient
- SEC EDGAR frames API lag may mean very recent periods return no data yet

## How this service works

AnswerPool turns SEC EDGAR, the Federal Register, USAspending, NIH, BLS and OpenAlex into structured JSON answers that AI agents and developers fetch in one call. 69 endpoints free, no account; derived analyses $0.02–$0.05 per call by card credits or USDC (x402). MCP server, full provenance.

## Output

Returns a JSON object containing the XBRL tag name, the requested metric slug, the period, an as-of timestamp, the total number of filers that reported the metric, and an array of top-N rows each with the company's CIK, entity name, and reported numeric value. Also includes a disclaimer noting the data is derived from public SEC EDGAR filings.

## 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",
     "title": "FrameIn",
     "required": [
      "metric",
      "period"
     ],
     "properties": {
      "limit": {
       "type": "integer",
       "title": "Limit",
       "default": 50,
       "maximum": 200,
       "minimum": 1,
       "description": "Number of filers to return, ranked by reported value descending; total_filers reports the full population. Default 50."
      },
      "metric": {
       "type": "string",
       "title": "Metric",
       "maxLength": 120,
       "description": "Required metric key from /v1/sec/xbrl/metrics (e.g. revenue) or a raw US-GAAP XBRL concept as us-gaap:<Tag>; one tag is queried across all filers."
      },
      "period": {
       "type": "string",
       "title": "Period",
       "pattern": "^CY\\d{4}(Q[1-4])?I?$",
       "maxLength": 12,
       "description": "e.g. CY2025, CY2025Q1, CY2025Q1I"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tag": "Revenues",
  "top": [
   {
    "cik": "0000320193",
    "value": 94000000000,
    "entity": "Apple Inc."
   }
  ],
  "as_of": "2026-08-31T14:00:00Z",
  "metric": "revenue",
  "period": "CY2025Q1",
  "total_filers": 4000
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/answerpool-xbrl-frame-4b1b1456/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from answerpool.io](https://www.zero.xyz/host/answerpool.io/llms.txt)