# x402stock Market Pulse

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

Returns a broad market and economic snapshot covering US stocks, ETFs, options, forex, crypto, commodities, macro indicators, SEC filings, congressional trades, and sentiment in a single call

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/market-pulse?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402, MPP
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-market-pulse-ab951fe7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LARycl6_RlMmdSa_EHOZB

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-market-pulse-ab951fe7
```

Example prompt: Give me a broad market pulse right now — I want to see how US stocks, crypto, forex, energy commodities, and key macro indicators like CPI and Treasury yields are all sitting at this moment.

## When to prefer this

Choose this endpoint when you need a single broad snapshot across many asset classes and macro indicators simultaneously, rather than deep per-ticker or per-series data. It is ideal for morning briefings, cross-asset monitoring, and high-level economic situation awareness. Prefer per-ticker endpoints (e.g. latest price, daily OHLCV, short interest) when you need detailed historical series or specific company data.

## Known failure modes

- Payment not included or insufficient USDC via x402/MPP — returns 402 Payment Required
- Network or upstream data provider outage — returns 5xx error
- Malformed request parameters — returns 400 Bad Request
- Endpoint not listed in /manifest.json catalog — not supported
- Rate limiting if free included units exhausted without payment

## How this service works

Top gainers, top losers, market status, news.

## Output

A broad aggregated snapshot of live and recent market and economic data, potentially including US stock and ETF prices, options data, forex rates, crypto prices, on-chain perpetuals, energy commodity prices (crude oil, natural gas, gasoline), US macro indicators (Fed funds rate, CPI, PCE, jobs, GDP), Treasury debt and yields, World Bank global indicators, recent SEC filings, congressional trade disclosures, and market sentiment metrics — all returned in a single response for $0.03 USDC per call.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "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": false
   }
  },
  "source": {
   "type": "string",
   "const": "x402stock"
  },
  "gainers": {
   "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": false
   }
  },
  "market_status": {
   "anyOf": [
    {
     "type": "object",
     "required": [
      "market",
      "early_hours",
      "after_hours"
     ],
     "properties": {
      "market": {
       "type": "string"
      },
      "after_hours": {
       "type": "boolean"
      },
      "early_hours": {
       "type": "boolean"
      }
     },
     "additionalProperties": false
    },
    {
     "type": "null"
    }
   ]
  }
 },
 "additionalProperties": false
}
```

## More

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