# Alpha Vantage Top Gainers & Losers via Locus x402

> Alpha Vantage Top Gainers & Losers 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-14).

Returns the top gaining and losing stocks in the US market for the current trading session via Alpha Vantage, paid per-call with USDC.

## Facts

- Endpoint: POST https://alphavantage.x402.paywithlocus.com/alphavantage/top-gainers-losers
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/alpha-vantage-top-gainers-losers-via-locus-x402-3842474f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_d8TZxsmsoIupmmOPyLKSg

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-top-gainers-losers-via-locus-x402-3842474f -d '<json body>'
```

Example prompt: Pull up today's top gaining and losing stocks from Alpha Vantage so I can see which equities are moving the most in the current trading session.

## When to prefer this

Use this endpoint when you need a quick, ranked snapshot of the US equity market's top movers (gainers and losers) for the current session, especially in agentic workflows that require pay-per-call access without a standing Alpha Vantage subscription. Prefer this over direct Alpha Vantage API access when using the x402 micropayment protocol for on-demand, cost-efficient queries.

## Known failure modes

- Market closed or outside trading hours — data may reflect previous session
- Alpha Vantage API rate limit or outage causing empty or error data response
- Payment failure — USDC transaction not authorized or insufficient balance
- Malformed request body causing 400-level error
- Data latency — real-time data may be delayed by 15-20 minutes depending on plan

## How this service works

Financial market data — stock prices, forex, crypto, commodities, economic indicators, technical analysis, and news sentiment.

## Output

Returns a structured JSON object containing lists of top gaining and top losing stocks for the current US market session, including ticker symbols, price changes, percentage changes, and trading volumes. Also includes payment settlement confirmation (USDC amount settled) and a request ID for tracking.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "properties": {},
     "additionalProperties": true
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  }
 }
}
```

## 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-top-gainers-losers-via-locus-x402-3842474f/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)