# sygnldata
Machine-readable market intelligence for autonomous agents. Pay per call via x402 (USDC on base); no signup, no API key.

## What you can buy
- GET /v1/regime/current: $0.005 USDC
- GET /v1/regime/history: $0.02 USDC
- POST /v1/cost/estimate: $0.01 USDC
- POST /v1/bars/qc: $0.05 USDC
- POST /v1/audit: $5.0 USDC
- POST /v1/trade/preflight: $0.01 USDC
- GET /v1/potus/live: $2.0 USDC
- GET /v1/potus/events/1m: $0.75 USDC
- GET /v1/potus/events/15m: $0.25 USDC
- GET /v1/potus/archive: $0.1 USDC
- GET /v1/potus/event/*: $2.0 USDC
- GET /v1/potus/entities: $0.25 USDC
- GET /v1/potus/feeds: $0.25 USDC
- POST /v1/potus/subscribe/live/24h: $50.0 USDC
- POST /v1/potus/subscribe/live/30d: $750.0 USDC
- POST /v1/potus/subscribe/archive/30d: $100.0 USDC
- GET /v1/x/agent-economy-directory: $0.01 USDC
- GET /v1/x/perp-funding-rates: $0.005 USDC

## Endpoints
- GET /v1/regime/current — live market regime: STABLE or VOLATILE + confidence + position_scalar. Validated variance detector (VOLATILE ~2x forward vol, ~90% persistence). Use for position sizing, not direction.
- GET /v1/regime/history?start=&end=&limit= — 417k+ historical snapshots since 2026-02.
- POST /v1/cost/estimate {symbol, side, notional_usd, order_type} — realistic execution cost in bps, calibrated to measured fills (SPY/QQQ 1.5bps RT).
- POST /v1/bars/qc — send your OHLCV bars, get a data-quality forensic report (impossible bars, bad prints, unadjusted splits) before you backtest on garbage.
- POST /v1/audit — upload a trade ledger CSV, get a forensic backtest audit: impossible-fill detection, cost-adjusted expectancy, overfitting checks. Powered by sygnliq.com.
- POST /v1/trade/preflight {order:{symbol,side,notional_usd,order_type}, policy:{...}, state:{...}, evidence:{audit_score}} — deterministic pre-trade gate for AI trading agents: ALLOW / REDUCE / REQUIRE_CONFIRMATION / BLOCK with reason codes, order-hash-bound approval, 60s expiry, and an EIP-191-signed attestation (recover the signer with any EVM library; pin it via GET /v1/trade/preflight/signer). Composes the validated regime detector + measured cost oracle + your policy. Free demo (rate-limited): POST /v1/trade/preflight/demo.

## SYGNL/47 — verified POTUS statement events (47.sygnliq.com)
Low-latency VERIFIED OBSERVATIONS of US-presidential public statements naming publicly traded companies: what was said, whether the audio was LIVE or a REPLAY (acoustic fingerprinting), how many independent feeds corroborated it in a lag-corrected window, and the abnormal price move that followed (instrument minus benchmark). This is NOT a prediction feed and makes no edge claim — it has zero confirmed live outcomes, and its current inventory is 2 events reconstructed from archived audio and labelled source: replay.
- GET /v1/potus — FREE service manifest: method, tier ladder, prices, honest inventory. Contains no event data. Read this first.
- Price is a function of RECENCY only. Identical schema, identical fields and identical verification block at every tier; a cheaper tier simply cannot see events newer than its cutoff. The cutoff is server-side on ts_utc and bound to the priced route, never to a query parameter.
- GET /v1/potus/live — no delay, served as soon as an event is CONFIRMED. The polling call.
- GET /v1/potus/events/1m — nothing newer than 60s.
- GET /v1/potus/events/15m — nothing newer than 15 minutes.
- GET /v1/potus/archive — T+24h and older, cheapest rung, same complete payload.
- GET /v1/potus/event/{event_id} — one event in full, any age, priced at the live tier.
- GET /v1/potus/entities — tracked gazetteer with its disambiguation rules, plus which tickers are blocked today by the earnings/liquidity guards.
- GET /v1/potus/feeds — measured connect-buffer depth and source health across live news feeds. Standing latency is deliberately NOT published: it needs a simulcast we have not captured.
- Billing: a tier with no events in its window returns 404 and is NOT settled — you are never charged for an empty response. Missing publisher sync returns 503, also unsettled. Every response reports sync.feed_age_seconds.
- Verbatim broadcast quotes are hard-capped at 180 characters: we sell derived facts, not transcript text.
- SUBSCRIPTIONS (prepaid time-boxed passes on the same x402 rails): GET /v1/potus/subscribe is a free plan catalog. POST /v1/potus/subscribe/live/24h, /live/30d or /archive/30d is a priced call that returns a signed bearer token; send it as header X-SYGNL47-TOKEN and no per-call payment is charged until it expires. A pass buys unmetered access to its tier and NEVER fresher data than that tier — a slower-tier pass does not authorize a faster route, and an expired or invalid token falls back to a normal 402, never to a free serve.
- Traffic is published on the free manifest: 402 challenges served vs payments settled, per route. We would rather show a zero than hide one.

## Dynamic product catalog
- GET /v1/x — free machine-readable catalog of additional pay-per-call datasets (agent-economy directory, funding rates, more added continuously)
- GET /v1/x/<slug> — the products themselves (x402 paid)

## MCP
Native MCP server (streamable HTTP) at https://api.sygnliq.com/mcp — tools: get_regime_sample (free), get_pricing (free), get_regime_current, get_regime_history, estimate_execution_cost, check_bar_quality, audit_backtest. Paid tools accept a payment_signature argument (base64 x402 PaymentPayload).

## Free
- GET /v1/regime/sample — 24h-delayed regime snapshot (taste before buying)
- GET /health, /pricing.json, /openapi.json

## Why trust this
Built from a live trading stack whose forensics caught 72% impossible fills in marketed strategies. We sell measurements and diagnostics, not alpha promises.