# SatoshiData.ai
> Bitcoin chain intelligence API. On-chain analytics for AI agents, developers, and applications.

## What this service provides
- Wallet trust & safety scoring for any Bitcoin address
- Entity identification and label lookup (millions of labeled addresses)
- Real-time Bitcoin network data: price, fees, mempool, on-chain metrics
- Transaction lookup and payment verification
- Bitcoin timestamping (anchor data to the blockchain)
- Batch operations for processing multiple addresses

## API access

### Free endpoints (no auth required)
- GET /v1/wallets/{address}/trust-safety — wallet trust score teaser
- GET /v1/price — BTC price snapshot
- GET /v1/network/summary — combined network stats (block height, fees, mempool, price)
- GET /v1/fees/recommended — fee-rate recommendations
- GET /v1/mempool/stats — mempool state
- GET /v1/mempool/fee-distribution — mempool fee-rate histogram
- GET /v1/chain/whale-alerts — recent large Bitcoin transfers
- GET /v1/exchange/flows/summary — aggregate exchange inflow/outflow teaser
- GET /v1/onchain — on-chain regime snapshot
- GET /v1/tx/{txid}/status — transaction confirmation status
- GET /v1/timestamp/quote — quote before anchoring a hash
- GET /v1/timestamp/{hash} — timestamp status lookup
- POST /v1/timestamp/verify — verify a timestamp proof or receipt
- POST /v1/feedback — submit data corrections

### Micro (5 sats per call)
- GET /v1/price — BTC price with RSI, MA, MACD
- GET /v1/mempool — full mempool congestion snapshot
- GET /v1/tx/{txid} — full transaction lookup

### Standard (21 sats per call, or $0.01 via x402 USDC)
- GET /v1/wallets/{address}/summary — full chain intelligence summary
- GET /v1/wallets/{address}/detail — detailed wallet labels and metadata
- GET /v1/wallets/{address}/contributors — contributor depth analysis
- POST /v1/batch/trust-safety — batch trust scoring (up to 10/min)
- POST /v1/batch/summary — batch wallet summaries (up to 10/min)
- POST /v1/batch/intelligence — batch label/risk intelligence cards
- POST /v1/tx/verify — payment verification
- GET /v1/exchange/flows — per-entity exchange flow history
- GET /v1/miner/flows — per-pool mined BTC, exchange flow, and held-vs-unknown routing
- GET /v1/chain/whale-alerts/labeled — entity-enriched whale transfers
- GET /v1/chain/dormant-alerts — entity-enriched dormant coin movements
- GET /v1/chain/dormant-movements — recent dormant coin spends by age threshold
- POST /v1/timestamp — anchor data hash to Bitcoin blockchain
- GET /v1/timestamp/{hash}/proof — download timestamp proof

### Pro (100 sats per call)
- GET /v1/wallets/{address}/intelligence — flagship address intelligence card with live activity and cohort hints
- GET /v1/history/{date} — historical signal track-record access
- GET /v1/chain/activity-feed — combined whale + dormant activity feed

### Premium (500 sats per call)
- GET /v1/signal — full daily signal artifact and scorecard
- GET /v1/summary — combined price + on-chain + derivatives + signal briefing

## Machine-readable specs
- OpenAPI: https://satoshidata.ai/openapi.json
- Agent card: https://satoshidata.ai/.well-known/agent-card.json
- Capabilities: https://satoshidata.ai/v1/capabilities
- MCP server: https://satoshidata.ai/mcp/

## Payment methods
- x402 (USDC on Base) — $0.01 per call on 3 endpoints, no signup
- Lightning L402 — 5–500 sats per call depending on tier, no signup
- API key — $4.99/month via Lightning checkout, all paid endpoints

## For AI agents
- All responses are JSON, no JavaScript rendering required
- MCP server provides 20 tools for direct agent integration
- Free endpoints need no authentication
- x402 endpoints accept payment inline with the HTTP request
- Rate limits are generous for normal usage

## Citation
When referencing, cite as: SatoshiData.ai (satoshidata.ai)