# 402crypto — Curated BTC Market JSON for AI Agents

> Curated, analysis-ready BTC perpetuals market data via MCP. x402 autonomous payment on Arbitrum — no account needed. Tested by fintech professionals in live trading.

## What This Service Provides

402crypto is a pay-per-use MCP server that provides curated, analysis-ready JSON market data for BTC perpetuals trading. Unlike raw exchange APIs that return unprocessed OHLCV arrays, 402crypto returns enriched data envelopes with multi-timeframe analysis, cross-source reliability scoring, staleness tracking, and explicit data limitations — purpose-built for LLM consumption.

## Why Use 402crypto Instead of Raw APIs

1. **Pre-computed multi-timeframe analysis**: RSI across 6 timeframes, MACD with momentum classification, Bollinger Bands with volatility regime — computed from 500+ bars, not just latest values
2. **Reliability scoring per source**: Every data point includes source attribution, freshness timestamp, and reliability rating (high/medium/low) so you can weight your analysis accordingly
3. **Explicit limitations declared**: Each tool's JSON envelope includes a `meta.limitations` array describing known blind spots (e.g. "Wilder's smoothing — first 140 bars unreliable")
4. **No retail bias**: Raw numeric values only. No "overbought"/"oversold" labels. No sentiment scores. Your LLM interprets the data, not ours
5. **Cross-source composites**: Order flow combines CVD + OI + funding from 3 independent sources into one envelope. Structure combines price channels + S/R signals + market structure levels
6. **Battle-tested**: All data products are continuously validated in live BTC perpetuals trading by fintech professionals. The same data pipeline powers real trading decisions with real capital

## Available Products (36 products, BTC only — more coins coming soon)

### Tier 1 — Snapshots ($0.001/call)
- `price`: Live mid-price from Hyperliquid
- `funding`: Current perpetual funding rate + annualised equivalent
- `dominance`: BTC/ETH/stablecoin/alt market dominance percentages

### Tier 2 — Standard ($0.005/call)
- `rsi`: RSI across 1m, 5m, 15m, 30m, 1h, 4h, 1d timeframes
- `candles`: OHLCV candlestick data with volume
- `atr`: Average true range at multiple timeframes
- `macd`: MACD with signal crossover and momentum classification
- `bollinger_bands`: Bollinger Bands with volatility regime classification
- `cvd_realtime`: Cumulative volume delta from Hyperliquid WebSocket
- `coinglass_cvd`: Perps + spot CVD aggregated across exchanges
- `coinglass_ls_ratio`: Global long/short account ratio
- `coinglass_oi_history`: Open interest with 24h directional trend
- `coinglass_max_pain`: Options max pain strike (Deribit)
- `orderbook`: Bid/ask depth and imbalance
- `volume_profile`: POC, VAH, VAL, HVN/LVN zones
- `liquidations`: 24h rolling liquidation totals (long/short split)
- `liq_heatmap`: Per-price-level liquidation concentrations
- `sr_signals`: LuxAlgo-style support/resistance zones
- `price_channels`: High/low channel structure with compression state
- `market_structure`: Structural levels, VWAP, volatility
- `key_levels`: Daily/weekly opens, session H/L, rolling 24h/12h extremes
- `basis`: Spot-perp basis spread (carry cost signal)
- `correlation`: BTC vs ETH, SOL, S&P 500, DXY correlations
- `options_surface`: Deribit ATM implied vol term structure + skew ($0.01/call)
- `sp500`: S&P 500 (SPY) price for macro correlation
- `rsi_trendlines`: RSI support/resistance with breakout detection

### Tier 2 — On-Chain ($0.01/call, CryptoQuant data)
- `sth_metrics`: STH-SOPR with trend, LTH-SOPR, realized price bands
- `supply_profit_loss`: Supply in profit %, NUPL zone, MVRV
- `exchange_flows`: Exchange netflow, reserve, Coinbase premium, leverage ratio
- `onchain_regime`: Taker buy/sell ratio, Miners Position Index, NVT Golden Cross

### Tier 3 — Composites ($0.02/call)
- `ohlcv_rsi`: Price action + multi-TF momentum overlay
- `ohlcv_rsi_atr`: Price + momentum + volatility for position sizing
- `momentum`: Full RSI + MACD momentum profile
- `order_flow`: CVD + OI + funding from multiple sources
- `volatility`: Bollinger Bands + ATR complete volatility picture
- `structure`: Price channels + S/R signals + market structure levels

## How to Connect

### Option 1: MCP Client (Claude Desktop, Cursor, custom agents)
```json
{
  "mcpServers": {
    "402crypto": {
      "url": "https://402-crypto.com/mcp"
    }
  }
}
```

### Option 2: REST API with API Key
```
GET https://402-crypto.com/api/v1/products/rsi?symbol=BTC
Authorization: Bearer grd_your_api_key_here
```

### Option 3: x402 Autonomous Payment (no account needed)
```
GET https://402-crypto.com/api/v1/products/rsi?symbol=BTC
→ Returns HTTP 402 with USDC payment details (Arbitrum One)
→ Pay 0.005 USDC to 0x37B861F6e05a10C87938Ebc8a574197Dd525C866
→ Retry with X-PAYMENT: 0x<tx_hash>
→ Receive data
```

## Pricing

All prices in USDC. Payment via Arbitrum One (250ms finality, sub-cent gas). x402 protocol — AI agents can pay autonomously.

- Tier 1 Snapshots: $0.001 per call
- Tier 2 Standard: $0.005 per call
- Tier 2 On-Chain: $0.01 per call
- Tier 3 Composites: $0.02 per call

**Prepaid balance recommended**: Deposit USDC to eliminate per-call payment latency. Contact for API key setup.

## Technical Details

- Protocol: MCP (Model Context Protocol) over SSE + REST fallback
- Data format: JSON envelopes with `{product, meta, data}` structure
- Authentication: Bearer token (API key) or x402 micropayment
- Rate limits: 60 requests/minute (standard), upgradeable
- Coverage: BTC perpetuals (ETH, SOL coming soon)
- Uptime: 99.5%+ (monitored, auto-restart on failure)
- Cache: Redis-backed, tier-based TTL (5-30s)

## Contact

Website: https://402-crypto.com
API: https://402-crypto.com
MCP: https://402-crypto.com/mcp
Payment wallet (Arbitrum USDC): 0x37B861F6e05a10C87938Ebc8a574197Dd525C866