# x402stock Top Market Gainers

> x402stock Top Market Gainers is a paid API for AI agents from agents.x402stock.xyz, paid per call via x402 or MPP, $0.02/call, status unknown (last checked 2026-10-30).

Returns the top gaining US stocks, ETFs, or related instruments for the current trading session, paid per request in USDC via x402.

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/gainers?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402, MPP
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-top-market-gainers-0e33eb1d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NIvyiL5uU-9icLckMbh76

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-market-gainers-0e33eb1d
```

Example prompt: What are the top gaining stocks in the US market right now? Give me today's biggest winners with their percentage moves and volume.

## When to prefer this

Use this endpoint when you need real-time or intraday data on the top performing US equities by percentage gain. Prefer this over general quote or screener endpoints when the specific goal is to rank today's winners quickly in a single call, especially in agentic workflows where pay-per-use with no API key setup is desirable.

## Known failure modes

- Market closed or pre-market hours may return empty or limited results
- Payment failure if insufficient USDC balance via x402
- Rate limiting if quota exceeded
- Malformed or missing properties parameter may yield default or error response
- Network timeout from upstream data provider

## How this service works

The day's biggest percentage gainers across US equities, with current and previous-day OHLCV per ticker.

## Output

A ranked list of the top gaining US stocks or ETFs for the current session, including ticker symbols, company names, price change, percentage gain, volume, and potentially market cap or other ranking signals.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "maximum": 100,
   "exclusiveMinimum": 0
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "source",
  "as_of",
  "direction",
  "count",
  "tickers"
 ],
 "properties": {
  "as_of": {
   "type": "string"
  },
  "count": {
   "type": "number"
  },
  "source": {
   "type": "string",
   "const": "x402stock"
  },
  "tickers": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "ticker",
     "change",
     "change_percent",
     "updated"
    ],
    "properties": {
     "day": {
      "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
     },
     "change": {
      "type": "number"
     },
     "ticker": {
      "type": "string"
     },
     "updated": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ]
     },
     "previous_day": {
      "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
     },
     "change_percent": {
      "type": "number"
     }
    },
    "additionalProperties": false
   }
  },
  "direction": {
   "enum": [
    "gainers",
    "losers"
   ],
   "type": "string"
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-top-market-gainers-0e33eb1d/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)