Every change Wellknown observed on this MCP server, newest first, with what it was before and what it became. Tool-surface changes carry the definition diff. Nothing here is edited after the fact.
Changed the definition of "get_congress_member"
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"coverage":{"anyOf":[{"additionalProperties":false,"properties":{"note":{"type":["string","null"]},"paper_filings":{"type":["number","null"]}},"required":["paper_filings","note"],"type":"object"},{"type":"null"}]},"member":{"type":"string"},"paging" ⟨252 unchanged words⟩ type":"array"}},"required":["member","coverage","rows","paging","plan_limit"],"type":"object"}
Changed the definition of "get_stock_activity" and "get_stock_holders"
⟨55 unchanged words⟩ plan allows. structuredContent carries the exact net shares/values. Each quarter carries ko.io's comparability state (comparable / split_adjusted with its split factor / not_comparable / first_reported): a null share or value flow means UNKNOWN (withheld), never zero.
⟨8 unchanged words⟩ additionalProperties":false,"properties":{"changes":{"additionalPropertiesanyOf":false,"description[{":additionalProperties"equity_filer_baseline:common stock only (option legs excluded); one holder per filer CIK; only filers with a usable prior-quarter baseline are classified. Same names/values as ko.io REST `changes`. Absent when ko.io did not send it."
Changed the definition of "get_stock_activity"
⟨8 unchanged words⟩ ":[{"additionalProperties":false,"properties":{"changes":{"additionalProperties":false,"description":"equity_filer_baseline: common stock only (option legs excluded); one holder per filer CIK; only filers with a usable prior-quarter baseline are classified. Same names/values as ko.io REST `changes`. Absent when ko.io did not send it.","properties":{"added":{"$ref":"#/properties/latest/anyOf/0/properties/institutions_increased"},"basis":{"description":"\"equity_filer_baseline\"","type":["string","null"]},"exited":{"$ref":"#/properties/latest/anyOf/0/properties/institutions_increased"},"holders":{"$ref":"#/properties/latest/anyOf/0/properties/institutions_increased"},"net_shares":{"$ref":"#/properties/latest/anyOf/0/properties/changes/properties/shares_added"},"net_value":{"$ref":"#/properties/latest/anyOf/0/properties/changes/properties/shares_added"},"new":{"$ref":"#/properties/latest/anyOf/0/properties/institutions_increased"},"no_baseline":{"anyOf":[{"$ref":"#/properties/quarters_requested/anyOf/0"},{"type":"null"}],"description":"Filers with no usable prior-quarter baseline: not classified as new/added/..."},"shares_added":{"type":["number","null"]},"shares_removed":{"$ref":"#/properties/latest/anyOf/0/properties/changes/properties/shares_added"},"trimmed":{"$ref":"#/properties/latest/anyOf/0/properties/institutions_increased"},"unchanged":{"$ref":"#/properties/latest/anyOf/0/properties/institutions_increased"},"value_added":{"$ref":"#/properties/latest/anyOf/0/properties/changes/properties/shares_added"},"value_removed":{"$ref":"#/properties/latest/anyOf/0/properties/changes/properties/shares_added"}},"required":["basis","new","added","trimmed","exited","unchanged","no_baseline","holders","shares_added","shares_removed","net_shares","value_added","value_removed","net_value"],"type":"object"},"
Changed the definition of "get_congress_member", "get_congress_trades", "get_crypto_exposure" and 21 more
before
—after
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"member":{"type":"string"},"paging":{"additionalProperties":false,"description":"Paging state reconciled from ko.io meta.total_count and meta.softwall","properties":{"continuation":{"description":"SIGNIN_REQUIRED = page>1 needs a (free) ko.io API key","type":["string","null"]},"has_more":{"description":"null = a full page came back and more MAY exist","type":["boolean","null"]},"next_page":{"anyOf":[{"$ref":"#/properties/paging/properties/total_count/anyOf/0"},{"type":"null"}],"description":"Next page THIS caller can open; null when there is none (or sign-in is required)"},"page":{"type":"integer"},"per_page":{"type":"integer"},"plan_row_cap":{"anyOf":[{"$ref":"#/properties/paging/properties/total_count/anyOf/0"},{"type":"null"}],"description":"Row cap the caller's plan applied to this page, if any"},"returned":{"type":"integer"},"total_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Total rows matching the request, when ko.io reported it"},"truncated_by_plan":{"description":"True when the plan's row cap withheld rows from this page","type":"boolean"}},"required":["page","per_page","returned","total_count","has_more","next_page","continuation","plan_row_cap","truncated_by_plan"],"type":"object"},"plan_limit":{"anyOf":[{"additionalProperties":false,"properties":{"continuation":{"$ref":"#/properties/rows/items/properties/member_name"},"date_basis":{"$ref":"#/properties/rows/items/properties/member_name"},"effective_period":{"$ref":"#/properties/rows/items/properties/member_name"},"policy_version":{"$ref":"#/properties/rows/items/properties/member_name"},"row_cap":{"anyOf":[{"$ref":"#/properties/paging/properties/total_count/anyOf/0"},{"type":"null"}]},"truncated":{"type":["boolean","null"]},"window_end":{"$ref":"#/properties/rows/items/properties/member_name"},"window_start":{"$ref":"#/properties/rows/items/properties/member_name"}},"required":["policy_version","window_start","window_end","effective_period","date_basis","row_cap","truncated","continuation"],"type":"object"},{"type":"null"}],"description":"The Free/keyless plan limits ko.io applied to this answer (null for paid callers)"},"rows":{"items":{"additionalProperties":false,"properties":{"amount_range":{"description":"The disclosed dollar RANGE (STOCK Act bands), not an exact amount","type":["string","null"]},"asset_description":{"$ref":"#/properties/rows/items/properties/member_name"},"chamber":{"$ref":"#/properties/rows/items/properties/member_name"},"disclosure_date":{"$ref":"#/properties/rows/items/properties/member_name"},"member_name":{"type":["string","null"]},"owner":{"$ref":"#/properties/rows/items/properties/member_name"},"ticker":{"$ref":"#/properties/rows/items/properties/member_name"},"transaction_date":{"$ref":"#/properties/rows/items/properties/member_name"},"transaction_type":{"$ref":"#/properties/rows/items/properties/member_name"}},"required":["member_name","chamber","ticker","asset_description","transaction_type","transaction_date","disclosure_date","amount_range","owner"],"type":"object"},"type":"array"}},"required":["member","rows","paging","plan_limit"],"type":"object"}Changed the definition of "get_congress_trades", "get_economic_indicators", "get_financial_stress" and 2 more
⟨65 unchanged words⟩ Senate trades this quarter'. Filter by chamber,party, state,ticker, or member name; sort by traded value ⟨15 unchanged words⟩
⟨50 unchanged words⟩ "minimum":1,"type":"integer"},"party":{"default":"all","description":"Filter by party — D=Democrat, R=Republican, I=Independent","enum":["D","R","I","all"],"type":"string"},"search":{"description":"Full or partial member ⟨27 unchanged words⟩ enum":["volume","trades","recent"],"type":"string"},"state":{"description":"Member 2-letter U.S. state code, e.g. CA or TX","maxLength":200,"type":"string"},"ticker":{" ⟨17 unchanged words⟩
Certificate recorded, valid to 2026-12-11
Authorization not required
First tool surface recorded: 24 tools (server version 1.1.0)
Showing the latest 8 events. The API returns up to 500 and filters by kind: ?kind=tool_surface_changed
⟨276 unchanged words⟩ ,"cik":{"$ref":"#/properties/quarter_date"},"equity_action":{"$ref":"#/properties/quarter_date","description":"NEW | ADDED | TRIMMED | EXITED | UNCHANGED on the equity_filer_baseline basis; null = not classified"},"equity_share_change":{"$ref":"#/properties/rows/items/properties/shares_held","description":"Common-share change on the equity_filer_baseline basis (split-restated); null = no usable prior-quarter baseline (unknown, never zero). Absent when ko.io did not send it"},"equity_shares":{"$ref":"#/properties/rows/items/properties/shares_held"},"family" ⟨25 unchanged words⟩ this holder belongs to, when ko.io attributes it"},"flags":{"description":"e.g. NO_BASELINE (no prior-quarter 13F in ko.io), DEALER (market maker / dealer desk)","items":{"type":"string"},"type":"array"},"has_option_legs":{"type":["boolean" ⟨92 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true}before
—after
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"filters":{"additionalProperties":false,"properties":{"chamber":{"type":["string","null"]},"search":{"$ref":"#/properties/filters/properties/chamber"},"sort":{"$ref":"#/properties/filters/properties/chamber"},"ticker":{"$ref":"#/properties/filters/properties/chamber"}},"required":["chamber","ticker","search","sort"],"type":"object"},"paging":{"additionalProperties":false,"description":"Paging state reconciled from ko.io meta.total_count and meta.softwall","properties":{"continuation":{"description":"SIGNIN_REQUIRED = page>1 needs a (free) ko.io API key","type":["string","null"]},"has_more":{"description":"null = a full page came back and more MAY exist","type":["boolean","null"]},"next_page":{"anyOf":[{"$ref":"#/properties/paging/properties/total_count/anyOf/0"},{"type":"null"}],"description":"Next page THIS caller can open; null when there is none (or sign-in is required)"},"page":{"type":"integer"},"per_page":{"type":"integer"},"plan_row_cap":{"anyOf":[{"$ref":"#/properties/paging/properties/total_count/anyOf/0"},{"type":"null"}],"description":"Row cap the caller's plan applied to this page, if any"},"returned":{"type":"integer"},"total_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Total rows matching the request, when ko.io reported it"},"truncated_by_plan":{"description":"True when the plan's row cap withheld rows from this page","type":"boolean"}},"required":["page","per_page","returned","total_count","has_more","next_page","continuation","plan_row_cap","truncated_by_plan"],"type":"object"},"plan_limit":{"anyOf":[{"additionalProperties":false,"properties":{"continuation":{"$ref":"#/properties/filters/properties/chamber"},"date_basis":{"$ref":"#/properties/filters/properties/chamber"},"effective_period":{"$ref":"#/properties/filters/properties/chamber"},"policy_version":{"$ref":"#/properties/filters/properties/chamber"},"row_cap":{"anyOf":[{"$ref":"#/properties/paging/properties/total_count/anyOf/0"},{"type":"null"}]},"truncated":{"type":["boolean","null"]},"window_end":{"$ref":"#/properties/filters/properties/chamber"},"window_start":{"$ref":"#/properties/filters/properties/chamber"}},"required":["policy_version","window_start","window_end","effective_period","date_basis","row_cap","truncated","continuation"],"type":"object"},{"type":"null"}],"description":"The Free/keyless plan limits ko.io applied to this answer (null for paid callers)"},"rows":{"items":{"additionalProperties":false,"properties":{"amount_range":{"description":"The disclosed dollar RANGE (STOCK Act bands), not an exact amount","type":["string","null"]},"asset_description":{"$ref":"#/properties/filters/properties/chamber"},"chamber":{"$ref":"#/properties/filters/properties/chamber"},"disclosure_date":{"$ref":"#/properties/filters/properties/chamber"},"member_name":{"$ref":"#/properties/filters/properties/chamber"},"owner":{"$ref":"#/properties/filters/properties/chamber"},"ticker":{"$ref":"#/properties/filters/properties/chamber"},"transaction_date":{"$ref":"#/properties/filters/properties/chamber"},"transaction_type":{"$ref":"#/properties/filters/properties/chamber"}},"required":["member_name","chamber","ticker","asset_description","transaction_type","transaction_date","disclosure_date","amount_range","owner"],"type":"object"},"type":"array"}},"required":["filters","rows","paging","plan_limit"],"type":"object"}before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true}before
—after
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"complex":{"additionalProperties":false,"properties":{"products":{"anyOf":[{"type":"integer"},{"type":"null"}]},"qoq_change":{"$ref":"#/properties/complex/properties/total_usd"},"total_usd":{"anyOf":[{"pattern":"^-?\\d+(\\.\\d+)?([eE][-+]?\\d+)?$","type":"string"},{"type":"null"}],"description":"Exact decimal string as served by ko.io (not rounded); null = unknown"}},"required":["total_usd","qoq_change","products"],"type":"object"},"products":{"items":{"additionalProperties":false,"properties":{"holders":{"$ref":"#/properties/complex/properties/products"},"prev_usd":{"$ref":"#/properties/complex/properties/total_usd"},"product_name":{"$ref":"#/properties/products/items/properties/product_ticker"},"product_ticker":{"type":["string","null"]},"qoq_change":{"$ref":"#/properties/complex/properties/total_usd"},"sponsor":{"$ref":"#/properties/products/items/properties/product_ticker"},"total_usd":{"$ref":"#/properties/complex/properties/total_usd"}},"required":["product_ticker","product_name","sponsor","holders","total_usd","prev_usd","qoq_change"],"type":"object"},"type":"array"}},"required":["complex","products"],"type":"object"}before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true}before
—after
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"cik":{"type":["string","null"]},"institution":{"anyOf":[{"additionalProperties":false,"properties":{"latest_quarter":{"$ref":"#/properties/cik"},"name":{"$ref":"#/properties/cik"},"portfolio_weight_pct":{"$ref":"#/properties/institution/anyOf/0/properties/total_usd"},"qoq_change":{"$ref":"#/properties/institution/anyOf/0/properties/total_usd"},"rank":{"anyOf":[{"type":"integer"},{"type":"null"}]},"total_holders":{"$ref":"#/properties/institution/anyOf/0/properties/rank"},"total_usd":{"anyOf":[{"pattern":"^-?\\d+(\\.\\d+)?([eE][-+]?\\d+)?$","type":"string"},{"type":"null"}],"description":"Exact decimal string as served by ko.io (not rounded); null = unknown"}},"required":["name","latest_quarter","total_usd","qoq_change","rank","total_holders","portfolio_weight_pct"],"type":"object"},{"type":"null"}]},"plan_limit":{"anyOf":[{"additionalProperties":false,"properties":{"continuation":{"$ref":"#/properties/cik"},"date_basis":{"$ref":"#/properties/cik"},"effective_period":{"$ref":"#/properties/cik"},"policy_version":{"$ref":"#/properties/cik"},"row_cap":{"$ref":"#/properties/institution/anyOf/0/properties/rank"},"truncated":{"type":["boolean","null"]},"window_end":{"$ref":"#/properties/cik"},"window_start":{"$ref":"#/properties/cik"}},"required":["policy_version","window_start","window_end","effective_period","date_basis","row_cap","truncated","continuation"],"type":"object"},{"type":"null"}],"description":"The Free/keyless plan limits ko.io applied to this answer (null for paid callers)"},"positions":{"items":{"additionalProperties":false,"properties":{"action":{"$ref":"#/properties/cik"},"product_name":{"$ref":"#/properties/cik"},"product_ticker":{"$ref":"#/properties/cik"},"qoq_value_change":{"$ref":"#/properties/institution/anyOf/0/properties/total_usd"},"shares_held":{"$ref":"#/properties/institution/anyOf/0/properties/total_usd"},"usd_value":{"$ref":"#/properties/institution/anyOf/0/properties/total_usd"}},"required":["product_ticker","product_name","shares_held","usd_value","qoq_value_change","action"],"type":"object"},"type":"array"},"requested":{"type":"string"}},"required":["requested","cik","institution","positions","plan_limit"],"type":"object"}before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true}before
—after
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"paging":{"additionalProperties":false,"description":"Paging state reconciled from ko.io meta.total_count and meta.softwall","properties":{"continuation":{"description":"SIGNIN_REQUIRED = page>1 needs a (free) ko.io API key","type":["string","null"]},"has_more":{"description":"null = a full page came back and more MAY exist","type":["boolean","null"]},"next_page":{"anyOf":[{"$ref":"#/properties/total_holders/anyOf/0"},{"type":"null"}],"description":"Next page THIS caller can open; null when there is none (or sign-in is required)"},"page":{"type":"integer"},"per_page":{"type":"integer"},"plan_row_cap":{"anyOf":[{"$ref":"#/properties/total_holders/anyOf/0"},{"type":"null"}],"description":"Row cap the caller's plan applied to this page, if any"},"returned":{"type":"integer"},"total_count":{"anyOf":[{"$ref":"#/properties/total_holders/anyOf/0"},{"type":"null"}],"description":"Total rows matching the request, when ko.io reported it"},"truncated_by_plan":{"description":"True when the plan's row cap withheld rows from this page","type":"boolean"}},"required":["page","per_page","returned","total_count","has_more","next_page","continuation","plan_row_cap","truncated_by_plan"],"type":"object"},"plan_limit":{"anyOf":[{"additionalProperties":false,"properties":{"continuation":{"$ref":"#/properties/product"},"date_basis":{"$ref":"#/properties/product"},"effective_period":{"$ref":"#/properties/product"},"policy_version":{"$ref":"#/properties/product"},"row_cap":{"$ref":"#/properties/total_holders"},"truncated":{"type":["boolean","null"]},"window_end":{"$ref":"#/properties/product"},"window_start":{"$ref":"#/properties/product"}},"required":["policy_version","window_start","window_end","effective_period","date_basis","row_cap","truncated","continuation"],"type":"object"},{"type":"null"}],"description":"The Free/keyless plan limits ko.io applied to this answer (null for paid callers)"},"product":{"type":["string","null"]},"rows":{"items":{"additionalProperties":false,"properties":{"cik":{"$ref":"#/properties/product"},"name":{"$ref":"#/properties/product"},"prev_usd":{"$ref":"#/properties/rows/items/properties/total_usd"},"product_count":{"$ref":"#/properties/total_holders"},"products":{"items":{"type":"string"},"type":"array"},"qoq_value_change":{"$ref":"#/properties/rows/items/properties/total_usd"},"rank":{"$ref":"#/properties/total_holders"},"total_usd":{"anyOf":[{"pattern":"^-?\\d+(\\.\\d+)?([eE][-+]?\\d+)?$","type":"string"},{"type":"null"}],"description":"Exact decimal string as served by ko.io (not rounded); null = unknown"}},"required":["rank","cik","name","total_usd","prev_usd","qoq_value_change","product_count","products"],"type":"object"},"type":"array"},"total_holders":{"anyOf":[{"type":"integer"},{"type":"null"}]}},"required":["product","total_holders","rows","paging","plan_limit"],"type":"object"}before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true}before
—after
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"category":{"type":"string"},"paging":{"additionalProperties":false,"description":"Paging state reconciled from ko.io meta.total_count and meta.softwall","properties":{"continuation":{"description":"SIGNIN_REQUIRED = page>1 needs a (free) ko.io API key","type":["string","null"]},"has_more":{"description":"null = a full page came back and more MAY exist","type":["boolean","null"]},"next_page":{"anyOf":[{"$ref":"#/properties/paging/properties/total_count/anyOf/0"},{"type":"null"}],"description":"Next page THIS caller can open; null when there is none (or sign-in is required)"},"page":{"type":"integer"},"per_page":{"type":"integer"},"plan_row_cap":{"anyOf":[{"$ref":"#/properties/paging/properties/total_count/anyOf/0"},{"type":"null"}],"description":"Row cap the caller's plan applied to this page, if any"},"returned":{"type":"integer"},"total_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Total rows matching the request, when ko.io reported it"},"truncated_by_plan":{"description":"True when the plan's row cap withheld rows from this page","type":"boolean"}},"required":["page","per_page","returned","total_count","has_more","next_page","continuation","plan_row_cap","truncated_by_plan"],"type":"object"},"rows":{"items":{"additionalProperties":false,"properties":{"category":{"$ref":"#/properties/rows/items/properties/date"},"date":{"type":["string","null"]},"series_id":{"$ref":"#/properties/rows/items/properties/date"},"series_name":{"$ref":"#/properties/rows/items/properties/date"},"value":{"anyOf":[{"pattern":"^-?\\d+(\\.\\d+)?([eE][-+]?\\d+)?$","type":"string"},{"type":"null"}],"description":"Exact decimal string as served by ko.io (not rounded); null = unknown"}},"required":["date","series_id","series_name","value","category"],"type":"object"},"type":"array"}},"required":["category","rows","paging"],"type":"object"}before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true}before
—after
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"rows":{"items":{"additionalProperties":false,"properties":{"date":{"type":["string","null"]},"fed_funds_rate":{"anyOf":[{"pattern":"^-?\\d+(\\.\\d+)?([eE][-+]?\\d+)?$","type":"string"},{"type":"null"}],"description":"Exact decimal string as served by ko.io (not rounded); null = unknown"},"prime_rate":{"$ref":"#/properties/rows/items/properties/fed_funds_rate"},"sofr":{"$ref":"#/properties/rows/items/properties/fed_funds_rate"},"treasury_10y":{"$ref":"#/properties/rows/items/properties/fed_funds_rate"},"treasury_2y":{"$ref":"#/properties/rows/items/properties/fed_funds_rate"},"treasury_30y":{"$ref":"#/properties/rows/items/properties/fed_funds_rate"},"treasury_3m":{"$ref":"#/properties/rows/items/properties/fed_funds_rate"}},"required":["date","fed_funds_rate","sofr","prime_rate","treasury_3m","treasury_2y","treasury_10y","treasury_30y"],"type":"object"},"type":"array"},"unit":{"const":"percent","type":"string"}},"required":["unit","rows"],"type":"object"}before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true}before
—after
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"paging":{"additionalProperties":false,"description":"Paging state reconciled from ko.io meta.total_count and meta.softwall","properties":{"continuation":{"description":"SIGNIN_REQUIRED = page>1 needs a (free) ko.io API key","type":["string","null"]},"has_more":{"description":"null = a full page came back and more MAY exist","type":["boolean","null"]},"next_page":{"anyOf":[{"$ref":"#/properties/paging/properties/total_count/anyOf/0"},{"type":"null"}],"description":"Next page THIS caller can open; null when there is none (or sign-in is required)"},"page":{"type":"integer"},"per_page":{"type":"integer"},"plan_row_cap":{"anyOf":[{"$ref":"#/properties/paging/properties/total_count/anyOf/0"},{"type":"null"}],"description":"Row cap the caller's plan applied to this page, if any"},"returned":{"type":"integer"},"total_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Total rows matching the request, when ko.io reported it"},"truncated_by_plan":{"description":"True when the plan's row cap withheld rows from this page","type":"boolean"}},"required":["page","per_page","returned","total_count","has_more","next_page","continuation","plan_row_cap","truncated_by_plan"],"type":"object"},"rows":{"items":{"additionalProperties":false,"properties":{"date":{"type":["string","null"]},"series":{"$ref":"#/properties/rows/items/properties/date"},"value":{"anyOf":[{"pattern":"^-?\\d+(\\.\\d+)?([eE][-+]?\\d+)?$","type":"string"},{"type":"null"}],"description":"Exact decimal string as served by ko.io (not rounded); null = unknown"}},"required":["date","series","value"],"type":"object"},"type":"array"}},"required":["rows","paging"],"type":"object"}before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true}before
—after
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"filters":{"additionalProperties":false,"properties":{"insider_cik":{"$ref":"#/properties/filters/properties/ticker"},"ticker":{"type":["string","null"]}},"required":["ticker","insider_cik"],"type":"object"},"paging":{"additionalProperties":false,"description":"Paging state reconciled from ko.io meta.total_count and meta.softwall","properties":{"continuation":{"description":"SIGNIN_REQUIRED = page>1 needs a (free) ko.io API key","type":["string","null"]},"has_more":{"description":"null = a full page came back and more MAY exist","type":["boolean","null"]},"next_page":{"anyOf":[{"$ref":"#/properties/paging/properties/total_count/anyOf/0"},{"type":"null"}],"description":"Next page THIS caller can open; null when there is none (or sign-in is required)"},"page":{"type":"integer"},"per_page":{"type":"integer"},"plan_row_cap":{"anyOf":[{"$ref":"#/properties/paging/properties/total_count/anyOf/0"},{"type":"null"}],"description":"Row cap the caller's plan applied to this page, if any"},"returned":{"type":"integer"},"total_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Total rows matching the request, when ko.io reported it"},"truncated_by_plan":{"description":"True when the plan's row cap withheld rows from this page","type":"boolean"}},"required":["page","per_page","returned","total_count","has_more","next_page","continuation","plan_row_cap","truncated_by_plan"],"type":"object"},"plan_limit":{"anyOf":[{"additionalProperties":false,"properties":{"continuation":{"$ref":"#/properties/filters/properties/ticker"},"date_basis":{"$ref":"#/properties/filters/properties/ticker"},"effective_period":{"$ref":"#/properties/filters/properties/ticker"},"policy_version":{"$ref":"#/properties/filters/properties/ticker"},"row_cap":{"anyOf":[{"$ref":"#/properties/paging/properties/total_count/anyOf/0"},{"type":"null"}]},"truncated":{"type":["boolean","null"]},"window_end":{"$ref":"#/properties/filters/properties/ticker"},"window_start":{"$ref":"#/properties/filters/properties/ticker"}},"required":["policy_version","window_start","window_end","effective_period","date_basis","row_cap","truncated","continuation"],"type":"object"},{"type":"null"}],"description":"The Free/keyless plan limits ko.io applied to this answer (null for paid callers)"},"rows":{"items":{"additionalProperties":false,"properties":{"accession_no":{"$ref":"#/properties/filters/properties/ticker"},"aggregate_market_value":{"anyOf":[{"$ref":"#/properties/rows/items/properties/units_to_sell/anyOf/0"},{"type":"null"}],"description":"Exact decimal string as served by ko.io (not rounded); null = unknown"},"approx_sale_date":{"$ref":"#/properties/filters/properties/ticker"},"broker_name":{"$ref":"#/properties/filters/properties/ticker"},"filed_date":{"$ref":"#/properties/filters/properties/ticker"},"has_10b5_1_plan":{"type":["boolean","null"]},"issuer_cik":{"$ref":"#/properties/filters/properties/ticker"},"issuer_name":{"$ref":"#/properties/filters/properties/ticker"},"issuer_ticker":{"$ref":"#/properties/filters/properties/ticker"},"relationship":{"$ref":"#/properties/filters/properties/ticker"},"securities_class":{"$ref":"#/properties/filters/properties/ticker"},"seller_name":{"$ref":"#/properties/filters/properties/ticker"},"units_to_sell":{"anyOf":[{"pattern":"^-?\\d+(\\.\\d+)?([eE][-+]?\\d+)?$","type":"string"},{"type":"null"}],"description":"Units the filer NOTIFIED an intent to sell -- not a completed sale"}},"required":["accession_no","filed_date","issuer_ticker","issuer_name","issuer_cik","seller_name","relationship","securities_class","units_to_sell","aggregate_market_value","approx_sale_date","broker_name","has_10b5_1_plan"],"type":"object"},"type":"array"}},"required":["filters","rows","paging","plan_limit"],"type":"object"}before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true}Get SECFailures-to-Deliverfails-to-deliver (FTD) data for a stock.HighEachFTDquantity is the aggregate net BALANCE of shares that had failed to deliver and were still outstanding on that settlement date, as published by the SEC -- NOT the number of new fails that day. Balances carry over between days, so never sum quantitiesmayacrossindicatedates (that counts the same unsettled shares repeatedly); compare levels or take the maximum instead. Fails arise from many causes (operational and processing delays, long sales, market-maker activity), and FTD data on its own is not evidence of naked shortsellingselling.orFree/keylesssettlementaccessissues.covers the trailing 92 days. structuredContent carries the exact share quantities.
⟨6 unchanged words⟩ "days":{"default":90,"description":"NumberDays ofdays ofsettlement-date history (default9090; Free/keyless access allows up to 92)","maximum":1825,"minimum":1," ⟨71 unchanged words⟩
before
—after
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"measure":{"const":"outstanding_fail_balance","description":"Each quantity is the balance of fails outstanding on that settlement date -- not new fails that day; never sum across dates","type":"string"},"paging":{"additionalProperties":false,"description":"Paging state reconciled from ko.io meta.total_count and meta.softwall","properties":{"continuation":{"description":"SIGNIN_REQUIRED = page>1 needs a (free) ko.io API key","type":["string","null"]},"has_more":{"description":"null = a full page came back and more MAY exist","type":["boolean","null"]},"next_page":{"anyOf":[{"$ref":"#/properties/paging/properties/total_count/anyOf/0"},{"type":"null"}],"description":"Next page THIS caller can open; null when there is none (or sign-in is required)"},"page":{"type":"integer"},"per_page":{"type":"integer"},"plan_row_cap":{"anyOf":[{"$ref":"#/properties/paging/properties/total_count/anyOf/0"},{"type":"null"}],"description":"Row cap the caller's plan applied to this page, if any"},"returned":{"type":"integer"},"total_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Total rows matching the request, when ko.io reported it"},"truncated_by_plan":{"description":"True when the plan's row cap withheld rows from this page","type":"boolean"}},"required":["page","per_page","returned","total_count","has_more","next_page","continuation","plan_row_cap","truncated_by_plan"],"type":"object"},"plan_limit":{"anyOf":[{"additionalProperties":false,"properties":{"continuation":{"$ref":"#/properties/rows/items/properties/settlement_date"},"date_basis":{"$ref":"#/properties/rows/items/properties/settlement_date"},"effective_period":{"$ref":"#/properties/rows/items/properties/settlement_date"},"policy_version":{"$ref":"#/properties/rows/items/properties/settlement_date"},"row_cap":{"anyOf":[{"$ref":"#/properties/paging/properties/total_count/anyOf/0"},{"type":"null"}]},"truncated":{"type":["boolean","null"]},"window_end":{"$ref":"#/properties/rows/items/properties/settlement_date"},"window_start":{"$ref":"#/properties/rows/items/properties/settlement_date"}},"required":["policy_version","window_start","window_end","effective_period","date_basis","row_cap","truncated","continuation"],"type":"object"},{"type":"null"}],"description":"The Free/keyless plan limits ko.io applied to this answer (null for paid callers)"},"rows":{"items":{"additionalProperties":false,"properties":{"price":{"anyOf":[{"$ref":"#/properties/rows/items/properties/quantity/anyOf/0"},{"type":"null"}],"description":"Exact decimal string as served by ko.io (not rounded); null = unknown"},"quantity":{"anyOf":[{"pattern":"^-?\\d+(\\.\\d+)?([eE][-+]?\\d+)?$","type":"string"},{"type":"null"}],"description":"Outstanding fails-to-deliver balance (shares) on that settlement date"},"settlement_date":{"type":["string","null"]},"ticker":{"$ref":"#/properties/rows/items/properties/settlement_date"}},"required":["settlement_date","ticker","quantity","price"],"type":"object"},"type":"array"},"ticker":{"type":"string"}},"required":["ticker","measure","rows","paging","plan_limit"],"type":"object"}before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true}Getinsider/executive stock tradesinsider (SEC Form 4) transactions foraone company.ShowsTwoCEOgrains,CFOand the answer says which: (1) with `executive_cik` -> one row per Form 4 transaction line,directorswith its SEC code (P open-market or private purchase, S open-market or private sale, M/X/C option or RSU exercise/conversion, A grant/award, F shares withheld for tax, G gift, ...), shares, price andothervalue;officers(2)buyingwithout it -> one row per insider per trade date that AGGREGATES all that day's lines, split into code P/S purchases/sales (open market orsellingprivate)theirversusownallcompany'sacquisitions/dispositionsstock(which—also count vests, exercises and tax withholding), with both dollar totals and the line count; when ko.io reports them, the Lines cell and structuredContent also carry that day's SEC codes (e.g. '4 (F 1, M 2, S 1)'). Do not read an aggregate day's total disposed value as akeysalesignaldecision;foruseinstitutionaltheinvestors.P/S columns, whose dollar totals cover priced lines only (unpriced lines are counted and flagged as partial). Keyless/Free access covers the trailing 92 days; `period` beyond 1Q requires Pro. structuredContent carries the exact share counts and dollar amounts.
⟨5 unchanged words⟩ ,"properties":{"executive_cik":{"description":"Filter by specificInsider'sexecutiveSEC CIK (from a previous answer's person_cik, or list_insider_traders). When given, returns that insider's individual Form 4 transaction lines in this company, newest first.","type":"string"},"limit":{"default":50,"description":"TradesRows per page, 1-200","maximum":200," ⟨9 unchanged words⟩ number","minimum":1,"type":"integer"},"period":{"default":"1Q","description":"Trade-date window for the per-day view: 1Q = trailing 90 days (default, allowed on every plan); 2Q / 1Y / ALL require Pro. Ignored when executive_cik is given (that view returns the full history your plan allows).","enum":["1Q","2Q","1Y","ALL"],"type":"string"},"ticker":{"description":"Stock ticker ⟨11 unchanged words⟩
before
—after
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"executive_cik":{"type":["string","null"]},"grain":{"description":"insider_trade_date = one row per insider per day, aggregating that day's Form 4 lines; form4_transaction_line = one row per line","enum":["insider_trade_date","form4_transaction_line"],"type":"string"},"paging":{"additionalProperties":false,"description":"Paging state reconciled from ko.io meta.total_count and meta.softwall","properties":{"continuation":{"description":"SIGNIN_REQUIRED = page>1 needs a (free) ko.io API key","type":["string","null"]},"has_more":{"description":"null = a full page came back and more MAY exist","type":["boolean","null"]},"next_page":{"anyOf":[{"$ref":"#/properties/rows/items/properties/form4_lines/anyOf/0"},{"type":"null"}],"description":"Next page THIS caller can open; null when there is none (or sign-in is required)"},"page":{"type":"integer"},"per_page":{"type":"integer"},"plan_row_cap":{"anyOf":[{"$ref":"#/properties/rows/items/properties/form4_lines/anyOf/0"},{"type":"null"}],"description":"Row cap the caller's plan applied to this page, if any"},"returned":{"type":"integer"},"total_count":{"anyOf":[{"$ref":"#/properties/rows/items/properties/form4_lines/anyOf/0"},{"type":"null"}],"description":"Total rows matching the request, when ko.io reported it"},"truncated_by_plan":{"description":"True when the plan's row cap withheld rows from this page","type":"boolean"}},"required":["page","per_page","returned","total_count","has_more","next_page","continuation","plan_row_cap","truncated_by_plan"],"type":"object"},"period":{"$ref":"#/properties/executive_cik"},"plan_limit":{"anyOf":[{"additionalProperties":false,"properties":{"continuation":{"$ref":"#/properties/executive_cik"},"date_basis":{"$ref":"#/properties/executive_cik"},"effective_period":{"$ref":"#/properties/executive_cik"},"policy_version":{"$ref":"#/properties/executive_cik"},"row_cap":{"$ref":"#/properties/rows/items/properties/form4_lines"},"truncated":{"type":["boolean","null"]},"window_end":{"$ref":"#/properties/executive_cik"},"window_start":{"$ref":"#/properties/executive_cik"}},"required":["policy_version","window_start","window_end","effective_period","date_basis","row_cap","truncated","continuation"],"type":"object"},{"type":"null"}],"description":"The Free/keyless plan limits ko.io applied to this answer (null for paid callers)"},"rows":{"items":{"additionalProperties":false,"properties":{"acquired_disposed":{"anyOf":[{"enum":["A","D"],"type":"string"},{"type":"null"}]},"all_shares_acquired":{"$ref":"#/properties/rows/items/properties/shares","description":"Exact decimal string as served by ko.io (not rounded); null = unknown"},"all_shares_disposed":{"$ref":"#/properties/rows/items/properties/shares","description":"Exact decimal string as served by ko.io (not rounded); null = unknown"},"all_value_acquired":{"$ref":"#/properties/rows/items/properties/shares","description":"Exact decimal string as served by ko.io (not rounded); null = unknown"},"all_value_disposed":{"$ref":"#/properties/rows/items/properties/shares","description":"Exact decimal string as served by ko.io (not rounded); null = unknown"},"code_meaning":{"$ref":"#/properties/executive_cik"},"code_p_or_s":{"description":"true for SEC codes P (purchase) and S (sale) -- open market OR private; the code does not distinguish","type":"boolean"},"first_filed_date":{"$ref":"#/properties/executive_cik"},"form4_lines":{"anyOf":[{"type":"integer"},{"type":"null"}]},"is_derivative":{"type":"boolean"},"last_filed_date":{"$ref":"#/properties/executive_cik"},"officer_title":{"$ref":"#/properties/executive_cik"},"person_cik":{"$ref":"#/properties/executive_cik"},"person_name":{"$ref":"#/properties/executive_cik"},"price":{"$ref":"#/properties/rows/items/properties/shares","description":"Exact decimal string as served by ko.io (not rounded); null = unknown"},"ps_buy_lines":{"$ref":"#/properties/rows/items/properties/form4_lines","description":"Code P lines that day (open market or private purchases)"},"ps_buy_unpriced_lines":{"$ref":"#/properties/rows/items/properties/form4_lines","description":"Code P lines with no dollar value; > 0 means ps_value_bought is partial"},"ps_sell_lines":{"$ref":"#/properties/rows/items/properties/form4_lines","description":"Code S lines that day (open market or private sales)"},"ps_sell_unpriced_lines":{"$ref":"#/properties/rows/items/properties/form4_lines","description":"Code S lines with no dollar value; > 0 means ps_value_sold is partial"},"ps_shares_bought":{"$ref":"#/properties/rows/items/properties/shares","description":"null = unknown (a line had no share count)"},"ps_shares_sold":{"$ref":"#/properties/rows/items/properties/shares","description":"Exact decimal string as served by ko.io (not rounded); null = unknown"},"ps_value_bought":{"$ref":"#/properties/rows/items/properties/shares","description":"Dollar total of PRICED code P lines only"},"ps_value_bought_complete":{"description":"false = some code P lines unpriced; null = not reported","type":["boolean","null"]},"ps_value_sold":{"$ref":"#/properties/rows/items/properties/shares","description":"Dollar total of PRICED code S lines only"},"ps_value_sold_complete":{"type":["boolean","null"]},"security_title":{"$ref":"#/properties/executive_cik"},"shares":{"anyOf":[{"pattern":"^-?\\d+(\\.\\d+)?([eE][-+]?\\d+)?$","type":"string"},{"type":"null"}],"description":"Exact decimal string as served by ko.io (not rounded); null = unknown"},"shares_owned_after":{"$ref":"#/properties/rows/items/properties/shares"},"trade_date":{"$ref":"#/properties/executive_cik"},"transaction_code":{"$ref":"#/properties/executive_cik"},"transaction_code_breakdown":{"anyOf":[{"items":{"additionalProperties":false,"properties":{"acquired_disposed":{"enum":["A","D"],"type":"string"},"code":{"$ref":"#/properties/executive_cik"},"code_meaning":{"type":"string"},"is_derivative":{"type":"boolean"},"lines":{"$ref":"#/properties/rows/items/properties/form4_lines"},"shares":{"$ref":"#/properties/rows/items/properties/shares"},"value":{"$ref":"#/properties/rows/items/properties/shares"}},"required":["code","code_meaning","acquired_disposed","is_derivative","lines","shares","value"],"type":"object"},"type":"array"},{"type":"null"}],"description":"Per code x acquired/disposed x table: line count, shares, value (null = unknown, not partial)"},"transaction_codes":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Distinct SEC Form 4 codes aggregated into this day (e.g. [\"F\",\"M\",\"S\"]); null = not reported by ko.io"},"value":{"$ref":"#/properties/rows/items/properties/shares","description":"Exact decimal string as served by ko.io (not rounded); null = unknown"}},"required":["trade_date","person_cik","person_name","shares_owned_after"],"type":"object"},"type":"array"},"ticker":{"type":"string"}},"required":["ticker","grain","executive_cik","period","rows","paging","plan_limit"],"type":"object"}before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true}⟨23 unchanged words⟩ with share counts, values, and quarter-over-quarter changes. Every answer states its grain: ENTITY (a CIK that belongs to a manager family is answered for the whole family by default -- pass entity='filer' for that one filer's own 13F) and SECURITY (the default portfolio merges an issuer's share classes into one row, e.g. GOOG+GOOGL, and lists the per-class breakdown; pass `ticker` to get only that security). Shares and value are the 13F-reported totals over all legs; option legs are flagged. structuredContent carries exact shares/values and the grain fields.
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"entity":{"default":"family","description":"family (default): consolidate every 13F filer in the manager family; filer: only the requested CIK's own filing.","enum":["family","filer"],"type":"string"},"institution":{"description":"Institution CIK number ( ⟨37 unchanged words⟩ number","minimum":1,"type":"integer"},"ticker":{"description":"Only this security (e.g. 'GOOG'). Returns the security grain: GOOG is Class C only, not the Alphabet issuer total.","maxLength":20,"type":"string"}},"required":["institution"],"type":"object"}
before
—after
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"entity_grain":{"description":"filer = one 13F filer's own filing; family = consolidated across a manager family's filers","enum":["filer","family","unknown"],"type":"string"},"family":{"anyOf":[{"additionalProperties":false,"properties":{"canonical_cik":{"$ref":"#/properties/family/anyOf/0/properties/slug"},"name":{"$ref":"#/properties/family/anyOf/0/properties/slug"},"slug":{"type":["string","null"]}},"required":["slug","name","canonical_cik"],"type":"object"},{"type":"null"}],"description":"The manager family, when the answer is at family grain and ko.io named it"},"paging":{"additionalProperties":false,"description":"Paging state reconciled from ko.io meta.total_count and meta.softwall","properties":{"continuation":{"description":"SIGNIN_REQUIRED = page>1 needs a (free) ko.io API key","type":["string","null"]},"has_more":{"description":"null = a full page came back and more MAY exist","type":["boolean","null"]},"next_page":{"anyOf":[{"$ref":"#/properties/rows/items/properties/reported_by_members/anyOf/0"},{"type":"null"}],"description":"Next page THIS caller can open; null when there is none (or sign-in is required)"},"page":{"type":"integer"},"per_page":{"type":"integer"},"plan_row_cap":{"anyOf":[{"$ref":"#/properties/rows/items/properties/reported_by_members/anyOf/0"},{"type":"null"}],"description":"Row cap the caller's plan applied to this page, if any"},"returned":{"type":"integer"},"total_count":{"anyOf":[{"$ref":"#/properties/rows/items/properties/reported_by_members/anyOf/0"},{"type":"null"}],"description":"Total rows matching the request, when ko.io reported it"},"truncated_by_plan":{"description":"True when the plan's row cap withheld rows from this page","type":"boolean"}},"required":["page","per_page","returned","total_count","has_more","next_page","continuation","plan_row_cap","truncated_by_plan"],"type":"object"},"plan_limit":{"anyOf":[{"additionalProperties":false,"properties":{"continuation":{"$ref":"#/properties/family/anyOf/0/properties/slug"},"date_basis":{"$ref":"#/properties/family/anyOf/0/properties/slug"},"effective_period":{"$ref":"#/properties/family/anyOf/0/properties/slug"},"policy_version":{"$ref":"#/properties/family/anyOf/0/properties/slug"},"row_cap":{"$ref":"#/properties/rows/items/properties/reported_by_members"},"truncated":{"type":["boolean","null"]},"window_end":{"$ref":"#/properties/family/anyOf/0/properties/slug"},"window_start":{"$ref":"#/properties/family/anyOf/0/properties/slug"}},"required":["policy_version","window_start","window_end","effective_period","date_basis","row_cap","truncated","continuation"],"type":"object"},{"type":"null"}],"description":"The Free/keyless plan limits ko.io applied to this answer (null for paid callers)"},"position_basis":{"description":"What shares_held/holding_value count, when ko.io stated it (e.g. 13f_reported_all_legs)","type":["string","null"]},"quarter_date":{"description":"The snapshot's quarter; null for a history (each row carries its own quarter_date)","type":["string","null"]},"quarters":{"description":"Distinct quarter-ends present in rows, newest first","items":{"type":"string"},"type":"array"},"requested":{"description":"The institution identifier the caller passed","type":"string"},"requested_cik":{"description":"The CIK/slug the request was made for","type":["string","null"]},"resolved_cik":{"description":"The CIK ko.io answered for (the family's canonical CIK at family grain)","type":["string","null"]},"rows":{"items":{"additionalProperties":false,"properties":{"action":{"$ref":"#/properties/family/anyOf/0/properties/slug"},"call_shares":{"$ref":"#/properties/rows/items/properties/shares_held"},"cik":{"$ref":"#/properties/family/anyOf/0/properties/slug"},"equity_shares":{"$ref":"#/properties/rows/items/properties/shares_held"},"has_option_legs":{"type":["boolean","null"]},"holding_value":{"$ref":"#/properties/rows/items/properties/shares_held"},"issuer":{"$ref":"#/properties/family/anyOf/0/properties/slug"},"portfolio_weight_pct":{"$ref":"#/properties/rows/items/properties/shares_held"},"put_shares":{"$ref":"#/properties/rows/items/properties/shares_held"},"quarter_date":{"$ref":"#/properties/family/anyOf/0/properties/slug"},"reported_by_members":{"anyOf":[{"type":"integer"},{"type":"null"}]},"security_grain":{"enum":["security","issuer"],"type":"string"},"share_change":{"$ref":"#/properties/rows/items/properties/shares_held"},"share_classes":{"description":"Per-class breakdown of an issuer-grain row; empty at security grain","items":{"additionalProperties":false,"properties":{"holding_value":{"$ref":"#/properties/rows/items/properties/shares_held"},"shares_held":{"$ref":"#/properties/rows/items/properties/shares_held"},"ticker":{"$ref":"#/properties/family/anyOf/0/properties/slug"}},"required":["ticker","shares_held","holding_value"],"type":"object"},"type":"array"},"shares_held":{"anyOf":[{"pattern":"^-?\\d+(\\.\\d+)?([eE][-+]?\\d+)?$","type":"string"},{"type":"null"}],"description":"Exact decimal string as served by ko.io (not rounded); null = unknown"},"ticker":{"$ref":"#/properties/family/anyOf/0/properties/slug"},"tickers":{"description":"Share-class tickers summed into this row (one entry at security grain)","items":{"type":"string"},"type":"array"}},"required":["cik","ticker","issuer","quarter_date","shares_held","holding_value","portfolio_weight_pct","action","share_change","security_grain","tickers","share_classes","equity_shares","call_shares","put_shares","has_option_legs","reported_by_members"],"type":"object"},"type":"array"},"security_grain":{"description":"security = one row per security/share class; issuer = share classes of one issuer merged; mixed = portfolio with some merged rows","enum":["security","issuer","mixed"],"type":"string"},"ticker_filter":{"$ref":"#/properties/family/anyOf/0/properties/slug"},"view":{"description":"snapshot = one quarter's holdings; history = one position across quarters (family + ticker), one row per quarter, newest first","enum":["snapshot","history"],"type":"string"}},"required":["requested","requested_cik","resolved_cik","entity_grain","family","security_grain","ticker_filter","position_basis","view","quarters","quarter_date","rows","paging","plan_limit"],"type":"object"}before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true}⟨25 unchanged words⟩ — useful for detecting accumulation or distribution patterns. Plan limits: Free/keyless access covers the latest 13F quarter only; the multi-quarter trend requires Pro. Omit `quarters` to get the most your plan allows. structuredContent carries the exact net shares/values.
⟨3 unchanged words⟩ additionalProperties":false,"properties":{"quarters":{"default":8,"description":"Number of quarters toreturnreturn.(Omit for the plan default (Pro: 8 = 2yearsyears; Free/keyless: the latest quarter only). An explicit value above what your plan allows returns a plan-limit error.","maximum":40,"minimum":1,"type ⟨14 unchanged words⟩
before
—after
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"latest":{"anyOf":[{"additionalProperties":false,"properties":{"institutions_decreased":{"$ref":"#/properties/latest/anyOf/0/properties/institutions_increased"},"institutions_exited":{"$ref":"#/properties/latest/anyOf/0/properties/institutions_increased"},"institutions_increased":{"anyOf":[{"$ref":"#/properties/quarters_requested/anyOf/0"},{"type":"null"}]},"institutions_new":{"$ref":"#/properties/latest/anyOf/0/properties/institutions_increased"},"institutions_total":{"$ref":"#/properties/latest/anyOf/0/properties/institutions_increased"},"net_shares":{"anyOf":[{"pattern":"^-?\\d+(\\.\\d+)?([eE][-+]?\\d+)?$","type":"string"},{"type":"null"}],"description":"Exact decimal string as served by ko.io (not rounded); null = unknown"},"net_value":{"$ref":"#/properties/latest/anyOf/0/properties/net_shares"},"quarter":{"type":["string","null"]},"shares_added":{"$ref":"#/properties/latest/anyOf/0/properties/net_shares"},"shares_removed":{"$ref":"#/properties/latest/anyOf/0/properties/net_shares"},"value_added":{"$ref":"#/properties/latest/anyOf/0/properties/net_shares"},"value_removed":{"$ref":"#/properties/latest/anyOf/0/properties/net_shares"}},"required":["quarter","institutions_increased","institutions_decreased","institutions_new","institutions_exited","net_shares","net_value","institutions_total","shares_added","shares_removed","value_added","value_removed"],"type":"object"},{"type":"null"}]},"plan_limit":{"anyOf":[{"additionalProperties":false,"properties":{"continuation":{"$ref":"#/properties/latest/anyOf/0/properties/quarter"},"date_basis":{"$ref":"#/properties/latest/anyOf/0/properties/quarter"},"effective_period":{"$ref":"#/properties/latest/anyOf/0/properties/quarter"},"policy_version":{"$ref":"#/properties/latest/anyOf/0/properties/quarter"},"row_cap":{"$ref":"#/properties/latest/anyOf/0/properties/institutions_increased"},"truncated":{"type":["boolean","null"]},"window_end":{"$ref":"#/properties/latest/anyOf/0/properties/quarter"},"window_start":{"$ref":"#/properties/latest/anyOf/0/properties/quarter"}},"required":["policy_version","window_start","window_end","effective_period","date_basis","row_cap","truncated","continuation"],"type":"object"},{"type":"null"}],"description":"The Free/keyless plan limits ko.io applied to this answer (null for paid callers)"},"plan_note":{"description":"Set when the plan limited how many quarters were returned","type":["string","null"]},"quarters_requested":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"null = the plan default was used"},"quarters_returned":{"type":"integer"},"ticker":{"type":"string"},"trend":{"items":{"additionalProperties":false,"properties":{"institutions_decreased":{"$ref":"#/properties/latest/anyOf/0/properties/institutions_increased"},"institutions_exited":{"$ref":"#/properties/latest/anyOf/0/properties/institutions_increased"},"institutions_increased":{"$ref":"#/properties/latest/anyOf/0/properties/institutions_increased"},"institutions_new":{"$ref":"#/properties/latest/anyOf/0/properties/institutions_increased"},"net_shares":{"$ref":"#/properties/latest/anyOf/0/properties/net_shares"},"net_value":{"$ref":"#/properties/latest/anyOf/0/properties/net_shares"},"quarter":{"$ref":"#/properties/latest/anyOf/0/properties/quarter"}},"required":["quarter","institutions_increased","institutions_decreased","institutions_new","institutions_exited","net_shares","net_value"],"type":"object"},"type":"array"}},"required":["ticker","quarters_requested","quarters_returned","latest","trend","plan_note","plan_limit"],"type":"object"}before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true}⟨15 unchanged words⟩ flow, debt ratios) from SEC 10-K/10-Q filings. Plan limits: the Free plan and keyless access return only the latest quarterly statement; annual statements and earlier quarters require Pro (a request for them returns an explicit plan-limit error, never 'no data'). structuredContent carries the exact reported values.
before
—after
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"period_type":{"enum":["quarterly","annual"],"type":"string"},"periods":{"items":{"additionalProperties":false,"properties":{"eps_basic":{"$ref":"#/properties/periods/items/properties/revenue"},"eps_diluted":{"$ref":"#/properties/periods/items/properties/revenue"},"gross_profit":{"$ref":"#/properties/periods/items/properties/revenue"},"long_term_debt":{"$ref":"#/properties/periods/items/properties/revenue"},"net_income":{"$ref":"#/properties/periods/items/properties/revenue"},"operating_cashflow":{"$ref":"#/properties/periods/items/properties/revenue"},"operating_income":{"$ref":"#/properties/periods/items/properties/revenue"},"period_end":{"type":["string","null"]},"revenue":{"anyOf":[{"pattern":"^-?\\d+(\\.\\d+)?([eE][-+]?\\d+)?$","type":"string"},{"type":"null"}],"description":"Exact decimal string as served by ko.io (not rounded); null = unknown"},"short_term_debt":{"$ref":"#/properties/periods/items/properties/revenue"},"stockholders_equity":{"$ref":"#/properties/periods/items/properties/revenue"}},"required":["period_end","revenue","net_income","eps_basic","eps_diluted","gross_profit","operating_income","operating_cashflow","long_term_debt","short_term_debt","stockholders_equity"],"type":"object"},"type":"array"},"plan_limit":{"anyOf":[{"additionalProperties":false,"properties":{"continuation":{"$ref":"#/properties/periods/items/properties/period_end"},"date_basis":{"$ref":"#/properties/periods/items/properties/period_end"},"effective_period":{"$ref":"#/properties/periods/items/properties/period_end"},"policy_version":{"$ref":"#/properties/periods/items/properties/period_end"},"row_cap":{"anyOf":[{"type":"integer"},{"type":"null"}]},"truncated":{"type":["boolean","null"]},"window_end":{"$ref":"#/properties/periods/items/properties/period_end"},"window_start":{"$ref":"#/properties/periods/items/properties/period_end"}},"required":["policy_version","window_start","window_end","effective_period","date_basis","row_cap","truncated","continuation"],"type":"object"},{"type":"null"}],"description":"The Free/keyless plan limits ko.io applied to this answer (null for paid callers)"},"plan_note":{"description":"Set when the caller's plan limited which periods were returned","type":["string","null"]},"ticker":{"type":"string"}},"required":["ticker","period_type","periods","plan_note","plan_limit"],"type":"object"}before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true}before
—after
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"entity_grain":{"anyOf":[{"enum":["filer","family"],"type":"string"},{"type":"null"}],"description":"filer = each row is one 13F filer CIK (not consolidated into manager families); null = ko.io did not state it"},"family":{"anyOf":[{"additionalProperties":false,"properties":{"canonical_cik":{"$ref":"#/properties/quarter_date"},"name":{"$ref":"#/properties/quarter_date"},"slug":{"$ref":"#/properties/quarter_date"}},"required":["slug","name","canonical_cik"],"type":"object"},{"type":"null"}]},"paging":{"additionalProperties":false,"description":"Paging state reconciled from ko.io meta.total_count and meta.softwall","properties":{"continuation":{"description":"SIGNIN_REQUIRED = page>1 needs a (free) ko.io API key","type":["string","null"]},"has_more":{"description":"null = a full page came back and more MAY exist","type":["boolean","null"]},"next_page":{"anyOf":[{"$ref":"#/properties/total_institutions/anyOf/0"},{"type":"null"}],"description":"Next page THIS caller can open; null when there is none (or sign-in is required)"},"page":{"type":"integer"},"per_page":{"type":"integer"},"plan_row_cap":{"anyOf":[{"$ref":"#/properties/total_institutions/anyOf/0"},{"type":"null"}],"description":"Row cap the caller's plan applied to this page, if any"},"returned":{"type":"integer"},"total_count":{"anyOf":[{"$ref":"#/properties/total_institutions/anyOf/0"},{"type":"null"}],"description":"Total rows matching the request, when ko.io reported it"},"truncated_by_plan":{"description":"True when the plan's row cap withheld rows from this page","type":"boolean"}},"required":["page","per_page","returned","total_count","has_more","next_page","continuation","plan_row_cap","truncated_by_plan"],"type":"object"},"plan_limit":{"anyOf":[{"additionalProperties":false,"properties":{"continuation":{"$ref":"#/properties/quarter_date"},"date_basis":{"$ref":"#/properties/quarter_date"},"effective_period":{"$ref":"#/properties/quarter_date"},"policy_version":{"$ref":"#/properties/quarter_date"},"row_cap":{"$ref":"#/properties/total_institutions"},"truncated":{"type":["boolean","null"]},"window_end":{"$ref":"#/properties/quarter_date"},"window_start":{"$ref":"#/properties/quarter_date"}},"required":["policy_version","window_start","window_end","effective_period","date_basis","row_cap","truncated","continuation"],"type":"object"},{"type":"null"}],"description":"The Free/keyless plan limits ko.io applied to this answer (null for paid callers)"},"position_basis":{"$ref":"#/properties/quarter_date"},"position_basis_note":{"$ref":"#/properties/quarter_date"},"quarter_date":{"type":["string","null"]},"requested_cik":{"$ref":"#/properties/quarter_date"},"rows":{"items":{"additionalProperties":false,"properties":{"action":{"$ref":"#/properties/quarter_date"},"call_shares":{"$ref":"#/properties/rows/items/properties/shares_held"},"cik":{"$ref":"#/properties/quarter_date"},"equity_shares":{"$ref":"#/properties/rows/items/properties/shares_held"},"family":{"anyOf":[{"additionalProperties":false,"properties":{"canonical_cik":{"$ref":"#/properties/quarter_date"},"name":{"$ref":"#/properties/quarter_date"},"slug":{"$ref":"#/properties/quarter_date"}},"required":["slug","name","canonical_cik"],"type":"object"},{"type":"null"}],"description":"The manager family this holder belongs to, when ko.io attributes it"},"has_option_legs":{"type":["boolean","null"]},"holding_value":{"$ref":"#/properties/rows/items/properties/shares_held"},"name":{"$ref":"#/properties/quarter_date"},"portfolio_weight_pct":{"$ref":"#/properties/rows/items/properties/shares_held"},"put_shares":{"$ref":"#/properties/rows/items/properties/shares_held"},"rank":{"type":"integer"},"reported_by_members":{"$ref":"#/properties/total_institutions"},"share_change":{"$ref":"#/properties/rows/items/properties/shares_held"},"shares_held":{"anyOf":[{"pattern":"^-?\\d+(\\.\\d+)?([eE][-+]?\\d+)?$","type":"string"},{"type":"null"}],"description":"Exact decimal string as served by ko.io (not rounded); null = unknown"}},"required":["rank","cik","name","shares_held","holding_value","portfolio_weight_pct","share_change","action","equity_shares","call_shares","put_shares","has_option_legs","family","reported_by_members"],"type":"object"},"type":"array"},"ticker":{"type":"string"},"total_institutions":{"anyOf":[{"type":"integer"},{"type":"null"}]}},"required":["ticker","quarter_date","position_basis","position_basis_note","entity_grain","requested_cik","family","total_institutions","rows","paging","plan_limit"],"type":"object"}before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true}before
—after
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"days_requested":{"type":"integer"},"latest":{"anyOf":[{"additionalProperties":false,"properties":{"close":{"anyOf":[{"pattern":"^-?\\d+(\\.\\d+)?([eE][-+]?\\d+)?$","type":"string"},{"type":"null"}],"description":"Exact decimal string as served by ko.io (not rounded); null = unknown"},"date":{"type":["string","null"]}},"required":["date","close"],"type":"object"},{"type":"null"}]},"period":{"type":"string"},"period_high_close":{"$ref":"#/properties/latest/anyOf/0/properties/close"},"period_low_close":{"$ref":"#/properties/latest/anyOf/0/properties/close"},"period_start":{"anyOf":[{"additionalProperties":false,"properties":{"close":{"$ref":"#/properties/latest/anyOf/0/properties/close"},"date":{"$ref":"#/properties/latest/anyOf/0/properties/date"}},"required":["date","close"],"type":"object"},{"type":"null"}]},"plan_limit":{"anyOf":[{"additionalProperties":false,"properties":{"continuation":{"$ref":"#/properties/latest/anyOf/0/properties/date"},"date_basis":{"$ref":"#/properties/latest/anyOf/0/properties/date"},"effective_period":{"$ref":"#/properties/latest/anyOf/0/properties/date"},"policy_version":{"$ref":"#/properties/latest/anyOf/0/properties/date"},"row_cap":{"anyOf":[{"type":"integer"},{"type":"null"}]},"truncated":{"type":["boolean","null"]},"window_end":{"$ref":"#/properties/latest/anyOf/0/properties/date"},"window_start":{"$ref":"#/properties/latest/anyOf/0/properties/date"}},"required":["policy_version","window_start","window_end","effective_period","date_basis","row_cap","truncated","continuation"],"type":"object"},{"type":"null"}],"description":"The Free/keyless plan limits ko.io applied to this answer (null for paid callers)"},"rows":{"description":"The rows rendered: the full series (series=true, up to limit) or the latest 10","items":{"additionalProperties":false,"properties":{"close":{"$ref":"#/properties/latest/anyOf/0/properties/close"},"date":{"$ref":"#/properties/latest/anyOf/0/properties/date"},"high":{"$ref":"#/properties/latest/anyOf/0/properties/close"},"low":{"$ref":"#/properties/latest/anyOf/0/properties/close"},"open":{"$ref":"#/properties/latest/anyOf/0/properties/close"},"volume":{"$ref":"#/properties/latest/anyOf/0/properties/close"}},"required":["date","open","high","low","close","volume"],"type":"object"},"type":"array"},"rows_returned":{"type":"integer"},"ticker":{"type":"string"},"total_return_pct":{"anyOf":[{"$ref":"#/properties/latest/anyOf/0/properties/close/anyOf/0"},{"type":"null"}],"description":"(latest close - period-start close) / period-start close x 100, from the returned rows"}},"required":["ticker","period","days_requested","rows_returned","latest","period_start","total_return_pct","period_high_close","period_low_close","rows","plan_limit"],"type":"object"}before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true}before
—after
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"position_basis":{"$ref":"#/properties/stock/properties/sector"},"stock":{"additionalProperties":false,"properties":{"avg_volume":{"$ref":"#/properties/stock/properties/market_cap"},"beta":{"$ref":"#/properties/stock/properties/market_cap"},"current_price":{"$ref":"#/properties/stock/properties/market_cap"},"dividend_yield_pct":{"$ref":"#/properties/stock/properties/market_cap"},"eps":{"$ref":"#/properties/stock/properties/market_cap"},"fifty_two_week_high":{"$ref":"#/properties/stock/properties/market_cap"},"fifty_two_week_low":{"$ref":"#/properties/stock/properties/market_cap"},"industry":{"$ref":"#/properties/stock/properties/sector"},"market_cap":{"anyOf":[{"pattern":"^-?\\d+(\\.\\d+)?([eE][-+]?\\d+)?$","type":"string"},{"type":"null"}],"description":"Exact decimal string as served by ko.io (not rounded); null = unknown"},"pe_ratio":{"$ref":"#/properties/stock/properties/market_cap"},"previous_close":{"$ref":"#/properties/stock/properties/market_cap"},"price_date":{"$ref":"#/properties/stock/properties/sector"},"profit_margins":{"$ref":"#/properties/stock/properties/market_cap"},"sector":{"type":["string","null"]}},"required":["sector","industry","market_cap","current_price","price_date","previous_close","fifty_two_week_high","fifty_two_week_low","pe_ratio","eps","beta","dividend_yield_pct","profit_margins","avg_volume"],"type":"object"},"ticker":{"type":"string"},"top_holders":{"items":{"additionalProperties":false,"properties":{"call_shares":{"$ref":"#/properties/stock/properties/market_cap"},"cik":{"$ref":"#/properties/stock/properties/sector"},"equity_shares":{"$ref":"#/properties/stock/properties/market_cap"},"has_option_legs":{"type":["boolean","null"]},"holding_value":{"$ref":"#/properties/stock/properties/market_cap"},"name":{"$ref":"#/properties/stock/properties/sector"},"portfolio_weight_pct":{"$ref":"#/properties/stock/properties/market_cap"},"put_shares":{"$ref":"#/properties/stock/properties/market_cap"},"shares_held":{"$ref":"#/properties/stock/properties/market_cap"}},"required":["cik","name","shares_held","holding_value","portfolio_weight_pct","equity_shares","call_shares","put_shares","has_option_legs"],"type":"object"},"type":"array"}},"required":["ticker","stock","position_basis","top_holders"],"type":"object"}before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true}before
—after
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"rows":{"items":{"additionalProperties":false,"properties":{"date":{"type":["string","null"]},"m1":{"anyOf":[{"pattern":"^-?\\d+(\\.\\d+)?([eE][-+]?\\d+)?$","type":"string"},{"type":"null"}],"description":"Exact decimal string as served by ko.io (not rounded); null = unknown"},"m3":{"$ref":"#/properties/rows/items/properties/m1"},"m6":{"$ref":"#/properties/rows/items/properties/m1"},"y1":{"$ref":"#/properties/rows/items/properties/m1"},"y10":{"$ref":"#/properties/rows/items/properties/m1"},"y2":{"$ref":"#/properties/rows/items/properties/m1"},"y30":{"$ref":"#/properties/rows/items/properties/m1"},"y5":{"$ref":"#/properties/rows/items/properties/m1"}},"required":["date","m1","m3","m6","y1","y2","y5","y10","y30"],"type":"object"},"type":"array"},"unit":{"const":"percent","type":"string"}},"required":["unit","rows"],"type":"object"}before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true}before
—after
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"grain":{"const":"insider_trade_date","type":"string"},"paging":{"additionalProperties":false,"description":"Paging state reconciled from ko.io meta.total_count and meta.softwall","properties":{"continuation":{"description":"SIGNIN_REQUIRED = page>1 needs a (free) ko.io API key","type":["string","null"]},"has_more":{"description":"null = a full page came back and more MAY exist","type":["boolean","null"]},"next_page":{"anyOf":[{"$ref":"#/properties/rows/items/properties/form4_lines/anyOf/0"},{"type":"null"}],"description":"Next page THIS caller can open; null when there is none (or sign-in is required)"},"page":{"type":"integer"},"per_page":{"type":"integer"},"plan_row_cap":{"anyOf":[{"$ref":"#/properties/rows/items/properties/form4_lines/anyOf/0"},{"type":"null"}],"description":"Row cap the caller's plan applied to this page, if any"},"returned":{"type":"integer"},"total_count":{"anyOf":[{"$ref":"#/properties/rows/items/properties/form4_lines/anyOf/0"},{"type":"null"}],"description":"Total rows matching the request, when ko.io reported it"},"truncated_by_plan":{"description":"True when the plan's row cap withheld rows from this page","type":"boolean"}},"required":["page","per_page","returned","total_count","has_more","next_page","continuation","plan_row_cap","truncated_by_plan"],"type":"object"},"plan_limit":{"anyOf":[{"additionalProperties":false,"properties":{"continuation":{"$ref":"#/properties/search"},"date_basis":{"$ref":"#/properties/search"},"effective_period":{"$ref":"#/properties/search"},"policy_version":{"$ref":"#/properties/search"},"row_cap":{"$ref":"#/properties/rows/items/properties/form4_lines"},"truncated":{"type":["boolean","null"]},"window_end":{"$ref":"#/properties/search"},"window_start":{"$ref":"#/properties/search"}},"required":["policy_version","window_start","window_end","effective_period","date_basis","row_cap","truncated","continuation"],"type":"object"},{"type":"null"}],"description":"The Free/keyless plan limits ko.io applied to this answer (null for paid callers)"},"role":{"type":"string"},"rows":{"items":{"additionalProperties":false,"properties":{"all_value_acquired":{"anyOf":[{"$ref":"#/properties/rows/items/properties/ps_value_bought/anyOf/0"},{"type":"null"}],"description":"Exact decimal string as served by ko.io (not rounded); null = unknown"},"all_value_disposed":{"$ref":"#/properties/rows/items/properties/all_value_acquired"},"company_name":{"$ref":"#/properties/search"},"form4_lines":{"anyOf":[{"type":"integer"},{"type":"null"}]},"officer_title":{"$ref":"#/properties/search"},"person_cik":{"$ref":"#/properties/search"},"person_name":{"$ref":"#/properties/search"},"ps_value_bought":{"anyOf":[{"pattern":"^-?\\d+(\\.\\d+)?([eE][-+]?\\d+)?$","type":"string"},{"type":"null"}],"description":"Code P lines (open-market or private purchase), priced lines only"},"ps_value_sold":{"anyOf":[{"$ref":"#/properties/rows/items/properties/ps_value_bought/anyOf/0"},{"type":"null"}],"description":"Code S lines (open-market or private sale), priced lines only"},"shares_owned_after":{"$ref":"#/properties/rows/items/properties/all_value_acquired"},"ticker":{"$ref":"#/properties/search"},"trade_date":{"$ref":"#/properties/search"}},"required":["ticker","company_name","person_cik","person_name","officer_title","trade_date","form4_lines","ps_value_bought","ps_value_sold","all_value_acquired","all_value_disposed","shares_owned_after"],"type":"object"},"type":"array"},"search":{"type":["string","null"]}},"required":["search","role","grain","rows","paging","plan_limit"],"type":"object"}before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true}before
—after
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"paging":{"additionalProperties":false,"description":"Paging state reconciled from ko.io meta.total_count and meta.softwall","properties":{"continuation":{"description":"SIGNIN_REQUIRED = page>1 needs a (free) ko.io API key","type":["string","null"]},"has_more":{"description":"null = a full page came back and more MAY exist","type":["boolean","null"]},"next_page":{"anyOf":[{"$ref":"#/properties/rows/items/properties/rank/anyOf/0"},{"type":"null"}],"description":"Next page THIS caller can open; null when there is none (or sign-in is required)"},"page":{"type":"integer"},"per_page":{"type":"integer"},"plan_row_cap":{"anyOf":[{"$ref":"#/properties/rows/items/properties/rank/anyOf/0"},{"type":"null"}],"description":"Row cap the caller's plan applied to this page, if any"},"returned":{"type":"integer"},"total_count":{"anyOf":[{"$ref":"#/properties/rows/items/properties/rank/anyOf/0"},{"type":"null"}],"description":"Total rows matching the request, when ko.io reported it"},"truncated_by_plan":{"description":"True when the plan's row cap withheld rows from this page","type":"boolean"}},"required":["page","per_page","returned","total_count","has_more","next_page","continuation","plan_row_cap","truncated_by_plan"],"type":"object"},"plan_limit":{"anyOf":[{"additionalProperties":false,"properties":{"continuation":{"$ref":"#/properties/search"},"date_basis":{"$ref":"#/properties/search"},"effective_period":{"$ref":"#/properties/search"},"policy_version":{"$ref":"#/properties/search"},"row_cap":{"$ref":"#/properties/rows/items/properties/rank"},"truncated":{"type":["boolean","null"]},"window_end":{"$ref":"#/properties/search"},"window_start":{"$ref":"#/properties/search"}},"required":["policy_version","window_start","window_end","effective_period","date_basis","row_cap","truncated","continuation"],"type":"object"},{"type":"null"}],"description":"The Free/keyless plan limits ko.io applied to this answer (null for paid callers)"},"rows":{"items":{"additionalProperties":false,"properties":{"category":{"$ref":"#/properties/search"},"cik":{"$ref":"#/properties/search"},"name":{"$ref":"#/properties/search"},"portfolio_value":{"anyOf":[{"pattern":"^-?\\d+(\\.\\d+)?([eE][-+]?\\d+)?$","type":"string"},{"type":"null"}],"description":"Exact decimal string as served by ko.io (not rounded); null = unknown"},"rank":{"anyOf":[{"type":"integer"},{"type":"null"}]},"slug":{"$ref":"#/properties/search"},"stock_count":{"$ref":"#/properties/rows/items/properties/rank"}},"required":["cik","name","slug","rank","category","portfolio_value","stock_count"],"type":"object"},"type":"array"},"search":{"type":["string","null"]}},"required":["search","rows","paging","plan_limit"],"type":"object"}before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true}before
—after
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"congress":{"items":{"additionalProperties":false,"properties":{"name":{"$ref":"#/properties/institutions/items/properties/cik"},"type":{"$ref":"#/properties/institutions/items/properties/cik"}},"required":["name","type"],"type":"object"},"type":"array"},"insiders":{"items":{"additionalProperties":false,"properties":{"name":{"$ref":"#/properties/institutions/items/properties/cik"},"ticker":{"$ref":"#/properties/institutions/items/properties/cik"},"type":{"$ref":"#/properties/institutions/items/properties/cik"}},"required":["name","ticker","type"],"type":"object"},"type":"array"},"institutions":{"items":{"additionalProperties":false,"properties":{"aum":{"anyOf":[{"pattern":"^-?\\d+(\\.\\d+)?([eE][-+]?\\d+)?$","type":"string"},{"type":"null"}],"description":"Exact decimal string as served by ko.io (not rounded); null = unknown"},"category":{"$ref":"#/properties/institutions/items/properties/cik"},"cik":{"type":["string","null"]},"matched_person":{"anyOf":[{"additionalProperties":false,"properties":{"name":{"$ref":"#/properties/institutions/items/properties/cik"},"role":{"$ref":"#/properties/institutions/items/properties/cik"}},"required":["name","role"],"type":"object"},{"type":"null"}]},"name":{"$ref":"#/properties/institutions/items/properties/cik"},"rank":{"anyOf":[{"type":"integer"},{"type":"null"}]},"slug":{"$ref":"#/properties/institutions/items/properties/cik"}},"required":["cik","name","slug","category","aum","rank","matched_person"],"type":"object"},"type":"array"},"query":{"type":"string"},"stocks":{"items":{"additionalProperties":false,"properties":{"industry":{"$ref":"#/properties/institutions/items/properties/cik"},"market_cap":{"$ref":"#/properties/institutions/items/properties/aum"},"name":{"$ref":"#/properties/institutions/items/properties/cik"},"sector":{"$ref":"#/properties/institutions/items/properties/cik"},"ticker":{"$ref":"#/properties/institutions/items/properties/cik"}},"required":["ticker","name","sector","industry","market_cap"],"type":"object"},"type":"array"}},"required":["query","institutions","stocks","insiders","congress"],"type":"object"}before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true}⟨38 unchanged words⟩ open the link or request a specific section. Requires a paid ko.io plan (Pro): on Free or keyless access the call returns an explicit plan-limit error. Use sec_list_filings / sec_get_filing_index (open on every plan) to find filings and their files.
before
—after
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"accession_no":{"type":"string"},"cik":{"type":"string"},"excerpt":{"additionalProperties":false,"properties":{"chars_total":{"anyOf":[{"type":"integer"},{"type":"null"}]},"status":{"enum":["ok","unavailable","not_requested"],"type":"string"},"text":{"$ref":"#/properties/file"},"truncated":{"type":["boolean","null"]}},"required":["status","text","chars_total","truncated"],"type":"object"},"file":{"type":["string","null"]},"link":{"additionalProperties":false,"properties":{"expires_at":{"$ref":"#/properties/file"},"signed":{"description":"true = ko.io-signed, expiring link a browser can open; false = needs a paid API key","type":"boolean"},"url":{"type":"string"}},"required":["url","signed","expires_at"],"type":"object"}},"required":["cik","accession_no","file","link","excerpt"],"type":"object"}before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true}before
—after
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"accession":{"$ref":"#/properties/cik"},"cik":{"type":["string","null"]},"files":{"items":{"additionalProperties":false,"properties":{"last_modified":{"$ref":"#/properties/cik"},"name":{"$ref":"#/properties/cik"},"size_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}]},"type":{"$ref":"#/properties/cik"}},"required":["name","type","size_bytes","last_modified"],"type":"object"},"type":"array"}},"required":["cik","accession","files"],"type":"object"}before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true}before
—after
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"cik":{"type":"string"},"filters":{"additionalProperties":false,"properties":{"form_type":{"type":["string","null"]},"from":{"$ref":"#/properties/filters/properties/form_type"},"to":{"$ref":"#/properties/filters/properties/form_type"}},"required":["form_type","from","to"],"type":"object"},"rows":{"items":{"additionalProperties":false,"properties":{"accession":{"$ref":"#/properties/filters/properties/form_type"},"description":{"$ref":"#/properties/filters/properties/form_type"},"filing_date":{"$ref":"#/properties/filters/properties/form_type"},"form":{"$ref":"#/properties/filters/properties/form_type"},"primary_document":{"$ref":"#/properties/filters/properties/form_type"}},"required":["filing_date","form","accession","primary_document","description"],"type":"object"},"type":"array"}},"required":["cik","filters","rows"],"type":"object"}before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true}⟨40 unchanged words⟩ 3650,"minimum":1,"type":"integer"},"limit":{"default":100,"description":"Rows per page, 1-500 (default 100). A long `days` window can hold more rows than one page; the answer says when the page is full and names the next one.","maximum":500,"minimum":1,"type":"integer"},"page":{"default":1,"description":"Page number (default 1)","minimum":1,"type":"integer"}},"type":"object"}
⟨18 unchanged words⟩ 3650,"minimum":1,"type":"integer"},"limit":{"default":100,"description":"Rows per page, 1-500 (default 100). A long `days` window can hold more rows than one page; the answer says when the page is full and names the next one.","maximum":500,"minimum":1,"type":"integer"},"page":{"default":1,"description":"Page number (default 1)","minimum":1,"type":"integer"}},"type":"object"}
⟨19 unchanged words⟩ "minimum":1,"type":"integer"},"limit":{"default":100,"description":"Rows per page, 1-500 (default 100). A long `days` window can hold more rows than one page; the answer says when the page is full and names the next one.","maximum":500,"minimum":1,"type":"integer"},"page":{"default":1,"description":"Page number (default 1)","minimum":1,"type":"integer"},"ticker":{"description":"Stock ticker symbol ( ⟨11 unchanged words⟩
⟨17 unchanged words⟩ "limit":{"default":50,"description":"MaxTradestradespertopage,return1-200","maximum":200,"minimum":1,"type":"integer"},"page":{"default":1,"description":"Page number","minimum":1,"type":"integer"}, ⟨15 unchanged words⟩