# PRO-LO (Proprietary Liquidity Optimizer) — Script Master Labs

Real-time, real-data-only market intelligence for AI agents: a multi-path Coherence Gate (|Σ w·d| / Σ w across independent signal paths) with optional Jev (TypeSafe AI) review, plus live Squeeze, Options, Pre-Ignition and Momentum radars. Unconfigured data sources are reported as unavailable, never simulated.

## Discovery
- llms.txt: https://pro-lo.onrender.com/llms.txt
- OpenAPI 3: https://pro-lo.onrender.com/openapi.json
- MCP manifest: https://pro-lo.onrender.com/.well-known/mcp.json
- MCP JSON-RPC endpoint: https://pro-lo.onrender.com/api/mcp/rpc
- x402 manifest: https://pro-lo.onrender.com/.well-known/x402.json (also https://pro-lo.onrender.com/.well-known/x402)
- agents.json: https://pro-lo.onrender.com/agents.json
- A2A agent card: https://pro-lo.onrender.com/.well-known/agent-card.json (also https://pro-lo.onrender.com/agent.json)

## Data policy
Real data only. When a data source is not configured, endpoints return an explicit unavailable/503 error instead of simulated values. Live configuration status: https://pro-lo.onrender.com/api/setup-status

## Coherence Gate
- GET https://pro-lo.onrender.com/api/market/signal-paths/{symbol} — independent directional signal paths + coherence.
- POST https://pro-lo.onrender.com/api/market/coherence {"ticker":"AMC","jev":false} — verdict ACT_LONG | ACT_SHORT | HOLD | NO_DATA.
- Formula: coherence = |Σ wᵢ·dᵢ| / Σ wᵢ, d ∈ {+1 long, −1 short, 0 flat}, w = confidence ∈ [0,1]. Gate passes when consensus ≠ flat and coherence ≥ threshold. ACT also needs at least two agreeing independent paths; if Jev (TypeSafe AI) is requested and available it must agree.

## Radars (free, from the live background scan; 503 while warming up)
- GET https://pro-lo.onrender.com/api/market/squeeze-radar
- GET https://pro-lo.onrender.com/api/market/options-radar
- GET https://pro-lo.onrender.com/api/market/pre-ignition-radar
- GET https://pro-lo.onrender.com/api/market/momentum
- GET https://pro-lo.onrender.com/api/market/activity-log

## Other free endpoints
- GET https://pro-lo.onrender.com/api/market/tickers
- GET https://pro-lo.onrender.com/api/market/quote/{symbol}
- GET https://pro-lo.onrender.com/api/health
- GET https://pro-lo.onrender.com/api/setup-status
- GET https://pro-lo.onrender.com/api/mcp/manifest

## MCP tools
- analyze_narrative_divergence: Compares real fundamental signals (P/E, real reference data) against a disclosed, real-price-derived momentum/volatility proxy for narrative intensity. Real fundamental/social sentiment data is not currently wired — narrative-side scoring is disclosed as a proxy, not literal sentiment measurement.
- simulate_counterfactual_stress_test: Runs a disclosed hypothetical shock scenario (from a static, pre-defined scenario catalog) against a real live quote. The projected impact is an explicit heuristic model applied to a real spot price, not a claimed prediction.
- classify_microstructure_regime: Real dealer gamma exposure (GEX) computed from a real fetched options chain (Tradier/Polygon), real short-sale volume from FINRA, and real Reg SHO threshold-list status.
- execute_gemini_frontier_reasoning: Invokes Google Gemini with real, live-fetched market data as grounding context — no invented inputs are passed to the model.
- generate_trade_execution_signals: Generates a disclosed-heuristic BUY/SELL/HOLD verdict and selects real, currently-listed option contracts (real strike, real expiration, real bid/ask/greeks) nearest a target delta band from a real fetched chain — never an invented contract.
- mandelbrot_fractal_analysis: Real Rescaled-Range Hurst exponent computed from real historical bars at each real timeframe (15M/1H/4H/1D/1W). Reports real excess kurtosis of the real return series. Does not compute a true Hölder singularity spectrum (requires tick-level history this build does not ingest) — abstains rather than fabricating one.
- track_volatility_surface: Real implied-volatility surface grid built directly from a real fetched options chain across several real expirations — every grid point is a real listed contract, not an interpolated/fabricated one.
- track_gamma_squeeze_mechanics: Real squeeze-pressure score from real chain-derived GEX and real FINRA short-sale volume — a disclosed proxy for short-selling pressure, not true short interest.
- live_universe_scanner_scan: Real wide-market scan (Polygon grouped-daily aggregates across the real US equity universe, not a fixed short symbol list, no pinned symbols) fused with the real per-symbol GEX/Hurst/IV-surface engines above.
- coherence_gate_review: PRO-LO Coherence Gate: multi-path consensus for one ticker across PRO-LO's independent real directional signals (trade-engine composite, daily SMA20/50 trend, SqueezeOS graded picks, SML Triple-Trigger). Returns each path with direction (long/short/flat) and confidence, the coherence score, and pass/block gate. Same formula as the SML mcp-x402 Coherent Gate. Jev (TypeSafe) review is not run over MCP.

## Paid endpoints (x402 via 402proof, RLUSD on XRPL)
Payment authority: https://four02proof.onrender.com
Payment verification configured on this server right now: yes
Flow: request an invoice from the payment authority for the endpoint UUID, pay the quoted RLUSD on XRPL, then call the route with the signed token in the X-Payment-Token header (or payment_token in the JSON body). Without a valid token the route answers HTTP 402 with a payment_required block.
- POST https://pro-lo.onrender.com/api/x402/trade-signals — 0.08 RLUSD — uuid a7d09142-826d-4610-ace2-1008ddabfc91 — MCP tool generate_trade_execution_signals — Real BUY/SELL/HOLD signal plus real recommended option contracts (real strike/expiration/bid-ask/greeks) selected from a real fetched Tradier/Polygon chain.
- POST https://pro-lo.onrender.com/api/x402/mm-obligations — 0.06 RLUSD — uuid eaa09b2c-567a-4dec-aecf-1361508cfe63 — MCP tool classify_microstructure_regime — Real dealer GEX regime, real max-pain/call-wall/put-wall strikes, real FINRA short-volume and Reg SHO threshold status.
- POST https://pro-lo.onrender.com/api/x402/gamma-squeeze — 0.05 RLUSD — uuid c30415cd-ac70-470d-916c-05384e2ade87 — MCP tool track_gamma_squeeze_mechanics — Real squeeze-pressure score from real chain-derived GEX and real FINRA short-sale volume.
- POST https://pro-lo.onrender.com/api/x402/surface-report — 0.05 RLUSD — uuid 318162d9-ba8b-4d03-8abc-7dd78ba858da — MCP tool track_volatility_surface — Real implied-volatility surface grid built from a real fetched options chain across multiple real expirations.
- POST https://pro-lo.onrender.com/api/x402/mandelbrot-fractal — 0.04 RLUSD — uuid 9814b1fc-efb9-4e8b-966c-4979cd49e576 — MCP tool mandelbrot_fractal_analysis — Real Rescaled-Range Hurst exponent per real timeframe (15M/1H/4H/1D/1W) from real historical bars.
- GET https://pro-lo.onrender.com/api/x402/universe-scan — 0.1 RLUSD — uuid 33bcbe49-9a7b-43a6-a3bb-b439f62f6a5e — MCP tool live_universe_scanner_scan — Real wide-market scan (Polygon grouped-daily across the real US equity universe, no pinned symbols) fused with real per-symbol GEX/squeeze scoring.
- POST https://pro-lo.onrender.com/api/x402/gemini-reasoning — 0.07 RLUSD — uuid 798ad1c4-09d9-4eab-a520-61c63484b107 — MCP tool execute_gemini_frontier_reasoning — Google Gemini reasoning grounded only in real, live-fetched market data for the requested ticker.

## Operator
Script Master Labs LLC — https://scriptmasterlabs.com