Previous value: -"Period end dates of this fund's reports, newest first — the horizon report_date can address, not the fund's full history. It reaches back roughly a decade of quarterly reports, and a period older than that is refused rather than served. A period inside the horizon can still be missing from the list: the dates come from the registrant's recent submissions window, which a trust filing thousands of reports a year outruns in months, and a report the window no longer reaches is dated by reading it only when report_date asks for it."New value: +"Period end dates of this fund's reports, newest first: what report_date can address, about a decade back. A trust filing thousands of reports a year can miss periods here that report_date still reaches."

Previous value: -"SEC class IDs of the share classes covered. One report covers every class of the series, so a fund with both an ETF and an admiral-share class reports them together."New value: +"SEC class IDs covered; one report covers every class of the series."

Previous value: -"Canvas dataframe holding every position in the report (the inline holdings[] is a preview capped at limit). Each row carries the fund keys — series_id, registrant_cik, report_period_date, accession_number — alongside the position fields, so it joins against the 13F and insider dataframes on cusip. Absent when canvas is unavailable or the report had no positions."New value: +"Dataframe of every position, each row carrying the fund keys; joins 13F and insider dataframes on cusip. Absent when canvas is unavailable or the report had no positions."

Previous value: -"Dataframe handle (df_XXXXX_XXXXX) — inspect its columns with secedgar_dataframe_describe, then query it with secedgar_dataframe_query."New value: +"Dataframe handle (df_XXXXX_XXXXX) for secedgar_dataframe_describe, then secedgar_dataframe_query."

Previous value: -"SEC asset-type code — EC equity-common, EP equity-preferred, DBT debt, RA repurchase agreement, STIV short-term investment vehicle, DE derivative. A filer that classifies a position as Other reports its own label here instead of a code (\"Right\"), because the code in that case is just \"OTHER\"."New value: +"SEC asset-type code (EC equity-common, EP equity-preferred, DBT debt, RA repurchase agreement, STIV short-term investment vehicle, DE derivative), or the filer's own label for Other (\"Right\")."

Previous value: -"Units held, counted in whatever `units` names — shares, principal, or contracts."New value: +"Units held, in whatever `units` names (shares, principal, or contracts)."

Previous value: -"SEC issuer-type code — CORP corporate, MUN municipal, USGSE US government-sponsored, RF registered fund. A filer that classifies an issuer as Other reports its own label here instead of a code (\"Future\", \"Warrant\")."New value: +"SEC issuer-type code (CORP corporate, MUN municipal, USGSE US government-sponsored, RF registered fund), or the filer's own label for Other (\"Future\")."

Previous value: -"Issuer name as the fund reports it. A derivative position routinely reports the literal \"N/A\" here and names the instrument in title instead, so group and label positions by title when asset_category marks a derivative."New value: +"Issuer name as reported. Derivatives often report \"N/A\" and name the instrument in title."

Previous value: -"Percent of the fund's net assets, as the filer computes it. Negative on a short position — a leveraged fund's swap or futures leg regularly reports several percent below zero — so this is not bounded at 0."New value: +"Percent of the fund's net assets as the filer computes it; negative on short positions, so not bounded at 0."

Previous value: -"True when the fund reports this as its last filing on the series, which marks a liquidation or merger. Absent when the filing does not answer."New value: +"True when the fund marks this its last filing for the series (liquidation or merger). Absent when unstated."

Previous value: -"Offset to pass on the next call to continue through the portfolio. Absent on the last page."New value: +"Offset for the next page. Absent on the last page."

Previous value: -"Days between the portfolio date and the filing date. Absent when the report omits its period date."New value: +"Days from the portfolio date to the filing date. Absent when the report omits its period date."

Previous value: -"Last day of the period this portfolio is reported as of (YYYY-MM-DD). Holdings are the fund's positions on this date, not today's. Absent only when the filer omits it."New value: +"Portfolio date (YYYY-MM-DD): positions as of this date, not today. Absent only when the filer omits it."

Previous value: -"Last day of the fiscal year the reporting period falls in (YYYY-MM-DD) — the fund's fiscal year end, not the portfolio date."New value: +"Fiscal year end the reporting period falls in (YYYY-MM-DD), not the portfolio date."

Previous value: -"SEC series ID of the fund this report covers. Absent when the registrant files as a single fund with no series structure, which is how some older exchange-traded trusts are organized."New value: +"SEC series ID of the fund. Absent when the registrant files as a single fund with no series."

Previous value: -"Fund name as the filer states it on the report. A closed-end fund organized as a single registrant names itself here with no series_id alongside; absent only when the filer leaves the field blank or writes \"N/A\"."New value: +"Fund name on the report; a single-registrant closed-end fund names itself here, with no series_id. Absent when blank or \"N/A\"."

Previous value: -"Positions in the report, before offset and limit — the size of the full portfolio."New value: +"Positions in the full report, before offset and limit."

Previous value: -"Machine-readable failure mode. Declared by this tool: `fund_not_found`: The fund input resolves to neither an EDGAR company nor a known fund series `ambiguous_fund`: The fund name matches several EDGAR companies `series_required`: The input resolves to a registrant trust that files reports for more than one fund series `no_filings_found`: No NPORT-P report exists for this fund, or none for the requested report_date Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `fund_not_found`: The fund input resolves to neither an EDGAR company nor a known fund series. `ambiguous_fund`: The fund name matches several EDGAR companies. `series_required`: The input resolves to a registrant trust that files reports for more than one fund series. `no_filings_found`: No NPORT-P report exists for this fund, or none covers the report_date requested. `rate_limited`: SEC is rate-limiting this server's IP — SEC answered 429, or the call was refused without being sent while the cool-down after one runs. Other values are possible when a failure originates below the handler."

Previous value: -[
-  "fund_not_found",
-  "ambiguous_fund",
-  "series_required",
-  "no_filings_found"
-]New value: +[
+  "fund_not_found",
+  "ambiguous_fund",
+  "series_required",
+  "no_filings_found",
+  "rate_limited"
+]

Previous value: -"Dataframe handle (df_XXXXX_XXXXX) — pass to secedgar_dataframe_query."New value: +"Dataframe handle (df_XXXXX_XXXXX) — inspect its columns with secedgar_dataframe_describe, then query it with secedgar_dataframe_query."

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +false

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "fund",
+      "class_ids",
+      "registrant_cik",
+      "registrant_name",
+      "filing_date",
+      "form",
+      "accession_number",
+      "total_holdings",
+      "offset",
+      "available_report_periods",
+      "holdings",
+      "as_of"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]

Added value: +{
+  "additionalProperties": {},
+  "description": "Present when the call failed. Absent on success.",
+  "properties": {
+    "code": {
+      "description": "JSON-RPC error code for this failure.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "data": {
+      "additionalProperties": {},
+      "properties": {
+        "reason": {
+          "description": "Machine-readable failure mode. Declared by this tool: `fund_not_found`: The fund input resolves to neither an EDGAR company nor a known fund series `ambiguous_fund`: The fund name matches several EDGAR companies `series_required`: The input resolves to a registrant trust that files reports for more than one fund series `no_filings_found`: No NPORT-P report exists for this fund, or none for the requested report_date Other values are possible when a failure originates below the handler.",
+          "examples": [
+            "fund_not_found",
+            "ambiguous_fund",
+            "series_required",
+            "no_filings_found"
+          ],
+          "type": "string"
+        },
+        "recovery": {
+          "additionalProperties": {},
+          "description": "Actionable next step for the caller.",
+          "properties": {
+            "hint": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "hint"
+          ],
+          "type": "object"
+        },
+        "retryable": {
+          "description": "Whether retrying may succeed.",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "message": {
+      "description": "Human-readable description of what went wrong.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "code",
+    "message"
+  ],
+  "type": "object"
+}

Removed value: -[
-  "fund",
-  "class_ids",
-  "registrant_cik",
-  "registrant_name",
-  "filing_date",
-  "form",
-  "accession_number",
-  "total_holdings",
-  "offset",
-  "available_report_periods",
-  "holdings",
-  "as_of"
-]