changedInput schema / properties / end_date / description
Previous value: -"Inclusive end of the date range (YYYY-MM-DD). Defaults to today (the latest available close). Weekends and holidays resolve to the last trading close on or before this date."New value: +"Last date of the range, YYYY-MM-DD; omit for the latest completed month, e.g. 2024-12-31."
changedInput schema / properties / limit / description
Previous value: -"Maximum number of bars to return. Daily plans (Pro, Institutional): 1–252, default 252 ≈ 1 trading year. Free plans (sample, benchmark), which return month-end bars: 1–360, covering up to the full ~30-year monthly archive. When the range contains more bars than `limit`, the most recent `limit` bars within the range are returned."New value: +"Maximum number of month-end bars, 1 to 360; defaults to 252. The most recent bars in the range are kept, e.g. 60."
changedInput schema / properties / start_date / description
Previous value: -"Inclusive start of the date range (YYYY-MM-DD). Bars on or after this date are returned (up to `limit`). Omit to receive the `limit` most-recent bars before end_date."New value: +"First date of the range, YYYY-MM-DD; omit to take the latest limit months up to end_date, e.g. 2021-01-01."
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 / source
Removed value: -{
- "const": "SEC EDGAR",
- "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: +[
+ "pit_safe"
+]
removedOutput schema / properties / plan
Removed value: -{
- "type": "string"
-}
changedOutput schema / required
Previous value: -[
- "_meta",
- "ticker",
- "plan",
- "cik",
- "company_name",
- "start_date",
- "end_date",
- "bar_count",
- "granularity",
- "bars",
- "note"
-]New value: +[
+ "_meta",
+ "ticker",
+ "cik",
+ "company_name",
+ "start_date",
+ "end_date",
+ "bar_count",
+ "granularity",
+ "bars",
+ "note"
+]