# x402stock US Stock Overview

> x402stock US Stock Overview is a paid API for AI agents from agents.x402stock.xyz, paid per call via MPP or x402, $0.05/call, status healthy (last checked 2026-10-07, last successful call 2026-10-08).

Returns a comprehensive single-call snapshot of a US-listed stock including profile, delayed OHLCV price, fundamentals, dividends, corporate events, technical indicators, news, and peers.

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/overview/{ticker}?utm_source=zero.xyz
- Price: $0.05/call
- Payment: MPP, x402
- Status: healthy
- Last checked: 2026-10-07
- Last successful call: 2026-10-08
- Success rate: 100% of calls made through Zero
- Activations on Zero: 1
- Provider: agents.x402stock.xyz
- Website: https://agents.x402stock.xyz
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agents-x402stock-xyz-x402stock-us-stock-overview-94acc46f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rz0MXMi1PN7JcB3b20dZm

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-us-stock-overview-94acc46f
```

Example prompt: Give me the full stock overview for NVDA — I want the company profile, current price, P/E ratio, dividend yield, RSI and MACD technicals, latest news, and who its peers are.

## When to prefer this

Choose this endpoint when you need a broad, all-in-one view of a single US-listed stock without orchestrating multiple API calls. It is ideal for initial research, dashboard snapshots, or when an agent needs to reason across price, fundamentals, technicals, and news simultaneously. Prefer more specialized endpoints when you need deep historical data, full XBRL financials, or SEC filing details.

## Known failure modes

- Unknown or invalid ticker returns error or empty sections
- Delisted stocks may have missing price or fundamentals sections flagged in sections map
- Technical indicators may be null if insufficient price history exists
- News array may be empty for tickers with low media coverage
- Rate limiting or payment failure returns 402 or 429 error

## How this service works

Use when you need a full picture of one US-listed stock without making a dozen calls. Returns company profile, delayed price with OHLCV, fundamentals with computed P/E and margins, dividend yield, splits and corporate events, technical indicators (RSI, SMA, EMA, MACD) with neutral zone labels, recent news, and peers. A `sections` map flags anything unavailable. From x402stock

## Output

A rich JSON object containing: ticker and timestamp, company profile (name, sector, SIC code, market cap, employees, description, logo), delayed price with OHLCV and VWAP, fundamentals (P/E, margins, shares outstanding), dividend yield and history, corporate actions and splits, technical indicators (RSI, SMA, EMA, MACD) with neutral-zone labels, an array of recent news articles (title, URL, publisher, date), a list of peer tickers, and a sections availability map flagging any unavailable data.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "ticker": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "ticker",
  "source",
  "as_of",
  "sections",
  "profile",
  "price",
  "fundamentals",
  "dividends",
  "corporate_actions",
  "technicals",
  "news",
  "peers"
 ],
 "properties": {
  "news": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "title",
     "url",
     "publisher",
     "published_at",
     "tickers"
    ],
    "properties": {
     "url": {
      "type": "string"
     },
     "title": {
      "type": "string"
     },
     "tickers": {
      "type": "array",
      "items": {
       "type": "string"
      }
     },
     "publisher": {
      "type": "string"
     },
     "published_at": {
      "type": "string"
     }
    },
    "additionalProperties": false
   }
  },
  "as_of": {
   "type": "string"
  },
  "peers": {
   "type": "array",
   "items": {
    "type": "string"
   }
  },
  "price": {
   "anyOf": [
    {
     "type": "object",
     "required": [
      "last",
      "change",
      "change_percent",
      "previous_close",
      "is_delayed",
      "delayed_by",
      "timestamp"
     ],
     "properties": {
      "day": {
       "anyOf": [
        {
         "type": "object",
         "required": [
          "open",
          "high",
          "low",
          "close",
          "volume",
          "vwap"
         ],
         "properties": {
          "low": {
           "type": "number"
          },
          "high": {
           "type": "number"
          },
          "open": {
           "type": "number"
          },
          "vwap": {
           "type": "number"
          },
          "close": {
           "type": "number"
          },
          "volume": {
           "type": "number"
          }
         },
         "additionalProperties": false
        },
        {
         "type": "null"
        }
       ]
      },
      "last": {
       "anyOf": [
        {
         "type": "number"
        },
        {
         "type": "null"
        }
       ]
      },
      "change": {
       "anyOf": [
        {
         "type": "number"
        },
        {
         "type": "null"
        }
       ]
      },
      "timestamp": {
       "anyOf": [
        {
         "type": "string"
        },
        {
         "type": "null"
        }
       ]
      },
      "delayed_by": {
       "type": "string"
      },
      "is_delayed": {
       "type": "boolean"
      },
      "change_percent": {
       "anyOf": [
        {
         "type": "number"
        },
        {
      
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-x402stock-xyz-x402stock-us-stock-overview-94acc46f/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)