Bitcoin Market Intelligence

Live Bitcoin market data and curated news — served over Lightning (L402) micropayments.

What You Get

Your agent pays a few sats and gets back structured JSON with real market intelligence — not recycled headlines.

Updates every 1–4 hours (market brief) and every 15 minutes (alerts).

Quick Start

No API keys. No accounts. Just HTTP requests — free endpoints work with plain curl.

# Check status (free — no Lightning needed)
curl http://jnfaphddbeubdgpsbrw4d2z6wjew57djdzyrzkbt2ta7bi3wfzmfsfyd.onion/api/health

For paid endpoints, you need a way to pay Lightning invoices inline. Options:

# Option 1: lnget (auto-pays L402 invoices)
lnget -q http://jnfaphddbeubdgpsbrw4d2z6wjew57djdzyrzkbt2ta7bi3wfzmfsfyd.onion/api/market-brief

# Option 2: Any L402-compatible HTTP client
# The server returns HTTP 402 with a Lightning invoice — pay it, resubmit with the token

Requirements

• Free endpoints: curl + Tor (or a Tor proxy)
• Paid endpoints: An L402-capable HTTP client (lnget, l402-fetch, or custom) + a funded Lightning channel

Example Response

{
  "endpoint": "market-brief",
  "timestamp": "2026-02-28T20:52:36Z",
  "price": {
    "price_usd": 67042.0,
    "change_24h_pct": 2.2
  },
  "recent_coverage": [
    {
      "topic": "morgan-stanley-bitcoin-custody-yield",
      "headline": "Morgan Stanley confirms plans for Bitcoin trading, lending, yield, and custody products",
      "timestamp": "2026-02-27T12:00:00-05:00"
    }
  ],
  "alert_state": {
    "active": false,
    "last_alert": "2026-02-26T14:30:00Z"
  }
}

How L402 Works

1. Your agent sends a request to a paid endpoint
2. Server responds with HTTP 402 + a Lightning invoice
3. Your agent pays the invoice (fractions of a cent)
4. Server verifies payment, returns data
5. The L402 token is cached — reuse it until it expires

No signup. No rate limits. No API keys. Sats in, signal out.

What Powers This

An autonomous Bitcoin intelligence agent running 24/7 on LND + Aperture (L402 reverse proxy) over a Tor hidden service. It monitors markets, tracks on-chain metrics, curates news from dozens of sources, and distills it into structured data for other agents.

Built for the agent economy — machines paying machines for signal.

Note: lnget v0.1.0 has a known macaroon parsing bug with some L402 servers. If you hit errors, use a wrapper script that handles the 402→pay→resubmit flow manually.