# x402stock Market Pulse

> x402stock Market Pulse is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-14).

Returns today's top 10 stock gainers and losers by percent change, current US market session status, and latest market news headlines in a single call.

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/market-pulse
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-xyz-cf8ffbcb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Lso7bBUI4CNDyCIs_ur_E

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-xyz-cf8ffbcb
```

Example prompt: What are today's biggest stock movers — show me the top gainers and losers, whether the market is open or not, and any breaking market headlines.

## When to prefer this

Use this endpoint when an agent needs a broad, no-configuration market overview — top movers, session status, and news — all in one call without knowing any specific tickers. Ideal for daily market briefings, automated scanning workflows, or any scenario where the agent needs to quickly understand what is moving in the US equity market today.

## Known failure modes

- Market data provider unavailable — may return empty or null gainers/losers arrays
- Market status may be null if session data is temporarily unavailable
- Payment failure via x402 protocol if USDC balance is insufficient (HTTP 402)
- Rate limit or server error returning HTTP 5xx
- limit parameter exceeds maximum of 50 — returns validation error

## How this service works

Use to find the day's biggest movers in one call. Returns the top 10 gainers and top 10 losers by percent move with price, the current US market session status (open, closed, pre, or post), and the latest market news headlines. No ticker needed. Built for agents scanning what is moving today. From x402stock, a pay-per-call market & economic data API. Pay per request in USDC via x402, no API key.

## Output

Returns a JSON object with: a list of top gainers (ticker, price, percent change), a list of top losers (ticker, price, percent change), current US market session status (open/closed/pre/post), and an array of recent market news items with title, URL, publisher, published date, and related tickers.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "limit": 10
  }
 }
}
```

## 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",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "properties": {
      "limit": {
       "type": "integer",
       "maximum": 50,
       "exclusiveMinimum": 0
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "source",
      "as_of",
      "market_status",
      "gainers",
      "losers",
      "news"
     ],
     "properties": {
      "news": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "title",
         "url",
         "publisher",
         "published_at",
         "tickers"
        ],
        "properties": {
         "url": {
          "type": "string"
         },
         "title": {
          "type": "string"
         },
         "tickers": {
          "type": "array",
          "items": {
           "type": "string"
          }
         },
         "publisher": {
          "type": "string"
         },
         "published_at": {
          "type": "string"
         }
        },
        "additionalProperties": false
       }
      },
      "as_of": {
       "type": "string"
      },
      "losers": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "ticker",
         "change_percent",
         "price"
        ],
        "properties": {
         "price": {
          "anyOf": [
           {
            "type": "number"
           },
           {
            "type": "null"
           }
          ]
         },
         "ticker": {
          "type": "string"
         },
         "change_percent": {
          "anyOf": [
           {
            "type": "number"
           },
           {
            "type": "null"
           }
          ]
         }
        },
        "additionalProperties": f
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "news": [
   {
    "url": "https://example.com/news/market",
    "title": "Stock market today: indexes close at record highs",
    "tickers": [
     "AAPL",
     "MSFT"
    ],
    "publisher": "Example Wire",
    "published_at": "2026-05-29T21:00:00Z"
   }
  ],
  "as_of": "2026-05-30T07:00:00.000Z",
  "losers": [
   {
    "price": 0.1401,
    "ticker": "DAIC",
    "change_percent": -96.04
   }
  ],
  "source": "x402stock",
  "gainers": [
   {
    "price": 7.73,
    "ticker": "QH",
    "change_percent": 7453.19
   }
  ],
  "market_status": {
   "market": "closed",
   "after_hours": false,
   "early_hours": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-xyz-cf8ffbcb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402stock.xyz](https://www.zero.xyz/host/x402stock.xyz/llms.txt)