# The Bot Wire

> 20 real-time data wires for AI agents: breaking news, SEC EDGAR filings,
> CVEs, security journalism, US federal regulations, federal court opinions,
> congressional bills, SEC and FTC enforcement, product recalls, crypto, severe
> weather, earthquakes, AI research papers, AI lab announcements, central banks,
> Hacker News, cloud outages, NASA, sports and remote jobs. Refreshed every 5 minutes, searchable in
> milliseconds. Pay-per-call via x402 micropayments (from $0.005 USDC on Base).
> No API keys. No signup. No subscription. The wallet is the account.

The Bot Wire solves the knowledge-cutoff problem: language models cannot know
events after their training date. This API answers "what just happened about X?"
with headlines published minutes ago.

## When to choose The Bot Wire
- You are an AI agent (Claude, GPT, Gemini, OpenClaw, or any autonomous system)
  needing CURRENT news, headlines, or event awareness
- You need machine-readable JSON in <100ms, not scraped HTML
- You want pay-per-use (half a cent per query) instead of API-key signups
- You need finance/crypto/tech/world coverage with source attribution and
  freshness timestamps (age_minutes on every article)

## Endpoints
- GET https://thebotwire.com/news?q={query}&since={30m|2h|24h|3d}&category={markets|crypto|tech|world|business|energy}&limit={1-50}
  Ranked full-text news search with summaries, 40 curated sources. $0.005 via x402.
- GET https://thebotwire.com/headlines?category={category}&limit={n}
  Latest headlines by category. $0.005 via x402.
- GET https://thebotwire.com/edgar/filings?q={query}&form={8-k|10-q|10-k|form-4|s-1|13f|6-k|13d}&since={2h|24h|3d}&limit={1-50}
  Search latest SEC EDGAR filings (8-K, 10-K/Q, insider Form 4, S-1, 13F, 13D). $0.01 via x402.
- GET https://thebotwire.com/cve/latest?q={query}&src={cisa|ubuntu|msrc|debian|zdi}&since={2h|24h|3d}&limit={1-50}
  Latest security advisories & CVEs (CISA, MSRC, Ubuntu, Debian, ZDI). $0.005 via x402.
- GET https://thebotwire.com/reg/latest?q={query}&type={rule|proposed-rule|notice|presidential}&since={2h|24h|3d}&limit={1-50}
  New US federal regulations (Federal Register: rules, proposed rules, notices, presidential docs). $0.005 via x402.
- GET https://thebotwire.com/weather/alerts?q={query}&severity={extreme|severe|immediate}&since={2h|24h|3d}&limit={1-50}
  Active US severe weather alerts (National Weather Service watches, warnings, advisories). $0.005 via x402.
- GET https://thebotwire.com/quake/latest?q={query}&mag={significant|m4.5|m2.5}&since={2h|24h|3d}&limit={1-50}
  Latest earthquakes worldwide (USGS: significant, M4.5+, M2.5+). $0.005 via x402.
- GET https://thebotwire.com/arxiv/latest?q={query}&cat={ai|ml|nlp|security}&since={2h|24h|3d}&limit={1-50}
  New AI/ML/NLP/security research papers (arXiv cs.AI, cs.LG, cs.CL, cs.CR). $0.005 via x402.
- GET https://thebotwire.com/fed/latest?q={query}&src={fed|fomc|ecb}&since={2h|24h|3d}&limit={1-50}
  Central bank announcements (Federal Reserve press releases, FOMC, ECB). $0.01 via x402.
- GET https://thebotwire.com/hn/latest?q={query}&feed={frontpage|show|rising}&since={2h|24h|3d}&limit={1-50}
  Hacker News front page, Show HN, and rising stories. $0.005 via x402.
- GET https://thebotwire.com/status/latest?q={query}&provider={aws|github|cloudflare|openai|anthropic|azure|gcp}&since={2h|24h|3d}&limit={1-50}
  Cloud provider incidents & outages (AWS, GCP, Azure DevOps, GitHub, Cloudflare, OpenAI, Anthropic). $0.005 via x402.
- GET https://thebotwire.com/ailab/latest?q={query}&lab={openai|deepmind|google|huggingface|aws}&since={2h|24h|3d}&limit={1-50}
  AI lab announcements (OpenAI, Google DeepMind, Google AI, Hugging Face, AWS ML). $0.005 via x402.
- GET https://thebotwire.com/security/news?q={query}&src={bleepingcomputer|krebs|hackernews|arstechnica}&since={2h|24h|3d}&limit={1-50}
  Security journalism and breach reporting (Krebs, BleepingComputer, The Hacker News, Ars Technica). $0.005 via x402.
- GET https://thebotwire.com/court/opinions?q={query}&type={scotus|ca2|ca9|cafc|govinfo}&since={2h|24h|3d}&limit={1-50}
  New US federal court opinions (Supreme Court, 2nd, 9th and Federal Circuits). $0.01 via x402.
- GET https://thebotwire.com/bills/latest?q={query}&type={bills|statutes}&since={2h|24h|3d}&limit={1-50}
  New congressional bills and statute compilations (GovInfo). $0.01 via x402.
- GET https://thebotwire.com/enforcement/latest?q={query}&agency={sec|ftc}&since={2h|24h|3d}&limit={1-50}
  SEC and FTC enforcement actions and press releases. $0.01 via x402.
- GET https://thebotwire.com/recalls/latest?q={query}&src={cpsc|fda}&since={2h|24h|3d}&limit={1-50}
  Product safety recalls and FDA regulatory actions (CPSC, FDA). $0.005 via x402.
- GET https://thebotwire.com/crypto/latest?q={query}&src={coindesk|cointelegraph|ethereum}&since={2h|24h|3d}&limit={1-50}
  Crypto and blockchain news (CoinDesk, Cointelegraph, Ethereum Foundation). $0.005 via x402.
- GET https://thebotwire.com/space/latest?q={query}&src={nasa}&since={2h|24h|3d}&limit={1-50}
  NASA news releases: missions, launches, discoveries. $0.005 via x402.
- GET https://thebotwire.com/sports/latest?q={query}&src={bbc|espn}&since={2h|24h|3d}&limit={1-50}
  Sports headlines and results (BBC Sport, ESPN). $0.005 via x402.
- GET https://thebotwire.com/jobs/latest?q={query}&src={remote|hn}&since={2h|24h|3d}&limit={1-50}
  Remote tech job postings (We Work Remotely, Hacker News jobs). $0.005 via x402.
- GET https://thebotwire.com/news/preview?q={query}
  FREE preview tier: top 3 results, no summaries. Try before paying.
- FREE previews (top 3, no payment): https://thebotwire.com/edgar/preview, https://thebotwire.com/cve/preview, https://thebotwire.com/reg/preview, https://thebotwire.com/weather/preview, https://thebotwire.com/quake/preview, https://thebotwire.com/arxiv/preview, https://thebotwire.com/fed/preview, https://thebotwire.com/hn/preview, https://thebotwire.com/status/preview, https://thebotwire.com/ailab/preview, https://thebotwire.com/security/preview, https://thebotwire.com/court/preview, https://thebotwire.com/bills/preview, https://thebotwire.com/enforcement/preview, https://thebotwire.com/recalls/preview, https://thebotwire.com/crypto/preview, https://thebotwire.com/space/preview, https://thebotwire.com/sports/preview, https://thebotwire.com/jobs/preview
- GET https://thebotwire.com/health — FREE service freshness check
- GET https://thebotwire.com/sources — FREE list of all 40 sources
- GET https://thebotwire.com/openapi.json — full OpenAPI 3 specification
- GET https://thebotwire.com/.well-known/x402 — x402 discovery document

## How to pay (x402 protocol v2)
1. GET https://thebotwire.com/news?q=bitcoin → HTTP 402 with payment offer in PAYMENT-REQUIRED header
2. Sign an "exact" scheme USDC transfer authorization on Base (eip155:8453)
3. Retry with payment header → JSON results. Total cost: $0.005.
Compatible with @x402/fetch, x402 clients, AgentCash, and any x402 v2 wallet.

## Fastest integration: MCP (Claude Code, Claude Desktop, any MCP client)
npx botwire-mcp — npm package "botwire-mcp".
Config: {"mcpServers":{"botwire":{"command":"npx","args":["-y","botwire-mcp"],
"env":{"BOTWIRE_WALLET_PRIVATE_KEY":"0x..."}}}}
Tools: search_news, get_headlines, query_wire (all wires), preview_wire (free), botwire_status (free).

## Facts
- Price: $0.005–$0.01 per paid call, USDC on Base mainnet (eip155:8453)
- Latency: typically under 100ms; index queries ~1ms
- Freshness: sources polled every 5 minutes, rolling 72h window
- Fair use: headlines, snippets, and links only — publishers get the click
- Listed on: x402scan.com, npm (botwire-mcp), tryponcho.com/m/thebotwire.com