{
  "name": "seekingdata",
  "description": "Agent-native, category-agnostic market-data platform. Normalizes public venue feeds into derived values (e.g. a cross-venue reference price per symbol) wrapped in an auditable envelope (data + meta + provenance) with computed confidence, staleness, and venue-level lineage. Crypto is live today; the same catalog and envelope generalize to weather, sports, and macro.",
  "homepage": "https://seekingdata.dev",
  "version": "v1",
  "venues": ["binance", "coinbase", "deribit"],
  "symbols": ["BTC-USD", "ETH-USD", "SOL-USD"],
  "categories": [
    { "id": "crypto", "status": "live" },
    { "id": "weather", "status": "planned" },
    { "id": "sports", "status": "planned" },
    { "id": "macro", "status": "planned" }
  ],
  "api": {
    "base": "https://api.seekingdata.dev",
    "note": "No auth required in V1."
  },
  "envelope": {
    "data": "the requested payload (e.g. reference price, candle, trade, option chain)",
    "meta": "as_of, venues[], staleness_ms, confidence (0-1); optionally has_more, next_cursor, truncated, returned, hint",
    "provenance": "sources[] (venue, symbol, ts) and the derivation method"
  },
  "endpoints": [
    {
      "method": "GET",
      "path": "/v1/price/{symbol}",
      "description": "Latest cross-venue reference price for a symbol, with full envelope."
    },
    {
      "method": "GET",
      "path": "/v1/ohlcv/{symbol}",
      "description": "OHLCV candles for a symbol.",
      "query": { "interval": "1s | 1m" }
    },
    {
      "method": "GET",
      "path": "/v1/trades/{symbol}",
      "description": "Recent normalized trades for a symbol, per venue."
    },
    {
      "method": "GET",
      "path": "/v1/options/{underlying}",
      "description": "Option chain for an underlying (mark price, IV, greeks, open interest), sourced from Deribit."
    },
    {
      "method": "GET",
      "path": "/v1/categories",
      "description": "The top-level data categories seekingdata serves (live and planned)."
    },
    {
      "method": "GET",
      "path": "/v1/catalog",
      "description": "The full category -> dataset catalog: unit, cadence, sources, API path, MCP tool, and status per dataset."
    },
    {
      "method": "GET",
      "path": "/openapi.json",
      "description": "OpenAPI 3.1 machine contract for the REST API — the load-bearing discovery document."
    }
  ],
  "mcp": {
    "package": "@seekingdata/mcp",
    "install": "claude mcp add seekingdata -- npx -y @seekingdata/mcp",
    "transport": "stdio (V1)",
    "env": { "SEEKINGDATA_API": "https://api.seekingdata.dev (default; override to self-host)" },
    "tools": [
      "reference_price",
      "ohlcv",
      "recent_trades",
      "option_chain",
      "catalog",
      "provenance",
      "venues"
    ],
    "resources": ["catalog", "symbols", "venues"]
  },
  "method_note": "V1 reference price is an outlier-trimmed cross-venue median across Binance and Coinbase (USDT treated as approximately USD).",
  "contact": "matteo.assinnata@gmail.com"
}