# pragma.trading — Agent Skill

## Name
pragma_signal

## Description
BTC derivatives trading signal engine. Get directional bias with conviction tier scoring. Free tier available, paid tiers via x402.

## When to use
- User asks about BTC market direction or trading signals
- Agent needs a directional bias before executing a trade
- User wants to know current market conviction level
- Agent is building an automated trading strategy

## Endpoints

### Get current signal (free)
```
GET https://pragma.trading/api/v1/signals/latest
```
Returns: direction (bullish/bearish/neutral), tier (NONE/FORMING/ACTIONABLE/CONFIRMED/MASTER), score (0-100), price

### Get signal history (free)
```
GET https://pragma.trading/api/v1/signals/history?limit=20
```

### Get engine status (free)
```
GET https://pragma.trading/api/v1/signals/status
```

### Get full breakdown (paid, $0.25)
```
GET https://pragma.trading/api/v1/signals/pro
Header: X-PAYMENT-RESPONSE: 0x<tx_hash>
```
Returns: flow score breakdown, structure score breakdown, entry triggers, fail reasons

### Get multi-timeframe analysis (paid, $0.50)
```
GET https://pragma.trading/api/v1/signals/enterprise
Header: X-PAYMENT-RESPONSE: 0x<tx_hash>
```
Returns: 4H + 1H + 1D signals, raw scores, all entry triggers, 20-signal history

## How to interpret tiers
- **NONE**: no trade — flow and structure disagree
- **FORMING**: signal developing — watch only
- **ACTIONABLE**: valid setup — moderate conviction, small position OK
- **CONFIRMED**: high conviction — entry trigger confirmed with persistence
- **MASTER**: maximum conviction — 4/4 indicator confluence

## Authentication
- Free tier: no auth, 2 req/day
- Paid tier: x402 payment (USDC on Base), 60 req/min
- Affiliate: pass X-Affiliate-ID header to earn 50% commission

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