# PulseFeed

> Independent trust & safety oracle for the x402 agent-payment ecosystem, plus real-time Base on-chain intelligence. AI agents pay per call via x402 (USDC on Base).

## Why it matters
~70% of listed x402 endpoints are dead or invalid, and only ~half of what catalogs call "healthy" actually returns a valid x402 challenge. Before an agent pays an unknown endpoint, it should verify it. PulseFeed is that verification layer.

## Free, machine-readable
- https://pulsefeed.dev/ — service manifest (JSON): all tools, prices, how to pay via x402
- https://pulsefeed.dev/status.json — live x402 ecosystem audit: live services, catalog accuracy, risk map, on-chain receiver profiles
- https://pulsefeed.dev/openapi.json — OpenAPI schema
- https://pulsefeed.dev/status — human-readable observatory (HTML)
- https://pulsefeed.dev/reports — "State of x402" report: ecosystem health & catalog accuracy over time, updated daily (HTML)
- https://pulsefeed.dev/reports.json — machine-readable State of x402 report + time series
- https://pulsefeed.dev/methodology — how PulseFeed scores x402 trust (transparent methodology & docs)
- https://pulsefeed.dev/badge.svg?endpoint=<url> — embeddable trust badge for any x402 service (put <img> on your site/README)

## Paid tools (x402, USDC on Base)
- GET https://pulsefeed.dev/trust?endpoint=<url> — verify an x402 endpoint before paying: live validity, uptime/reputation, scam/anomaly scan (payTo hijack, price bait-and-switch, honeypot, non-USDC asset), on-chain receiver profile, pay/avoid verdict. No param = working-services catalog + ecosystem risk map.
- GET https://pulsefeed.dev/trust/history?endpoint=<url> — the endpoint's track record over time: uptime, payTo & price change history, trend. Unique compounding data from continuous audit.
- GET https://pulsefeed.dev/pulse?token=<0x...> — live token pulse on Base (transfer activity, unique senders/receivers, volume)
- GET https://pulsefeed.dev/whales?token=<0x...> — large transfers (whale alerts)
- GET https://pulsefeed.dev/flow?token=<0x...> — accumulation/distribution (smart-money flow)
- GET https://pulsefeed.dev/momentum?token=<0x...> — heating up or cooling down vs previous window

## How to pay
Call any paid tool without payment to receive a 402 with x402 payment details, then retry with the payment header. Facilitator: Coinbase CDP (Base mainnet, USDC).