{"openapi":"3.0.0","info":{"title":"PulseFeed x402 API","version":"1.0.0","description":"Real-time Base on-chain intelligence + x402 trust oracle for AI agents. Pay-per-call via x402 (USDC on Base)."},"servers":[{"url":"https://www.pulsefeed.dev"}],"paths":{"/pulse":{"get":{"summary":"Token pulse: on-chain activity over a block window","parameters":[{"name":"token","in":"query","required":true,"schema":{"type":"string"},"description":"ERC-20 contract address (0x...)"}],"responses":{"200":{"description":"OK"},"402":{"description":"Payment Required (x402)"}}}},"/whales":{"get":{"summary":"Whale alerts: large token transfers","parameters":[{"name":"token","in":"query","required":true,"schema":{"type":"string"},"description":"ERC-20 contract address (0x...)"},{"name":"min","in":"query","required":false,"schema":{"type":"number"},"description":"min transfer size (token units)"}],"responses":{"200":{"description":"OK"},"402":{"description":"Payment Required (x402)"}}}},"/flow":{"get":{"summary":"Accumulation/distribution: net flow by address","parameters":[{"name":"token","in":"query","required":true,"schema":{"type":"string"},"description":"ERC-20 contract address (0x...)"}],"responses":{"200":{"description":"OK"},"402":{"description":"Payment Required (x402)"}}}},"/momentum":{"get":{"summary":"Momentum: current vs previous window","parameters":[{"name":"token","in":"query","required":true,"schema":{"type":"string"},"description":"ERC-20 contract address (0x...)"}],"responses":{"200":{"description":"OK"},"402":{"description":"Payment Required (x402)"}}}},"/trust":{"get":{"summary":"x402 trust & safety oracle: verify an endpoint + scam/anomaly scan / working-services catalog with ecosystem risk map","parameters":[{"name":"endpoint","in":"query","required":false,"schema":{"type":"string"},"description":"x402 endpoint URL to verify"}],"responses":{"200":{"description":"OK"},"402":{"description":"Payment Required (x402)"}}}},"/trust/history":{"get":{"summary":"x402 endpoint track record over time: uptime, payTo & price change history, trend (unique compounding audit data)","parameters":[{"name":"endpoint","in":"query","required":true,"schema":{"type":"string"},"description":"x402 endpoint URL"}],"responses":{"200":{"description":"OK"},"402":{"description":"Payment Required (x402)"}}}},"/trust/dataset":{"get":{"summary":"Bulk x402 trust dataset ($0.10): every service's full trust profile in one call — trustScore/verdict, scam flags, receiver stability, on-chain profile + compounding payTo/price history. For builders of trust/uptime tools. Free format preview in /status.json.","parameters":[{"name":"all","in":"query","required":false,"schema":{"type":"string"},"description":"1 = include dead/invalid services"},{"name":"limit","in":"query","required":false,"schema":{"type":"number"},"description":"max services (default 2000)"}],"responses":{"200":{"description":"OK"},"402":{"description":"Payment Required (x402)"}}}},"/data/full":{"get":{"summary":"PulseFeed Data API ($1.00): the whole cross-domain trust dataset in one call — every x402 service (moat profile) + every audited MCP server (safety) + ecosystem aggregates + live security incidents with on-chain proof. Free preview + schema in /data.json.","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"number"},"description":"max x402 services (default 3000)"},{"name":"all","in":"query","required":false,"schema":{"type":"string"},"description":"1 = include dead/invalid services"}],"responses":{"200":{"description":"OK"},"402":{"description":"Payment Required (x402)"}}}},"/incidents.json":{"get":{"summary":"Free: live x402 security incidents — receiver hijacks, bait-and-switch, honeypots, unverified receivers — each with on-chain proof","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"number"}},{"name":"limit","in":"query","required":false,"schema":{"type":"number"}}],"responses":{"200":{"description":"OK (free)"}}}},"/data.json":{"get":{"summary":"Free: PulseFeed Data API preview + schema + coverage + samples (the paid full feed is /data/full)","responses":{"200":{"description":"OK (free)"}}}},"/verify":{"get":{"summary":"Free cached trust verdict for an x402 endpoint (liveness, score, verdict, band, flags) — powers the guard SDK & agent tools","parameters":[{"name":"endpoint","in":"query","required":true,"schema":{"type":"string"},"description":"x402 endpoint URL"}],"responses":{"200":{"description":"OK (free)"}}}},"/status.json":{"get":{"summary":"Free: live x402 ecosystem audit — live services, catalog accuracy, risk map, on-chain receiver profiles + bulk-dataset preview","responses":{"200":{"description":"OK (free)"}}}},"/changes.json":{"get":{"summary":"Free: recent ecosystem change feed — services gone dark, payTo swaps, price jumps, new services","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"number"}},{"name":"limit","in":"query","required":false,"schema":{"type":"number"}}],"responses":{"200":{"description":"OK (free)"}}}},"/reports.json":{"get":{"summary":"Free: State of x402 report + ecosystem time series (updated daily)","responses":{"200":{"description":"OK (free)"}}}},"/trust-score.json":{"get":{"summary":"Free: the PulseFeed Trust Score standard spec — bands, factors, versioning","responses":{"200":{"description":"OK (free)"}}}}}}