API Reference
Base URL:
https://api.sigmagrid.appSpec:https://api.sigmagrid.app/openapi.json
SigmaGrid serves 14 paid routes at three price points, plus free discovery and a free teaser. The OpenAPI spec is generated by the server itself, so it always matches what is served: prices, routes and accepted tickers.
Base URL
https://api.sigmagrid.app
All endpoints below are relative to this base URL.
Payments
- Paid endpoints answer HTTP 402 (Payment Required) with x402 payment details.
- Your agent signs a USDC payment on Base (chain ID 8453) and retries with the payment header.
- No API keys, subscriptions or minimums.
- Each paid call is charged when it is served.
Tickers
| Group | Tickers | Routes |
|---|---|---|
| Stocks | TSLA, NVDA, AAPL, MSFT, META, AMZN, GOOG | All per-ticker routes |
| Index ETFs | SPY, QQQ | Fair value only: every per-ticker route except spread, funding, premium and liquidity |
GOOG is Alphabet Class C. SPY and QQQ have no tradeable perp on the venues we cover, so the four venue-data routes answer 400 before any payment with a message pointing to /v1/fair-value. Any ticker not listed above also gets a 400 before payment.
Venues
| Venue | Tickers |
|---|---|
| Hyperliquid | TSLA, NVDA, AAPL, MSFT, META, AMZN |
| Veranta (formerly Avantis) | TSLA, NVDA, AAPL, MSFT, META, AMZN, GOOG |
Free endpoints
GET /healthz — Health check
200 {"status":"ok"} when the signal backend is healthy, 503 {"status":"degraded"} otherwise. Nothing else is exposed.
GET /v1/validate — Service validation
Confirms the API is reachable before you make paid requests.
GET /openapi.json — OpenAPI 3.1 specification
Machine-readable spec for every route, with x-payment-info prices and the accepted ticker list per route.
GET /x402-discovery — Service discovery manifest
Every service with its price, pay-to address and supported tickers.
GET /.well-known/x402 — x402 resource list
The list of paid routes, for x402 crawlers.
Free teaser
GET /v1/signals/{ticker} — Regime and event-risk labels
Returns regime and event-risk as text labels only, plus a gated_endpoints map of where to get numeric data. No payment.
0.02 USDC per request
GET /v1/fair-value/{ticker} — Fair value estimate
Fair value with confidence band and z-score against spot. All nine tickers.
GET /v1/premium/{ticker} — Cross-venue mispricing
Per-venue premiums against fair value, divergence z-score and mean-reversion probability. Stocks only.
GET /v1/spread/{ticker} — Cross-venue spread
Bid/ask spread, effective spread and venue-level spread dispersion. Stocks only.
GET /v1/funding/{ticker} — Funding
Funding rate, predicted next funding and carry-adjusted basis across venues. Stocks only.
GET /v1/regime-basic/{ticker} — Risk regime (basic)
Regime label with confidence, VIX level and 24h change, and funding direction.
GET /v1/regime/{ticker} — Regime classification
Regime, volatility forecasts, transition probability and structural stress.
GET /v1/event-risk/{ticker} — Event risk
Event risk score, implied move and suppression triggers for upcoming events.
GET /v1/events/{ticker} — Event calendar
Next event, historical impact, directional bias and risk window timing.
0.03 USDC per request
GET /v1/liquidity/{ticker} — Execution cost by size and venue
What a trade of a given size costs on each venue, and where the cheapest venue changes. Stocks only.
- Cost in basis points per venue at $10k, $100k and $1m (order-book walk or published spread; fees excluded)
- Cheapest venue at each size
- Crossover: the trade size at which the cheapest venue changes, found on a 13-step grid from $10k to $2.5m, on trading cost alone and with the one-way opening fee added. Marked approximate when it relies on an aggregated book.
- Each venue's fee, size cap and 24h volume, and why any venue was excluded (not listed, no live price, market closed)
- TradFi positioning context alongside the DEX figures
GET /v1/drift/{ticker} — Drift
Drift over 1h and overnight with confidence, regime and positioning bias.
GET /v1/historical/{ticker} — Historical time series
Stored history of fair value, regime, drift and premiums for one ticker.
GET /v1/alpha-snapshot/{ticker} — Full AlphaSnapshot
Every signal column for one ticker in one call: fair value, regime, drift, volatility, event context, funding and macro betas.
0.05 USDC per request
GET /v1/snapshot — Market snapshot
Snapshot across all covered tickers in one call.
GET /v1/alpha-snapshot/batch — Batch AlphaSnapshot
Full AlphaSnapshot for every covered ticker in one call.
Both batch routes always return every covered ticker; there is no ticker filter.
Endpoint summary
| Endpoint | Price | Tickers | Description |
|---|---|---|---|
/healthz | Free | — | Health check |
/v1/validate | Free | — | Service validation |
/openapi.json | Free | — | OpenAPI 3.1 spec |
/x402-discovery | Free | — | Service discovery manifest |
/.well-known/x402 | Free | — | x402 resource list |
/v1/signals/{ticker} | Free | All 9 | Regime + event-risk labels (teaser) |
/v1/fair-value/{ticker} | 0.02 USDC | All 9 | Fair value |
/v1/premium/{ticker} | 0.02 USDC | Stocks | Cross-venue mispricing |
/v1/spread/{ticker} | 0.02 USDC | Stocks | Cross-venue spread |
/v1/funding/{ticker} | 0.02 USDC | Stocks | Funding and carry |
/v1/regime-basic/{ticker} | 0.02 USDC | All 9 | Risk regime + VIX context |
/v1/regime/{ticker} | 0.02 USDC | All 9 | Regime classification |
/v1/event-risk/{ticker} | 0.02 USDC | All 9 | Event risk |
/v1/events/{ticker} | 0.02 USDC | All 9 | Event calendar |
/v1/liquidity/{ticker} | 0.03 USDC | Stocks | Execution cost by size and venue |
/v1/drift/{ticker} | 0.03 USDC | All 9 | Drift |
/v1/historical/{ticker} | 0.03 USDC | All 9 | Historical time series |
/v1/alpha-snapshot/{ticker} | 0.03 USDC | All 9 | Full AlphaSnapshot |
/v1/snapshot | 0.05 USDC | All | Market snapshot |
/v1/alpha-snapshot/batch | 0.05 USDC | All | Batch AlphaSnapshot |
"Stocks" means TSLA, NVDA, AAPL, MSFT, META, AMZN and GOOG.