{
  "openapi": "3.0.3",
  "info": {
    "title": "Wiseek Filing Impact Open Data API",
    "version": "1.0.0",
    "description": "Free, keyless, read-only access to the Wiseek Filing Impact dataset: how SEC filings move US stocks, by importance score, sentiment, filing family and market cap. All endpoints are static, CORS-open, edge-cached files. License CC BY 4.0 with attribution to wiseek.ai. DOI (all versions): 10.5281/zenodo.22047734.",
    "license": { "name": "CC BY 4.0", "url": "https://creativecommons.org/licenses/by/4.0/" },
    "contact": { "url": "https://wiseek.ai/contact/" }
  },
  "servers": [{ "url": "https://wiseek.ai" }],
  "paths": {
    "/datasets/index.json": {
      "get": {
        "summary": "Catalog of all releases",
        "description": "Lists every published release with its period, canonical URL, files and sha256 checksums. Start here for discovery.",
        "responses": { "200": { "description": "Catalog", "content": { "application/json": {} } } }
      }
    },
    "/datasets/{release}/{table}.json": {
      "get": {
        "summary": "Aggregate table as JSON",
        "description": "Tables: impact_by_score, score_x_mcap, score_x_sentiment, form_family (and cum_t5_by_score on monthly releases). Shape: {schema_version, period, rows: [...]}. Cells with fewer than 30 measured filings carry null statistics and note='insufficient_sample'.",
        "parameters": [
          { "name": "release", "in": "path", "required": true, "schema": { "type": "string" }, "example": "launch-note" },
          { "name": "table", "in": "path", "required": true, "schema": { "type": "string" }, "example": "impact_by_score" }
        ],
        "responses": { "200": { "description": "Table rows", "content": { "application/json": {} } } }
      }
    },
    "/datasets/{release}/events_score7plus.csv": {
      "get": {
        "summary": "Per-event archive (CSV)",
        "description": "Ticker-level rows for published filings scoring 7+ (pre-exclusion, pre-dedup). The reproduction recipe in meta.json turns this file into every aggregate cell exactly.",
        "parameters": [
          { "name": "release", "in": "path", "required": true, "schema": { "type": "string" }, "example": "launch-note" }
        ],
        "responses": { "200": { "description": "CSV file", "content": { "text/csv": {} } } }
      }
    },
    "/datasets/{release}/meta.json": {
      "get": {
        "summary": "Methodology, tape series, provenance and reproduction recipe",
        "parameters": [
          { "name": "release", "in": "path", "required": true, "schema": { "type": "string" }, "example": "launch-note" }
        ],
        "responses": { "200": { "description": "Metadata", "content": { "application/json": {} } } }
      }
    }
  }
}