# Heurist Mesh: SEC EDGAR XBRL Fact Trends

> Heurist Mesh: SEC EDGAR 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-13).

Returns quarterly or annual SEC XBRL financial fact observations for a specified metric and publicly traded company, supporting plain-English or exact XBRL concept names.

## Facts

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

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-edgar-xbrl-fact-trends-f950f9e7 -d '<json body>'
```

Example prompt: Pull the quarterly revenue trend for Apple (AAPL) from SEC EDGAR XBRL filings — I want to see how Revenues has moved over the last 8 quarters.

## When to prefer this

Choose this endpoint when you need authoritative, SEC-filed financial data for a public US company in structured time-series form — especially when verifying fundamental metrics like revenue, net income, EPS, or balance sheet items directly from official XBRL filings rather than third-party data providers. Prefer it over market data APIs when data provenance and regulatory accuracy matter.

## Known failure modes

- Unknown or unsupported metric name returns an error or empty result
- Invalid or unrecognized company ticker/CIX causes lookup failure
- XBRL concept not filed by the company for the requested period returns no data
- Rate limiting or payment failure ($0.002 USDC) blocks the request
- SEC EDGAR data lag means very recent filings may not yet be available

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

A time-series of XBRL fact observations for the requested metric and company, including reported values, fiscal period labels, and filing dates — drawn directly from SEC EDGAR structured data.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/heurist-mesh-sec-edgar-xbrl-fact-trends-f950f9e7/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)