{
 "openapi": "3.1.0",
 "info": {
  "title": "FirmTape dataset files",
  "version": "1.0.0",
  "description": "Every finished SPX session as a file, for your own research, on the DATASET licence."
 },
 "servers": [
  {
   "url": "https://firmtape.com"
  }
 ],
 "security": [
  {
   "bearer": []
  }
 ],
 "x-product": "dataset",
 "x-features": [
  "archive-files",
  "dataset-licence",
  "evening-delivery",
  "three-books"
 ],
 "components": {
  "securitySchemes": {
   "bearer": {
    "type": "http",
    "scheme": "bearer",
    "description": "The account's `lab` key (`labk_...`) while the DATASET licence is active."
   }
  },
  "schemas": {}
 },
 "paths": {
  "/snapshots/{file}": {
   "get": {
    "operationId": "datasetFile",
    "x-slug": "files",
    "summary": "A day file",
    "x-plan": "dataset",
    "x-key": "dataset",
    "x-limit": "No breadth limit for a licence holder",
    "description": "One finished session: `<day>.json.gz`, the full payload, or `<day>.lite.json.gz`, the smaller summary twin.",
    "x-features": [
     "archive-files",
     "evening-delivery"
    ],
    "parameters": [
     {
      "name": "file",
      "in": "path",
      "required": true,
      "description": "`YYYY-MM-DD.json.gz` or `YYYY-MM-DD.lite.json.gz`.",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Gzipped JSON.",
      "content": {
       "application/gzip": {
        "schema": {
         "type": "string",
         "format": "binary"
        }
       }
      }
     },
     "404": {
      "description": "No such session."
     }
    }
   }
  }
 }
}