# x402stock Equity Tearsheet PNG Generator

> x402stock Equity Tearsheet PNG Generator is a paid API for AI agents from agents.x402stock.xyz, paid per call via MPP, $0.5/call, status healthy (last checked 2026-10-12, last successful call 2026-10-09).

Renders a complete one-page equity tearsheet as a hosted PNG image for any US-listed stock, including a 1-year price chart, 50-day moving average, key financial stats, and recent news headlines.

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/report/{ticker}?utm_source=zero.xyz
- Price: $0.5/call
- Payment: MPP
- Status: healthy
- Last checked: 2026-10-12
- Last successful call: 2026-10-09
- Success rate: 100% of calls made through Zero
- Activations on Zero: 8
- Provider: agents.x402stock.xyz
- Website: https://agents.x402stock.xyz
- Canonical page: https://www.zero.xyz/c/agents-x402stock-xyz-x402stock-equity-tearsheet-png-generator-e47c279e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AGRJ0oUltehHTljM0fVaV

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 agents-x402stock-xyz-x402stock-equity-tearsheet-png-generator-e47c279e
```

Example prompt: Can you pull up a one-page tearsheet for NVDA — the PNG with the price chart, fundamentals like P/E and market cap, and recent news headlines?

## When to prefer this

Choose this endpoint when you need a fully rendered, presentation-ready visual stock report rather than raw JSON data to process yourself. It is ideal when the output will be shared with a human — in a report, newsletter, chat interface, or briefing — and you want a single API call to handle data aggregation, chart rendering, and layout. Prefer alternatives (raw price, fundamentals, or history endpoints) when you need machine-readable data for downstream computation rather than a visual artifact.

## Known failure modes

- Invalid or non-US ticker symbol returns an error or empty/null data fields
- Delisted or OTC stocks may have unavailable sections marked as 'unavailable' in the sections map
- Payment failure via x402 prevents the request from completing
- Artifact PNG URL expires after the time indicated in expires_at
- Missing fundamentals data results in null values for P/E, margins, or dividend yield fields
- Network timeout when fanning out to multiple underlying data sources

## How this service works

Returns a URL to a rendered one-page PNG equity tearsheet report.

## Output

Returns a JSON object containing: a hosted artifact PNG URL (with expiry timestamp) showing a complete one-page tearsheet image; the stock ticker and company name; current price with change and percent change; a stats object with market cap, P/E, margins, dividend yield, 52-week range, and other key fundamentals; a technicals object with indicators; a list of recent news headlines with publisher and URL; and a sections map indicating which data components were successfully retrieved.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "ticker"
 ],
 "properties": {
  "ticker": {
   "type": "string",
   "description": "US-listed ticker symbol (uppercase), e.g. AAPL."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "ticker",
  "source",
  "as_of",
  "artifact",
  "data"
 ],
 "properties": {
  "data": {
   "type": "object",
   "required": [
    "name",
    "price",
    "stats",
    "technicals",
    "news",
    "sections"
   ],
   "properties": {
    "name": {
     "anyOf": [
      {
       "type": "string"
      },
      {
       "type": "null"
      }
     ]
    },
    "news": {
     "type": "array",
     "items": {
      "type": "object",
      "required": [
       "title",
       "publisher",
       "url"
      ],
      "properties": {
       "url": {
        "anyOf": [
         {
          "type": "string"
         },
         {
          "type": "null"
         }
        ]
       },
       "title": {
        "type": "string"
       },
       "publisher": {
        "anyOf": [
         {
          "type": "string"
         },
         {
          "type": "null"
         }
        ]
       }
      },
      "additionalProperties": false
     }
    },
    "price": {
     "type": "object",
     "required": [
      "last",
      "change",
      "change_percent"
     ],
     "properties": {
      "last": {
       "anyOf": [
        {
         "type": "number"
        },
        {
         "type": "null"
        }
       ]
      },
      "change": {
       "anyOf": [
        {
         "type": "number"
        },
        {
         "type": "null"
        }
       ]
      },
      "change_percent": {
       "anyOf": [
        {
         "type": "number"
        },
        {
         "type": "null"
        }
       ]
      }
     },
     "additionalProperties": false
    },
    "stats": {
     "type": "object",
     "propertyNames": {
      "type": "string"
     },
     "additionalProperties": {
      "anyOf": [
       {
        "type": "number"
       },
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ]
     }
    },
    "sections": {
     "type": "object",
     "propertyNames": {
      "type": "string"
     },
     "additionalProperties": {
      "enum": [
       "ok",
       "unavailable"
      ],
      "type": "string"
     }
    },
    "technicals": {
     "type": "object",
     "propertyNames": {
      "type": "string"
     },
     "additionalProperties": {
      "anyOf": [
       {
        "type": "number"
       },
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ]
     }
    }
   },
   "additionalProperties": false
  },
  "as_of": {
   "type":
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-x402stock-xyz-x402stock-equity-tearsheet-png-generator-e47c279e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.x402stock.xyz](https://www.zero.xyz/host/agents.x402stock.xyz/llms.txt)