BitData™ · direct endpoints

Data BitTuitive™ serves itself, only when we can legally redistribute it: public-domain government sources and commercially licensed APIs. No free sample. Pay per call with Lightning or USDC on Base.

Lightning L402 USDC on Base · x402 Licensed sources only

Available Endpoints

Bitcoin — one of BitTuitive's data categories.

Pay per call with Lightning (L402) in sats or USDC on Base (x402) in USD, settled via the PayAI facilitator. One payment = one fresh data point. Free pre-flight status checks on every tier.

Weather

US conditions, forecasts and alerts from the NOAA National Weather Service (public domain). Pass lat and lon, or a US city or ZIP (location=Austin, TX or zip=10001). City and ZIP lookup uses U.S. Census Gazetteer files. Outside the US, current conditions and forecasts fall back to MET Norway (CC BY 4.0). Alerts are US-only. Source: NOAA National Weather Service. Not endorsed by NOAA or NWS. Included in the pro subscription.

Travel

US airport ground stops, ground delay programs, arrival and departure delays, and closures from the FAA National Airspace System Status snapshot (US government work, public domain). Omit the airport parameter for the full snapshot, or pass airport=SFO (IATA) or airport=KSFO (ICAO). travel_airport adds current weather and NWS alerts at that airport (NOAA). Not for navigation. Source: Federal Aviation Administration (NAS Status). Not endorsed by the FAA. Included in the pro subscription.

Stocks

SEC EDGAR fundamentals and filings for any US ticker. Open a tile, enter a symbol, then pay with Lightning or USDC.

Market insights

What agents want, and what the network can already supply. The public view is a teaser (rank and a coarse volume band). Full ranked counts, 7/30-day trends, willingness-to-pay, unmet searches and supply–demand gaps are a paid market_insights endpoint — 500 sats, Lightning L402, also included in the pro subscription.

See the teaser

One Lightning payment, any verified data API

Routed calls take sats over Lightning or USDC on Base. BitTuitive can call other paid agent APIs for you. Pay one BitTuitive L402 invoice (upstream price + 20%, minimum 3 sats); BitTuitive pays the highest-rated verified API (ranked by quality score and latency), calls it and returns its data with the upstream, its score and the fee. URL fetchers and LLM endpoints never route. Vetted sources only: BitTuitive routes just to upstreams that pass its own recent probes (quality score >= 80) and policy checks (no scrapers, URL fetchers or LLM endpoints); stock prices route only to sources with a disclosed redistribution license, and registered providers must disclose their data source and license and pass review before they are routed. BitTuitive's own data comes from public-domain or openly licensed sources (NOAA, FAA, SEC EDGAR, MET Norway). Upstreams are picked by reliability score and latency, with automatic fallback. If a call fails BitTuitive retries, falls back to the next-best API, or returns a 24-hour credit. Answers within about 75 seconds, or a 202 to poll with the same credential.

Run a data API? List it on BitTuitive — listing is free, and BitTuitive takes a cut only when a call sells.

GET /api/v1/route/endpoints                         # free: what can be routed, all-in prices
GET /api/v1/route?data_type=weather&q=air+quality  # best verified API, with fallback
GET /api/v1/route/{endpoint_id}                     # one specific API
MCP: route_endpoints (free), route_call (paid)

How It Works

Four steps, no accounts or API keys.

01

Request Data

Call any endpoint. If unpaid, you get a 402 with a Lightning invoice and macaroon (L402). Our own data endpoints also include an x402 USDC requirement.

02

Pay the Invoice

Send sats via any Lightning wallet. Your wallet returns a preimage (payment proof).

03

Build the L402 Credential

Combine: L402 <macaroon>:<preimage>

04

Get Your Data

Resend within 10 minutes. One payment returns one fresh data point; the next call pays again.

How to pay

Two equal ways to pay, for BitTuitive's own data endpoints and for routed calls: sats over Lightning (L402) or USDC on Base (x402). Subscriptions are Lightning only.

Lightning (L402)

Prices in sats, derived from the USD list price and the BTC price. Call an endpoint, pay the Lightning invoice with any wallet, then retry with the preimage as Authorization: L402 <macaroon>:<preimage>. One payment buys one response.

USDC on Base (x402)

Prices in USD, settled via the PayAI facilitator. Agents sign the 402's x402 requirement (PAYMENT-REQUIRED header, or accepts in the JSON body) and retry with a PAYMENT-SIGNATURE (v2) or X-PAYMENT (v1) header. Only a successful 200 is settled.

L402 Token Example

# Step 1: Request data (unpaid)
curl -i https://api.bittuitive.ai/api/v1/data/btc_oracle

# Response: HTTP 402 Payment Required
# WWW-Authenticate: L402 macaroon="AgEKYml0dHVpdGl2ZQJCAAA...", invoice="lnbc500n1p5..."
# (same macaroon + invoice in the JSON body)

# Step 2: Pay the invoice with your Lightning wallet
# Your wallet returns the preimage (64 hex chars), e.g.:
#   a1b2c3d4e5f67890abcdef...

# Step 3: Resend with the L402 credential
# Format: Authorization: L402 <macaroon>:<preimage>
curl -H "Authorization: L402 AgEKYml0dHVpdGl2ZQJCAAA...:a1b2c3d4e5f6..." \
  https://api.bittuitive.ai/api/v1/data/btc_oracle

# One payment = one response (use it within 10 min). The next call needs a new payment,
# or a subscription. Standard L402 (github.com/lightninglabs/L402): lnget and other L402 clients work as-is.

Subscriptions

Lightning only. Many calls, one Lightning payment. A plan's credential works on its endpoints for 30 days from payment, with a daily call quota. Over quota returns 429 with Retry-After. No recurring billing: renew when it expires. Limited number of subscriptions per plan.

basic5,000 sats

30 days · 100 calls/day · resets 00:00 UTC

btc_pricebtc_oracle

GET /api/v1/subscribe/basic

pro25,000 sats

30 days · 250 calls/day · resets 00:00 UTC

btc_pricebtc_oraclebtc_probtc_signals

GET /api/v1/subscribe/pro

# Buy: returns 402 with an L402 challenge for the plan price
curl -i https://api.bittuitive.ai/api/v1/subscribe/basic

# Pay once, then use the same credential on any covered endpoint
curl -H "Authorization: L402 <macaroon>:<preimage>" https://api.bittuitive.ai/api/v1/data/btc_price

# Free usage check: plan, expiry, calls used / remaining today
curl -H "Authorization: L402 <macaroon>:<preimage>" https://api.bittuitive.ai/api/v1/subscription/status

For AI Agents

GET /api/v1/endpoints          # Programmatic discovery
GET /api/v1/status/{endpoint}  # Free pre-flight check
GET /api/v1/subscriptions      # Subscription plans
GET /api/v1/subscription/status # Your plan's usage (send Authorization)
GET /docs                      # OpenAPI spec
GET /api/v1/scoreboard         # Free quality scores for paid agent APIs
GET /api/v1/route/endpoints    # APIs BitTuitive can call for you (one payment)