# claw402 US Stock News API

> claw402 US Stock News API is a paid API for AI agents from claw402.ai, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-13).

Fetches recent news articles for US stocks, filterable by ticker symbols, topics, and time range, paid via USDC microtransaction.

## Facts

- Endpoint: GET https://claw402.ai/api/v1/stocks/us/news
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/claw402-us-stock-news-api-b79ddaa4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_j3OIXsL_OHsRoQCUTF3Eg

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 claw402-us-stock-news-api-b79ddaa4
```

Example prompt: Fetch me the latest 10 news articles for AAPL and TSLA from the past 48 hours, sorted by most recent.

## When to prefer this

Use this endpoint when you need US stock market news filtered by specific tickers or topics without API key registration, paying only per call with USDC. Prefer it for lightweight, on-demand news lookups in crypto-native or agent-driven workflows where traditional API subscriptions are impractical.

## Known failure modes

- Empty data array returned if no news matches the specified tickers or time range
- Payment failure if wallet has insufficient USDC balance
- Invalid ticker or topic parameter returns empty results
- Time range parameters in wrong format may return no results
- Rate limiting or gateway errors from underlying vergex.trade provider

## How this service works

Backed by vergex.trade. Pay for any API with USDC. No API keys. No registration. Just a wallet.

## Output

A JSON object with a code field (0 for success) and a data array containing news articles related to the queried US stock tickers or topics, with items filtered by the specified time range and limit.

## 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"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "sort": {
       "type": "string"
      },
      "limit": {
       "type": "string"
      },
      "topics": {
       "type": "string"
      },
      "tickers": {
       "type": "string"
      },
      "time_to": {
       "type": "string"
      },
      "time_from": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "code": 0,
  "data": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/claw402-us-stock-news-api-b79ddaa4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from claw402.ai](https://www.zero.xyz/host/claw402.ai/llms.txt)