# OBOL — Validated Bitcoin On-Chain Anomaly Signals

> Pay-per-call x402 API. 0.010000 USDC on Base per block height.

Base URL: https://obol-payai.fly.dev
Network: eip155:8453
Asset (USDC): 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
PayTo: 0x215f0C5e62735A54185f253B6245A630b744a7Ce
Amount atomic: 10000 (= $0.010000)

## Free endpoints
- GET https://obol-payai.fly.dev/health
- GET https://obol-payai.fly.dev/catalog
- GET https://obol-payai.fly.dev/examples
- GET https://obol-payai.fly.dev/pulse/preview   (FREE: next-block fee sat/vB + congestion)
- GET https://obol-payai.fly.dev/openapi.json
- GET https://obol-payai.fly.dev/.well-known/x402
- GET https://obol-payai.fly.dev/.well-known/agent-card.json

## Paid marketplace (default $0.002 USDC on Base; bundle $0.006)
- Full list: GET https://obol-payai.fly.dev/catalog  (sku_count includes all /v1/* listings)
- GET https://obol-payai.fly.dev/prices  |  https://obol-payai.fly.dev/pulse  |  https://obol-payai.fly.dev/signal/{height}
- Atomic fees: https://obol-payai.fly.dev/v1/btc/fee/next-block , .../fee/tiers , .../mempool ,
  .../congestion , .../tip , .../spot
- Per-asset spot: https://obol-payai.fly.dev/v1/price/BTC|ETH|SOL|USDC|USDT
- Anomaly: https://obol-payai.fly.dev/v1/btc/anomaly/latest + per-detector /latest paths
- Bundle: https://obol-payai.fly.dev/v1/bundle/trader  ($0.006 = pulse+prices)
  Payment: 402 + PAYMENT-REQUIRED → sign USDC → PAYMENT-SIGNATURE → 200 JSON

## Recommended agent path
1. GET https://obol-payai.fly.dev/pulse/preview   # free taste of next-block fee
2. GET https://obol-payai.fly.dev/catalog         # pick a SKU
3. GET https://obol-payai.fly.dev/pulse           # or any paid path

## MCP server (install as native tools)
- Remote MCP (streamable-http): https://obol-mcp.fly.dev/mcp
- Tools: get_crypto_prices, get_bitcoin_mempool_fees, get_bitcoin_signal
- Each tool is x402-paid ($0.01-0.02 USDC on Base); requires an x402-capable MCP client.
- Client config: {"mcpServers":{"obol":{"url":"https://obol-mcp.fly.dev/mcp"}}}

## Notes for agents
- Only validation-gated detectors are sold (no high-fire-rate junk).
- No account, no API key, no human approval — machine payment only.
- Facilitator: CDP x402 on mainnet (gasless EIP-3009 USDC for buyer).