# stock-market-movers

> stock-market-movers is a paid API for AI agents from agentdatum.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns today's biggest US stock market gainers and losers from Yahoo Finance, providing a real-time sentiment snapshot of the American equity market.

## Facts

- Endpoint: GET https://agentdatum.com/api/v1/d/stock-market-movers
- 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/stock-market-movers-3bbb1842
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WuYBLPhVKuFgEb80yNN10

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 stock-market-movers-3bbb1842
```

Example prompt: What are today's biggest gainers and losers in the US stock market right now? I want to get a feel for which direction the market is moving.

## When to prefer this

Choose this endpoint when you need a quick, real-time snapshot of US stock market sentiment via today's top gainers and losers. Prefer it over general stock quote APIs when the goal is identifying market-wide momentum rather than tracking a specific ticker. Useful for daily briefings, sentiment checks, or triggering further research on specific movers.

## Known failure modes

- Yahoo Finance data source unavailable — empty or error response
- Market is closed (pre/post market hours) — data may reflect previous session
- Rate limiting or payment failure — 402 payment required if x402 header not provided
- Stale data if Yahoo Finance feed is delayed

## How this service works

US Stock Movers — Yahoo Finance US stock movers: today's top gainers and losers, market sentiment indicator.

## Output

A structured list of today's top gaining and top losing US stocks sourced from Yahoo Finance, including stock symbols, company names, price change amounts, and percentage change figures — effectively a real-time market sentiment indicator.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "raw": {
   "type": "market_movers",
   "movers": [
    {
     "price": null,
     "change": null,
     "symbol": "BTC-USD",
     "changePercent": null
    },
    {
     "price": null,
     "change": null,
     "symbol": "BTC-USD",
     "changePercent": null
    }
   ],
   "source": "Yahoo Finance"
  },
  "source": "yahoo_finance",
  "data_type": "金融",
  "collected_at": "2026-08-09T18:12:17Z"
 }
}
```

## More

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