# x402stock — Top US Stock Gainers

> x402stock — Top US Stock Gainers is a paid API for AI agents from x402stock.vercel.app, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Returns today's top US stock market gainers with price change, OHLC data, and volume via pay-per-request x402 payments

## Facts

- Endpoint: GET https://x402stock.vercel.app/api/v1/gainers
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-top-us-stock-gainers-3e47843f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_aaRF4OvjgGzRs6NM8CY8X

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 x402stock-top-us-stock-gainers-3e47843f
```

Example prompt: Which US stocks have gained the most today? Show me the top gainers with their percentage change and volume.

## When to prefer this

Use this endpoint when you need a ready-made ranked list of today's top US stock gainers without specifying individual tickers — ideal for market screeners, daily briefings, momentum trading signals, or alerting workflows. Prefer over individual price endpoints when the goal is discovery of outperforming stocks rather than lookup of a known ticker.

## Known failure modes

- Payment not submitted or insufficient USDC — 402 Payment Required
- Market data unavailable outside trading hours — may return empty or stale data
- Rate limit exceeded — too many requests in short window
- Service downtime on Vercel hosting — 503 or timeout

## How this service works

The day's biggest percentage gainers across US equities, with current and previous-day OHLCV per ticker. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.

## Output

A JSON object with a timestamp, count, source, and direction field (gainers), plus an array of ticker objects each containing: ticker symbol, day OHLC (open, high, low, close, VWAP, volume), previous day OHLC, absolute price change, and percent change — sorted by largest gainers.

## Example request

```json
{
 "properties": "symbol,price,change,changePercent,volume"
}
```

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "as_of": "2026-05-29T20:00:00.000Z",
  "count": 1,
  "source": "massive",
  "tickers": [
   {
    "day": {
     "low": 23.06,
     "high": 26.11,
     "open": 25.94,
     "vwap": 24.3,
     "close": 23.55,
     "volume": 19121
    },
    "change": 16.1942,
    "ticker": "CBRX",
    "updated": "2026-05-29T19:58:00.000Z",
    "previous_day": {
     "low": 6.91,
     "high": 7.44,
     "open": 6.97,
     "vwap": 7.17,
     "close": 7.36,
     "volume": 58578
    },
    "change_percent": 220.03
   }
  ],
  "direction": "gainers"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-top-us-stock-gainers-3e47843f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402stock.vercel.app](https://www.zero.xyz/host/x402stock.vercel.app/llms.txt)