# Alpha Vantage Global Quote via Locus x402

> Alpha Vantage Global Quote via Locus x402 is a paid API for AI agents from alphavantage.x402.paywithlocus.com, paid per call via x402, $0.008/call, status unknown (last checked 2026-09-15).

Fetches the latest real-time global quote (price, change, volume) for a given stock ticker symbol via a pay-per-call x402 micropayment gateway.

## Facts

- Endpoint: POST https://alphavantage.x402.paywithlocus.com/alphavantage/global-quote
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/alpha-vantage-global-quote-via-locus-x402-b0363d13
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3xFJvWA_9vsQa8OGfgbHE

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 alpha-vantage-global-quote-via-locus-x402-b0363d13 -d '<json body>'
```

Example prompt: Can you pull the latest global quote for IBM stock — I need the current price, change, and volume for today?

## When to prefer this

Prefer this endpoint when you need a single real-time or latest-available global quote for a specific stock ticker and want to pay per call via USDC micropayment (x402 protocol) without managing an Alpha Vantage API key directly. Ideal for low-frequency spot checks embedded in agent workflows where pay-per-use economics are preferred over subscription API keys.

## Known failure modes

- Invalid or unrecognized ticker symbol returns empty or error data object
- Market closed or after-hours may return stale last-traded price
- Insufficient USDC balance causes payment failure and 402 response
- Malformed request body missing 'symbol' field returns validation error
- Rate limiting or upstream Alpha Vantage API outage returns 5xx error

## How this service works

Locus public pay-per-use API

## Output

Returns a JSON object containing the latest global quote for the requested ticker, including current price, open, high, low, previous close, volume, latest trading day, price change, and percentage change. Also includes payment settlement details (USDC amount) and a request ID with status URL.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "symbol": {
   "type": "string"
  },
  "datatype": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {},
  "payment": {
   "scheme": "exact",
   "settledUsdc": "0.001000",
   "authorizedMaxUsdc": "0.001000"
  },
  "request": {
   "id": "00000000-0000-4000-8000-000000000000",
   "statusUrl": "/requests/00000000-0000-4000-8000-000000000000"
  },
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/alpha-vantage-global-quote-via-locus-x402-b0363d13/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from alphavantage.x402.paywithlocus.com](https://www.zero.xyz/host/alphavantage.x402.paywithlocus.com/llms.txt)
