# Ysaere SEC Shares Outstanding Lookup

> Ysaere SEC Shares Outstanding 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-10-27).

Returns the current shares outstanding for a public company by ticker or name, sourced from SEC filings.

## Facts

- Endpoint: POST https://api.ysaere.com/v1/intel/sec-shares-outstanding?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-27
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ysaere-sec-shares-outstanding-lookup-e984bc78
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_24NQRyXgMMp5Y1jMroFSF

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-shares-outstanding-lookup-e984bc78 -d '<json body>'
```

Example prompt: How many shares outstanding does Costco (COST) have according to their latest SEC filing?

## When to prefer this

Use this endpoint when you need SEC-sourced shares outstanding data for a publicly traded US company and want a pay-per-call model with no account setup. Prefer this over generic financial data APIs when you need lightweight, low-cost spot lookups of share counts without a subscription, or when building an agentic workflow that uses crypto micropayments via x402.

## Known failure modes

- Unknown or invalid ticker/company name returns an error or refusal before payment is charged
- Company not found in SEC database (e.g. private companies) results in a refused or empty response
- Ambiguous company name with multiple matches may return an error requiring a more specific ticker
- Payment not processed or wallet issue results in no response delivered

## How this service works

Ysaere Agent Shares Outstanding — $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 shares outstanding count for the specified public company, sourced from SEC filings. Typically includes the share count figure and may include the reporting period or filing date 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-shares-outstanding-lookup-e984bc78/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)