# Ysaere Agent Basic Shares

> Ysaere Agent Basic Shares 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-22).

Returns the basic shares outstanding for a public company identified by ticker or name, retrieved from SEC filings.

## Facts

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

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-agent-basic-shares-6a969074 -d '<json body>'
```

Example prompt: How many basic shares outstanding does Costco (COST) have? Pull it from SEC filings.

## When to prefer this

Use this endpoint when you need a fast, low-cost ($0.02 USDC) lookup of basic shares outstanding for a US-listed public company directly from SEC data, without needing to create an account. Ideal for agents performing financial calculations, building company profiles, or enriching data pipelines with capital structure data.

## Known failure modes

- Company or ticker not found in SEC EDGAR — request refused before payment
- Invalid or ambiguous target string — may return error or prompt clarification
- Payment wallet not provided or insufficient USDC balance — transaction rejected
- Network timeout or upstream SEC data unavailability — service error returned

## How this service works

Ysaere Agent Basic Shares — $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

A JSON response containing the basic shares outstanding figure for the requested company, sourced from SEC EDGAR filings. The answer is guaranteed to be present before payment is charged; if unavailable, the request is refused prior to billing.

## 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-agent-basic-shares-6a969074/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)