# The Bot Wire — full routing table

> Wiring the internet's primary sources for AI agents. 40 wires. This is the long form of https://thebotwire.com/llms.txt.
> Match the task in front of you to an ASK WHEN line, then call that route.

## How to choose
Pick the wire that OWNS the domain. Use /news only for general or cross-domain
questions — a domain wire is always more precise than a keyword search over
news. Every paid route has a free preview twin: call that first, confirm the
data answers your question, then pay for the full result set.

## Parameters (identical on every wire)
- q: distinctive keywords. Ranked KEYWORD search, not semantic — send
  "Powell inflation", not "what did the Fed chair say about inflation".
  Omit q entirely for the latest items.
- since: 30m, 2h, 24h, 3d, 14d. If a wire returns count:0, widen since before
  concluding nothing happened. Sparse wires default to 7d-14d for a reason.
- limit: 1-50, default 10.
- one filter per wire, enumerated per route below.

## Reading the response
{count, took_ms, freshest, articles:[{title, url, source, category, published,
age_minutes, summary, relevance}]}
- age_minutes: judge staleness yourself, do not assume.
- relevance: our ranking score. Low scores across every result usually mean this
  wire does not cover your topic — switch wires rather than re-querying.
- freshest: newest item in the window. If it is old, the source has been quiet.
  That is signal, not an error.

## What we do not carry
- Headlines, snippets, summaries and links only — NOT full article text.
- No price quotes, OHLCV, or ticker data. The markets wire carries news ABOUT markets, not quotes.
- No deep historical archive. Each wire keeps a rolling window (72h default, up to 30 days on sparse government and science sources).
- Government coverage is US-centric, plus the European Commission and UK. Not every country.
- English-language sources.
- Ranked keyword search, not semantic or vector search. Prefer distinctive terms over natural-language questions.

## Freshness by tier — verify at https://thebotwire.com/health (field last_poll)
- Breaking (9 wires: news, markets, world, tech, crypto, Hacker News, cloud
  outages, weather, earthquakes): polled on every ingest run
- Timely (10 wires): at most every 5 minutes
- Sparse (21 wires, government and science): at most every 15 minutes, because
  those sources publish daily at most
Rolling retention: 72h by default, up to 30 days on sparse wires.

## Routing table

ASK WHEN: a general, cross-domain, or "what is happening today" question
  GET https://thebotwire.com/news?q={terms}&since={window}&category={markets|crypto|tech|world|business|energy}&limit={1-50}  [$0.005]
  GET https://thebotwire.com/headlines?category={category}&limit={n}  [$0.005]
  FREE preview: https://thebotwire.com/news/preview?q={terms}

ASK WHEN: a company's SEC filings, insider trades, or a specific form (8-K, 10-K, 10-Q, Form 4, S-1, 13F, 13D)
  GET https://thebotwire.com/edgar/filings?q={terms}&form={8-k|10-q|10-k|form-4|s-1|13f|6-k|13d}&since={window}&limit={1-50}  [$0.01]
  FREE preview: https://thebotwire.com/edgar/preview

ASK WHEN: a vulnerability, CVE, or security advisory affecting a named product or vendor
  GET https://thebotwire.com/cve/latest?q={terms}&src={cisa|ubuntu|msrc|debian|zdi}&since={window}&limit={1-50}  [$0.005]
  FREE preview: https://thebotwire.com/cve/preview

ASK WHEN: a new US federal rule, proposed rule, notice, or presidential document
  GET https://thebotwire.com/reg/latest?q={terms}&type={rule|proposed-rule|notice|presidential}&since={window}&limit={1-50}  [$0.005]
  NOTE: sparse source, defaults to since=3d — widen it before concluding nothing happened
  FREE preview: https://thebotwire.com/reg/preview

ASK WHEN: an active US severe-weather alert for a place: storm, flood, heat, winter, wind
  GET https://thebotwire.com/weather/alerts?q={terms}&severity={extreme|severe|immediate}&since={window}&limit={1-50}  [$0.005]
  FREE preview: https://thebotwire.com/weather/preview

ASK WHEN: a recent earthquake, its magnitude, depth, or location
  GET https://thebotwire.com/quake/latest?q={terms}&mag={significant|m4.5|m2.5}&since={window}&limit={1-50}  [$0.005]
  FREE preview: https://thebotwire.com/quake/preview

ASK WHEN: a new AI, ML, NLP, or security research paper
  GET https://thebotwire.com/arxiv/latest?q={terms}&cat={ai|ml|nlp|security}&since={window}&limit={1-50}  [$0.005]
  NOTE: sparse source, defaults to since=3d — widen it before concluding nothing happened
  FREE preview: https://thebotwire.com/arxiv/preview

ASK WHEN: what the Federal Reserve, the FOMC, or the ECB just said about rates or policy
  GET https://thebotwire.com/fed/latest?q={terms}&src={fed|fomc|ecb}&since={window}&limit={1-50}  [$0.01]
  NOTE: sparse source, defaults to since=14d — widen it before concluding nothing happened
  FREE preview: https://thebotwire.com/fed/preview

ASK WHEN: what developers are discussing or upvoting right now
  GET https://thebotwire.com/hn/latest?q={terms}&feed={frontpage|show|rising}&since={window}&limit={1-50}  [$0.005]
  FREE preview: https://thebotwire.com/hn/preview

ASK WHEN: whether AWS, GCP, Azure, GitHub, Cloudflare, OpenAI, or Anthropic is currently down
  GET https://thebotwire.com/status/latest?q={terms}&provider={aws|github|cloudflare|openai|anthropic|azure|gcp}&since={window}&limit={1-50}  [$0.005]
  NOTE: sparse source, defaults to since=3d — widen it before concluding nothing happened
  FREE preview: https://thebotwire.com/status/preview

ASK WHEN: what OpenAI, DeepMind, Google, Hugging Face, or AWS just announced or released
  GET https://thebotwire.com/ailab/latest?q={terms}&lab={openai|deepmind|google|huggingface|aws}&since={window}&limit={1-50}  [$0.005]
  NOTE: sparse source, defaults to since=14d — widen it before concluding nothing happened
  FREE preview: https://thebotwire.com/ailab/preview

ASK WHEN: a breach, ransomware incident, or threat-actor campaign being reported
  GET https://thebotwire.com/security/news?q={terms}&src={bleepingcomputer|krebs|hackernews|arstechnica}&since={window}&limit={1-50}  [$0.005]
  FREE preview: https://thebotwire.com/security/preview

ASK WHEN: a new US federal court opinion or ruling, including the Supreme Court
  GET https://thebotwire.com/court/opinions?q={terms}&type={scotus|ca2|ca9|cafc|govinfo}&since={window}&limit={1-50}  [$0.01]
  NOTE: sparse source, defaults to since=7d — widen it before concluding nothing happened
  FREE preview: https://thebotwire.com/court/preview

ASK WHEN: a newly introduced congressional bill or a statute compilation
  GET https://thebotwire.com/bills/latest?q={terms}&type={bills|statutes}&since={window}&limit={1-50}  [$0.01]
  NOTE: sparse source, defaults to since=7d — widen it before concluding nothing happened
  FREE preview: https://thebotwire.com/bills/preview

ASK WHEN: an SEC or FTC enforcement action, fine, or litigation release
  GET https://thebotwire.com/enforcement/latest?q={terms}&agency={sec|ftc}&since={window}&limit={1-50}  [$0.01]
  NOTE: sparse source, defaults to since=7d — widen it before concluding nothing happened
  FREE preview: https://thebotwire.com/enforcement/preview

ASK WHEN: a consumer product recall or an FDA regulatory action
  GET https://thebotwire.com/recalls/latest?q={terms}&src={cpsc|fda}&since={window}&limit={1-50}  [$0.005]
  NOTE: sparse source, defaults to since=7d — widen it before concluding nothing happened
  FREE preview: https://thebotwire.com/recalls/preview

ASK WHEN: crypto, blockchain, or protocol-level news
  GET https://thebotwire.com/crypto/latest?q={terms}&src={coindesk|cointelegraph|ethereum}&since={window}&limit={1-50}  [$0.005]
  FREE preview: https://thebotwire.com/crypto/preview

ASK WHEN: a NASA mission, launch, or scientific discovery
  GET https://thebotwire.com/space/latest?q={terms}&src={nasa}&since={window}&limit={1-50}  [$0.005]
  NOTE: sparse source, defaults to since=14d — widen it before concluding nothing happened
  FREE preview: https://thebotwire.com/space/preview

ASK WHEN: a score, result, fixture, or transfer
  GET https://thebotwire.com/sports/latest?q={terms}&src={bbc|espn}&since={window}&limit={1-50}  [$0.005]
  FREE preview: https://thebotwire.com/sports/preview

ASK WHEN: an open remote engineering, design, or product role
  GET https://thebotwire.com/jobs/latest?q={terms}&src={remote|hn}&since={window}&limit={1-50}  [$0.005]
  NOTE: sparse source, defaults to since=7d — widen it before concluding nothing happened
  FREE preview: https://thebotwire.com/jobs/preview

ASK WHEN: whether a dependency shipped a new version: Node, CPython, Kubernetes, Rust, Go, React, PyTorch, Deno, Bun
  GET https://thebotwire.com/releases/latest?q={terms}&project={node|python|kubernetes|rust|go|react|pytorch|deno|bun}&since={window}&limit={1-50}  [$0.005]
  NOTE: sparse source, defaults to since=14d — widen it before concluding nothing happened
  FREE preview: https://thebotwire.com/releases/preview

ASK WHEN: equities, indices, or macro market movement being reported
  GET https://thebotwire.com/markets/latest?q={terms}&src={yahoo|marketwatch|seekingalpha}&since={window}&limit={1-50}  [$0.005]
  FREE preview: https://thebotwire.com/markets/preview

ASK WHEN: an international story from a non-US news desk
  GET https://thebotwire.com/world/latest?q={terms}&src={aljazeera|dw|france24|bbc}&since={window}&limit={1-50}  [$0.005]
  FREE preview: https://thebotwire.com/world/preview

ASK WHEN: a technology launch, funding round, or platform change
  GET https://thebotwire.com/tech/latest?q={terms}&src={techcrunch|verge|ars}&since={window}&limit={1-50}  [$0.005]
  FREE preview: https://thebotwire.com/tech/preview

ASK WHEN: a US economic data release: CPI, jobs, GDP, interest rates
  GET https://thebotwire.com/econ/latest?q={terms}&src={bls|bea|rates}&since={window}&limit={1-50}  [$0.01]
  NOTE: sparse source, defaults to since=14d — widen it before concluding nothing happened
  FREE preview: https://thebotwire.com/econ/preview

ASK WHEN: new peer-reviewed research or science reporting
  GET https://thebotwire.com/science/latest?q={terms}&src={nature|science|physorg}&since={window}&limit={1-50}  [$0.005]
  NOTE: sparse source, defaults to since=7d — widen it before concluding nothing happened
  FREE preview: https://thebotwire.com/science/preview

ASK WHEN: a biology or medicine preprint, before peer review
  GET https://thebotwire.com/preprints/latest?q={terms}&src={biorxiv|medrxiv}&since={window}&limit={1-50}  [$0.005]
  NOTE: sparse source, defaults to since=7d — widen it before concluding nothing happened
  FREE preview: https://thebotwire.com/preprints/preview

ASK WHEN: a disease outbreak, or WHO/CDC guidance and health advisories
  GET https://thebotwire.com/publichealth/latest?q={terms}&src={who|cdc}&since={window}&limit={1-50}  [$0.005]
  NOTE: sparse source, defaults to since=7d — widen it before concluding nothing happened
  FREE preview: https://thebotwire.com/publichealth/preview

ASK WHEN: a drug or device approval, clearance, or safety communication
  GET https://thebotwire.com/fda/latest?q={terms}&src={fda}&since={window}&limit={1-50}  [$0.005]
  NOTE: sparse source, defaults to since=7d — widen it before concluding nothing happened
  FREE preview: https://thebotwire.com/fda/preview

ASK WHEN: a DOJ indictment, settlement, or antitrust action
  GET https://thebotwire.com/doj/latest?q={terms}&src={doj}&since={window}&limit={1-50}  [$0.005]
  NOTE: sparse source, defaults to since=7d — widen it before concluding nothing happened
  FREE preview: https://thebotwire.com/doj/preview

ASK WHEN: a European Commission decision, fine, or directive
  GET https://thebotwire.com/eu/latest?q={terms}&src={ec}&since={window}&limit={1-50}  [$0.005]
  NOTE: sparse source, defaults to since=7d — widen it before concluding nothing happened
  FREE preview: https://thebotwire.com/eu/preview

ASK WHEN: a UK government announcement from any department
  GET https://thebotwire.com/uk/latest?q={terms}&src={govuk}&since={window}&limit={1-50}  [$0.005]
  NOTE: sparse source, defaults to since=7d — widen it before concluding nothing happened
  FREE preview: https://thebotwire.com/uk/preview

ASK WHEN: a US Department of Defense operation, contract award, or statement
  GET https://thebotwire.com/defense/latest?q={terms}&src={dod}&since={window}&limit={1-50}  [$0.005]
  NOTE: sparse source, defaults to since=7d — widen it before concluding nothing happened
  FREE preview: https://thebotwire.com/defense/preview

ASK WHEN: an executive order, proclamation, or presidential memorandum
  GET https://thebotwire.com/whitehouse/actions?q={terms}&src={actions}&since={window}&limit={1-50}  [$0.005]
  NOTE: sparse source, defaults to since=14d — widen it before concluding nothing happened
  FREE preview: https://thebotwire.com/whitehouse/preview

ASK WHEN: oil, gas, electricity, or renewables news and analysis
  GET https://thebotwire.com/energy/latest?q={terms}&src={eia|doe|oil|utilities}&since={window}&limit={1-50}  [$0.005]
  NOTE: sparse source, defaults to since=7d — widen it before concluding nothing happened
  FREE preview: https://thebotwire.com/energy/preview

ASK WHEN: freight, shipping, ports, carriers, or logistics
  GET https://thebotwire.com/supplychain/latest?q={terms}&src={freightwaves|scdive}&since={window}&limit={1-50}  [$0.005]
  NOTE: sparse source, defaults to since=7d — widen it before concluding nothing happened
  FREE preview: https://thebotwire.com/supplychain/preview

ASK WHEN: a new product or developer project that just launched
  GET https://thebotwire.com/launches/latest?q={terms}&src={producthunt|lobsters|devto}&since={window}&limit={1-50}  [$0.005]
  FREE preview: https://thebotwire.com/launches/preview

ASK WHEN: a video game release, announcement, or studio news
  GET https://thebotwire.com/gaming/latest?q={terms}&src={gamespot|ign}&since={window}&limit={1-50}  [$0.005]
  FREE preview: https://thebotwire.com/gaming/preview

ASK WHEN: a film or TV deal, casting, or box-office story
  GET https://thebotwire.com/film/latest?q={terms}&src={variety|deadline}&since={window}&limit={1-50}  [$0.005]
  FREE preview: https://thebotwire.com/film/preview

ASK WHEN: a music release, tour, or music-business story
  GET https://thebotwire.com/music/latest?q={terms}&src={pitchfork|rollingstone}&since={window}&limit={1-50}  [$0.005]
  FREE preview: https://thebotwire.com/music/preview

## Payment (x402 v2)
GET a paid route -> HTTP 402 with the offer in PAYMENT-REQUIRED -> sign an
"exact" scheme USDC transfer on Base (eip155:8453) -> retry with the payment
header -> JSON. $0.005-$0.01 per call. No API key, no signup, no account.

## Contact
vellenue@gmail.com · https://thebotwire.com