# TerminalFeed.io — Real-Time World Data

> TerminalFeed is a free real-time dashboard aggregating 35+ live data feeds.
> This file helps AI agents understand what data is available.

> Free Premium Trial: 100 Calls Per IP Per Day. Every IP address gets up to 100 free /api/pro/* premium API calls per 24-hour rolling window. No authentication, no signup, no wallet, no credit card required. Just call the endpoint without an Authorization header and the trial counter increments automatically. Self-service status: GET https://terminalfeed.io/api/free-tier/status (no auth, does not consume a slot). After the cap is reached the canonical x402 V2 402 challenge fires with `free_trial.status` set to "exhausted" and `resets_at` populated. Applies to every TerminalFeed premium endpoint (briefing, macro, crypto-deep, sentiment, world-deltas, agent-context, correlation-matrix, whales, exchange-flows, defi-tvl, stablecoin-flows, github-velocity). Free-trial responses are still AFTA receipt-signed; the receipt records `no_charge_reason: free_trial`.

> Agent Fair-Trade Agreement (AFTA): TerminalFeed is agent fair-trade certified.
> Code-enforced no-charge guarantees on 5xx, breaker, schema fail, and stale data.
> Ed25519-signed receipts on every paid call. Public on-chain payment rail (USDC on Base).
> Inference-only license. Built with Claude. Reciprocal access with TensorFeed: a single
> bearer token works on tensorfeed.ai and terminalfeed.io; credits live in one ledger.
> Standard at https://terminalfeed.io/.well-known/agent-fair-trade.json
> Whitepaper at https://tensorfeed.ai/whitepaper (canonical AFTA spec, maintained by federation host)
> Manifesto at https://terminalfeed.io/agent-fair-trade
> Public no-charge ledger at https://terminalfeed.io/api/payment/no-charge-stats
> Receipt verify endpoint at https://terminalfeed.io/api/receipt/verify
> Public Ed25519 key at https://terminalfeed.io/.well-known/terminalfeed-receipt-key.json

**x402 method support.** TerminalFeed accepts x402 payments today through the federation with TensorFeed: a bearer token minted on either site (via USDC on Base mainnet, network eip155:8453) works on both. Stripe Link agents (link.com/agents) holding Shared Payment Tokens cannot pay TerminalFeed directly today; the federation host (tensorfeed.ai) is evaluating SPT verification, and once live, TerminalFeed will inherit SPT acceptance without its own Stripe merchant account. Until then, Link agents should use the credits flow at /api/payment/buy-credits (which proxies to TF) or send USDC on Base. The full x402 manifest is at https://tensorfeed.ai/.well-known/x402.json (TerminalFeed inherits TF's x402 manifest by federation).

## For AI agents and frameworks

Machine-readable manifests:
- OpenAPI spec: https://terminalfeed.io/openapi.json
- Plugin manifest (OpenAI plugin format): https://terminalfeed.io/.well-known/ai-plugin.json
- Capability manifest: https://terminalfeed.io/agents.txt
- Function-calling tool defs: https://terminalfeed.io/api/llm-tools?format=anthropic
- MCP server (JSON-RPC over HTTP): https://terminalfeed.io/api/mcp (30 tools native; pass Authorization: Bearer tf_live_<64-char-hex> for premium)

Canonical landing pages for agent-builders:
- https://terminalfeed.io/api/for-agents (overview, why-not-DIY, quick start)
- https://terminalfeed.io/developers/agent-payments (full developer guide)
- https://terminalfeed.io/developers/openai-tools (drop-in OpenAI/Anthropic/Gemini tool definitions, universal handler, end-to-end example)
- https://terminalfeed.io/api/llm-tools (live tool catalog: openai, anthropic, raw)
- https://terminalfeed.io/api/usdc-payable (X402 / USDC payment surface)

Cross-site bundle: https://tensorfeed.ai/developers/agent-payments
Same wallet, same credit pool. Tokens minted on either site spend on either site.

License:
- Free endpoints: permissive use
- Premium endpoints (/api/pro/*): inference-only; not licensed as training data, fine-tuning input, model distillation, or dataset redistribution. See https://terminalfeed.io/terms#premium for full clauses.

## What TerminalFeed Provides

Real-time data across these categories:
- Cryptocurrency: BTC price (WebSocket), top 30 crypto by market cap, Fear & Greed index, whale transactions, mempool data
- Stock Market: Top 30 US stocks with biggest movers, indices (SPY, QQQ, DIA, IWM), gold
- News: Hacker News, Ars Technica, The Verge, TechCrunch, Reddit tech feeds
- World Events: Earthquakes (USGS), global disasters (GDACS), space launches, solar weather
- Developer: GitHub trending, GitHub events, Stack Overflow hot questions, NPM trends, 13 service status monitors
- Wikipedia: Live edit stream (SSE), featured article of the day
- Social: Bluesky posts, Reddit tech, Show HN / Ask HN
- Culture: AI model leaderboard, hacker history (The Wire), trending books, museum art, daily recipes

## Data Freshness

Most data updates every 30-90 seconds. WebSocket feeds (BTC, stocks) update every 1-3 seconds.
Wikipedia edits stream in real-time via Server-Sent Events.

## For AI Agents

Visit https://terminalfeed.io to see all data rendered live.
The site is a single-page application — all data is fetched client-side from free public APIs.

## Source APIs Used

CoinGecko, Binance WebSocket, Finnhub, mempool.space, ESPN, USGS, GDACS, NASA DONKI,
Open-Meteo, Hacker News Firebase, RSS2JSON, GitHub API, StackExchange, Frankfurter,
Open Library, Art Institute of Chicago, TheMealDB, Dog CEO, The Cat API, and more.

## Free API Endpoints (no auth, no key, no signup)

All free endpoints return JSON, support CORS, and follow a stale-cache-on-failure contract (always 200 with usable data). Rate limit: 100,000 requests/day per IP, target no more than 1 call per 30 seconds per endpoint.

- GET /api/                     directory of all endpoints
- GET /api/health               version + uptime
- GET /api/briefing             one-call world snapshot (BTC + Fear&Greed + quakes + HN + ISS)
- GET /api/btc-price            Bitcoin live ticker (Binance with CoinCap fallback)
- GET /api/stocks               top US stocks (Finnhub, optional ?symbols= filter)
- GET /api/crypto-movers        top 15 crypto movers by 24h change
- GET /api/fear-greed           Crypto Fear & Greed Index 0-100
- GET /api/forex                USD-base currency rates (Frankfurter)
- GET /api/economic-data        FRED Fed rate, CPI, unemployment, GDP
- GET /api/predictions          active Polymarket prediction markets
- GET /api/earthquake           recent earthquakes M2.5+ from USGS
- GET /api/disaster-alerts      global disaster alerts from GDACS
- GET /api/launches             upcoming space launches (The Space Devs)
- GET /api/humans-in-space      ISS crew (Open Notify)
- GET /api/cyber-threats        URLhaus + ThreatFox malware/IOCs
- GET /api/service-status       GitHub, Cloudflare, OpenAI, Anthropic status
- GET /api/gas                  Ethereum gas oracle (Etherscan)
- GET /api/weather              weather by ?lat=&lon= (Open-Meteo)
- GET /api/hackernews           Hacker News top stories
- GET /api/nasa-apod            NASA Astronomy Picture of the Day
- GET /api/hf-trending          HuggingFace trending models (top 15 by 7d likes)
- GET /api/solana-network       Solana network health (TPS, slot, epoch)
- GET /api/harnesses            Agentic-coding harness leaderboards (Claude Code, Cursor, Codex, Aider, OpenHands, Devin, SWE-Agent) across SWE-bench Verified, Terminal-Bench, Aider Polyglot, METR HCAST. ?view=summary|gaps|combined|raw
- GET /api/space-weather        NOAA SWPC: planetary Kp index, solar wind, X-ray flare class 24h, active alerts. 5min cache.
- GET /api/wildfires            NASA FIRMS active fire detections (North America 24h, top 25 by Fire Radiative Power). 10min cache.
- GET /api/severe-weather       National Weather Service active US alerts (top 15 by severity score: tornado, flood, severe thunderstorm, hurricane, winter, etc). 60s cache.
- GET /api/climate/earthquakes  USGS pre-built summary feed, parameterized by ?magnitude=(significant|4.5|2.5|1.0|all) x ?period=(hour|day|week|month). 20 selectable feeds. Public domain. Cache TTL scales with window (60s..900s).
- GET /api/climate/weather-alerts NWS active alerts, filterable by ?area=<2-letter state> ?event=<exact name> ?severity= ?urgency= ?status= ?limit=. US-only. Public domain. 60s cache.
- GET /api/funding-rates        Top 20 perp futures funding rates across Binance, Bybit, dYdX, Hyperliquid (sorted by absolute annualized %). 60s cache.
- GET /api/air-quality          Open-Meteo Air Quality (US AQI, PM2.5, PM10, ozone, NO2) by ?lat=&lon=. Defaults to LA. 30min cache.
- GET /api/shodan               Shodan InternetDB exposure scan: ports, CVEs, hostnames, tags. ?ip= for any public IPv4, default returns curated rotation (Cloudflare DNS, Google DNS, Quad9, OpenDNS, GitHub, Fastly). 1h cache. No key required.
- GET /api/volcanoes            Smithsonian GVP weekly volcano activity report. 1h cache.
- GET /api/llm-tools            pre-baked OpenAI / Anthropic function-calling tool definitions for every endpoint above. Pass ?format=openai or ?format=anthropic and paste the result directly into your tool-use scaffold. Free.

Full machine-readable contract: https://terminalfeed.io/openapi.json
Agent capability manifest: https://terminalfeed.io/agents.txt

## Premium API (USDC micropayments on Base mainnet)

Pay-as-you-go premium tier for autonomous agents that need composed multi-source payloads. Bearer-token auth. Credits are cross-redeemable on tensorfeed.ai (same wallet, same chain, shared credit pool). One purchase, both sites.

Discovery:
  /.well-known/agent-payments     JSON descriptor with auth flow + endpoints
  /openapi.json                   full OpenAPI 3.1 contract
  /agents.txt                     agent capability manifest

Payment flow:
  1. POST /api/payment/buy-credits {amount_usd}      -> wallet, memo, quote
  2. Send USDC on Base to wallet (memo optional)
  3. POST /api/payment/confirm {tx_hash, nonce}      -> bearer token + 50 credits
  4. GET  /api/pro/<endpoint> with Authorization: Bearer tf_live_<64-char-hex>
  5. GET  /api/payment/balance                       -> credits remaining (any time)

Premium endpoints (price per call at $1 USDC = 50 credits):

  Endpoint              Credits  Approx USD  Composes
  /api/pro/briefing     1        $0.02       BTC + Fear&Greed + quakes + HN + ISS + Polymarket
  /api/pro/macro        2        $0.04       FRED (5 series) + forex + commodities + indices + VIX
  /api/pro/crypto-deep  2        $0.04       top 50 + Binance top 20 + mempool.space + Etherscan gas
  /api/pro/sentiment    2        $0.04       Fear&Greed + VIX + trending tickers (HN + Reddit) + Polymarket signals
  /api/pro/world-deltas 2        $0.04       Time-sorted event stream: earthquakes + HN front-page + Polymarket + launches
  /api/pro/agent-context 2       $0.04       Curated world-state snapshot for LLMs + paste-ready system_prompt (~350 tokens)
  /api/pro/defi-tvl     2        $0.04       Top 50 DeFi protocols by TVL with movers + category breakdown (DefiLlama)
  /api/pro/stablecoin-flows 2    $0.04       Net stablecoin circulation changes (USDT, USDC, DAI, etc.) over 24h/7d/30d
  /api/pro/github-velocity 2     $0.04       Trending GitHub repos (7d), AI/ML share, language mix (GitHub Search API)
  /api/pro/correlation-matrix 2  $0.04       30-day Pearson correlations across BTC, ETH, SOL, AVAX, LINK, gold, treasuries, USD, oil
  /api/pro/whales       2        $0.04       Large on-chain BTC (>=10 BTC) and ETH (>=100 ETH) transactions in real time
  /api/pro/exchange-flows 2      $0.04       ETH net flow to major exchanges (Binance, Coinbase, OKX, Kraken, Bybit, Crypto.com, KuCoin)

Optional query params:
  /api/pro/briefing     ?include=btc,fear-greed,predictions   ?history=24h
  /api/pro/macro        ?history=30d
  /api/pro/crypto-deep  ?coins=btc,eth,sol                    ?history=30d
  /api/pro/sentiment    no params; returns top 15 trending tickers automatically
  /api/pro/world-deltas ?since=2026-04-27T22:00:00Z           defaults to 1h ago, clamped to 1h horizon
  /api/pro/agent-context no params; returns structured context + system_prompt string

Webhooks (push instead of poll, 1 credit per fire, ~5min cadence):
  POST   /api/pro/subscribe        body: { webhook_url, endpoint }   creates subscription, returns HMAC secret
  GET    /api/pro/subscriptions                                       lists owner's subs
  DELETE /api/pro/subscribe/<id>                                      cancels a sub
  Delivery: POST application/json with X-TerminalFeed-Signature: sha256=<hmac>, X-TerminalFeed-Timestamp: <unix>
  Verify: hmac_sha256(secret, timestamp + "." + raw_body) == signature
  Per-token cap: 5 active subs. Auto-pause on insufficient_credits.

Example invocations:

  curl -X POST https://terminalfeed.io/api/payment/buy-credits \
       -H "Content-Type: application/json" \
       -d '{"amount_usd":1.00}'

  curl -X POST https://terminalfeed.io/api/payment/confirm \
       -H "Content-Type: application/json" \
       -d '{"tx_hash":"0x...","nonce":"tf-..."}'

  curl https://terminalfeed.io/api/pro/macro \
       -H "Authorization: Bearer tf_live_<64-char-hex>"

Response includes header X-Credits-Remaining: <int>.

Failure modes (HTTP 402 Payment Required, body field `error`):
  missing_token         no Authorization header sent
  invalid_token         token format wrong or token does not exist
  insufficient_credits  token valid but balance too low
  expired               token revoked
  billing_unavailable   auth service unreachable, retry

Pricing: $1 USDC on Base mainnet = 50 credits. No subscription. No expiry. No KYC.
License: inference and reasoning only; not licensed as training data, fine-tuning input, model distillation, or dataset redistribution.
Refunds: none. All credit purchases are final and non-refundable. Credits never expire, however, and remain spendable indefinitely across terminalfeed.io and tensorfeed.ai. Recommendation: buy small ($1 = 50 credits) until call volume is calibrated, then top up.
AFTA deferred-debit: credits validate on entry but only debit on success. No charge on 5xx, billing-rail breaker, schema validation failure, or stale data. Each premium response includes an Ed25519-signed receipt and the no-charge events appear at /api/payment/no-charge-stats.
SLA: best-effort, stale-cache-on-failure means always-200 with usable data on the free tier; premium tier honors the freshness SLAs published at /api/meta.

Cross-site bundle: credits work on https://tensorfeed.ai (AI news + model intelligence). Same wallet, shared pool. A bearer token minted on either site works on the other; both sites are AFTA adopters.
Full docs: https://terminalfeed.io/developers/agent-payments
Mainnet proof: https://basescan.org/tx/0x6aa357c7e984e9bedef0987021f67ac4616b5446c3895d2eb64da5e98c56614c

Wallet (published, cross-verified at /terms, /developers/agent-payments, /llms.txt, GitHub README): 0x549c82e6bfc54bdae9a2073744cbc2af5d1fc6d1

## Editorial Team

Original articles credited to one of five author personas. Each persona has a permanent profile page listing every article they have bylined.

- Ripper: https://terminalfeed.io/team/ripper (founder, weekly originals, product)
- zer0day: https://terminalfeed.io/team/zer0day (security, privacy, hacker culture)
- Pulse: https://terminalfeed.io/team/pulse (markets, crypto, prediction markets)
- Node: https://terminalfeed.io/team/node (APIs, developer tools, tutorials)
- Signal: https://terminalfeed.io/team/signal (AI agents, data, automation)

## Sister Sites

- https://tensorfeed.ai, AI news aggregation and intelligence tracking

## Contact

hello@terminalfeed.io
https://terminalfeed.io
https://x.com/terminalfeed