x402.professorsausages.com

{
  "properties": {
    "about": {
      "description": "What this response is and where its data comes from, in one sentence.",
      "type": "string"
    },
    "found": {
      "description": "false = a definitive miss — still a complete, paid answer with domain fields present-but-null and a `why` block.",
      "type": "boolean"
    },
    "freshness": {
      "description": "How fresh the data is, measured when you called. `age_seconds` is the number to act on; `max_age_seconds` is the refresh cadence (null = deterministic, cannot go stale).",
      "properties": {
        "age_seconds": {
          "minimum": 0,
          "type": "integer"
        },
        "as_of": {
          "description": "Newest datum this answer is based on (ISO 8601).",
          "type": "string"
        },
        "max_age_seconds": {
          "minimum": 0,
          "type": [
            "integer",
            "null"
          ]
        },
        "note": {
          "type": "string"
        },
        "tier": {
          "example": "nightly",
          "type": "string"
        }
      },
      "required": [
        "tier",
        "as_of",
        "age_seconds",
        "max_age_seconds"
      ],
      "type": "object"
    },
    "loadedQuarters": {
      "description": "On a QUARTER_NOT_LOADED miss: the quarters that ARE loaded.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "managers": {
      "items": {
        "type": "object"
      },
      "type": "array"
    },
    "period": {
      "type": [
        "string",
        "null"
      ]
    },
    "related": {
      "additionalProperties": {
        "type": "string"
      },
      "description": "Next steps as paths on this origin. Each is priced by its own 402 challenge; GET /.well-known/x402 prices the whole origin in one free call.",
      "type": "object"
    },
    "why": {
      "description": "Present only when found is false: the machine code and plain-English explanation of the definitive miss.",
      "properties": {
        "code": {
          "description": "Semantic miss code, e.g. NO_13F_FILINGS, QUARTER_NOT_LOADED, NOT_FILED_FOR_QUARTER, NO_DIFF_PAIR, CUSIP_NOT_REPORTED, NO_QOQ_FLOW.",
          "type": "string"
        },
        "detail": {
          "description": "Buyer-language explanation of what was checked and what the negative means.",
          "type": "string"
        }
      },
      "type": "object"
    }
  },
  "type": "object"
}