SqueezeOS — Institutional AI Market Intelligence

Official62 toolsLive

by Timwal78 · Python

Institutional AI market intelligence: squeeze scanner, options flow, council verdicts. x402 RLUSD.

io.github.Timwal78/squeezeos (MCP)

Institutional AI market intelligence “squeezeos”, with a squeeze scanner, options flow, and council verdicts. The repository describes two live MCP servers that expose a total of 44 tools via MCP JSON-RPC 2.0, with per-call payment using USDC on Base or RLUSD on XRPL via x402/HTTP-402.

🛠️ Key Features

Two MCP servers: SqueezeOS MCP (33 tools) and 402Proof MCP (11 tools)
Protocol: MCP JSON-RPC 2.0
x402/HTTP-402 flow for paid calls (retry after payment)

🚀 Use Cases

Integrating institutional AI market intelligence into MCP-based AI agents
Querying squeeze scanner outputs, options flow data, and council verdicts

⚡ Developer Benefits

Discoverable endpoints: https://squeezeos-api.onrender.com/mcp and https://four02proof.onrender.com/mcp
Payment-driven access via x402: GET /api/{endpoint} → HTTP 402 → pay → retry with X-PAYMENT

⚠️ Limitations

Tool access is described as pay-per-call in USDC (Base) or RLUSD (XRPL)

Topics

ai-agentsmcpx402kinstonopenapiscriptmasterlabssdvosb

Captured live from the server via tools/list.

demo_council

Free preview of council_verdict, scoped to IWM (Russell 2000 ETF). Same JSON shape, same engines, 5-minute cache. Use this to validate output quality and integration before paying 0.10 RLUSD per call on council_verdict for any symbol.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

council_verdict

Institutional-grade BUY/SELL/HOLD directive for US equity symbols — the production-grade upgrade from demo_council (which is IWM-only, 5-min cached, free). Aggregates 8 proprietary engines — gamma-flow + flip detection, VPIN order-flow toxicity, fractal anchor confluence, regime classifier, dark-pool axis tracking, options sweep intelligence, mean-reversion regime, and Battle Computer consensus — into one tradeable verdict: directive, confidence 0-100, regime label (ALPHA_EXPANSION / MACRO_COLLAPSE / NEUTRAL / SHIELD), price targets (tp1/tp2/stop), and a per-engine breakdown explaining the score. Call this when you need a high-conviction directional read before sizing or executing a position — this is the same verdict institutional desks subscribe to at $1,000/mo via the Leviathan tier. Cost: 0.10 RLUSD per call (~$0.10). 60-second per-symbol cache, so back-to-back queries on the same ticker are effectively free. Pass payment_token from verify_payment plus your agent_wallet. Coverage: US equities; crypto coverage in roadmap. Typical response time: <2s cached, ~4s fresh compute.

Parameters3

agent_wallet	string	optional	Your XRPL wallet address
payment_token	string	optional	JWT from verify_payment (1h TTL)
symbol	string	required	US equity ticker (e.g. SPY, QQQ, AAPL, NVDA, GME, AMC, IWM)

Raw schema

{
  "type": "object",
  "properties": {
    "agent_wallet": {
      "description": "Your XRPL wallet address",
      "type": "string"
    },
    "payment_token": {
      "description": "JWT from verify_payment (1h TTL)",
      "type": "string"
    },
    "symbol": {
      "description": "US equity ticker (e.g. SPY, QQQ, AAPL, NVDA, GME, AMC, IWM)",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ]
}

market_scan

Full $1-$50 equity universe squeeze scanner. Returns setups ranked by 8-module score + grade-A options picks. Cost: 0.05 RLUSD.

Parameters2

agent_wallet	string	optional
payment_token	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "agent_wallet": {
      "type": "string"
    },
    "payment_token": {
      "type": "string"
    }
  }
}

options_intelligence

Institutional options flow: PUT/CALL sweep detection, whale blocks, unusual volume. Net delta, GEX, put/call ratios, max pain. Cost: 0.05 RLUSD.

Parameters2

agent_wallet	string	optional
payment_token	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "agent_wallet": {
      "type": "string"
    },
    "payment_token": {
      "type": "string"
    }
  }
}

iwm_odte

IWM zero-day-to-expiry scanner. Scored contracts by delta/gamma, gamma flip level, max pain, 30-day realized vol. Cost: 0.03 RLUSD.

Parameters2

agent_wallet	string	optional
payment_token	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "agent_wallet": {
      "type": "string"
    },
    "payment_token": {
      "type": "string"
    }
  }
}

signal_preview

Free bias + regime preview for any symbol. 15-minute cache. Not tradeable — use council_verdict for full thesis.

Parameters1

symbol

string

required

Equity ticker

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "description": "Equity ticker",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ]
}

signal_history

Last 200 recorded signals for a symbol (SQUEEZE_ALERT, OPTIONS_SWEEP, COUNCIL_VERDICT, MARKETPLACE_LISTING). Newest first. Free — enables backtesting and confidence calibration.

Parameters1

symbol

string

required

Equity ticker

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "description": "Equity ticker",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ]
}

get_invoice

Request a payment invoice for any SqueezeOS endpoint. Returns XRPL destination address, amount in RLUSD, and memo_hex. Pay on XRPL then call verify_payment. Free.

Parameters1

endpoint_id

string

required

UUID of the endpoint to pay for

Raw schema

{
  "type": "object",
  "properties": {
    "endpoint_id": {
      "description": "UUID of the endpoint to pay for",
      "type": "string"
    }
  },
  "required": [
    "endpoint_id"
  ]
}

verify_payment

Submit XRPL tx_hash after paying an invoice. Returns a signed JWT access_token (1-hour TTL) to use as payment_token. Free.

Parameters4

agent_domain	string	optional	Optional agent domain for attribution
agent_wallet	string	required	Your XRPL classic address
invoice_id	string	required
tx_hash	string	required	64-char hex XRPL tx hash

Raw schema

{
  "type": "object",
  "properties": {
    "agent_domain": {
      "description": "Optional agent domain for attribution",
      "type": "string"
    },
    "agent_wallet": {
      "description": "Your XRPL classic address",
      "type": "string"
    },
    "invoice_id": {
      "type": "string"
    },
    "tx_hash": {
      "description": "64-char hex XRPL tx hash",
      "type": "string"
    }
  },
  "required": [
    "invoice_id",
    "tx_hash",
    "agent_wallet"
  ]
}

bureau_public_score

FICO-style 300-850 Agent Credit Bureau score for any XRPL wallet. Includes grade and loyalty tier. Free.

Parameters1

wallet

string

required

XRPL classic address (rADDRESS)

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "description": "XRPL classic address (rADDRESS)",
      "type": "string"
    }
  },
  "required": [
    "wallet"
  ]
}

marketplace_browse

Browse peer signal marketplace listings. Filter by symbol or bias. Free.

Parameters2

bias	string	optional
symbol	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "bias": {
      "enum": [
        "BULLISH",
        "BEARISH",
        "NEUTRAL"
      ],
      "type": "string"
    },
    "symbol": {
      "type": "string"
    }
  }
}

marketplace_read_signal

Read full thesis for a marketplace signal listing. Returns entry, target, stop, and seller reputation. Cost: 0.02 RLUSD.

Parameters3

agent_wallet	string	optional
listing_id	string	required	UUID of the listing
payment_token	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "agent_wallet": {
      "type": "string"
    },
    "listing_id": {
      "description": "UUID of the listing",
      "type": "string"
    },
    "payment_token": {
      "type": "string"
    }
  },
  "required": [
    "listing_id"
  ]
}

marketplace_list_signal

Post your own analysis signal to the marketplace. Buyers pay 0.02 RLUSD to read your thesis. Sellers earn Credit Bureau score +2 per sale. Free to post.

Parameters9

bias	string	required
confidence	number	required
entry	number	optional
signal_type	string	optional
stop	number	optional
symbol	string	required
target	number	optional
thesis	string	required
wallet	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "bias": {
      "enum": [
        "BULLISH",
        "BEARISH",
        "NEUTRAL"
      ],
      "type": "string"
    },
    "confidence": {
      "maximum": 100,
      "minimum": 0,
      "type": "number"
    },
    "entry": {
      "type": "number"
    },
    "signal_type": {
      "type": "string"
    },
    "stop": {
      "type": "number"
    },
    "symbol": {
      "type": "string"
    },
    "target": {
      "type": "number"
    },
    "thesis": {
      "type": "string"
    },
    "wallet": {
      "type": "string"
    }
  },
  "required": [
    "wallet",
    "symbol",
    "bias",
    "confidence",
    "thesis"
  ]
}

hiring_browse_jobs

Browse open agent hiring jobs. Filter by type, symbol, or min bounty. Free.

Parameters3

min_bounty	number	optional
symbol	string	optional
type	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "min_bounty": {
      "type": "number"
    },
    "symbol": {
      "type": "string"
    },
    "type": {
      "type": "string"
    }
  }
}

hiring_post_job

Post an analysis job for other agents to fulfill. Bounty paid direct XRPL wallet-to-wallet — SqueezeOS never holds funds. Free to post.

Parameters7

bounty_rlusd	number	optional
deadline_hours	integer	optional
description	string	required
job_type	string	optional
payment_wallet	string	optional
symbol	string	optional
wallet	string	required	Your XRPL wallet

Raw schema

{
  "type": "object",
  "properties": {
    "bounty_rlusd": {
      "type": "number"
    },
    "deadline_hours": {
      "maximum": 168,
      "minimum": 1,
      "type": "integer"
    },
    "description": {
      "type": "string"
    },
    "job_type": {
      "enum": [
        "ANALYSIS",
        "SCAN",
        "SIGNAL",
        "PREDICTION",
        "ARBITRAGE",
        "RESEARCH",
        "DATA",
        "CUSTOM"
      ],
      "type": "string"
    },
    "payment_wallet": {
      "type": "string"
    },
    "symbol": {
      "type": "string"
    },
    "wallet": {
      "description": "Your XRPL wallet",
      "type": "string"
    }
  },
  "required": [
    "wallet",
    "description"
  ]
}

system_status

SqueezeOS system health check. Returns uptime and version. Free.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

ccs_validate

Cognitive Credit Swarms — Content Trust Validation. Submit any text (news, message, social post, ad copy) and receive a trust score 0-100, a verdict (TRUSTED / LOW_RISK / SUSPICIOUS / HIGH_RISK / BLOCKED), and a flag breakdown identifying manipulation patterns: certainty abuse, emotional manipulation, attribution gaps, synthetic/AI content markers, excessive capitalization. Sender wallet reputation is tracked on the Agent Credit Bureau — blocked senders accumulate negative history. Used by agents to filter their information environment and enforce a Micro-Attention Tax: misinformation costs the sender without reaching the target. Free tier: 3 calls/hour per IP. Paid: 0.01 RLUSD per call via X-Payment-Token (unlimited). Endpoint ID for payment: 05764097-3f3e-4279-89e5-c786efab2f91

Parameters4

agent_wallet	string	optional	Your XRPL wallet
content	string	required	Text to validate (max 10,000 chars)
payment_token	string	optional	JWT from verify_payment (0.01 RLUSD — for unlimited access)
sender_wallet	string	optional	XRPL wallet of the content sender (optional, enables reputation tracking)

Raw schema

{
  "type": "object",
  "properties": {
    "agent_wallet": {
      "description": "Your XRPL wallet",
      "type": "string"
    },
    "content": {
      "description": "Text to validate (max 10,000 chars)",
      "type": "string"
    },
    "payment_token": {
      "description": "JWT from verify_payment (0.01 RLUSD — for unlimited access)",
      "type": "string"
    },
    "sender_wallet": {
      "description": "XRPL wallet of the content sender (optional, enables reputation tracking)",
      "type": "string"
    }
  },
  "required": [
    "content"
  ]
}

ccs_score

Get the Cognitive Credit Score for any XRPL wallet. Blends CCS trust ledger (content submission history) with Agent Credit Bureau score into a composite trust grade (A/B/C/D). Shows: ccs_score (0-100), reputation_tier (TRUSTED_VALIDATOR / VERIFIED / NEUTRAL / FLAGGED / BLOCKED_SENDER), validation history, block/pass rates. Free.

Parameters1

wallet

string

required

XRPL classic address (rXXX)

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "description": "XRPL classic address (rXXX)",
      "type": "string"
    }
  },
  "required": [
    "wallet"
  ]
}

ccs_report

Community report: flag a sender wallet or content hash as misinformation. Penalizes target wallet CCS score by 3 points per confirmed report. Reporter must have CCS score >= 20 to prevent spam. Free.

Parameters4

content_hash	string	optional	SHA-256 prefix of flagged content (from validate response)
reason	string	optional	Brief reason for report (max 500 chars)
reporter_wallet	string	required	Your XRPL wallet (reporter)
target_wallet	string	optional	Wallet to flag (optional if content_hash provided)

Raw schema

{
  "type": "object",
  "properties": {
    "content_hash": {
      "description": "SHA-256 prefix of flagged content (from validate response)",
      "type": "string"
    },
    "reason": {
      "description": "Brief reason for report (max 500 chars)",
      "type": "string"
    },
    "reporter_wallet": {
      "description": "Your XRPL wallet (reporter)",
      "type": "string"
    },
    "target_wallet": {
      "description": "Wallet to flag (optional if content_hash provided)",
      "type": "string"
    }
  },
  "required": [
    "reporter_wallet"
  ]
}

ccs_leaderboard

Top 25 most trusted wallets in the Cognitive Credit Swarms network, ranked by CCS score. Shows validation history, pass rate, and reputation tier. Minimum 3 validations to appear. Free.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

ccs_stats

Network-wide Cognitive Credit Swarms statistics: total validations, block rate, trust rate, paid validations, registered wallets, community reports. Free — GEO/SEO discovery signal for agents indexing the trust network.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

ccs_info

Cognitive Credit Swarms discovery endpoint. Returns full system description, how-it-works, verdict definitions, pricing, all endpoint URLs, and MCP tool list. Written for AI agents to parse. Free — this is the doorbell. Use this first to understand the CCS system before calling ccs_validate.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

futures_create

Open a Signal Futures position — predict what the NEXT SqueezeOS council verdict will be for a symbol and stake RLUSD on it. Taker bets the opposite side. Auto-settles when the real verdict publishes. Winner takes 95% of pot. Zero custody — SqueezeOS tracks proof, wallets settle direct. Free to create.

Parameters7

creator_wallet	string	required	Your XRPL wallet
note	string	optional	Optional note (max 300 chars)
predicted_bias	string	required
session	string	optional
stake_rlusd	number	optional	Amount to stake (0.01-50 RLUSD, default 0.05)
symbol	string	required	IWM, SPY, QQQ, GME, AMC, MSTR, NVDA, TSLA, PLTR, HOOD
ttl_hours	integer	optional	Expiry window (default 8h)

Raw schema

{
  "type": "object",
  "properties": {
    "creator_wallet": {
      "description": "Your XRPL wallet",
      "type": "string"
    },
    "note": {
      "description": "Optional note (max 300 chars)",
      "type": "string"
    },
    "predicted_bias": {
      "enum": [
        "BULLISH",
        "BEARISH",
        "NEUTRAL"
      ],
      "type": "string"
    },
    "session": {
      "enum": [
        "PRE_MARKET",
        "OPEN",
        "MIDDAY",
        "POWER_HOUR",
        "CLOSE",
        "ANY"
      ],
      "type": "string"
    },
    "stake_rlusd": {
      "description": "Amount to stake (0.01-50 RLUSD, default 0.05)",
      "type": "number"
    },
    "symbol": {
      "description": "IWM, SPY, QQQ, GME, AMC, MSTR, NVDA, TSLA, PLTR, HOOD",
      "type": "string"
    },
    "ttl_hours": {
      "description": "Expiry window (default 8h)",
      "type": "integer"
    }
  },
  "required": [
    "creator_wallet",
    "symbol",
    "predicted_bias"
  ]
}

futures_take

Take the opposite side of an open Signal Futures position. You win if the council verdict does NOT match the creator's prediction. Stakes locked immediately. Settles on next council verdict for that symbol. Free.

Parameters2

future_id	string	required	UUID from futures_browse
taker_wallet	string	required	Your XRPL wallet

Raw schema

{
  "type": "object",
  "properties": {
    "future_id": {
      "description": "UUID from futures_browse",
      "type": "string"
    },
    "taker_wallet": {
      "description": "Your XRPL wallet",
      "type": "string"
    }
  },
  "required": [
    "future_id",
    "taker_wallet"
  ]
}

futures_browse

Browse open Signal Futures positions. Filter by symbol, status, or bias. Shows stake, pot size, creator prediction, and expiry. Free.

Parameters4

bias	string	optional
limit	integer	optional	Max results (default 50, max 200)
status	string	optional
symbol	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "bias": {
      "enum": [
        "BULLISH",
        "BEARISH",
        "NEUTRAL"
      ],
      "type": "string"
    },
    "limit": {
      "description": "Max results (default 50, max 200)",
      "type": "integer"
    },
    "status": {
      "enum": [
        "OPEN",
        "ACTIVE",
        "SETTLED",
        "EXPIRED"
      ],
      "type": "string"
    },
    "symbol": {
      "type": "string"
    }
  }
}

futures_leaderboard

Top Signal Futures predictors ranked by wins. Shows win rate, PnL, total staked. Free.

Parameters1

limit

integer

optional

Max results (default 20, max 100)

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Max results (default 20, max 100)",
      "type": "integer"
    }
  }
}

settlement_create

Create a conditional agent-to-agent escrow contract. Lock intent: 'I'll pay X RLUSD to Agent B IF condition Y is met.' Conditions: bias_match, confidence_above, price_above, price_below, time_elapsed. SqueezeOS tracks and proves — wallets settle direct. 1% platform fee on settlement. Free to create.

Parameters8

amount_rlusd	number	required	RLUSD to pay on condition met (0.01-1000)
condition_type	string	required
condition_value	string	optional	Condition threshold (e.g. 'BULLISH', '75', '220.50')
creator_wallet	string	required	Your XRPL wallet (payer)
description	string	optional	Human-readable contract description
recipient_wallet	string	required	Recipient XRPL wallet
symbol	string	required	Target equity symbol
ttl_hours	integer	optional	Contract expiry (default 24h)

Raw schema

{
  "type": "object",
  "properties": {
    "amount_rlusd": {
      "description": "RLUSD to pay on condition met (0.01-1000)",
      "type": "number"
    },
    "condition_type": {
      "enum": [
        "bias_match",
        "confidence_above",
        "price_above",
        "price_below",
        "time_elapsed"
      ],
      "type": "string"
    },
    "condition_value": {
      "description": "Condition threshold (e.g. 'BULLISH', '75', '220.50')",
      "type": "string"
    },
    "creator_wallet": {
      "description": "Your XRPL wallet (payer)",
      "type": "string"
    },
    "description": {
      "description": "Human-readable contract description",
      "type": "string"
    },
    "recipient_wallet": {
      "description": "Recipient XRPL wallet",
      "type": "string"
    },
    "symbol": {
      "description": "Target equity symbol",
      "type": "string"
    },
    "ttl_hours": {
      "description": "Contract expiry (default 24h)",
      "type": "integer"
    }
  },
  "required": [
    "creator_wallet",
    "recipient_wallet",
    "amount_rlusd",
    "condition_type",
    "symbol"
  ]
}

convergence_check

Run the full SML proprietary engine cascade against a symbol and evaluate the Beastmode convergence gate. Five independent engines across five distinct market dimensions (price elasticity, settlement-clock timing, dark-pool volume kinetics, temporal correlation, macro structural frequency) score the setup. Includes Options Sniper that scans Tradier for short-DTE calls/puts in a high-leverage delta band when convergence is high. Signal levels: BEASTMODE (all 5) > HIGH_CONVERGENCE (4) > CONVERGENCE (3) > LIE_DETECTOR_ACTIVE > PARTIAL_ALIGNMENT. Auto-fires Discord alert on BEASTMODE and HIGH_CONVERGENCE. Free endpoint.

Parameters2

sniper	boolean	optional	Run Tradier options sniper (default true, only fires on HIGH_CONVERGENCE+)
symbol	string	required	US equity ticker — best on high-manipulation assets (GME, AMC, MSTR, PLTR, HOOD)

Raw schema

{
  "type": "object",
  "properties": {
    "sniper": {
      "description": "Run Tradier options sniper (default true, only fires on HIGH_CONVERGENCE+)",
      "type": "boolean"
    },
    "symbol": {
      "description": "US equity ticker — best on high-manipulation assets (GME, AMC, MSTR, PLTR, HOOD)",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ]
}

autopilot_status

Read-only status of the Sovereign Autopilot (CEO Trader). Returns: active (bool), live_mode (bool), symbols watchlist, min_confidence threshold, Kelly fraction, max concurrent positions, cooldown remaining, active open positions with symbol/side/entry/SL/TP, circuit breaker state, daily P&L, daily trade count. Free — no auth required. Safe for any agent to call at any frequency.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

autopilot_start

Activate the Sovereign Autopilot. Requires X-Operator-Key header (set OPERATOR_API_KEY env var on the server). Once active, the autopilot polls OracleEngine every AUTOPILOT_SCAN_INTERVAL seconds, fires on confidence >= AUTOPILOT_MIN_CONFIDENCE, sizes via Kelly Criterion from live Tradier account equity, and routes to Tradier API. TRADIER_LIVE must be true for real orders — otherwise runs in shadow mode. Returns: {status, live_mode, message}.

Parameters1

operator_key

string

optional

Operator API key (or pass X-Operator-Key header)

Raw schema

{
  "type": "object",
  "properties": {
    "operator_key": {
      "description": "Operator API key (or pass X-Operator-Key header)",
      "type": "string"
    }
  }
}

autopilot_stop

Halt the Sovereign Autopilot immediately. Does NOT close open positions — use autopilot_trades to review then manage manually. Requires X-Operator-Key header. Returns: {status}.

Parameters1

operator_key

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "operator_key": {
      "type": "string"
    }
  }
}

autopilot_trades

Live view of all active and historical autopilot trades. Returns: active_trades (open positions with symbol, side, qty, entry_price, current_price, sl, tp, unrealized_pnl, mode LIVE/SHADOW), trade_history (last 50 closed trades with realized_pnl), daily_pnl, daily_trade_count, live_mode. Free — no auth required.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

circuit_breaker_reset

Reset the autopilot circuit breaker after a daily loss halt. The circuit breaker fires automatically when realized daily P&L drops below AUTOPILOT_MAX_DAILY_LOSS_PCT of account equity. Call this to re-arm after reviewing trades and confirming resumption is safe. Requires X-Operator-Key. Returns: {status, daily_pnl, breaker_state}.

Parameters1

operator_key

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "operator_key": {
      "type": "string"
    }
  }
}

beastmode_scan

Scan the full Beastmode universe (GME AMC MSTR PLTR HOOD IWM SPY QQQ NVDA TSLA) for multi-engine convergence. Returns only symbols at HIGH_CONVERGENCE or BEASTMODE signal level. Includes options sniper output for each hit. Auto-fires Discord alerts for any Beastmode locks found. Use this as the autonomous agent's primary market surveillance call. Free endpoint.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

proprietary_ema_signal

SML Proprietary EMA Suite — three independent engines on three distinct market dimensions (macro price stretch, dark-pool volume kinetics, price ribbon harmonics) evaluated together for high-conviction consensus. Consensus levels: TRIPLE_LOCK_BULL/BEAR (highest conviction — all engines agree at independent dimensions), LIE_DETECTOR_ACTIVE (cross-engine divergence trigger, institutional accumulation footprint), BULL/BEAR_CONFLUENCE, BULL/BEAR_DIVERGENT, NEUTRAL. Returns directional bias, per-engine signal blocks (without internal parameters), and combined_score (0-100) that feeds council_verdict confidence. Free.

Parameters1

symbol

string

required

US equity ticker (e.g. SPY, IWM, GME, NVDA)

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "description": "US equity ticker (e.g. SPY, IWM, GME, NVDA)",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ]
}

settlement_browse

Browse open conditional settlement contracts. Filter by symbol or creator wallet. Free.

Parameters4

limit	integer	optional
status	string	optional
symbol	string	optional
wallet	string	optional	Filter by creator or recipient wallet

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer"
    },
    "status": {
      "enum": [
        "OPEN",
        "TRIGGERED",
        "SETTLED",
        "EXPIRED",
        "CANCELLED"
      ],
      "type": "string"
    },
    "symbol": {
      "type": "string"
    },
    "wallet": {
      "description": "Filter by creator or recipient wallet",
      "type": "string"
    }
  }
}

settlement_trigger

Check if a settlement contract's condition is now met — and settle it if so. Publishes a settlement proof to SSE stream. Returns proof on success. Anyone can call — contract creator, recipient, or any agent. Free.

Parameters1

contract_id

string

required

UUID from settlement_browse

Raw schema

{
  "type": "object",
  "properties": {
    "contract_id": {
      "description": "UUID from settlement_browse",
      "type": "string"
    }
  },
  "required": [
    "contract_id"
  ]
}

oracle_feeds

Free catalog of all available Real-World Data Oracle feeds. Returns feed names, descriptions, current event buffer counts, poll intervals, and per-call pricing. Available feeds: sec_8k (SEC Form 8-K material events), sec_s1 (IPO filings), fda (FDA NDA/BLA drug approvals), patents (USPTO patent grants). Use this before calling oracle_query to see what data is available and how many events are buffered. No payment required.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

oracle_query

Premium (0.02 RLUSD) — search or retrieve events from the Real-World Data Oracle. Covers four regulatory data feeds: sec_8k (8-K material events), sec_s1 (IPO filings), fda (FDA drug approvals), patents (USPTO patent grants). Returns machine-readable JSON events with timestamps, source URLs, and structured fields. Sub-second delivery vs Bloomberg's 5–10 minute lag — agents that catch the 8-K or FDA approval first win the trade. Pass feeds=[] to query all feeds. Pass keyword to text-search events. Pass since_ts (Unix timestamp) to get only recent events. Cost: 0.02 RLUSD per call. Pass payment_token from verify_payment.

Parameters6

agent_wallet	string	optional	Your XRPL wallet address
feeds	array	optional	Feed keys to query: sec_8k, sec_s1, fda, patents (default: all)
keyword	string	optional	Case-insensitive keyword to filter events
limit	integer	optional	Max events to return (default 50, max 200)
payment_token	string	optional	JWT from verify_payment (0.02 RLUSD)
since_ts	number	optional	Unix timestamp — only return events after this time

Raw schema

{
  "type": "object",
  "properties": {
    "agent_wallet": {
      "description": "Your XRPL wallet address",
      "type": "string"
    },
    "feeds": {
      "description": "Feed keys to query: sec_8k, sec_s1, fda, patents (default: all)",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "keyword": {
      "description": "Case-insensitive keyword to filter events",
      "type": "string"
    },
    "limit": {
      "description": "Max events to return (default 50, max 200)",
      "type": "integer"
    },
    "payment_token": {
      "description": "JWT from verify_payment (0.02 RLUSD)",
      "type": "string"
    },
    "since_ts": {
      "description": "Unix timestamp — only return events after this time",
      "type": "number"
    }
  }
}

iam_resolve

IAM — Inevitable Action Model. Proprietary. Cost: 0.05 RLUSD. Resolves what action the market is FORCED to take, not what it is predicted to do. IAM is a resolver, not a predictor. Five independent Obligation Committee analysts (no cross-communication) compute: (1) Volatility Release — how overdue is a vol event? (2) Liquidity Refill — which side of the book is depleted? (3) Dealer Inventory Hedge — what must dealers buy/sell to stay neutral? (4) Mean Reversion Pull — how far has price deviated from statistical equilibrium? (5) Structural Bounds — is price at a boundary that requires resolution? Truth Layer aggregates into neutral system stress (directional_bias: NONE). Action Resolution Oracle selects A* = argmin(projected_stress_after_action). Output: mandatory action BUY/SELL/HOLD, rationale, vehicle, invalidation condition, review trigger, per-analyst obligation pressure (0-100%). Internal AMM invariant parameters are proprietary and redacted from all responses. Use iam_truth (free) to preview the Truth Layer before paying. Pass payment_token from verify_payment plus agent_wallet.

Parameters3

agent_wallet	string	optional	Your XRPL wallet address
payment_token	string	optional	JWT from verify_payment (0.05 RLUSD)
symbol	string	required	US equity ticker (e.g. IWM, SPY, QQQ, GME, AMC, NVDA)

Raw schema

{
  "type": "object",
  "properties": {
    "agent_wallet": {
      "description": "Your XRPL wallet address",
      "type": "string"
    },
    "payment_token": {
      "description": "JWT from verify_payment (0.05 RLUSD)",
      "type": "string"
    },
    "symbol": {
      "description": "US equity ticker (e.g. IWM, SPY, QQQ, GME, AMC, NVDA)",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ]
}

iam_truth

IAM Truth Layer — neutral obligation state for a symbol. No action resolution. Returns the raw obligation pressure vector before direction is forced: Volatility Release, Liquidity Refill, Dealer Hedge, Mean Reversion Pull, Structural Pressure (all 0-100%), and Directional Bias: NONE (always — Truth Layer is strictly neutral), plus Time Window: DORMANT / DEVELOPING / NEAR_TERM / IMMEDIATE. Free endpoint.

Parameters1

symbol

string

required

US equity ticker

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "description": "US equity ticker",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ]
}

macro_741_scan

741 Pure Macro Matrix — 5-layer EMA structural alignment engine. Cost: 0.04 RLUSD. Computes EMA 30 / 60 / 90 / 120 / 741 on daily closes for any set of US equity tickers. Returns one of three macro states per ticker: PERFECT_BULLISH_REGIME — EMA_30 > EMA_60 > EMA_90 > EMA_120 > EMA_741 (full institutional highway: asset is locked into massive capital momentum, safe to ride). PERFECT_BEARISH_REGIME — full inversion, macro distribution confirmed. CONSOLIDATION_CHOP — mixed stack; watch matrix_spread_pct for squeeze_alert. squeeze_alert=true means CONSOLIDATION_CHOP with |matrix_spread_pct| < 5% — price is coiling directly against the 741 anchor, a macro breakout is building. Fires Discord alert automatically on every PERFECT BULLISH or BEARISH hit. Tickers are fully dynamic — pass any comma-separated list. Max 50 symbols per call. Cost: 0.04 RLUSD. Pass payment_token from verify_payment plus agent_wallet.

Parameters3

agent_wallet	string	optional	Your XRPL wallet address
payment_token	string	optional	JWT from verify_payment (0.04 RLUSD)
symbols	string	required	Comma-separated US equity tickers, e.g. 'SPY,QQQ,GME,NVDA,IWM'. Max 50.

Raw schema

{
  "type": "object",
  "properties": {
    "agent_wallet": {
      "description": "Your XRPL wallet address",
      "type": "string"
    },
    "payment_token": {
      "description": "JWT from verify_payment (0.04 RLUSD)",
      "type": "string"
    },
    "symbols": {
      "description": "Comma-separated US equity tickers, e.g. 'SPY,QQQ,GME,NVDA,IWM'. Max 50.",
      "type": "string"
    }
  },
  "required": [
    "symbols"
  ]
}

sovereign_741

SML 741 Macro Highway Signal — 0.02 RLUSD. Returns BULLISH HIGHWAY (full ascending EMA stack, institutional momentum confirmed), BEARISH HIGHWAY (full descending stack, macro distribution), or CONSOLIDATION (mixed stack; squeeze_alert=true means coiling against the anchor — macro breakout likely imminent). Labels only — no EMA values, spreads, or price data ever returned. Proprietary engine.

Parameters3

agent_wallet	string	optional	Your XRPL wallet address
payment_token	string	optional	JWT from verify_payment (0.02 RLUSD)
symbol	string	required	US equity ticker (e.g. SPY, IWM, GME)

Raw schema

{
  "type": "object",
  "properties": {
    "agent_wallet": {
      "description": "Your XRPL wallet address",
      "type": "string"
    },
    "payment_token": {
      "description": "JWT from verify_payment (0.02 RLUSD)",
      "type": "string"
    },
    "symbol": {
      "description": "US equity ticker (e.g. SPY, IWM, GME)",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ]
}

sovereign_365

SML 365-Day EMA Anchor Signal — 0.03 RLUSD. Returns ABOVE (price is above the 365-day EMA — macro bull structure intact) or BELOW (price is below — macro bear structure or recovery attempt). No raw EMA values or price levels returned. Proprietary calculation.

Parameters3

agent_wallet	string	optional	Your XRPL wallet address
payment_token	string	optional	JWT from verify_payment (0.03 RLUSD)
symbol	string	required	US equity ticker

Raw schema

{
  "type": "object",
  "properties": {
    "agent_wallet": {
      "description": "Your XRPL wallet address",
      "type": "string"
    },
    "payment_token": {
      "description": "JWT from verify_payment (0.03 RLUSD)",
      "type": "string"
    },
    "symbol": {
      "description": "US equity ticker",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ]
}

sovereign_triplelock

SML Triple Lock Consensus Signal — 0.05 RLUSD. Returns LOCKED BULL (all three engines aligned bullish — max-conviction long setup, rarest signal), LOCKED BEAR (all three engines aligned bearish — max-conviction short), FORMING (two of three engines aligned — building toward a lock), or UNLOCKED (engines not in consensus — wait for alignment). No engine names, theses, or raw values returned. Labels only.

Parameters3

agent_wallet	string	optional	Your XRPL wallet address
payment_token	string	optional	JWT from verify_payment (0.05 RLUSD)
symbol	string	required	US equity ticker

Raw schema

{
  "type": "object",
  "properties": {
    "agent_wallet": {
      "description": "Your XRPL wallet address",
      "type": "string"
    },
    "payment_token": {
      "description": "JWT from verify_payment (0.05 RLUSD)",
      "type": "string"
    },
    "symbol": {
      "description": "US equity ticker",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ]
}

sovereign_full

SML Sovereign Full Stack Signal — 0.10 RLUSD. Runs all three sovereign engines (741 Macro, 365 Anchor, Triple Lock) and combines them into one verdict: SOVEREIGN BULL (all three bullish — maximum confidence long), SOVEREIGN BEAR (all three bearish — maximum confidence short), TRANSITIONAL (two of three aligned — directional bias forming), or STANDBY (no consensus — preserve capital). Also returns squeeze_alert=true when the 741 matrix detects macro coiling. No raw values, EMA levels, or indicator readings returned. Ever.

Parameters3

agent_wallet	string	optional	Your XRPL wallet address
payment_token	string	optional	JWT from verify_payment (0.10 RLUSD)
symbol	string	required	US equity ticker

Raw schema

{
  "type": "object",
  "properties": {
    "agent_wallet": {
      "description": "Your XRPL wallet address",
      "type": "string"
    },
    "payment_token": {
      "description": "JWT from verify_payment (0.10 RLUSD)",
      "type": "string"
    },
    "symbol": {
      "description": "US equity ticker",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ]
}

post_to_slack

Post a sanitized market signal brief to Slack via incoming webhook. Proprietary data policy enforced server-side: price levels, EMA values, and raw indicator readings are stripped — only direction labels, confidence %, regime, risk level, and text thesis are delivered to Slack. Pass webhook_url to target your own Slack channel, or omit to post to the SML shared channel (requires SLACK_WEBHOOK_URL env var on this server). Free.

Parameters9

actionable	string	optional	One-line actionable instruction (max 300 chars)
bias	string	required
confidence	integer	optional	Signal confidence 0-100
regime	string	optional	Regime label (e.g. ALPHA_EXPANSION, MACRO_COLLAPSE, NEUTRAL)
risk_level	string	optional
session	string	optional
symbol	string	required	Equity ticker (e.g. IWM, SPY, GME)
thesis	string	optional	Signal thesis (max 500 chars)
webhook_url	string	optional	Slack incoming webhook URL (optional, falls back to server SLACK_WEBHOOK_URL)

Raw schema

{
  "type": "object",
  "properties": {
    "actionable": {
      "description": "One-line actionable instruction (max 300 chars)",
      "type": "string"
    },
    "bias": {
      "enum": [
        "BULLISH",
        "BEARISH",
        "NEUTRAL"
      ],
      "type": "string"
    },
    "confidence": {
      "description": "Signal confidence 0-100",
      "maximum": 100,
      "minimum": 0,
      "type": "integer"
    },
    "regime": {
      "description": "Regime label (e.g. ALPHA_EXPANSION, MACRO_COLLAPSE, NEUTRAL)",
      "type": "string"
    },
    "risk_level": {
      "enum": [
        "LOW",
        "MEDIUM",
        "HIGH",
        "EXTREME"
      ],
      "type": "string"
    },
    "session": {
      "enum": [
        "PRE_MARKET",
        "OPEN",
        "MIDDAY",
        "POWER_HOUR",
        "CLOSE"
      ],
      "type": "string"
    },
    "symbol": {
      "description": "Equity ticker (e.g. IWM, SPY, GME)",
      "type": "string"
    },
    "thesis": {
      "description": "Signal thesis (max 500 chars)",
      "type": "string"
    },
    "webhook_url": {
      "description": "Slack incoming webhook URL (optional, falls back to server SLACK_WEBHOOK_URL)",
      "type": "string"
    }
  },
  "required": [
    "symbol",
    "bias"
  ]
}

citation_score

AgentRank™ — Get citation authority scores for ScriptMasterLabs APIs. Returns how often SqueezeOS, Ghost Layer, 402Proof, and ScriptMasterLabs are mentioned on Reddit and Hacker News, scored 0–100. Includes recent brand mentions and context (e.g., cited in 'best API for trading' threads). Use this to gauge AI discoverability momentum. Free. Trigger a fresh probe with action='probe' (async, results appear within 60s).

Parameters3

action	string	optional	scores=leaderboard (default), history=all events, probe=trigger scan, status=health
limit	integer	optional	Max history events to return (default 100, max 500)
target	string	optional	Filter history by service id: squeezeos\|scriptmasterlabs\|ghost-layer\|402proof

Raw schema

{
  "type": "object",
  "properties": {
    "action": {
      "description": "scores=leaderboard (default), history=all events, probe=trigger scan, status=health",
      "enum": [
        "scores",
        "history",
        "probe",
        "status"
      ],
      "type": "string"
    },
    "limit": {
      "description": "Max history events to return (default 100, max 500)",
      "type": "integer"
    },
    "target": {
      "description": "Filter history by service id: squeezeos|scriptmasterlabs|ghost-layer|402proof",
      "type": "string"
    }
  }
}

narrative_optimize

P04 API Narrative Optimizer — Analyze ScriptMasterLabs API descriptions for AI-discoverability weaknesses. Scans llms.txt and .well-known/mcp.json for vague, passive, or AI-hostile copy patterns. Returns ranked issues with specific fix advice. Run this before updating discovery manifests. Free.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

provider_score

ARGUS AgentPageRank™ — Get the SqueezeOS API provider quality score (0–850) from live AI agent traffic. Score components: volume (how many agents call us), diversity (how many different AI systems), conversion (paid vs free ratio), repeat rate (return visitors). Also returns per-agent-type breakdown and hourly trend. Use this to benchmark provider authority before integrating or citing SqueezeOS. Free.

Parameters2

hours	integer	optional	Lookback window in hours (breakdown/trend/leaderboard, default 24)
view	string	optional	score=overall card (default), breakdown=per-agent-type, trend=24h hourly, leaderboard=top wallets

Raw schema

{
  "type": "object",
  "properties": {
    "hours": {
      "description": "Lookback window in hours (breakdown/trend/leaderboard, default 24)",
      "type": "integer"
    },
    "view": {
      "description": "score=overall card (default), breakdown=per-agent-type, trend=24h hourly, leaderboard=top wallets",
      "enum": [
        "score",
        "breakdown",
        "trend",
        "leaderboard"
      ],
      "type": "string"
    }
  }
}

semantic_gaps

Semantic Gap Detector™ — Discover unmet API demand in the developer community. Scans Reddit and Hacker News for 'I need an API for X' demand signals. Returns ranked topics where developer demand is high but no SML product covers the gap. Use this to identify new product opportunities. Trigger a fresh scan with action='scan'. Free.

Parameters3

action	string	optional	gaps=leaderboard (default), raw=all signals, scan=trigger, status=health
gaps_only	boolean	optional	raw only: filter to uncovered gaps (default false)
limit	integer	optional	Max raw signals to return (default 100)

Raw schema

{
  "type": "object",
  "properties": {
    "action": {
      "description": "gaps=leaderboard (default), raw=all signals, scan=trigger, status=health",
      "enum": [
        "gaps",
        "raw",
        "scan",
        "status"
      ],
      "type": "string"
    },
    "gaps_only": {
      "description": "raw only: filter to uncovered gaps (default false)",
      "type": "boolean"
    },
    "limit": {
      "description": "Max raw signals to return (default 100)",
      "type": "integer"
    }
  }
}

agent_economy

Agent Economy Intelligence Network™ (AEIN) — ComScore for AI agent commerce. Returns aggregate statistics on which AI systems (Claude, GPT, Gemini, etc.) are calling SqueezeOS APIs, conversion rates, and traffic patterns. Public summary is free. Full report with heatmap and wallet analytics costs 0.25 RLUSD. Use this to understand the AI agent commerce landscape before building on or citing SqueezeOS.

Parameters4

agent_wallet	string	optional	Your XRPL wallet address (required for view=report)
hours	integer	optional	Lookback window for summary/leaderboard (default 24, max 168)
payment_token	string	optional	JWT from verify_payment (required for view=report, 0.25 RLUSD)
view	string	optional	summary=free overview (default), report=premium 0.25 RLUSD, leaderboard=top agent types, heatmap=7d traffic matrix

Raw schema

{
  "type": "object",
  "properties": {
    "agent_wallet": {
      "description": "Your XRPL wallet address (required for view=report)",
      "type": "string"
    },
    "hours": {
      "description": "Lookback window for summary/leaderboard (default 24, max 168)",
      "type": "integer"
    },
    "payment_token": {
      "description": "JWT from verify_payment (required for view=report, 0.25 RLUSD)",
      "type": "string"
    },
    "view": {
      "description": "summary=free overview (default), report=premium 0.25 RLUSD, leaderboard=top agent types, heatmap=7d traffic matrix",
      "enum": [
        "summary",
        "report",
        "leaderboard",
        "heatmap"
      ],
      "type": "string"
    }
  }
}

truth_verify

Truth Engine. Cost: 0.02 RLUSD. Queries Tradier, Alpaca, and Polygon independently for the same symbol and returns a consensus price with a real measured variance/spread across whichever sources actually responded (not a single quote relabeled three times). Confidence is a direct function of source agreement, not a fixed number. Response includes an HMAC-SHA256 proof hash so it can be verified as unaltered after this server produced it. If fewer than 2 providers respond, consensus_method is marked 'single-source-unverified' rather than faking a second opinion. Pass payment_token from verify_payment plus agent_wallet.

Parameters3

agent_wallet	string	optional
payment_token	string	optional
symbol	string	required	Ticker symbol, e.g. IWM

Raw schema

{
  "type": "object",
  "properties": {
    "agent_wallet": {
      "type": "string"
    },
    "payment_token": {
      "type": "string"
    },
    "symbol": {
      "description": "Ticker symbol, e.g. IWM",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ]
}

memory_store

Memory Graph. Cost: 0.01 RLUSD. Persists an agent memory in Redis (durable across sessions) with the caller's own provenance kept exactly as submitted — this tool never invents or upgrades a confidence score. provenance.confidence is required. Pass payment_token from verify_payment plus agent_wallet.

Parameters7

agent_id	string	required
agent_wallet	string	optional
content	string	required
payment_token	string	optional
provenance	object	required
tags	array	optional
type	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string"
    },
    "agent_wallet": {
      "type": "string"
    },
    "content": {
      "type": "string"
    },
    "payment_token": {
      "type": "string"
    },
    "provenance": {
      "properties": {
        "confidence": {
          "type": "number"
        },
        "source_id": {
          "type": "string"
        },
        "source_type": {
          "type": "string"
        }
      },
      "required": [
        "confidence"
      ],
      "type": "object"
    },
    "tags": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "type": {
      "enum": [
        "episodic",
        "semantic",
        "procedural",
        "custom"
      ],
      "type": "string"
    }
  },
  "required": [
    "content",
    "agent_id",
    "provenance"
  ]
}

memory_recall

Memory Graph. Cost: 0.01 RLUSD. Literal keyword/tag search over an agent's own stored memories, ranked by recency. Not semantic or vector search — no embedding model is involved, and the response says so explicitly (match_method field). Pass payment_token from verify_payment plus agent_wallet.

Parameters7

agent_id	string	required
agent_wallet	string	optional
limit	number	optional
payment_token	string	optional
query	string	optional
tags	string	optional	comma-separated
type	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string"
    },
    "agent_wallet": {
      "type": "string"
    },
    "limit": {
      "type": "number"
    },
    "payment_token": {
      "type": "string"
    },
    "query": {
      "type": "string"
    },
    "tags": {
      "description": "comma-separated",
      "type": "string"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "agent_id"
  ]
}

memory_stats

Free. Real count of an agent's stored memories by type, and which storage backend is active (redis or in-memory-fallback).

Parameters1

agent_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string"
    }
  },
  "required": [
    "agent_id"
  ]
}

fred_preview

Free. Latest value + date only (no metadata) for a small whitelisted set of well-known FRED series: CPIAUCSL, UNRATE, FEDFUNDS, DGS10, GDP. Use fred_series (paid) for any series_id plus full metadata.

Parameters1

series_id

string

required

One of CPIAUCSL, UNRATE, FEDFUNDS, DGS10, GDP

Raw schema

{
  "type": "object",
  "properties": {
    "series_id": {
      "description": "One of CPIAUCSL, UNRATE, FEDFUNDS, DGS10, GDP",
      "type": "string"
    }
  },
  "required": [
    "series_id"
  ]
}

fred_series

Cost: 0.01 RLUSD. Latest real observation plus full series metadata (title, units, frequency, seasonal adjustment, last updated) for any FRED (Federal Reserve Economic Data) series — CPI (CPIAUCSL), unemployment (UNRATE), Fed funds rate (FEDFUNDS), 10Y treasury yield (DGS10), GDP, etc. Returns a real error (not a placeholder) if FRED_API_KEY isn't configured or the series has no data. Pass payment_token from verify_payment plus agent_wallet.

Parameters3

agent_wallet	string	optional
payment_token	string	optional
series_id	string	required	FRED series ID, e.g. CPIAUCSL

Raw schema

{
  "type": "object",
  "properties": {
    "agent_wallet": {
      "type": "string"
    },
    "payment_token": {
      "type": "string"
    },
    "series_id": {
      "description": "FRED series ID, e.g. CPIAUCSL",
      "type": "string"
    }
  },
  "required": [
    "series_id"
  ]
}

rwa_scan

Free. Scan the ScriptMasterLabs RWA universe via live sml-rwa-api. Returns tokenized/RWA asset rows (id, ticker, class, value, risk). Lead-gen for rwa_valuation / rwa_proof_of_reserves. Upstream: GET https://sml-rwa-api.onrender.com/x402/rwa-assets

Parameters2

asset_class	string	optional	Optional class filter e.g. tokenized_treasuries, fixed_income, real_estate
limit	integer	optional	Max assets (default 10, max 100)

Raw schema

{
  "type": "object",
  "properties": {
    "asset_class": {
      "description": "Optional class filter e.g. tokenized_treasuries, fixed_income, real_estate",
      "type": "string"
    },
    "limit": {
      "description": "Max assets (default 10, max 100)",
      "type": "integer"
    }
  }
}

rwa_valuation

Premium RWA valuation/NAV composite via live sml-rwa-api x402. Cost: 0.15 USDC on Base (x402 exact scheme). Pass x_payment (base64 X-PAYMENT payload) after settling the 402 challenge. Without payment, returns the real x402 PAYMENT-REQUIRED challenge (payTo, amount, network=base). Upstream: GET /x402/rwa-valuation?asset_id=...

Parameters3

asset_id	string	required	RWA id or ticker e.g. rwa-000001, BUIDL, SHV
days	integer	optional	History window days (default 90)
x_payment	string	optional	X-PAYMENT header value (base64 x402 payload) after USDC settle on Base

Raw schema

{
  "type": "object",
  "properties": {
    "asset_id": {
      "description": "RWA id or ticker e.g. rwa-000001, BUIDL, SHV",
      "type": "string"
    },
    "days": {
      "description": "History window days (default 90)",
      "type": "integer"
    },
    "x_payment": {
      "description": "X-PAYMENT header value (base64 x402 payload) after USDC settle on Base",
      "type": "string"
    }
  },
  "required": [
    "asset_id"
  ]
}

rwa_proof_of_reserves

Premium RWA proof-of-reserves attestation view via live sml-rwa-api x402. Cost: 0.20 USDC on Base. Pass x_payment after settling 402 challenge. Without payment returns protocol-correct x402 challenge. Optional asset_id; omit for aggregate hashes. Upstream: GET /x402/proof-of-reserves

Parameters2

asset_id	string	optional	Optional asset id/ticker
x_payment	string	optional	X-PAYMENT header value after USDC settle on Base

Raw schema

{
  "type": "object",
  "properties": {
    "asset_id": {
      "description": "Optional asset id/ticker",
      "type": "string"
    },
    "x_payment": {
      "description": "X-PAYMENT header value after USDC settle on Base",
      "type": "string"
    }
  }
}

rwa_intelligence

Premium RWA intelligence bundle via live sml-rwa-api x402 (0.20 USDC Base). Optional asset_id. Without x_payment returns x402 challenge. ACP micro-wedge alternative: hire scriptmasterlabs rwa_intelligence @ $0.03.

Parameters2

asset_id	string	optional	Optional asset id/ticker
x_payment	string	optional	X-PAYMENT header value after USDC settle on Base

Raw schema

{
  "type": "object",
  "properties": {
    "asset_id": {
      "description": "Optional asset id/ticker",
      "type": "string"
    },
    "x_payment": {
      "description": "X-PAYMENT header value after USDC settle on Base",
      "type": "string"
    }
  }
}

README.md10 KBView on GitHub

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 · agent.md · 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 — 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)

code

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

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

code

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
Agent Monetization Protocol	`AGENT_MONETIZATION.md`
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

Install

Tools (62)

demo_councilcouncil_verdictmarket_scanoptions_intelligenceiwm_odtesignal_previewsignal_historyget_invoice

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://squeezeos-api.onrender.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "squeezeos": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://squeezeos-api.onrender.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

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