Envelope

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/loopholetape-com/json-schema/loopholetape-com-envelope-schema.json",
  "title": "Envelope",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/loopholetape-com-openapi.json#/components/schemas/Envelope",
  "type": "object",
  "required": [
    "ok",
    "schema_version",
    "generated_at",
    "t",
    "coverage",
    "data",
    "meta"
  ],
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "schema_version": {
      "type": "string",
      "const": "2.0"
    },
    "generated_at": {
      "type": "string",
      "format": "date-time"
    },
    "t": {
      "type": "number",
      "description": "unix seconds at generation"
    },
    "coverage": {
      "type": "string",
      "enum": [
        "full",
        "thin"
      ],
      "description": "the mint is inside our live window (created while our captur / thin = the mint is not in the live window (older than ~2 h of silen"
    },
    "data": {
      "type": "object"
    },
    "meta": {
      "type": "object",
      "properties": {
        "source": {
          "type": "string"
        },
        "version": {
          "type": "string"
        },
        "feed_lag_s": {
          "type": [
            "number",
            "null"
          ],
          "description": "seconds between the newest event in our tape and now (the age of the newest event we ingested; it does not say whether the capture runs behind the chain, see chain_lag_s)"
        },
        "is_stale": {
          "type": "boolean",
          "description": "the ingest age (feed_lag_s) exceeds the route's freshness limit (5 s for compact risk checks, 30 s otherwise); a paid or keyed pump.fun request is also refused above 5 s of estimated chain lag when the gate enforces (see chain_lag_s, tape_behind), which this flag does not show"
        },
        "chain_lag_s": {
          "type": [
            "number",
            "null"
          ],
          "description": "estimated seconds the newest slot in our pump.fun tape is behind the Solana RPC's processed tip (slots_behind x the measured slot time, to 0.1 s); null when the tip is unknown; absent on Robinhood Chain answers"
        },
        "slots_behind": {
          "type": [
            "integer",
            "null"
          ],
          "description": "estimated slots between the newest slot in our pump.fun tape and the Solana RPC's processed tip (a tip read every 30 s, carried forward by the wall time since at the slot rate our own reads measure); 0 when the tape is at or ahead of the estimate; null when the tip is unknown"
        },
        "tape_behind": {
          "type": [
            "boolean",
            "null"
          ],
          "description": "true when the estimated chain_lag_s is above 5 s, false within 5 s, null when there is no tip to compare; on pump.fun answers only"
        },
        "last_slot": {
          "type": [
            "integer",
            "null"
          ]
        },
        "price_usd": {
          "type": [
            "number",
            "null"
          ]
        },
        "next": {
          "type": "object",
          "description": "related resources worth calling next (paths relative to base_url)"
        },
        "disclaimer": {
          "type": "string"
        }
      }
    }
  }
}