{
  "openapi": "3.1.0",
  "info": {
    "title": "SignalPost Machine API",
    "version": "3.0.0",
    "summary": "Read-only, evidence-grounded commercial signal intelligence API for AI agents and operators.",
    "description": "Serves strictly public C>=2 dossiers. Held regulatory dossiers and C1 traces are never exposed. All third-party source text is wrapped as untrusted_third_party data."
  },
  "servers": [
    {
      "url": "https://signalpost.pages.dev",
      "description": "Local SignalPost instance"
    }
  ],
  "paths": {
    "/llms.txt": {
      "get": {
        "summary": "LLM discovery index (llmstxt.org)",
        "responses": {
          "200": {
            "description": "Markdown/plain index"
          },
          "304": {
            "description": "Not Modified"
          }
        }
      }
    },
    "/llms-full.txt": {
      "get": {
        "summary": "Full deterministic public Markdown compendium",
        "responses": {
          "200": {
            "description": "Full compendium"
          },
          "304": {
            "description": "Not Modified"
          }
        }
      }
    },
    "/signals/{slug}.md": {
      "get": {
        "summary": "Single dossier in CommonMark with untrusted-source fences",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[a-z0-9][a-z0-9-]{0,95}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Markdown dossier"
          },
          "304": {
            "description": "Not Modified"
          },
          "404": {
            "description": "Problem+JSON Not Found"
          }
        }
      }
    },
    "/signals/{slug}.json": {
      "get": {
        "summary": "Single dossier canonical JSON (identical bytes/ETag to /api/v1/signals/{slug})",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[a-z0-9][a-z0-9-]{0,95}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "JSON dossier"
          },
          "304": {
            "description": "Not Modified"
          },
          "404": {
            "description": "Problem+JSON Not Found"
          }
        }
      }
    },
    "/api/v1/signals": {
      "get": {
        "summary": "List public C>=2 signals with optional filters",
        "parameters": [
          {
            "name": "beat",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lane",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "hotspot",
                "breakout",
                "alpha"
              ]
            }
          },
          {
            "name": "has_calculator",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "1",
                "true"
              ]
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Signals collection JSON"
          },
          "304": {
            "description": "Not Modified"
          },
          "400": {
            "description": "Invalid filter"
          }
        }
      }
    },
    "/api/v1/signals/{slug}": {
      "get": {
        "summary": "Single public signal dossier JSON",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[a-z0-9][a-z0-9-]{0,95}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "JSON dossier"
          },
          "304": {
            "description": "Not Modified"
          },
          "404": {
            "description": "Problem+JSON Not Found"
          }
        }
      }
    },
    "/api/v1/digest": {
      "get": {
        "summary": "Executive edition rollup JSON",
        "responses": {
          "200": {
            "description": "Digest JSON"
          },
          "304": {
            "description": "Not Modified"
          }
        }
      }
    },
    "/api/v1/deadlines": {
      "get": {
        "summary": "Claim-bound upcoming deadlines sorted ascending",
        "responses": {
          "200": {
            "description": "Deadlines JSON"
          },
          "304": {
            "description": "Not Modified"
          }
        }
      }
    },
    "/api/v1/tools": {
      "get": {
        "summary": "Verified Calculators (#26), Playbooks, and Matrices",
        "responses": {
          "200": {
            "description": "Tools JSON"
          },
          "304": {
            "description": "Not Modified"
          }
        }
      }
    },
    "/api/v1/sources": {
      "get": {
        "summary": "Active sources backing public dossiers",
        "responses": {
          "200": {
            "description": "Sources JSON"
          },
          "304": {
            "description": "Not Modified"
          }
        }
      }
    },
    "/api/v1/openapi.json": {
      "get": {
        "summary": "This OpenAPI 3.1 document",
        "responses": {
          "200": {
            "description": "OpenAPI 3.1 JSON"
          }
        }
      }
    }
  },
  "x-signalpost-template-version": "sp-v3.0"
}