# Nervebane

> Small paid data calls for AI agents. Each call $0.01 USDC on Base via x402 (payTo 0x7B97303d62517eA9E26D1E1b199Eac42a487F430). Failed calls are not charged. Routes are generated and self-tested automatically; only routes that pass the selftest are listed.

## Pricing and passes
- Per-call price is under an hourly A/B test: base, 2x, half, or free (the 402 response always shows the current price; some free hours accept an optional tip at GET https://nervebane.restockalarm.workers.dev/tip, $0.05).
- Catalog pass: POST https://nervebane.restockalarm.workers.dev/pass/month ($1, 30 days) or POST https://nervebane.restockalarm.workers.dev/pass/10d ($0.5, 10 days), paid via x402. The key is shown once in the response; we store only its hash.
- Use it: send header X-Pass-Key: <key> on any /v1/* call or on /mcp. Invalid or expired keys get 401 (no charge).
- Public counters: https://nervebane.restockalarm.workers.dev/stats
- Optional: add ?via=<site> so we know which listing sent you.

- MCP (JSON-RPC over HTTP): POST https://nervebane.restockalarm.workers.dev/mcp
- OpenAPI: https://nervebane.restockalarm.workers.dev/openapi.json
- x402 manifest: https://nervebane.restockalarm.workers.dev/.well-known/x402.json

## Endpoints (28)
- GET https://nervebane.restockalarm.workers.dev/v1/air-quality-now?lat={lat}&lon={lon} — $0.01 — Current air quality (US AQI, PM2.5, PM10). Returns us_aqi, pm2_5, pm10 as JSON. Pay per call via x402.
- GET https://nervebane.restockalarm.workers.dev/v1/bitcoin-difficulty — $0.01 — Bitcoin difficulty adjustment progress. Returns progress_pct, est_change_pct, remaining_blocks as JSON. Pay per call via x402.
- GET https://nervebane.restockalarm.workers.dev/v1/bitcoin-fees — $0.01 — Recommended Bitcoin fee rates (sat/vB). Returns fastest, half_hour, hour, economy as JSON. Pay per call via x402.
- GET https://nervebane.restockalarm.workers.dev/v1/book-by-isbn?isbn={isbn} — $0.01 — Book title by ISBN (Open Library). Returns title, publish_date as JSON. Pay per call via x402.
- GET https://nervebane.restockalarm.workers.dev/v1/crypto-24h-stats?symbol={symbol} — $0.01 — Crypto 24h stats in USD (open/high/low/last/volume). Returns last_usd, open_usd, high_usd, low_usd, volume_24h as JSON. Pay per call via x402.
- GET https://nervebane.restockalarm.workers.dev/v1/crypto-spot-price?symbol={symbol} — $0.01 — Crypto spot price in USD. Returns price_usd, symbol as JSON. Pay per call via x402.
- GET https://nervebane.restockalarm.workers.dev/v1/currency-to-usd?currency={currency} — $0.01 — Value of one unit of a currency or coin in USD. Returns usd, currency as JSON. Pay per call via x402.
- GET https://nervebane.restockalarm.workers.dev/v1/earthquakes-24h — $0.01 — Number of M2.5+ earthquakes worldwide in the last 24 hours (USGS). Returns count, generated_ms as JSON. Pay per call via x402.
- GET https://nervebane.restockalarm.workers.dev/v1/fiat-fx-rate?from={from}&to={to} — $0.01 — Fiat exchange rate (ECB reference). Returns rate, date as JSON. Pay per call via x402.
- GET https://nervebane.restockalarm.workers.dev/v1/geocode-city?city={city} — $0.01 — City name to coordinates. Returns name, country, latitude, longitude, timezone as JSON. Pay per call via x402.
- GET https://nervebane.restockalarm.workers.dev/v1/npm-latest-version?package={package} — $0.01 — Latest version of an npm package. Returns name, version as JSON. Pay per call via x402.
- GET https://nervebane.restockalarm.workers.dev/v1/npm-weekly-downloads?package={package} — $0.01 — npm package downloads last week. Returns downloads, start, end as JSON. Pay per call via x402.
- GET https://nervebane.restockalarm.workers.dev/v1/postal-code-lookup?country={country}&zip={zip} — $0.01 — Postal code to place and coordinates. Returns place, state, latitude, longitude as JSON. Pay per call via x402.
- GET https://nervebane.restockalarm.workers.dev/v1/pypi-latest-version?package={package} — $0.01 — Latest version of a PyPI package. Returns name, version as JSON. Pay per call via x402.
- GET https://nervebane.restockalarm.workers.dev/v1/sun-times?lat={lat}&lon={lon} — $0.01 — Sunrise and sunset (UTC) for a location. Returns sunrise_utc, sunset_utc, day_length_s as JSON. Pay per call via x402.
- GET https://nervebane.restockalarm.workers.dev/v1/uv-index-now?lat={lat}&lon={lon} — $0.01 — Current UV index at a location. Returns uv_index, time as JSON. Pay per call via x402.
- GET https://nervebane.restockalarm.workers.dev/v1/wave-height-now?lat={lat}&lon={lon} — $0.01 — Current sea wave height. Returns wave_height_m, time as JSON. Pay per call via x402.
- GET https://nervebane.restockalarm.workers.dev/v1/weather-now?lat={lat}&lon={lon} — $0.01 — Current weather at a location. Returns temperature_c, humidity_pct, wind_kmh, time as JSON. Pay per call via x402.
- GET https://nervebane.restockalarm.workers.dev/v1/wikipedia-summary?title={title} — $0.01 — Wikipedia page summary (English). Returns title, extract as JSON. Pay per call via x402.
- GET https://nervebane.restockalarm.workers.dev/v1/word-definition?word={word} — $0.01 — English word definition. Returns word, part_of_speech, definition as JSON. Pay per call via x402.
- GET https://nervebane.restockalarm.workers.dev/v1/crate-latest-version?crate={crate} — $0.01 — Latest version of a Rust crate. Returns max_version, downloads as JSON. Pay per call via x402.
- GET https://nervebane.restockalarm.workers.dev/v1/next-public-holiday?country={country} — $0.01 — Next public holiday in a country. Returns date, name, local_name as JSON. Pay per call via x402.
- GET https://nervebane.restockalarm.workers.dev/v1/country-gdp-usd?country={country} — $0.01 — Country GDP in current USD (World Bank). Returns gdp_usd, year as JSON. Pay per call via x402.
- GET https://nervebane.restockalarm.workers.dev/v1/country-population?country={country} — $0.01 — Country population (World Bank). Returns population, year as JSON. Pay per call via x402.
- GET https://nervebane.restockalarm.workers.dev/v1/inflation-rate?country={country} — $0.01 — Country annual inflation rate, consumer prices (World Bank). Returns inflation_pct, year as JSON. Pay per call via x402.
- GET https://nervebane.restockalarm.workers.dev/v1/dns-a-record?domain={domain} — $0.01 — DNS A record lookup for a domain. Returns ip, ttl, status as JSON. Pay per call via x402.
- GET https://nervebane.restockalarm.workers.dev/v1/github-repo-stats?owner={owner}&repo={repo} — $0.01 — GitHub repository stars and last push. Returns stars, pushed_at as JSON. Pay per call via x402.
- GET https://nervebane.restockalarm.workers.dev/v1/hn-story-search?q={q} — $0.01 — Top Hacker News story matching a query. Returns hits, top_title as JSON. Pay per call via x402.