# Ysaere SEC Retained Earnings Lookup

> Ysaere SEC Retained Earnings Lookup is a paid API for AI agents from api.ysaere.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-01).

Retrieves retained earnings data from SEC filings for a given public company by name or ticker symbol

## Facts

- Endpoint: POST https://api.ysaere.com/v1/intel/sec-retained-earnings?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ysaere-sec-retained-earnings-lookup-e2ad62bf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TXj-egvkGqgm70GGi9ZDr

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 ysaere-sec-retained-earnings-lookup-e2ad62bf -d '<json body>'
```

Example prompt: What are the retained earnings for Costco according to their SEC filings? Look up the ticker COST.

## When to prefer this

Use this endpoint when you need retained earnings specifically from SEC filings for a US-listed public company, without requiring an account or subscription. Ideal for lightweight, pay-per-query financial data retrieval at $0.02 USDC per call. Prefer this over full financial data APIs when you only need a single financial metric and want minimal setup overhead.

## Known failure modes

- Unknown or invalid ticker/company name returns an error or refusal before payment is processed
- Company not found in SEC database (e.g. private companies, foreign-only filers) results in no data
- Payment not completed results in no answer being returned
- Ambiguous company name may require a more specific ticker
- SEC data may be delayed or reflect last filed period rather than real-time

## How this service works

Ysaere Agent Retained Earnings — $0.02 USDC, no account needed. Input: {"target":"COST"}. The answer is in this response. A missing answer is refused before payment. Wallet only. No account price.

## Output

Returns the retained earnings value for the specified public company as reported in their SEC filings, typically sourced from the balance sheet section of annual or quarterly reports. The response contains the numeric financial figure along with relevant context.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "target": {
   "type": "string",
   "description": "Company name or ticker (for example \"COST\")"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ysaere-sec-retained-earnings-lookup-e2ad62bf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.ysaere.com](https://www.zero.xyz/host/api.ysaere.com/llms.txt)