# OneShot Agent Company Financials Lookup

> OneShot Agent Company Financials Lookup is a paid API for AI agents from win.oneshotagent.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-25).

Retrieves reported financial figures (revenue, income, balance sheet, EPS) for US public companies by SEC CIK identifier and period.

## Facts

- Endpoint: POST https://win.oneshotagent.com/v1/tools/lookup/company-financials?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-25
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/oneshot-agent-company-financials-lookup-b41fa42e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dFuHTSCE_Z_hIrgDttSBm

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 oneshot-agent-company-financials-lookup-b41fa42e -d '<json body>'
```

Example prompt: Pull Apple's annual revenue from its SEC filings for the last 5 years — Apple's CIK is 320193.

## When to prefer this

Use this endpoint when you need structured, SEC-sourced financial figures for US public companies keyed by CIK, especially when you need specific GAAP line items (revenue, net income, EPS, balance sheet) across multiple fiscal periods. Prefer this over general web search when you need machine-readable, authoritative reported values rather than analyst estimates or summarized articles.

## Known failure modes

- Invalid or non-existent CIK returns an error or empty results
- Metric not reported by the company (e.g. no revenue for a holding company) yields empty periods array
- CIK for a non-US or non-public company will return no data since coverage is SEC EDGAR only
- Limit out of range (less than 1 or greater than 20) may cause a validation error
- Network or payment failure (x402 protocol) prevents the call from completing

## How this service works

Look up a US public company's reported revenue, income, balance sheet figures or EPS by period, by its registry identifier.

## Output

Returns a JSON object containing the company name, the requested metric label, XBRL tag, unit of measure, and an array of period records each including start/end dates, fiscal year, fiscal period, form type (10-K or 10-Q), filing date, accession number, and the reported numeric value.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "cik": {
   "type": "string",
   "description": "The registry identifier (CIK), for example 320193. Shorter numbers are padded with zeros. A CIK is 1 to 10 digits."
  },
  "limit": {
   "type": "integer",
   "description": "Most periods to return, newest first. From 1 to 20. Defaults to `5`."
  },
  "metric": {
   "enum": [
    "revenue",
    "net_income",
    "operating_income",
    "total_assets",
    "total_liabilities",
    "stockholders_equity",
    "cash",
    "eps_diluted"
   ],
   "type": "string",
   "description": "Which reported figure to return"
  },
  "period": {
   "enum": [
    "annual",
    "quarterly"
   ],
   "type": "string",
   "description": "Fiscal years or fiscal quarters. Defaults to `\"annual\"`."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "cik": "0000320193",
  "tag": "RevenueFromContractWithCustomerExcludingAssessedTax",
  "unit": "USD",
  "label": "Revenue from Contract with Customer, Excluding Assessed Tax",
  "metric": "revenue",
  "periods": [
   {
    "end": "2025-09-27",
    "form": "10-K",
    "filed": "2025-10-31",
    "frame": "CY2025",
    "start": "2024-09-29",
    "value": 416161000000,
    "accession": "0000320193-25-000079",
    "fiscal_year": 2025,
    "fiscal_period": "FY"
   },
   {
    "end": "2024-09-28",
    "form": "10-K",
    "filed": "2025-10-31",
    "frame": "CY2024",
    "start": "2023-10-01",
    "value": 391035000000,
    "accession": "0000320193-25-000079",
    "fiscal_year": 2025,
    "fiscal_period": "FY"
   }
  ],
  "company_name": "Apple Inc."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/oneshot-agent-company-financials-lookup-b41fa42e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from win.oneshotagent.com](https://www.zero.xyz/host/win.oneshotagent.com/llms.txt)