# agent402.tools Stock Quote API

> agent402.tools Stock Quote API is a paid API for AI agents from agent402.tools, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-10).

Returns a live market quote (last price, day range, 52-week range, previous close, currency, exchange, relative change) for any equity, index, FX pair, or crypto symbol as clean JSON

## Facts

- Endpoint: GET https://agent402.tools/api/stock-quote?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-tools-stock-quote-api-48b0cfcf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oW5yBRc5gaK2dwLzwUA-F

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 agent402-tools-stock-quote-api-48b0cfcf
```

Example prompt: What's the current price of AAPL, including today's range and how it's changed from yesterday's close?

## When to prefer this

Choose this endpoint when you need a live, keyless market quote for equities, indices, FX pairs, or crypto with no API key setup and broad symbol coverage. Ideal for agents that need real-time price context without managing credentials or rate limits. Prefer this over dedicated brokerage APIs when you just need a quick price check rather than order execution or historical time series.

## Known failure modes

- Invalid or misspelled ticker symbol returns an error or empty result
- Delisted or obscure symbols may not be found in Yahoo Finance's dataset
- Temporary Yahoo Finance backend outage may cause request failures
- FX symbols require the =X suffix (e.g. EURUSD=X) or they won't resolve correctly
- Crypto symbols require the -USD suffix (e.g. BTC-USD) or they won't resolve

## How this service works

End-of-day US equity quote from a licensed feed: last close, day range, previous close and the change between them, consolidated across three venues. Use it when an agent needs a current price for a US stock without an exchange account; indices, FX and crypto are not covered here.

## Output

A JSON object containing the last traded price, intraday high/low range, 52-week high/low range, previous close, currency, exchange name, and percentage/absolute change relative to previous close for the requested ticker symbol.

## 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"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "symbol"
     ],
     "properties": {
      "symbol": {
       "type": "string",
       "description": "US equity ticker, e.g. AAPL. Indices, FX and crypto are not covered."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "asOf": "2026-09-18",
  "note": "End-of-day close from a three-venue consolidation. Not a live intraday quote, not consolidated-tape volume, and no 52-week range - use stock-history for a range.",
  "price": 335.5,
  "dayLow": 332.545,
  "source": "databento.com DBEQ.BASIC",
  "symbol": "AAPL",
  "venues": "NYSE Texas (formerly NYSE Chicago), NYSE National, IEX",
  "dayHigh": 338.41,
  "currency": "USD",
  "changeAbs": -1.29,
  "changePct": -0.383,
  "venueVolume": 1630155,
  "previousClose": 336.79
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-tools-stock-quote-api-48b0cfcf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)