# pragma.trading

## What is this?
BTC derivatives signal engine for autonomous trading agents. Returns directional bias with 5-tier conviction scoring. Free API + paid tiers via x402 USDC on Base.

## Signal Engine
The v3 engine evaluates two independent dimensions:
- **Flow Score** (12 dimensions): funding rates, open interest delta, basis/premium, taker buy/sell ratio, long/short ratio, ETF flows, smart money tracking, IV/RV ratio (Deribit), market regime (ATR-based), news sentiment (Fear & Greed contrarian), whale flow (Hyperliquid large trades), options flow (Deribit call/put ratio). Regime multiplier amplifies signals in trending markets and dampens them in ranging/choppy markets.
- **Structure Score**: multi-timeframe trend alignment, momentum regime, structural breaks, liquidity zones, confluence indicators

Both must agree on direction for any signal to fire. Composite score determines tier:
- NONE (<55): no signal
- FORMING (55+): developing, watch only
- ACTIONABLE (65+): valid setup, moderate conviction
- CONFIRMED (75+): entry trigger + persistence confirmed
- MASTER (85+): 4/4 confluence, maximum conviction

## API

### Free endpoints (no auth, 10 req/min)
- GET https://pragma.trading/api/v1/signals/latest — current signal (direction, tier, score, price)
- GET https://pragma.trading/api/v1/signals/history — recent signals with timestamps
- GET https://pragma.trading/api/v1/signals/status — engine health, signal count, pricing

### Paid endpoints (x402 USDC on Base)
- GET https://pragma.trading/api/v1/signals/pro — $0.25/call — full flow/structure breakdown + entry triggers
- GET https://pragma.trading/api/v1/signals/enterprise — $0.50/call — multi-timeframe (4H+1H+1D) + raw scores + history

### Payment flow (x402)
1. Call paid endpoint → receive 402 with payment requirements
2. x402 client pays USDC on Base automatically
3. Retry with X-PAYMENT-RESPONSE header → receive full data

## Example
```bash
curl https://pragma.trading/api/v1/signals/latest
```
Response:
```json
{"signal":{"asset":"BTC","direction":"bullish","tier":"FORMING","score":58,"price":74480},"meta":{"tier":"free","engine":"v3"}}
```

## Affiliate program
50% commission on paid signal calls via Pyrimid Protocol. Pass X-Affiliate-ID header on paid requests.

## Discovery
- MCP: https://pragma.trading/.well-known/mcp.json
- Agent Card: https://pragma.trading/agent.json
- A2A: https://pragma.trading/.well-known/agent.json