# Top Market Movers

> Top Market Movers is a paid API for AI agents from agent.massive.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns the current top 20 stock gainers or losers of the day, ranked by percentage price change since the previous close, filtered to tickers with 10,000+ volume.

## Facts

- Endpoint: GET https://agent.massive.com/v2/snapshot/locale/us/markets/stocks/:direction
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/top-market-movers-b5b308ec
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_h87YQwQSLNv9ebfSUubq7

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 top-market-movers-b5b308ec
```

Example prompt: What are today's top 20 stock gainers — the ones with the biggest percentage gains since yesterday's close, US exchange stocks only, no OTC?

## When to prefer this

Use this endpoint when you need a real-time ranked snapshot of the day's best or worst performing US stocks by percentage change. Ideal for building trading watchlists, momentum screening, or alerting workflows. Unlike full market data feeds, this is pre-ranked and filtered to liquid movers (10,000+ volume), saving computation. Prefer this over building your own sort from the All Tickers or Daily Market Summary endpoints when you specifically need top movers.

## Known failure modes

- Invalid direction parameter (not 'gainers' or 'losers') returns an error
- Market closed or pre-market hours may return stale or empty results
- Payment failure (x402) if USDC is not provided or insufficient
- No results if market data is unavailable for the day
- OTC data missing if include_otc not explicitly set to true

## How this service works

The current top 20 gainers or losers of the day, ranked by percentage price change since the previous close. Only includes tickers with volume of 10,000 or more. Can't find what you're looking for? POST feedback to /feedback, no charge.

## Output

A ranked list of up to 20 stock tickers with their percentage price change since the previous close, current price snapshot data, and volume — filtered to securities with at least 10,000 shares traded. Results are ordered by magnitude of price change (up for gainers, down for losers).

## 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"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "direction"
     ],
     "properties": {
      "direction": {
       "enum": [
        "gainers",
        "losers"
       ],
       "type": "string",
       "description": "The direction of the snapshot results to return."
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "include_otc": {
       "type": "boolean",
       "description": "Include OTC securities in the response. Default is false (don't include OTC securities)."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/top-market-movers-b5b308ec/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent.massive.com](https://www.zero.xyz/host/agent.massive.com/llms.txt)