# DataForAgents News Pulse Shift

> DataForAgents News Pulse Shift is a paid API for AI agents from dataforagents.net, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Fetches a structured hourly news pulse snapshot with event counts and status for a chosen category (finance, geopolitics, tech/AI, or sports), paid per-request via x402 USDC.

## Facts

- Endpoint: GET https://dataforagents.net/v1/news/pulse/shift
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/dataforagents-news-pulse-shift-0899538a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NGRuhQ155_kAmaEm-EloJ

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 dataforagents-news-pulse-shift-0899538a
```

Example prompt: Can you pull the latest hourly news pulse for the tech and AI category from DataForAgents right now and tell me how many events were captured?

## When to prefer this

Choose this endpoint when your agent needs structured, pay-per-request hourly news pulse data across four key categories (finance, geopolitics, tech/AI, sports) without managing API keys. Ideal for autonomous agents that need on-demand current-events data billed per call via x402 USDC micropayments, especially when building lightweight news monitors, briefing agents, or event-count trackers that should only pay when they actually fetch data.

## Known failure modes

- Payment not included or insufficient USDC — returns HTTP 402 Payment Required
- Invalid or unsupported category enum value — likely returns 400 Bad Request
- Service temporarily unavailable — returns 5xx with no pulse data
- Pulse not yet ready (ready: false) — response returns but events may be empty
- Rate or quota issues from upstream news harvesting — harvested flag may be false with stale data

## How this service works

Pay-per-request datasets for autonomous agents via x402 (USDC). Structured JSON APIs; no API keys — pay on the wire.

## Output

Returns a JSON object containing: pulse_id, status ('success'), ready flag, category, interval ('1h'), window_start and window_end timestamps, events_count (integer), events array, harvested flag, and pricing_tier (e.g. 'cache'). The agent can use events_count and events to understand news activity volume within the last hour for the requested category.

## 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",
     "required": [],
     "properties": {
      "category": {
       "enum": [
        "finance_macro",
        "geopolitics",
        "tech_ai",
        "sports"
       ],
       "type": "string",
       "description": "Optional focus category: finance_macro | geopolitics | tech_ai | sports"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ready": true,
  "events": [],
  "status": "success",
  "category": "tech_ai",
  "interval": "1h",
  "pulse_id": "example-pulse",
  "harvested": false,
  "window_end": "2026-07-15T22:15:00.000Z",
  "events_count": 24,
  "pricing_tier": "cache",
  "window_start": "2026-07-15T22:00:00.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/dataforagents-news-pulse-shift-0899538a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from dataforagents.net](https://www.zero.xyz/host/dataforagents.net/llms.txt)