# QuantJourney Earnings Recap Agent

> QuantJourney Earnings Recap Agent is a paid API for AI agents from agents.quantjourney.cloud, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns a structured AI-generated earnings recap for a given stock ticker, including key facts, coverage, and interpretation.

## Facts

- Endpoint: POST https://agents.quantjourney.cloud/v1/query/earnings-recap
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/quantjourney-earnings-recap-agent-c410885b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__WwoIoOfYrs3c6EYxDQdN

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 quantjourney-earnings-recap-agent-c410885b -d '<json body>'
```

Example prompt: Can you pull the latest earnings recap for NVDA — I want the key facts, coverage highlights, and any interpretation from QuantJourney's earnings agent?

## When to prefer this

Choose this endpoint when you need a structured, AI-generated earnings recap for a specific publicly traded stock ticker and want key facts, coverage, and interpretation in a single call. Prefer it over raw financial data APIs when you need a pre-interpreted, agent-ready summary rather than raw XBRL or SEC filings. Best suited for agents that need to quickly surface earnings highlights without post-processing.

## Known failure modes

- Invalid ticker format (fails pattern ^[A-Z0-9][A-Z0-9.\-]{0,14}$) returns validation error
- Ticker not found or no earnings data available returns empty facts/coverage arrays
- Payment not completed or insufficient USDC balance blocks the request
- Service temporarily unavailable returns 5xx error
- Ticker provided in lowercase or with spaces may fail pattern matching

## How this service works

Canonical discovery contract for currently executable public agent resources.

## Output

A JSON object containing the ticker queried, an 'asOf' date, structured earnings facts, coverage array, interpretation array, tools used to generate the recap, lineage references, freshness metadata, schema version, and payment/protocol metadata. The 'status' field indicates whether the recap is complete.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "ticker": {
   "type": "string",
   "title": "Ticker",
   "pattern": "^[A-Z0-9][A-Z0-9.\\-]{0,14}$",
   "examples": [
    "NVDA"
   ],
   "maxLength": 15,
   "minLength": 1,
   "description": "Canonical ticker, for example NVDA or BRK.B."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "asOf": "2026-08-29",
  "facts": {},
  "query": {
   "ticker": "AAPL"
  },
  "status": "complete",
  "payment": {
   "network": "eip155:8453",
   "protocol": "x402"
  },
  "skillId": "qj-earnings-recap",
  "coverage": [],
  "priceUsd": "0.01",
  "freshness": {},
  "toolsUsed": [],
  "generatedAt": "2026-08-30T08:00:00Z",
  "lineageRefs": [],
  "schemaVersion": "qj-agents.earnings-recap.v1",
  "interpretation": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/quantjourney-earnings-recap-agent-c410885b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.quantjourney.cloud](https://www.zero.xyz/host/agents.quantjourney.cloud/llms.txt)