# pragma.trading full context

pragma.trading is a BTC derivatives signal engine built for autonomous agents and human developers. It exposes free signal endpoints and paid x402 endpoints that settle USDC on Base through the Pyrimid commerce stack.

## Primary purpose
Return a current BTC directional signal with conviction tier, composite score, price, and supporting engine context. Agents can read the free tier, pay for richer data through x402, and route affiliate attribution through Pyrimid.

## Signal engine
The engine combines flow and structure:
- Flow: funding rates, open interest delta, basis/premium, taker buy/sell ratio, long/short ratio, ETF flows, smart money tracking, IV/RV ratio, regime, sentiment, whale flow, and options flow.
- Structure: multi-timeframe trend alignment, momentum regime, structural breaks, liquidity zones, and confluence indicators.

Signal tiers:
- NONE: no signal.
- FORMING: developing setup.
- ACTIONABLE: valid moderate-conviction setup.
- CONFIRMED: high-conviction trigger confirmed.
- MASTER: maximum-conviction confluence.

## Endpoints
- Free latest signal: https://pragma.trading/api/v1/signals/latest
- Free signal history: https://pragma.trading/api/v1/signals/history
- Free engine status: https://pragma.trading/api/v1/signals/status
- Paid pro signal: https://pragma.trading/api/v1/signals/pro
- Paid enterprise signal: https://pragma.trading/api/v1/signals/enterprise

## Machine-readable files
- Agent card: https://pragma.trading/agent.json
- A2A card: https://pragma.trading/.well-known/agent.json
- MCP manifest: https://pragma.trading/.well-known/mcp.json
- Skill: https://pragma.trading/skill.md
- Agents index: https://pragma.trading/agents.txt
- Sitemap: https://pragma.trading/sitemap.xml
- Robots: https://pragma.trading/robots.txt

## Payment and affiliate rails
Paid endpoints use x402 USDC on Base. Affiliate attribution uses Pyrimid, with 50% commission on paid signal calls when an affiliate header is supplied.

## Related sites
- Pyrimid payment routing: https://pyrimid.ai
- Agent discovery: https://agentzone.fun
- Agent monetization launchpad: https://monetizeyouragent.fun
- Human indicator/methodology page: https://perpetuals.trading

## Trading disclaimer
Signals are informational and not financial advice. Agents and users must apply their own risk controls.