# Heurist Mesh: SEC XBRL Fact Trends

> Heurist Mesh: SEC XBRL Fact Trends is a paid API for AI agents from mesh.heurist.xyz, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-15).

Returns quarterly or annual SEC XBRL financial fact observations for a specific metric and issuer, supporting plain-English or exact XBRL concept names.

## Facts

- Endpoint: POST https://mesh.heurist.xyz/x402/solana/agents/SecEdgarAgent/xbrl_fact_trends
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/heurist-mesh-sec-xbrl-fact-trends-60f8acde
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_j8KKiPBzq5Nlki-E-Re6R

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 heurist-mesh-sec-xbrl-fact-trends-60f8acde -d '<json body>'
```

Example prompt: Pull the quarterly revenue trend for Apple from SEC EDGAR XBRL filings — I want to see how it's changed over recent periods.

## When to prefer this

Use this endpoint when you need structured, audited financial fact data directly from SEC EDGAR XBRL filings for US public companies. Prefer this over third-party financial data APIs when regulatory accuracy and traceability to official filings matter, or when you need to support both plain-English metric names and precise XBRL concept names. Not suited for real-time price data or non-US issuers.

## Known failure modes

- Unknown or unsupported metric name returns an error or empty result
- Company not found if ticker or name is ambiguous or not a public SEC filer
- No data available for very recent periods not yet filed with SEC
- XBRL concept name typo results in no matching observations
- Rate limiting or payment failure if USDC balance is insufficient

## How this service works

Return quarterly or annual SEC XBRL fact observations for one metric and one issuer. Accepts plain-English metric names or exact XBRL concept names. See the metric parameter for supported values.

## Output

Returns a structured list of XBRL fact observations for the requested metric and issuer, including reported values, fiscal period labels (e.g. Q1 2023, FY2022), filing dates, and units of measurement, sourced directly from SEC EDGAR XBRL data.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "query",
      "metric"
     ],
     "properties": {
      "unit": {
       "type": "string",
       "description": "Optional exact SEC unit key for the selected concept. Common examples include 'USD', 'shares', 'USD/shares', and 'pure', but available units depend on the matched metric. Omit to auto-select the unit with the most observations."
      },
      "debug": {
       "type": "boolean",
       "default": false,
       "description": "Debug mode flag. ALWAYS use false."
      },
      "limit": {
       "type": "integer",
       "default": 8,
       "description": "Maximum number of observations to return."
      },
      "query": {
       "type": "string",
       "description": "Company name, ticker, or CIK."
      },
      "metric": {
       "type": "string",
       "description": "Plain-English metric name (e.g. 'revenue', 'net income', 'eps', 'cash', 'assets') or exact XBRL concept name (e.g. 'NetIncomeLoss'). One metric per call."
      },
      "taxonomy": {
       "enum": [
        "us-gaap",
        "dei"
       ],
       "type": "string",
       "description": "Optional taxonomy filter."
      },
      "frequency": {
       "enum": [
        "quarterly",
        "annual",
        "all"
       ],
       "type": "string",
       "default": "quarterly",
       "description": "Observation frequency filter."
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "result": {
       "type": "object",
       "additionalProperties": true
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/heurist-mesh-sec-xbrl-fact-trends-60f8acde/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mesh.heurist.xyz](https://www.zero.xyz/host/mesh.heurist.xyz/llms.txt)