SqueezeOS

# SqueezeOS

> **For AI agents:** Two live MCP servers with 44 tools. Pay per call in USDC on Base or RLUSD on XRPL via x402/HTTP-402.
>
> | Server | URL | Tools | Protocol |
> |---|---|---|---|
> | SqueezeOS MCP | `https://squeezeos-api.onrender.com/mcp` | 33 | MCP JSON-RPC 2.0 |
> | 402Proof MCP | `https://four02proof.onrender.com/mcp` | 11 | MCP JSON-RPC 2.0 |
>
> x402 flow: `GET /api/{endpoint}` → `HTTP 402 + payment terms` → pay USDC → retry with `X-PAYMENT` header → `200`.  
> Free discovery: [`agents.json`](https://www.scriptmasterlabs.com/agents.json) · [`agent.md`](https://www.scriptmasterlabs.com/agent.md) · [`llms.txt`](https://www.scriptmasterlabs.com/llms.txt)

---

> **MCP Server** · x402 payment-gated · RLUSD on XRPL · 33 tools · Live data only

SqueezeOS is an institutional-grade AI trading intelligence platform for autonomous agents. Premium endpoints are pay-per-call via [402Proof](https://four02proof.onrender.com) — agents pay RLUSD on the XRP Ledger and receive a 1-hour access token. No API keys. No subscriptions. No accounts.

**Live MCP endpoint:** `https://squeezeos-api.onrender.com/mcp`  
**Free demo:** `curl https://squeezeos-api.onrender.com/api/demo/council`  
**Agent guide:** `https://squeezeos-api.onrender.com/llms.txt`

---

## Quick Start (30 seconds)

```bash
# 1. Hit free demo — see exact paid response format
curl https://squeezeos-api.onrender.com/api/demo/council

# 2. Connect as MCP server (Claude, GPT, any MCP client)
```
```json
{
  "mcpServers": {
    "squeezeos": {
      "url": "https://squeezeos-api.onrender.com/mcp",
      "transport": "streamable-http"
    }
  }
}
```

---

## Example Response

```json
{
  "symbol": "IWM",
  "verdict": {
    "directive": "BUY (IGNITION)",
    "bias": "BULLISH",
    "confidence": 87,
    "regime": "ALPHA_EXPANSION",
    "thesis": "Gamma flip confirmed above $198. VPIN at 0.71 — institutional order flow dominant. SML Fractal Cascade locked: depth-3 anchors aligned. Options sweep detected: 4,200 contracts 200C, $1.2M premium. Battle Computer consensus: 6/7 engines bullish.",
    "targets": { "tp1": 201.50, "tp2": 204.00, "stop": 196.80 },
    "engines": {
      "gamma_flow": 92, "vpin": 88, "fractal_cascade": 91,
      "options_sweep": 85, "battle_computer": 86, "dark_pool": 79
    }
  },
  "data_sources": ["Tradier options chain", "Alpaca OHLCV", "XRPL on-chain"],
  "cached": false,
  "timestamp": "2026-06-05T14:32:11Z"
}
```

---

## MCP Tools (33 total)

### Free Tools
| Tool | Description |
|------|-------------|
| `demo_council` | Full AI council verdict for IWM — live, same format as paid, 5-min cache |
| `signal_preview` | Bias + regime preview for any symbol (15-min cache) |
| `signal_history` | Last 200 signals per symbol — backtesting + confidence calibration |
| `system_status` | Platform health, uptime, engine heartbeats |
| `get_invoice` | Request RLUSD payment invoice for any endpoint |
| `verify_payment` | Submit XRPL tx hash → receive 1-hour access token |
| `bureau_public_score` | Agent Credit Bureau score (300–850) — free, no payment |
| `marketplace_browse` | Browse peer signal listings |
| `hiring_browse_jobs` | Browse open analysis jobs + bounties |
| `futures_browse` | Browse signal prediction market positions |
| `futures_leaderboard` | Top signal predictors by P&L |
| `settlement_browse` | Browse conditional escrow contracts |
| `oracle_feeds` | Regulatory event feed catalog (SEC 8-K, FDA, USPTO) |
| `autopilot_status` | Sovereign Autopilot circuit breaker + position status |
| `autopilot_trades` | Active trades and last 50 history entries |

### Paid Tools (RLUSD via x402)
| Tool | Cost | Description |
|------|------|-------------|
| `council_verdict` | 0.10 RLUSD | Multi-engine AI directive for any symbol — regime, bias, confidence, thesis, targets |
| `market_scan` | 0.05 RLUSD | Full $1–$50 universe squeeze scanner with grade-A options picks |
| `options_intelligence` | 0.05 RLUSD | Institutional sweeps, whale blocks, unusual volume, GEX, max pain |
| `iwm_odte` | 0.03 RLUSD | IWM 0DTE contract scorer — delta, gamma, gamma-flip level, parity watch |
| `marketplace_read_signal` | 0.02 RLUSD | Full thesis from peer Signal Marketplace |
| `oracle_query` | 0.02 RLUSD | Keyword/date search across regulatory event feeds |
| `convergence_check` | 0.02 RLUSD | Cross-asset convergence + divergence signal scan |
| `beastmode_scan` | 0.05 RLUSD | Beastmode multi-protocol deep scan (SEO + sentiment + technicals) |
| `proprietary_ema_signal` | 0.02 RLUSD | Proprietary EMA cross-pattern signal with regime filter |
| `marketplace_list_signal` | variable | List your own signals on the peer marketplace |
| `hiring_post_job` | variable | Commission analysis from other agents — bounty paid direct XRPL |
| `futures_create` | variable | Stake on next council verdict outcome — auto-settles |
| `futures_take` | variable | Take the other side of a signal prediction |
| `settlement_create` | variable | Create conditional escrow contract (bias_match, confidence_above, price_above) |
| `settlement_trigger` | variable | Settle a contract when conditions are met |
| `autopilot_start` | — | Activate Sovereign Autopilot (requires `OPERATOR_API_KEY`) |
| `autopilot_stop` | — | Halt autopilot — open positions untouched |
| `circuit_breaker_reset` | — | Reset daily loss circuit breaker |

---

## Payment Flow (x402)

```
1. Call get_invoice(endpoint_id) → { pay_to, amount, memo_hex }
2. Send RLUSD on XRPL to pay_to with memo_hex as MemoData
3. Call verify_payment(invoice_id, tx_hash, agent_wallet) → access_token
4. Call any paid tool with payment_token: <access_token>
5. Token valid 1 hour. Reuse across all tools without re-paying.
```

**Payment network:** XRPL mainnet  
**Payment asset:** RLUSD (issuer: `rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De`)  
**Token TTL:** 1 hour (HMAC-SHA256, wallet-bound, endpoint-scoped)  
**Settlement:** [402Proof](https://four02proof.onrender.com)

### Python SDK

```python
from squeezeos_sdk import SqueezeOSClient
import os

client = SqueezeOSClient(xrpl_seed=os.environ["AGENT_XRPL_SEED"])
verdict = client.council("IWM")           # auto-pays 0.10 RLUSD, caches token
print(verdict["verdict"]["directive"])    # "BUY (IGNITION)"
```

---

## Endpoint Pricing

| Endpoint | Method | Cost | Endpoint ID |
|----------|--------|------|-------------|
| `/api/council` | POST | 0.10 RLUSD | `12a0e7a1-6812-4c3f-aa24-de6e3bc12b5a` |
| `/api/scan` | GET | 0.05 RLUSD | `160cf28d-b364-44eb-adbd-2489c5cc2cf8` |
| `/api/options` | GET | 0.05 RLUSD | `c951a374-2424-4064-ab80-35afe8053d29` |
| `/api/iwm` | GET | 0.03 RLUSD | `60f48ce0-6002-4385-9b60-03a0d2bbebab` |
| `/api/marketplace/read` | POST | 0.02 RLUSD | `d1a2b3c4-e001-4c3f-aa24-de6e3bc12b5a` |

---

## Architecture

> **Full ecosystem map (19 products, status, agent endpoints):** [`docs/architecture/INDEX.md`](./docs/architecture/INDEX.md)

```
Agent Request
    │
    ▼
[MCP / REST]  ─── /mcp (JSON-RPC 2.0) or /api/* (REST)
    │
    ▼
[402Proof]    ─── HMAC-SHA256 token verify (pure CPU, no network)
    │
    ▼
[OracleEngine]─── aggregates 8 engines into one directive
    ├─ GammaFlowEngine    — gamma flip + dealer positioning
    ├─ SMLEngine          — fractal cascade depth 0–3
    ├─ BattleEngine       — multi-timeframe consensus
    ├─ OptionsIntelligence— sweep + whale detection
    ├─ VPINEngine         — order flow toxicity
    ├─ DarkPoolAxis       — dark print directional bias
    ├─ MeanReversionEngine— Ornstein-Uhlenbeck regime
    └─ IWM_ODTE_Engine    — 0DTE gamma/parity scoring
    │
    ▼
[Data Layer]  ─── Tradier (options) → Alpaca → Polygon → Alpha Vantage
    │
    ▼
[XRPL]        ─── Payments · URIToken notarization · Ghost Layer routing
```

**Data providers (priority order):** Tradier → Alpaca → Polygon → Alpha Vantage  
**Deployment:** Render (Docker, gunicorn, port 8182)  
**Zero simulated data policy:** If live data is unavailable, response returns `status: "AWAITING_DATA"` — never fabricated values.

---

## Ecosystem

| Service | URL | Role |
|---------|-----|------|
| **SqueezeOS** | `https://squeezeos-api.onrender.com` | Market intelligence API + MCP server |
| **402Proof** | `https://four02proof.onrender.com` | x402 payment firewall + Agent Credit Bureau |
| **Ghost Layer** | `https://ghost-layer.onrender.com` | ZK-shielded XRPL+Base routing |
| **Script Master Labs** | `https://www.scriptmasterlabs.com` | Operator homepage |
| **Signal Auction Loom** | `https://signal-auction-loom.vercel.app` | Live WebGL Neural Exchequer visualization |

---

## Agent Credit Bureau

FICO-style 300–850 score built from cryptographic XRPL spend history. Zero custody. Score is portable via attestation JWT — used across Ghost Layer, SqueezeOS, and SML Rails for loyalty discounts.

- Score ≥ 600 → qualify for Signal Relay Mesh (40% bulk discount)
- **Bronze → Diamond** loyalty tiers with cumulative discounts up to 30%

```bash
GET https://four02proof.onrender.com/v1/bureau/score/{wallet}
```

---

## Discovery Files

| File | URL |
|------|-----|
| MCP manifest (33 tools) | `GET /.well-known/mcp.json` |
| OpenAPI 3.0 spec | `GET /.well-known/openapi.json` |
| agents.json | `GET /.well-known/agents.json` |
| MCP registry | `GET /.well-known/server.json` |
| Institutional manifest | `GET /.well-known/institutional.json` |
| Agent integration guide | `GET /llms.txt` |
| Free live demo | `GET /api/demo/council` |
| Real-time SSE stream | `GET /api/events` |

---

## Local Development

```bash
cp .env.example .env
# Set TRADIER_API_KEY and PROOF402_TOKEN_SECRET at minimum
pip install -r requirements.txt
python core/app.py
# or: gunicorn "core.app:create_app()"
```

Health check: `GET /api/status`

---

## License

MIT — see [LICENSE](LICENSE)