changedInput schema / properties / as_of_date / description
Previous value: -"Point-in-time date (YYYY-MM-DD). Only returns data with accepted_at on or before this date. Eliminates look-ahead bias for backtesting."New value: +"Point-in-time cutoff, YYYY-MM-DD: only figures filed with the SEC on or before this date, e.g. 2024-06-30."
changedInput schema / properties / fiscal_year / description
Previous value: -"Fiscal year (YYYY). Omit to return most recent periods."New value: +"Fiscal year to return, four digits; omit for the most recent years, e.g. 2024."
changedInput schema / properties / limit / description
Previous value: -"Maximum number of periods to return (1–40). Defaults to 5."New value: +"Maximum number of periods, 1 to 40; defaults to 5, e.g. 8."
changedInput schema / properties / period / description
Previous value: -"Filing period granularity. Annual uses 10-K; quarterly uses 10-Q."New value: +"annual (10-K) or quarterly (10-Q); defaults to annual, e.g. quarterly."
changedInput schema / properties / ticker / description
Previous value: -"Stock ticker symbol, e.g. AAPL, MSFT — or a CIK (SEC identifier), e.g. '0000320193'."New value: +"Ticker symbol or SEC CIK of the company, e.g. AAPL."
removedOutput schema / properties / _meta / properties / cost_usd
Removed value: -{
- "additionalProperties": false,
- "description": "Per-call cost transparency. Omitted for subscription-only tools that have no PAYG-equivalent price.",
- "properties": {
- "amount_usd": {
- "minimum": 0,
- "type": "number"
- },
- "basis": {
- "description": "payg_charge = real agent-pay charge. payg_rate_card = indicative price, not billed.",
- "enum": [
- "payg_charge",
- "payg_rate_card"
- ],
- "type": "string"
- },
- "billed": {
- "description": "true = this amount was actually charged via PAYG for this call. false = indicative PAYG-equivalent value; your plan already covers this call for free.",
- "type": "boolean"
- }
- },
- "required": [
- "amount_usd",
- "billed",
- "basis"
- ],
- "type": "object"
-}
removedOutput schema / properties / _meta / properties / data_plan
Removed value: -{
- "description": "Access plan: sample | sp500 | pro | full",
- "type": "string"
-}
changedOutput schema / properties / _meta / properties / fundamentals_as_of / description
Previous value: -"ISO timestamp when the FINANCIAL STATEMENTS were last rebuilt in bulk. Use THIS — not `last_updated` — when telling a user how current the cross-sectional fundamentals are. The snapshot is republished on every weekday price refresh while the statements are carried forward unchanged, so `last_updated` can be far more recent than the numbers it sits next to. It is a floor for a single filer, not a ceiling: a filer with a live partition receives its filing, facts and ratios intraday (minutes after EDGAR dissemination), so an entity-scoped read may carry a filing newer than this; cross-sectional ranks (factor scores, earnings signals) refresh with the weekly bulk export."New value: +"Use THIS — not `last_updated` — when telling a user how current the cross-sectional fundamentals are. The snapshot is republished on every weekday price refresh while the statements are carried forward unchanged, so `last_updated` can be far more recent than the numbers it sits next to. It is a floor for a single filer, not a ceiling: a filer with a live partition receives its filing, facts and ratios intraday (minutes after EDGAR dissemination), so an entity-scoped read may carry a filing newer than this; cross-sectional ranks (factor scores, earnings signals) refresh with the weekly bulk export."
removedOutput schema / properties / _meta / properties / last_updated
Removed value: -{
- "description": "ISO timestamp when the snapshot was exported",
- "type": "string"
-}
removedOutput schema / properties / _meta / properties / latency_ms
Removed value: -{
- "description": "Wall-clock milliseconds this tool call took, measured server-side around the handler.",
- "minimum": 0,
- "type": "integer"
-}
removedOutput schema / properties / _meta / properties / limit_warnings
Removed value: -{
- "description": "Soft-warning array for partial fulfillment. Each entry carries a stable subcode + remediation.options[]. AI agents pattern-match on subcode.",
- "items": {
- "additionalProperties": true,
- "properties": {
- "code": {
- "const": "LIMIT_EXCEEDED",
- "type": "string"
- },
- "current_plan": {
- "type": "string"
- },
- "extensions": {
- "additionalProperties": {},
- "type": "object"
- },
- "limit_type": {
- "type": "string"
- },
- "limit_value": {},
- "remediation": {
- "additionalProperties": true,
- "properties": {
- "contact_sales": {
- "type": "string"
- },
- "default_action": {
- "type": "string"
- },
- "options": {
- "items": {
- "additionalProperties": {},
- "type": "object"
- },
- "type": "array"
- },
- "pricing_page": {
- "type": "string"
- }
- },
- "required": [
- "options",
- "default_action",
- "pricing_page",
- "contact_sales"
- ],
- "type": "object"
- },
- "requested_value": {},
- "returned_value": {},
- "subcode": {
- "type": "string"
- }
- },
- "required": [
- "code",
- "subcode",
- "limit_type",
- "current_plan",
- "remediation"
- ],
- "type": "object"
- },
- "type": "array"
-}
removedOutput schema / properties / _meta / properties / payg_override
Removed value: -{
- "additionalProperties": false,
- "description": "Set when this single response was paid for via the agent-pay PAYG flow — the rate-limit / depth-limit checks were bypassed for this call only.",
- "properties": {
- "amount_cents": {
- "type": "number"
- },
- "entity_scope_hash": {
- "type": "string"
- },
- "meter": {
- "type": "string"
- },
- "quote_id": {
- "type": "string"
- },
- "retry_token_hash": {
- "type": "string"
- },
- "ticker_count": {
- "type": "number"
- },
- "tool": {
- "type": "string"
- }
- },
- "required": [
- "quote_id",
- "tool",
- "meter",
- "amount_cents",
- "ticker_count",
- "entity_scope_hash",
- "retry_token_hash"
- ],
- "type": "object"
-}
removedOutput schema / properties / _meta / properties / rate_limit
Removed value: -{
- "additionalProperties": false,
- "description": "Caller's remaining budget",
- "properties": {
- "limit": {
- "type": "integer"
- },
- "remaining": {
- "type": "integer"
- },
- "reset_at": {
- "description": "ISO 8601 timestamp when the window resets",
- "type": "string"
- },
- "window": {
- "enum": [
- "minute",
- "hour"
- ],
- "type": "string"
- }
- },
- "required": [
- "limit",
- "remaining",
- "reset_at",
- "window"
- ],
- "type": "object"
-}
removedOutput schema / properties / _meta / properties / request_id
Removed value: -{
- "description": "Per-request correlation id (8-char)",
- "type": "string"
-}
removedOutput schema / properties / _meta / properties / schema_version
Removed value: -{
- "description": "Parquet schema version from manifest.json",
- "type": "string"
-}
removedOutput schema / properties / _meta / properties / snapshot
Removed value: -{
- "description": "Snapshot directory name (e.g. snapshot_20260420)",
- "type": "string"
-}
removedOutput schema / properties / _meta / properties / truncation / properties / current_plan
Removed value: -{
- "type": "string"
-}
removedOutput schema / properties / _meta / properties / truncation / properties / upgrade_required_for
Removed value: -{
- "type": "string"
-}
removedOutput schema / properties / _meta / properties / truncation / properties / upgrade_url
Removed value: -{
- "type": "string"
-}
changedOutput schema / properties / _meta / required
Previous value: -[
- "data_plan",
- "schema_version",
- "snapshot",
- "last_updated",
- "source",
- "pit_safe"
-]New value: +[
+ "source",
+ "pit_safe"
+]
removedOutput schema / properties / data / items / properties / metrics_display / description
Removed value: -"The figure rendered exactly as it should be quoted in prose ($402.83B, 59.65%, $6.11). QUOTE THESE VERBATIM. Do not re-render the raw number in `metrics` yourself: a figure you reformat no longer matches the string Valuein can bind to its filing, so it is reported to the reader as unverified even though the underlying fact was sound."