{
  "name": "SigmaGrid Fair Value Signals",
  "version": "1.1.0",
  "description": "Fair value and execution-cost signals for crypto synthetic equity perpetuals, paid per call via x402. 14 paid routes at 0.02, 0.03 and 0.05 USDC.",
  "author": "SigmaGrid",
  "homepage": "https://sigmagrid.app",
  "base_url": "https://api.sigmagrid.app",
  "openapi_spec": "https://api.sigmagrid.app/openapi.json",
  "health": "https://api.sigmagrid.app/healthz",
  "mcp_status": "planned",
  "tools": [],
  "tools_note": "MCP tools are not available yet. Use the OpenAPI spec or plain HTTP calls.",
  "coverage": {
    "tickers": [
      "TSLA",
      "NVDA",
      "AAPL",
      "MSFT",
      "META",
      "AMZN",
      "GOOG",
      "SPY",
      "QQQ"
    ],
    "fair_value_only": [
      "SPY",
      "QQQ"
    ],
    "fair_value_only_note": "Spread, funding, premium and liquidity answer 400 for SPY and QQQ before payment.",
    "venues": {
      "hyperliquid": [
        "TSLA",
        "NVDA",
        "AAPL",
        "MSFT",
        "META",
        "AMZN"
      ],
      "veranta (formerly avantis)": [
        "TSLA",
        "NVDA",
        "AAPL",
        "MSFT",
        "META",
        "AMZN",
        "GOOG"
      ]
    }
  },
  "endpoints": {
    "free": [
      {
        "path": "/healthz",
        "method": "GET",
        "description": "200 {status: ok} or 503 {status: degraded}"
      },
      {
        "path": "/v1/validate",
        "method": "GET",
        "description": "Service validation"
      },
      {
        "path": "/openapi.json",
        "method": "GET",
        "description": "OpenAPI 3.1 spec with prices and ticker enums"
      },
      {
        "path": "/x402-discovery",
        "method": "GET",
        "description": "Service discovery manifest"
      },
      {
        "path": "/.well-known/x402",
        "method": "GET",
        "description": "x402 resource list"
      },
      {
        "path": "/v1/signals/{ticker}",
        "method": "GET",
        "description": "Free teaser: regime + event-risk labels and a gated_endpoints map"
      }
    ],
    "usdc_0_02": [
      {
        "path": "/v1/fair-value/{ticker}",
        "method": "GET",
        "description": "Fair value, confidence band, z-score vs spot"
      },
      {
        "path": "/v1/premium/{ticker}",
        "method": "GET",
        "description": "Per-venue premiums vs fair value (stocks only)"
      },
      {
        "path": "/v1/spread/{ticker}",
        "method": "GET",
        "description": "Cross-venue spread (stocks only)"
      },
      {
        "path": "/v1/funding/{ticker}",
        "method": "GET",
        "description": "Funding and carry (stocks only)"
      },
      {
        "path": "/v1/regime-basic/{ticker}",
        "method": "GET",
        "description": "Regime label + VIX context"
      },
      {
        "path": "/v1/regime/{ticker}",
        "method": "GET",
        "description": "Regime, vol forecasts, transition probability"
      },
      {
        "path": "/v1/event-risk/{ticker}",
        "method": "GET",
        "description": "Event risk score and implied move"
      },
      {
        "path": "/v1/events/{ticker}",
        "method": "GET",
        "description": "Event calendar and impact"
      }
    ],
    "usdc_0_03": [
      {
        "path": "/v1/liquidity/{ticker}",
        "method": "GET",
        "description": "Execution cost by trade size per venue and crossover size (stocks only)"
      },
      {
        "path": "/v1/drift/{ticker}",
        "method": "GET",
        "description": "Drift 1h and overnight, positioning bias"
      },
      {
        "path": "/v1/historical/{ticker}",
        "method": "GET",
        "description": "Stored history"
      },
      {
        "path": "/v1/alpha-snapshot/{ticker}",
        "method": "GET",
        "description": "Every signal column for one ticker"
      }
    ],
    "usdc_0_05": [
      {
        "path": "/v1/snapshot",
        "method": "GET",
        "description": "All covered tickers (no ticker filter)"
      },
      {
        "path": "/v1/alpha-snapshot/batch",
        "method": "GET",
        "description": "AlphaSnapshot for all covered tickers (no ticker filter)"
      }
    ]
  },
  "payment_info": {
    "protocol": "x402",
    "network": "base",
    "chain_id": 8453,
    "currency": "USDC",
    "usdc_contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "payment_flow": "HTTP 402 with payment requirements \u2192 sign USDC payment on Base \u2192 retry with payment header \u2192 data"
  },
  "track_record": "None published yet; collecting since 2026-10-04.",
  "disclaimer": "Data and model outputs for information only; not investment advice. No warranty of accuracy or uptime."
}
