# DeepSearch US Earnings Summary API

> DeepSearch US Earnings Summary API is a paid API for AI agents from x402.deepsearch.com, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-13).

Returns a natural-language earnings summary for a given US stock ticker and optional fiscal quarter, powered by up to 10 years of financial data.

## Facts

- Endpoint: GET https://x402.deepsearch.com/v1/context/us/earnings/%7Bticker%7D/summary
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/deepsearch-us-earnings-summary-api-15ae6a3e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_geqpOlMqpIIUluE12NlsQ

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 deepsearch-us-earnings-summary-api-15ae6a3e
```

Example prompt: Can you pull up the DeepSearch earnings summary for AAPL for Q2 2026 — I want a quick digest of how Apple performed that quarter?

## When to prefer this

Choose this endpoint when you need a fast, readable natural-language digest of US company earnings for a specific quarter, especially if you want pre-processed summaries rather than raw financial tables. Prefer it over raw financial data endpoints when the goal is to quickly understand business performance without parsing structured financials yourself. Best suited for single-ticker, per-quarter lookups with pay-per-query pricing via USDC on Base.

## Known failure modes

- Invalid or unrecognized ticker symbol returns an error or empty result
- Requested period not yet available returns no data
- Non-US ticker passed to US endpoint may return no result
- Network or payment authorization failure via x402 protocol returns 402 status
- Malformed period string (not YYYY-QN format) may cause a bad request error

## How this service works

Up to 10 years of financials + 3 years of daily price history for all 2,000+ KRX stocks. Pay-per-query with USDC on Base Mainnet — no subscription.

## Output

Returns a JSON object with the ticker symbol, fiscal period (e.g. '2026-Q2'), and a natural-language summary of the company's earnings results for that quarter, written in Korean based on the example response.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "ticker"
     ],
     "properties": {
      "period": {
       "type": "string",
       "description": "Optional YYYY-QN (e.g. 2026-Q2). Omit for latest."
      },
      "ticker": {
       "type": "string",
       "description": "US symbol, e.g. AAPL"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "period": "2026-Q2",
  "ticker": "AAPL",
  "summary": "애플은 재무실적 발표에서 2026년 회계연도 2분기 실적을 보고하였으며..."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/deepsearch-us-earnings-summary-api-15ae6a3e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.deepsearch.com](https://www.zero.xyz/host/x402.deepsearch.com/llms.txt)