13f holdings top derived

{
  "input": {
    "type": "http",
    "method": "GET",
    "queryParams": {
      "limit": "How many rows to return.",
      "quarter": "Reporting period. Omit for the latest on file."
    }
  },
  "output": {
    "type": "object",
    "properties": {
      "why": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "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."
          },
          "detail": {
            "type": "string",
            "description": "Buyer-language explanation of what was checked and what the negative means."
          }
        },
        "description": "Present only when found is false: the machine code and plain-English explanation of the definitive miss."
      },
      "about": {
        "type": "string",
        "description": "What this response is and where its data comes from, in one sentence."
      },
      "found": {
        "type": "boolean",
        "description": "false = a definitive miss — still a complete, paid answer with domain fields present-but-null and a `why` block."
      },
      "period": {
        "type": [
          "string",
          "null"
        ]
      },
      "related": {
        "type": "object",
        "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.",
        "additionalProperties": {
          "type": "string"
        }
      },
      "managers": {
        "type": "array",
        "items": {
          "type": "object"
        }
      },
      "freshness": {
        "type": "object",
        "required": [
          "tier",
          "as_of",
          "age_seconds",
          "max_age_seconds"
        ],
        "properties": {
          "note": {
            "type": "string"
          },
          "tier": {
            "type": "string",
            "example": "nightly"
          },
          "as_of": {
            "type": "string",
            "description": "Newest datum this answer is based on (ISO 8601)."
          },
          "age_seconds": {
            "type": "integer",
            "minimum": 0
          },
          "max_age_seconds": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0
          }
        },
        "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)."
      },
      "loadedQuarters": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "On a QUARTER_NOT_LOADED miss: the quarters that ARE loaded."
      }
    }
  }
}