BeliefState is an MCP server published by ai.beliefstate, hosted at beliefstate.ai. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 23 tools, including get_brief, get_case, get_cases, get_catalysts, get_changes.
26 account tools; 23 wallet tools (20 paid). Free company snapshots and cited research.
2 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Read a cited research brief for a covered U.S. ticker, ETF or released subject. Overview, current and full views support dated research and historical cutoffs. An explicit refresh requires current stock and SPY prices before payment. Per-call x402 price: 0.02 USDC on Base.
| Parameter | Type | Description |
|---|---|---|
| as_of | string | |
| cursor | string | |
| detail | string | Issuer_evidence lists retained SEC filing captures. To inspect a document, reuse its as_of with issuer_document_id and a literal issuer_query; continue with issuer_match_offset. This is a stored, metered evidence read without collection or model calls. Current returns up to three reviewed current Be… |
| ticker | string | |
| entity_id | string | Released subject ID returned by get_subjects. |
| max_results | integer | Maximum returned views. Overview returns at most five (default five); larger valid requests are capped at five with explicit returned and omitted counts. Full supports 1–20. Omit for an ordinary overview. |
| issuer_query | string | Literal phrase to find across one complete retained SEC document. Returns up to five cited excerpts, including beyond cached text prefixes; no raw document export. |
| issuer_document_id | string | For detail=issuer_evidence, select a document_id returned by its inventory; also pass the returned as_of and a literal issuer_query. |
| issuer_match_offset | integer | Continue with next_match_offset and unchanged ticker, as_of, issuer_document_id and issuer_query. Each read uses normal research allowance or credit. |
| refresh_market_data | boolean | Current briefs serve prepared research and refresh a missing or stale requested-stock quote by default. Set false to retain stored quotes. Daily paths and benchmark context refresh during preparation. Historical reads never refresh. |
{
"name": "get_brief",
"title": "Get research brief",
"description": "Read a cited research brief for a covered U.S. ticker, ETF or released subject. Overview, current and full views support dated research and historical cutoffs. An explicit refresh requires current stock and SPY prices before payment. Per-call x402 price: 0.02 USDC on Base.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"as_of": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"cursor": {
"type": "string",
"maxLength": 4096
},
"detail": {
"enum": [
"overview",
"full",
"current",
"issuer_evidence"
],
"type": "string",
"description": "Issuer_evidence lists retained SEC filing captures. To inspect a document, reuse its as_of with issuer_document_id and a literal issuer_query; continue with issuer_match_offset. This is a stored, metered evidence read without collection or model calls. Current returns up to three reviewed current Beliefs with up to three Risks and three Catalysts each, direct evidence URLs, clocks and explicit unknowns under 32KiB. Attached open Risks or materialized Risks with supported continuing relevance qualify, without age/severity exclusion; unknown concerns remain separately qualified. Selection reserves opposing views, then distinct stances, effective/publication recency, observed recency and stable ID. Omitted whole cases have continuations/detail references. Current is a stored read and cannot refresh. Start with overview for research questions: it includes complete selected cases, dated developments, assessment and citations. Full is for a complete machine export; oversized full company reads through MCP return an explicitly bounded overview with case IDs for get_case drill-down. REST detail=full retains the export. Fund briefs return fund_overview for either value."
},
"ticker": {
"type": "string",
"maxLength": 32,
"minLength": 1
},
"entity_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "Released subject ID returned by get_subjects."
},
"max_results": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "Maximum returned views. Overview returns at most five (default five); larger valid requests are capped at five with explicit returned and omitted counts. Full supports 1–20. Omit for an ordinary overview."
},
"issuer_query": {
"type": "string",
"maxLength": 200,
"minLength": 3,
"description": "Literal phrase to find across one complete retained SEC document. Returns up to five cited excerpts, including beyond cached text prefixes; no raw document export."
},
"issuer_document_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "For detail=issuer_evidence, select a document_id returned by its inventory; also pass the returned as_of and a literal issuer_query."
},
"issuer_match_offset": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Continue with next_match_offset and unchanged ticker, as_of, issuer_document_id and issuer_query. Each read uses normal research allowance or credit."
},
"refresh_market_data": {
"type": "boolean",
"description": "Current briefs serve prepared research and refresh a missing or stale requested-stock quote by default. Set false to retain stored quotes. Daily paths and benchmark context refresh during preparation. Historical reads never refresh."
}
},
"additionalProperties": false
},
"outputSchema": {
"truncated": true,
"chars": 166910
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Retrieves one complete investment case by returned belief_id: investor, reasoning, evidence, risks, catalysts, conditions, revisions, outcomes, provenance and coverage gaps. Useful for deeper follow-ups; start company overviews with get_brief. Use paragraph_index only when returned in investment_case and follow support/text offsets for exact evidence. Optional relationship_paths inspects supported dependencies; scenario applies up to eight hypothetical conditions. Both preserve evidence and investor statements. Per-call x402 price: 0.02 USDC on Base.
| Parameter | Type | Description |
|---|---|---|
| as_of | string | |
| scenario | object | Optional hypothetical condition assumptions for this belief. Does not change evidence or predict the investor's response. REST: JSON-encode this query parameter. |
| belief_id * | string | |
| support_index | integer | Source support within the selected paragraph; defaults to 0. Use next_support_index for another passage. |
| paragraph_index | integer | Read exact source support only for a paragraph_index present in the returned investment_case. Records without investment_case do not support this selector. Requires belief_id. Continue with returned as_of and support/text offsets. |
| relationship_paths | object | Inspect directed edge sequences within this Belief's originating case. Maximum depth is 3; edge_budget bounds examined edge steps. Requires belief_id. REST: JSON-encode relationship_paths. |
Retrieves dated investment cases for one company or research subject, with optional investor, direction and time filters. Returns attributed thesis records, case IDs, dates, citations and coverage information. Use get_brief first for who covers a ticker and what each investor thinks. Use get_cases for an article-by-article inventory. Each page costs a request. Continue only if the user wants more pages, using unchanged selectors and the returned cursor. Use get_search_results for a thesis or topic question. Per-call x402 price: 0.02 USDC on Base.
| Parameter | Type | Description |
|---|---|---|
| as_of | string | |
| limit | integer | Requested page size. For ticker/entity belief lists, MCP returns up to twelve complete summaries within its response budget; pagination.limit is the effective size. Continue with next_cursor and the same ticker/entity_id. REST supports larger pages. |
| cursor | string | |
| status | string | one of ["forming","active","strengthened","weakened","reversed","resolved","abandoned","unknown"] |
| ticker | string | |
| direction | string | one of ["bullish","bearish","mixed","neutral","non_directional","unknown"] |
| entity_id | string | Released subject ID returned by get_subjects. |
| person_id | string |
Retrieves evidence-linked catalysts for one company, research subject, investment case or the explicitly selected released corpus. Returns recorded conditions, lifecycle status, dates and supporting evidence. Useful for checking which thesis events remain pending, were met or missed, or have been superseded. Filter by investor, source, publication dates or status. Unassessed conditions retain unknown status. Continue with the returned cursor and unchanged filters. Per-call x402 price: 0.02 USDC on Base.
| Parameter | Type | Description |
|---|---|---|
| as_of | string | |
| limit | integer | |
| corpus | string | |
| cursor | string | |
| ticker | string | |
| belief_id | string | |
| entity_id | string | |
| person_id | string | |
| source_id | string | |
| object_status | string | |
| published_from | string |
Retrieves the ordered research change journal for a company, subject, case or explicitly selected released corpus. Returns dated events, citations and available before/after values, separating author revisions, distribution changes and calculated publication outcomes. Use domain=author_view for investor-view changes and revision_only=true for authored revisions only; get_brief provides a current synthesis. Preserve publication, observation and availability clocks. Drain a requested window with unchanged selectors; its continuation cursor differs from the completed next-poll checkpoint. Coverage and resynchronization gaps remain explicit. Per-call x402 price: 0.02 USDC on Base.
| Parameter | Type | Description |
|---|---|---|
| as_of | string | |
| limit | integer | |
| corpus | string | |
| cursor | string | |
| domain | string | one of ["author_view","author_condition","engine_assessment","calculated_publication_outcome","distribution","identity_resolution","provenance","engine_quality","engine_plan"] |
| resync | boolean | |
| ticker | string | |
| belief_id | string | |
| entity_id | string |
Find SEC-registered U.S. companies and selected verified international listings by symbol or name. Search by market, sector or exchange-qualified symbol, such as Indian banks, Canadian stocks or XTAI:2330. Listing identity and released investor research are reported separately. Free.
| Parameter | Type | Description |
|---|---|---|
| q * | string | Search the current SEC company directory by ticker or name, independently of direct research coverage. Omit as_of. |
{
"name": "get_companies",
"title": "Get companies",
"description": "Find SEC-registered U.S. companies and selected verified international listings by symbol or name. Search by market, sector or exchange-qualified symbol, such as Indian banks, Canadian stocks or XTAI:2330. Listing identity and released investor research are reported separately. Free.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Search the current SEC company directory by ticker or name, independently of direct research coverage. Omit as_of."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$defs": {
"0": {
"type": "string",
"format": "date-time",
"$anchor": "a0",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"1": {
"type": [
"string",
"null"
],
"$anchor": "a3"
},
"2": {
"type": "string",
"$anchor": "a1",
"minLength": 1
},
"3": {
"type": "array",
"items": {
"type": "string"
},
"$anchor": "a5"
},
"4": {
"type": "string",
"format": "uri",
"$anchor": "a2"
},
"5": {
"type": "integer",
"$anchor": "a4",
"maximum": 9007199254740991,
"minimum": 0
},
"6": {
"anyOf": [
{
"$ref": "#a0"
},
{
"type": "null"
}
],
"$anchor": "a6"
},
"7": {
"anyOf": [
{
"$ref": "#/$defs/9"
},
{
"type": "null"
}
],
"$anchor": "a7"
},
"8": {
"type": "array",
"items": {
"$ref": "#a1"
}
},
"9": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
"a": {
"anyOf": [
{
"$ref": "#a1"
},
{
"type": "null"
}
]
},
"b": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
},
"anyOf": [
{
"required": [
"schema_version",
"generated_at",
"as_of",
"resource",
"tickers",
"totals",
"coverage"
],
"properties": {
"as_of": {
"$ref": "#a0"
},
"totals": {
"type": "object",
"required": [
"ticker_count",
"belief_count"
],
"properties": {
"belief_count": {
"$ref": "#a4"
},
"ticker_count": {
"$ref": "#a4"
}
},
"additionalProperties": false
},
"tickers": {
"$ref": "#/$defs/8"
},
"coverage": {
"type": "array",
"items": {
"type": "object",
"required": [
"ticker",
"security_id",
"security_name",
"release_state",
"release_effective_at",
"belief_count",
"investor_count",
"first_belief_observed_at",
"latest_belief_observed_at"
],
"properties": {
"ticker": {
"$ref": "#a1"
},
"security_id": {
"$ref": "#a1"
},
"belief_count": {
"$ref": "#/$defs/b"
},
"release_state": {
"const": "released"
},
"security_name": {
"$ref": "#a1"
},
"investor_count": {
"$ref": "#/$defs/b"
},
"security_exchange": {
"$ref": "#/$defs/a"
},
"release_effective_at": {
"$ref": "#a0"
},
"first_belief_observed_at": {
"$ref": "#a0"
},
"latest_belief_observed_at": {
"$ref": "#a0"
}
},
"additionalProperties": false
}
},
"resource": {
"const": "beliefs"
},
"tracking": {
"type": "object",
"required": [
"limit",
"active",
"paused",
"unavailable",
"manage_url"
],
"properties": {
"limit": {
"$ref": "#a4"
},
"active": {
"$ref": "#a4"
},
"paused": {
"$ref": "#a5"
},
"changes": {
"type": "object",
"required": [
"checked_at",
"macro_since",
"companies",
"changes",
"omitted_changes",
"unavailable_macro_feeds",
"limitations"
],
"properties": {
"changes": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"kind",
"ticker",
"title",
"source_url",
"publisher",
"published_at",
"published_on",
"observed_at",
"available_at",
"fiscal_period",
"scheduled_on",
"actuals",
"guidance"
],
"properties": {
"id": {
"type": "string"
},
"kind": {
"enum": [
"earnings_results",
"earnings_schedule",
"guidance",
"macro_release"
]
},
"title": {
"type": "string"
},
"ticker": {
"$ref": "#a3"
},
"actuals": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"value",
"unit",
"period_start",
"period_end",
"source_url"
],
"properties": {
"unit": {
"type": "string"
},
"label": {
"type": "string"
},
"value": {
"type": "string"
},
"period_end": {
"$ref": "#/$defs/9"
},
"source_url": {
"$ref": "#a2"
},
"period_start": {
"$ref": "#a7"
}
},
"additionalProperties": false
},
"maxItems": 6
},
"guidance": {
"anyOf": [
{
"type": "object",
"required": [
"status",
"point",
"lower",
"upper",
"unit",
"basis",
"range_origin",
"qualifications"
],
"properties": {
"unit": {
"$ref": "#a3"
},
"basis": {
"type": "string"
},
"lower": {
"$ref": "#a3"
},
"point": {
"$ref": "#a3"
},
"upper": {
"$ref": "#a3"
},
"status": {
"enum": [
"unspecified",
"revised",
"reaffirmed",
"withdrawn"
]
},
"range_origin": {
"enum": [
"reported",
"computed_from_reported_tolerance",
"none"
]
},
"qualifications": {
"$ref": "#a5"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"publisher": {
"type": "string"
},
"source_url": {
"$ref": "#a2"
},
"observed_at": {
"$ref": "#a0"
},
"available_at": {
"$ref": "#a6"
},
"published_at": {
"$ref": "#a6"
},
"published_on": {
"$ref": "#a7"
},
"scheduled_on": {
"$ref": "#a7"
},
"fiscal_period": {
"$ref": "#a3"
}
},
"additionalProperties": false
},
"maxItems": 50
},
"companies": {
"type": "array",
"items": {
"type": "object",
"required": [
"ticker",
"since",
"basis",
"earnings_filings_checked_at",
"guidance_checked_at"
],
"properties": {
"basis": {
"enum": [
"saved_review",
"saved_outlook",
"recent_window"
]
},
"since": {
"$ref": "#a0"
},
"ticker": {
"type": "string"
},
"guidance_checked_at": {
"$ref": "#a6"
},
"earnings_filings_checked_at": {
"$ref": "#a6"
}
},
"additionalProperties": false
}
},
"checked_at": {
"$ref": "#a0"
},
"limitations": {
"$ref": "#a5"
},
"macro_since": {
"$ref": "#a6"
},
"omitted_changes": {
"$ref": "#a4"
},
"unavailable_macro_feeds": {
"$ref": "#a5"
}
},
"additionalProperties": false
},
"manage_url": {
"type": "string"
},
"unavailable": {
"$ref": "#a5"
},
"related_or_pending": {
"$ref": "#a5"
}
},
"additionalProperties": false
},
"discovery": {
"type": "object",
"required": [
"query",
"scope",
"source_url",
"results"
],
"properties": {
"query": {
"type": "string"
},
"scope": {
"const": "sec_registered_us_listings"
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"ticker",
"name",
"exchange",
"cik",
"direct_research"
],
"properties": {
"cik": {
"type": "number"
},
"name": {
"type": "string"
},
"ticker": {
"type": "string"
},
"exchange": {
"$ref": "#a3"
},
"direct_research": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"source_url": {
"$ref": "#a2"
}
},
"additionalProperties": false
},
"limitations": {
"$ref": "#/$defs/8"
},
"generated_at": {
"$ref": "#a0"
},
"coverage_scope": {
"enum": [
"released_library",
"query_matches"
]
},
"fund_discovery": {
"type": "object",
"required": [
"query",
"scope",
"results",
"limitation"
],
"properties": {
"query": {
"type": "string"
},
"scope": {
"const": "fund_identity"
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"ticker",
"name",
"source_url",
"research_tool"
],
"properties": {
"name": {
"type": "string"
},
"ticker": {
"type": "string"
},
"source_url": {
"$ref": "#a2"
},
"research_tool": {
"const": "get_brief"
}
},
"additionalProperties": false
}
},
"limitation": {
"type": "string"
}
},
"additionalProperties": false
},
"schema_version": {
"const": "1"
},
"listing_references": {
"type": "object",
"required": [
"query",
"scope",
"results"
],
"properties": {
"query": {
"type": "string"
},
"scope": {
"const": "venue_qualified_pilot"
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"selector",
"ticker",
"exchange",
"country",
"currency",
"isin",
"name",
"instrument",
"source_url"
],
"properties": {
"isin": {
"type": "string",
"maxLength": 12,
"minLength": 12
},
"name": {
"type": "string"
},
"ticker": {
"type": "string"
},
"country": {
"type": "string",
"maxLength": 2,
"minLength": 2
},
"currency": {
"type": "string",
"maxLength": 3,
"minLength": 3
},
"exchange": {
"type": "string",
"maxLength": 4,
"minLength": 4
},
"selector": {
"type": "string"
},
"instrument": {
"enum": [
"ordinary_share",
"depositary_share",
"preferred_share"
]
},
"source_url": {
"$ref": "#a2"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message",
"recovery",
"retryable"
],
"properties": {
"code": {
"enum": [
"unauthorized",
"invalid_input",
"entity_not_found",
"entity_ambiguous",
"outside_entitlement",
"rate_limited",
"data_unavailable",
"insufficient_sample",
"unsupported_security",
"duplicate_request"
]
},
"message": {
"$ref": "#a1"
},
"recovery": {
"$ref": "#/$defs/a"
},
"retryable": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
},
"annotations": {
"title": "Get companies",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Returns retained financial facts, company references, segment metrics, operating KPIs, management guidance and site milestones for one ticker. Use record_type=site_milestone for cited permit, contract, delivery and billing stages and source-specific dates. Use fiscal_year/fiscal_quarter for fiscal periods and date_field=report for issuance. Guidance is a forecast; reported tolerances and computed bounds stay separate. Inspect available_issuer_selectors for empty metric or dimension results. Coverage is bounded. Current archive reads recheck stale metadata. Historical and pinned reads use saved records. Reuse snapshot, cutoff and filters with the returned cursor or next_offset. Per-call x402 price: 0.02 USDC on Base.
| Parameter | Type | Description |
|---|---|---|
| site | string | Site name substring. Requires site_milestone. |
| unit | string | |
| as_of | string | Availability cutoff, separate from event/period filters. Historical reads never refresh. |
| basis | string | Accounting or operating basis; requires an issuer-metric record_type. |
| limit | integer | Matching typed observations per page; default32. |
| cursor | string | Archive continuation token; reuse with snapshot ID/hash, as_of and unchanged filters. |
| family | string | one of ["financial","market_reference","site_milestones"] |
| offset | integer |
Retrieves a cited engine comparison of two distinct investment cases using their returned belief_id and compare_to_belief_id. Returns a cited engine assessment of support, contradiction, dependency, unknown or unrelated reasoning, with assessment time and case cutoff. Useful for examining opposing views or investment alternatives. Optional comparison_focus narrows the assessment to a public research proposition present in both cases. Engine assessments remain separate from investor statements; shared sources qualify the independence of support. Per-call x402 price: 0.50 USDC on Base.
| Parameter | Type | Description |
|---|---|---|
| as_of | string | |
| belief_id * | string | |
| comparison_focus | string | Optional public research topic or proposition to compare within both complete cases. Supply a topic, not a desired relation, private portfolio information or instructions. Other relations in the cases are outside this focused assessment. |
| compare_to_belief_id * | string |
{
"name": "get_comparison",
"title": "Get case comparison",
"description": "Retrieves a cited engine comparison of two distinct investment cases using their returned belief_id and compare_to_belief_id. Returns a cited engine assessment of support, contradiction, dependency, unknown or unrelated reasoning, with assessment time and case cutoff. Useful for examining opposing views or investment alternatives. Optional comparison_focus narrows the assessment to a public research proposition present in both cases. Engine assessments remain separate from investor statements; shared sources qualify the independence of support. Per-call x402 price: 0.50 USDC on Base.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"belief_id",
"compare_to_belief_id"
],
"properties": {
"as_of": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"belief_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"comparison_focus": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "Optional public research topic or proposition to compare within both complete cases. Supply a topic, not a desired relation, private portfolio information or instructions. Other relations in the cases are outside this focused assessment."
},
"compare_to_belief_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$defs": {
"0": {
"type": "string",
"$anchor": "a0",
"minLength": 1
},
"1": {
"type": "string",
"format": "date-time",
"$anchor": "a3",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"2": {
"type": "string",
"format": "uuid",
"$anchor": "a1",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"3": {
"type": "string",
"format": "uri",
"$anchor": "a2"
},
"4": {
"type": "array",
"items": {
"$ref": "#a0"
},
"$anchor": "a4"
},
"5": {
"anyOf": [
{
"$ref": "#a0"
},
{
"type": "null"
}
],
"$anchor": "a5"
},
"6": {
"type": "object",
"$anchor": "a6",
"additionalProperties": {}
},
"7": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"8": {
"anyOf": [
{
"type": "string",
"maxLength": 1200,
"minLength": 1
},
{
"type": "null"
}
]
},
"9": {
"type": "array",
"items": {
"type": "integer",
"maximum": 7,
"minimum": 0
},
"maxItems": 8
},
"a": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"b": {
"type": "array",
"items": {
"$ref": "#a1"
},
"maxItems": 8
}
},
"anyOf": [
{
"required": [
"schema_version",
"methodology_version",
"generated_at",
"as_of",
"resource",
"view",
"data",
"citations",
"limitations"
],
"properties": {
"data": {
"type": "object",
"required": [
"status",
"comparison_focus",
"source_independence",
"case_snapshot_as_of",
"assessment",
"cases",
"comparison"
],
"properties": {
"cases": {
"type": "array",
"items": {
"type": "object",
"required": [
"belief_id",
"ticker",
"entity_id",
"subject",
"investor",
"first_observed_at",
"effective_at",
"time_horizon",
"passages"
],
"properties": {
"ticker": {
"type": [
"string",
"null"
]
},
"subject": {
"$ref": "#a0"
},
"investor": {
"$ref": "#a0"
},
"passages": {
"type": "array",
"items": {
"type": "object",
"required": [
"passage_id",
"text",
"available_at",
"citation_ids"
],
"properties": {
"text": {
"type": "string",
"maxLength": 4000,
"minLength": 1
},
"passage_id": {
"$ref": "#a1"
},
"available_at": {
"$ref": "#a3"
},
"citation_ids": {
"type": "array",
"items": {
"$ref": "#a0"
},
"minItems": 1
}
},
"additionalProperties": false
},
"maxItems": 8,
"minItems": 1
},
"belief_id": {
"$ref": "#a1"
},
"entity_id": {
"anyOf": [
{
"$ref": "#a1"
},
{
"type": "null"
}
]
},
"effective_at": {
"$ref": "#a3"
},
"time_horizon": {
"type": [
"string",
"null"
]
},
"first_observed_at": {
"$ref": "#a3"
}
},
"additionalProperties": false
},
"maxItems": 2
},
"status": {
"enum": [
"available",
"unavailable"
]
},
"assessment": {
"anyOf": [
{
"type": "object",
"required": [
"id",
"hash",
"recorded_at",
"model_completion_ids"
],
"properties": {
"id": {
"$ref": "#a1"
},
"hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"recorded_at": {
"$ref": "#a3"
},
"model_completion_ids": {
"type": "array",
"items": {
"$ref": "#a1"
},
"maxItems": 2,
"minItems": 2
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"comparison": {
"anyOf": [
{
"type": "object",
"required": [
"kind",
"dependency_direction",
"left_proposition",
"right_proposition",
"left_passage_indexes",
"right_passage_indexes",
"relevant_period",
"rationale",
"uncertainty",
"derivation",
"from_belief_id",
"to_belief_id",
"left_support_passage_ids",
"right_support_passage_ids"
],
"properties": {
"kind": {
"enum": [
"supports",
"contradicts",
"depends_on",
"unknown",
"unrelated"
]
},
"rationale": {
"type": "string",
"maxLength": 1600,
"minLength": 1
},
"derivation": {
"const": "engine_inferred"
},
"uncertainty": {
"type": "array",
"items": {
"$ref": "#/$defs/a"
},
"maxItems": 8,
"minItems": 1
},
"to_belief_id": {
"$ref": "#a1"
},
"from_belief_id": {
"$ref": "#a1"
},
"relevant_period": {
"anyOf": [
{
"$ref": "#/$defs/a"
},
{
"type": "null"
}
]
},
"left_proposition": {
"$ref": "#/$defs/8"
},
"right_proposition": {
"$ref": "#/$defs/8"
},
"dependency_direction": {
"anyOf": [
{
"enum": [
"left_on_right",
"right_on_left"
]
},
{
"type": "null"
}
]
},
"left_passage_indexes": {
"$ref": "#/$defs/9"
},
"right_passage_indexes": {
"$ref": "#/$defs/9"
},
"left_support_passage_ids": {
"$ref": "#/$defs/b"
},
"right_support_passage_ids": {
"$ref": "#/$defs/b"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"comparison_focus": {
"anyOf": [
{
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "Optional public research topic or proposition to compare within both complete cases. Supply a topic, not a desired relation, private portfolio information or instructions. Other relations in the cases are outside this focused assessment."
},
{
"type": "null"
}
]
},
"case_snapshot_as_of": {
"$ref": "#a3"
},
"source_independence": {
"anyOf": [
{
"type": "object",
"required": [
"status",
"same_attributed_investor",
"shared_evidence_ids",
"shared_source_urls",
"shared_source_revision_ids",
"shared_source_content_hashes",
"explanation",
"methodology_version"
],
"properties": {
"status": {
"const": "not_established"
},
"explanation": {
"$ref": "#a0"
},
"shared_source_urls": {
"type": "array",
"items": {
"$ref": "#a2"
}
},
"methodology_version": {
"$ref": "#/$defs/7"
},
"shared_evidence_ids": {
"$ref": "#a4"
},
"same_attributed_investor": {
"type": "boolean"
},
"shared_source_revision_ids": {
"$ref": "#a4"
},
"shared_source_content_hashes": {
"$ref": "#a4"
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Observed attribution, Evidence, URL, revision and content-hash overlap in the two authorized cases. Different authors, URLs, or Evidence IDs never prove independent research; a supports relation is not independent corroboration."
}
},
"additionalProperties": false
},
"view": {
"const": "compare"
},
"as_of": {
"$ref": "#a3"
},
"resource": {
"const": "beliefs"
},
"citations": {
"type": "array",
"items": {
"type": "object",
"required": [
"citation_id",
"evidence_id",
"source_url",
"source_title",
"author_name",
"published_at",
"observed_at",
"excerpt"
],
"properties": {
"excerpt": {
"$ref": "#a5"
},
"source_url": {
"$ref": "#a2"
},
"author_name": {
"$ref": "#a5"
},
"citation_id": {
"$ref": "#a0"
},
"evidence_id": {
"$ref": "#a0"
},
"observed_at": {
"$ref": "#a3"
},
"published_at": {
"anyOf": [
{
"$ref": "#a3"
},
{
"type": "null"
}
]
},
"source_title": {
"$ref": "#a0"
},
"full_document_stored": {
"type": [
"boolean",
"null"
],
"description": "Recorded storage flag, separate from verified source completeness. Null or absent means unknown."
},
"source_text_coverage": {
"anyOf": [
{
"enum": [
"partial",
"feed_body_field_unverified",
"context_article_unverified"
]
},
{
"type": "null"
}
],
"description": "Stored source-capture scope. Null or absent means unknown; no value here verifies complete article coverage."
}
},
"additionalProperties": false
}
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"generated_at": {
"$ref": "#a3"
},
"billing_notice": {
"type": "object",
"required": [
"code",
"message",
"remaining_requests",
"add_credits_url",
"plans_url"
],
"properties": {
"code": {
"const": "signup_credit_exhausted"
},
"message": {
"$ref": "#a0"
},
"plans_url": {
"$ref": "#a2"
},
"add_credits_url": {
"$ref": "#a2"
},
"remaining_requests": {
"const": 0
}
},
"additionalProperties": false
},
"schema_version": {
"const": "1"
},
"methodology_version": {
"$ref": "#/$defs/7"
}
},
"additionalProperties": false
},
{
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message",
"recovery",
"retryable"
],
"properties": {
"code": {
"enum": [
"unauthorized",
"invalid_input",
"entity_not_found",
"entity_ambiguous",
"outside_entitlement",
"rate_limited",
"data_unavailable",
"insufficient_sample",
"unsupported_security",
"duplicate_request"
]
},
"message": {
"$ref": "#a0"
},
"recovery": {
"$ref": "#a5"
},
"retryable": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"required": [
"accepts",
"resource",
"x402Version"
],
"properties": {
"error": {
"type": "string"
},
"accepts": {
"type": "array",
"items": {
"type": "object",
"required": [
"amount",
"asset",
"maxTimeoutSeconds",
"network",
"payTo",
"scheme"
],
"properties": {
"asset": {
"$ref": "#a0"
},
"extra": {
"$ref": "#a6"
},
"payTo": {
"$ref": "#a0"
},
"amount": {
"type": "string",
"pattern": "^\\d+$"
},
"scheme": {
"enum": [
"exact"
]
},
"network": {
"type": "string",
"pattern": "^eip155:\\d+$"
},
"maxTimeoutSeconds": {
"type": "number"
}
},
"additionalProperties": false
},
"minItems": 1
},
"resource": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"$ref": "#a0"
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"iconUrl": {
"type": "string"
},
"mimeType": {
"type": "string"
},
"description": {
"type": "string"
},
"serviceName": {
"type": "string"
}
},
"additionalProperties": false
},
"extensions": {
"type": "object",
"additionalProperties": {
"type": "object",
"required": [
"info",
"schema"
],
"properties": {
"info": {
"$ref": "#a6"
},
"schema": {
"$ref": "#a6"
}
},
"additionalProperties": false
}
},
"x402Version": {
"const": 2
}
},
"additionalProperties": false
},
{
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"enum": [
"payment_pending",
"rate_limited"
]
},
"message": {
"$ref": "#a0"
},
"retryable": {
"const": true
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Retrieves a dated engine context assessment by its returned assessment identifier, including permitted supporting evidence and coverage limitations. Useful for examining the issuer, market or event context cited in a brief or investment case. Assessment time and evidence dates remain explicit; the engine's interpretation is separate from the investor's stated thesis. Per-call x402 price: 0.02 USDC on Base.
| Parameter | Type | Description |
|---|---|---|
| as_of | string | |
| context_assessment_id * | string |
{
"name": "get_context_assessment",
"title": "Get context assessment",
"description": "Retrieves a dated engine context assessment by its returned assessment identifier, including permitted supporting evidence and coverage limitations. Useful for examining the issuer, market or event context cited in a brief or investment case. Assessment time and evidence dates remain explicit; the engine's interpretation is separate from the investor's stated thesis. Per-call x402 price: 0.02 USDC on Base.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"context_assessment_id"
],
"properties": {
"as_of": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"context_assessment_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$defs": {
"0": {
"type": "string",
"$anchor": "a0",
"minLength": 1
},
"1": {
"type": [
"string",
"null"
],
"$anchor": "a7"
},
"2": {
"type": "string",
"format": "uuid",
"$anchor": "a2",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"3": {
"type": "string",
"format": "date-time",
"$anchor": "a1",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"4": {
"type": "string",
"$anchor": "ac",
"pattern": "^[a-f0-9]{64}$"
},
"5": {
"type": "array",
"items": {
"$ref": "#a0"
},
"$anchor": "aa"
},
"6": {
"type": "integer",
"$anchor": "a6",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"7": {
"anyOf": [
{
"$ref": "#a0"
},
{
"type": "null"
}
],
"$anchor": "ab"
},
"8": {
"type": "integer",
"$anchor": "a3",
"maximum": 9007199254740991,
"minimum": 0
},
"9": {
"type": "string",
"format": "uri",
"$anchor": "a8"
},
"a": {
"anyOf": [
{
"$ref": "#a1"
},
{
"type": "null"
}
],
"$anchor": "a9"
},
"b": {
"anyOf": [
{
"$ref": "#a2"
},
{
"type": "null"
}
],
"$anchor": "a5"
},
"c": {
"type": "array",
"items": {
"type": "string"
},
"$anchor": "ad"
},
"d": {
"type": "string",
"$anchor": "ae",
"pattern": "^[A-Z][A-Z0-9.-]{0,19}$"
},
"e": {
"type": "integer",
"$anchor": "a4",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"f": {
"type": "object",
"$anchor": "af",
"additionalProperties": {}
},
"g": {
"type": "string",
"maxLength": 64,
"minLength": 64
},
"h": {
"type": "object",
"required": [
"evidence_id",
"start",
"end",
"visual_asset_id"
],
"properties": {
"end": {
"$ref": "#a4"
},
"start": {
"$ref": "#a3"
},
"evidence_id": {
"$ref": "#a2"
},
"visual_asset_id": {
"$ref": "#a5"
}
},
"additionalProperties": false
},
"i": {
"type": "array",
"items": {
"$ref": "#/$defs/h"
},
"minItems": 1
},
"j": {
"type": "array",
"items": {
"$ref": "#a2"
}
},
"k": {
"type": "array",
"items": {
"$ref": "#a3"
}
},
"l": {
"type": "array",
"items": {
"$ref": "#/$defs/h"
}
},
"m": {
"anyOf": [
{
"$ref": "#a3"
},
{
"type": "null"
}
]
},
"n": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
]
},
"o": {
"anyOf": [
{
"$ref": "#a6"
},
{
"type": "null"
}
]
},
"p": {
"type": "object",
"required": [
"decimal",
"unit",
"currency",
"scale",
"period",
"scenario",
"support"
],
"properties": {
"unit": {
"$ref": "#a7"
},
"scale": {
"anyOf": [
{
"type": "string",
"pattern": "^(?:0|[1-9]\\d*)(?:\\.\\d+)?$"
},
{
"type": "null"
}
]
},
"period": {
"$ref": "#a7"
},
"decimal": {
"anyOf": [
{
"type": "string",
"pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$"
},
{
"type": "null"
}
]
},
"support": {
"enum": [
"literal",
"derived",
"estimated",
"unknown"
]
},
"currency": {
"$ref": "#a7"
},
"scenario": {
"$ref": "#a7"
}
},
"additionalProperties": false
}
},
"anyOf": [
{
"required": [
"schema_version",
"generated_at",
"as_of",
"resource",
"data_status",
"methodology_versions",
"citations",
"warnings",
"data"
],
"properties": {
"data": {
"type": "object",
"required": [
"context_assessment"
],
"properties": {
"visuals": {
"type": "object",
"required": [
"descriptors",
"next_visual_offset",
"selected_region",
"coverage"
],
"properties": {
"coverage": {
"enum": [
"available",
"partial",
"no_saved_visual_data"
]
},
"descriptors": {
"type": "array",
"items": {
"type": "object",
"required": [
"visual_id",
"evidence_id",
"source_id",
"source_revision_id",
"source_content_hash",
"citation_id",
"representation",
"image_type",
"materiality",
"schema_version",
"available_at",
"availability",
"literal_text",
"next_region_offset",
"regions"
],
"properties": {
"regions": {
"type": "array",
"items": {
"type": "object",
"required": [
"region_id",
"kind",
"rows",
"columns"
],
"properties": {
"kind": {
"enum": [
"text",
"table",
"chart"
]
},
"rows": {
"$ref": "#a6"
},
"columns": {
"$ref": "#a6"
},
"region_id": {
"$ref": "#ac"
}
},
"additionalProperties": false
},
"maxItems": 100
},
"source_id": {
"$ref": "#a2"
},
"visual_id": {
"$ref": "#ac"
},
"image_type": {
"enum": [
"table",
"chart",
"text",
"illustration",
"mixed",
"unknown"
]
},
"citation_id": {
"type": "string"
},
"evidence_id": {
"type": "string"
},
"materiality": {
"enum": [
"material",
"non_material",
"unknown"
]
},
"availability": {
"enum": [
"available",
"after_cutoff",
"missing",
"incompatible",
"legacy_unknown"
]
},
"available_at": {
"$ref": "#a9"
},
"literal_text": {
"enum": [
"allowed",
"withheld"
]
},
"representation": {
"enum": [
"image",
"native_table"
]
},
"schema_version": {
"$ref": "#a7"
},
"next_region_offset": {
"$ref": "#/$defs/m"
},
"source_revision_id": {
"$ref": "#a2"
},
"source_content_hash": {
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 100
},
"selected_region": {
"anyOf": [
{
"type": "object",
"required": [
"visual_id",
"region_id",
"kind",
"text",
"geometry",
"row_offset",
"row_limit",
"total_rows",
"has_more",
"cells",
"footnotes",
"chart"
],
"properties": {
"kind": {
"enum": [
"text",
"table",
"chart"
]
},
"text": {
"$ref": "#a7"
},
"cells": {
"type": "array",
"items": {
"type": "object",
"required": [
"cell_id",
"row",
"column",
"text",
"bounds",
"row_span",
"column_span",
"status",
"role",
"header_ids",
"footnote_ids",
"value"
],
"properties": {
"row": {
"$ref": "#a6"
},
"role": {
"enum": [
"header",
"data",
"footnote",
"unknown"
]
},
"text": {
"$ref": "#a7"
},
"value": {
"anyOf": [
{
"$ref": "#/$defs/p"
},
{
"type": "null"
}
]
},
"bounds": {
"anyOf": [
{
"type": "array",
"items": {
"type": "number"
},
"maxItems": 4,
"minItems": 4
},
{
"type": "null"
}
]
},
"column": {
"$ref": "#a6"
},
"status": {
"enum": [
"value",
"blank",
"unreadable",
"not_applicable",
"unknown",
"legacy_unknown"
]
},
"cell_id": {
"$ref": "#ac"
},
"row_span": {
"$ref": "#/$defs/o"
},
"header_ids": {
"type": "array",
"items": {
"$ref": "#ac"
}
},
"column_span": {
"$ref": "#/$defs/o"
},
"footnote_ids": {
"$ref": "#ad"
}
},
"additionalProperties": false
}
},
"chart": {
"anyOf": [
{
"type": "object",
"required": [
"coverage",
"axes",
"series"
],
"properties": {
"axes": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"unit"
],
"properties": {
"unit": {
"$ref": "#a7"
},
"label": {
"$ref": "#a7"
}
},
"additionalProperties": false
}
},
"series": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"points"
],
"properties": {
"label": {
"$ref": "#a7"
},
"points": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"text",
"value"
],
"properties": {
"text": {
"$ref": "#a7"
},
"label": {
"$ref": "#a7"
},
"value": {
"$ref": "#/$defs/p"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}
},
"coverage": {
"enum": [
"printed_values_only",
"partial",
"unreadable",
"unknown"
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"geometry": {
"anyOf": [
{
"type": "object",
"required": [
"coordinate_system",
"width",
"height"
],
"properties": {
"width": {
"$ref": "#/$defs/n"
},
"height": {
"$ref": "#/$defs/n"
},
"coordinate_system": {
"const": "normalized-top-left"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"has_more": {
"type": "boolean"
},
"footnotes": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"text"
],
"properties": {
"id": {
"type": "string"
},
"text": {
"$ref": "#a7"
}
},
"additionalProperties": false
}
},
"region_id": {
"$ref": "#ac"
},
"row_limit": {
"$ref": "#a6"
},
"visual_id": {
"$ref": "#ac"
},
"row_offset": {
"$ref": "#a6"
},
"total_rows": {
"$ref": "#a6"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"next_visual_offset": {
"$ref": "#/$defs/m"
}
},
"additionalProperties": false
},
"context_assessment": {
"type": "object",
"required": [
"version",
"assessment_id",
"supersedes_assessment_id",
"evidence_id",
"source_revision_id",
"source_content_hash",
"cutoff",
"assessed_at",
"available_at",
"material_context_gaps",
"subjects",
"linked_belief_ids",
"assessment",
"checking_inputs",
"dependency_keys",
"case_snapshot_hash",
"retrieval",
"support",
"citation_ids"
],
"properties": {
"cutoff": {
"$ref": "#a1"
},
"support": {
"type": "array",
"items": {
"type": "object",
"required": [
"source_id",
"evidence_id",
"source_revision_id",
"attributed_identity_id",
"source_content_hash",
"source_url",
"published_at",
"first_observed_at",
"captured_at",
"available_at",
"representation",
"visual_asset_id",
"quote",
"start",
"end",
"literal_text"
],
"properties": {
"end": {
"$ref": "#a4"
},
"quote": {
"$ref": "#ab"
},
"start": {
"$ref": "#a3"
},
"source_id": {
"$ref": "#a2"
},
"source_url": {
"$ref": "#a8"
},
"captured_at": {
"$ref": "#a1"
},
"evidence_id": {
"$ref": "#a2"
},
"available_at": {
"$ref": "#a1"
},
"literal_text": {
"enum": [
"allowed",
"withheld"
]
},
"published_at": {
"$ref": "#a9"
},
"representation": {
"enum": [
"source_text",
"visual_transcription"
]
},
"visual_asset_id": {
"$ref": "#a5"
},
"first_observed_at": {
"$ref": "#a1"
},
"source_revision_id": {
"$ref": "#a2"
},
"source_content_hash": {
"$ref": "#ac"
},
"revision_published_at": {
"$ref": "#a9"
},
"attributed_identity_id": {
"$ref": "#a5"
}
},
"additionalProperties": false
}
},
"version": {
"const": "evidence-case-context-v1"
},
"subjects": {
"type": "array",
"items": {
"type": "object",
"required": [
"security_id",
"ticker",
"support"
],
"properties": {
"ticker": {
"$ref": "#ae"
},
"support": {
"$ref": "#/$defs/i"
},
"security_id": {
"$ref": "#a2"
}
},
"additionalProperties": false
}
},
"retrieval": {
"type": "object",
"required": [
"candidate_count",
"case_ids",
"bounded",
"scope"
],
"properties": {
"scope": {
"$ref": "#a0"
},
"bounded": {
"type": "boolean"
},
"case_ids": {
"$ref": "#/$defs/j"
},
"candidate_count": {
"$ref": "#a3"
}
},
"additionalProperties": false
},
"assessment": {
"type": "object",
"required": [
"summary",
"source_assertions",
"independently_checked_inputs",
"case_relationships",
"stock_price_mechanism",
"unknowns"
],
"properties": {
"summary": {
"$ref": "#a0"
},
"unknowns": {
"$ref": "#aa"
},
"source_assertions": {
"type": "array",
"items": {
"type": "object",
"required": [
"statement",
"support",
"measurement"
],
"properties": {
"support": {
"$ref": "#/$defs/i"
},
"statement": {
"$ref": "#a0"
},
"measurement": {
"anyOf": [
{
"type": "object",
"required": [
"metric",
"value",
"unit",
"scale",
"period",
"instrument"
],
"properties": {
"unit": {
"$ref": "#a7"
},
"scale": {
"$ref": "#a7"
},
"value": {
"$ref": "#a7"
},
"metric": {
"$ref": "#a0"
},
"period": {
"$ref": "#a7"
},
"instrument": {
"type": "object",
"required": [
"kind",
"identifier",
"issuer_security_id"
],
"properties": {
"kind": {
"enum": [
"equity",
"bond",
"cds",
"other",
"unknown"
]
},
"identifier": {
"$ref": "#a7"
},
"issuer_security_id": {
"$ref": "#a5"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}
},
"case_relationships": {
"type": "array",
"items": {
"type": "object",
"required": [
"belief_id",
"relation",
"explanation",
"case_paragraph_indexes",
"support",
"conditions",
"unknowns"
],
"properties": {
"support": {
"$ref": "#/$defs/l"
},
"relation": {
"enum": [
"supports",
"contradicts",
"unresolved",
"unrelated"
]
},
"unknowns": {
"$ref": "#aa"
},
"belief_id": {
"$ref": "#a2"
},
"conditions": {
"$ref": "#aa"
},
"explanation": {
"$ref": "#a0"
},
"case_paragraph_indexes": {
"$ref": "#/$defs/k"
}
},
"additionalProperties": false
}
},
"stock_price_mechanism": {
"anyOf": [
{
"type": "object",
"required": [
"explanation",
"support",
"checking_input_indexes",
"conditions",
"unknowns"
],
"properties": {
"support": {
"$ref": "#/$defs/l"
},
"unknowns": {
"$ref": "#aa"
},
"conditions": {
"$ref": "#aa"
},
"explanation": {
"$ref": "#a0"
},
"checking_input_indexes": {
"$ref": "#/$defs/k"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"independently_checked_inputs": {
"type": "array",
"items": {
"type": "object",
"required": [
"statement",
"checking_input_indexes"
],
"properties": {
"statement": {
"$ref": "#a0"
},
"checking_input_indexes": {
"type": "array",
"items": {
"$ref": "#a3"
},
"minItems": 1
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"assessed_at": {
"$ref": "#a1"
},
"evidence_id": {
"$ref": "#a2"
},
"available_at": {
"$ref": "#a1"
},
"citation_ids": {
"type": "array",
"items": {
"$ref": "#a0"
},
"minItems": 1
},
"assessment_id": {
"$ref": "#a2"
},
"checking_inputs": {
"type": "array",
"items": {
"type": "object",
"anyOf": [
{
"required": [
"kind",
"schema_version",
"result_id",
"provider",
"source_type",
"source_content_hash",
"facts"
],
"properties": {
"kind": {
"const": "provider_result"
},
"facts": {
"type": "object",
"required": [
"ticker",
"price",
"market_data_at",
"provider_observed_at",
"feed"
],
"properties": {
"feed": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"price": {
"type": "number",
"exclusiveMinimum": 0
},
"ticker": {
"$ref": "#ae"
},
"market_data_at": {
"$ref": "#a1"
},
"provider_observed_at": {
"$ref": "#a1"
}
},
"additionalProperties": false
},
"provider": {
"const": "alpaca"
},
"result_id": {
"type": "string",
"pattern": "^alpaca:market_price_snapshot:[a-f0-9]{64}$"
},
"source_type": {
"const": "market_price_snapshot"
},
"schema_version": {
"const": "condition-market-support-v1"
},
"source_content_hash": {
"$ref": "#ac"
}
},
"additionalProperties": false
},
{
"required": [
"kind",
"schema_version",
"result_id",
"provider",
"source_type",
"source_content_hash",
"facts",
"evidence"
],
"properties": {
"kind": {
"const": "provider_result"
},
"facts": {
"type": "object",
"required": [
"ticker",
"provider_observed_at"
],
"properties": {
"ticker": {
"$ref": "#ae"
},
"provider_observed_at": {
"$ref": "#a1"
}
},
"additionalProperties": false
},
"evidence": {
"type": "array",
"items": {
"type": "object",
"required": [
"document_id",
"quote",
"source_url",
"published_at",
"publication_time_basis",
"content_hash",
"start",
"end",
"representation"
],
"properties": {
"end": {
"$ref": "#a4"
},
"quote": {
"type": "string",
"maxLength": 1200,
"minLength": 12
},
"start": {
"$ref": "#a3"
},
"source_url": {
"$ref": "#a8"
},
"document_id": {
"$ref": "#a0"
},
"content_hash": {
"$ref": "#/$defs/g"
},
"published_at": {
"$ref": "#a1"
},
"representation": {
"enum": [
"issuer_text",
"structured_issuer_facts"
]
},
"publication_time_basis": {
"const": "filing_date_or_observation_bound"
}
},
"additionalProperties": false
},
"maxItems": 3,
"minItems": 1
},
"provider": {
"const": "sec_edgar"
},
"result_id": {
"$ref": "#a2"
},
"source_type": {
"const": "sec_edgar_issuer_snapshot"
},
"schema_version": {
"const": "condition-issuer-support-v1"
},
"source_content_hash": {
"$ref": "#ac"
}
},
"additionalProperties": false
}
]
}
},
"dependency_keys": {
"$ref": "#aa"
},
"linked_belief_ids": {
"$ref": "#/$defs/j"
},
"case_snapshot_hash": {
"$ref": "#ac"
},
"source_revision_id": {
"$ref": "#a2"
},
"source_content_hash": {
"$ref": "#ac"
},
"material_context_gaps": {
"type": "object",
"default": {
"reference_collection": "unknown",
"unavailable_references": []
},
"required": [
"reference_collection",
"unavailable_references"
],
"properties": {
"reference_collection": {
"enum": [
"observed",
"unknown",
"not_applicable"
]
},
"unavailable_references": {
"$ref": "#ad"
}
},
"additionalProperties": false
},
"supersedes_assessment_id": {
"anyOf": [
{
"$ref": "#a2"
},
{
"type": "null"
}
],
"default": null
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"as_of": {
"$ref": "#a1"
},
"resource": {
"const": "beliefs"
},
"warnings": {
"$ref": "#aa"
},
"citations": {
"type": "array",
"items": {
"type": "object",
"required": [
"citation_id",
"evidence_id",
"source_url",
"source_title",
"author_name",
"published_at",
"observed_at",
"excerpt",
"source_type",
"source_provider",
"source_revision_id",
"source_content_hash",
"review_state"
],
"properties": {
"excerpt": {
"$ref": "#ab"
},
"source_url": {
"$ref": "#a8"
},
"author_name": {
"$ref": "#ab"
},
"citation_id": {
"$ref": "#a0"
},
"evidence_id": {
"$ref": "#a0"
},
"observed_at": {
"$ref": "#a1"
},
"source_type": {
"$ref": "#ab"
},
"published_at": {
"$ref": "#a9"
},
"review_state": {
"enum": [
"machine_validated",
"human_reviewed",
"creator_corrected"
]
},
"source_title": {
"$ref": "#a0"
},
"source_provider": {
"$ref": "#ab"
},
"source_revision_id": {
"$ref": "#ab"
},
"source_content_hash": {
"anyOf": [
{
"$ref": "#/$defs/g"
},
{
"type": "null"
}
]
},
"full_document_stored": {
"type": [
"boolean",
"null"
],
"description": "Recorded storage flag, separate from verified source completeness. Null or absent means unknown."
},
"source_text_coverage": {
"anyOf": [
{
"enum": [
"partial",
"feed_body_field_unverified",
"context_article_unverified"
]
},
{
"type": "null"
}
],
"description": "Stored source-capture scope. Null or absent means unknown; no value here verifies complete article coverage."
}
},
"additionalProperties": false
}
},
"data_status": {
"type": "object",
"required": [
"mode",
"freshness",
"coverage",
"latest_observation_at",
"limitations"
],
"properties": {
"mode": {
"enum": [
"live",
"preview"
]
},
"coverage": {
"enum": [
"complete",
"partial",
"insufficient"
]
},
"freshness": {
"enum": [
"current",
"delayed",
"stale"
]
},
"limitations": {
"$ref": "#aa"
},
"latest_observation_at": {
"$ref": "#a9"
}
},
"additionalProperties": false
},
"generated_at": {
"$ref": "#a1"
},
"billing_notice": {
"type": "object",
"required": [
"code",
"message",
"remaining_requests",
"add_credits_url",
"plans_url"
],
"properties": {
"code": {
"const": "signup_credit_exhausted"
},
"message": {
"$ref": "#a0"
},
"plans_url": {
"$ref": "#a8"
},
"add_credits_url": {
"$ref": "#a8"
},
"remaining_requests": {
"const": 0
}
},
"additionalProperties": false
},
"schema_version": {
"const": "1"
},
"methodology_versions": {
"type": "object",
"required": [
"belief_dataset"
],
"properties": {
"belief_dataset": {
"const": "belief-dataset-v11"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message",
"recovery",
"retryable"
],
"properties": {
"code": {
"enum": [
"unauthorized",
"invalid_input",
"entity_not_found",
"entity_ambiguous",
"outside_entitlement",
"rate_limited",
"data_unavailable",
"insufficient_sample",
"unsupported_security",
"duplicate_request"
]
},
"message": {
"$ref": "#a0"
},
"recovery": {
"$ref": "#ab"
},
"retryable": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"required": [
"accepts",
"resource",
"x402Version"
],
"properties": {
"error": {
"type": "string"
},
"accepts": {
"type": "array",
"items": {
"type": "object",
"required": [
"amount",
"asset",
"maxTimeoutSeconds",
"network",
"payTo",
"scheme"
],
"properties": {
"asset": {
"$ref": "#a0"
},
"extra": {
"$ref": "#af"
},
"payTo": {
"$ref": "#a0"
},
"amount": {
"type": "string",
"pattern": "^\\d+$"
},
"scheme": {
"enum": [
"exact"
]
},
"network": {
"type": "string",
"pattern": "^eip155:\\d+$"
},
"maxTimeoutSeconds": {
"type": "number"
}
},
"additionalProperties": false
},
"minItems": 1
},
"resource": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"$ref": "#a0"
},
"tags": {
"$ref": "#ad"
},
"iconUrl": {
"type": "string"
},
"mimeType": {
"type": "string"
},
"description": {
"type": "string"
},
"serviceName": {
"type": "string"
}
},
"additionalProperties": false
},
"extensions": {
"type": "object",
"additionalProperties": {
"type": "object",
"required": [
"info",
"schema"
],
"properties": {
"info": {
"$ref": "#af"
},
"schema": {
"$ref": "#af"
}
},
"additionalProperties": false
}
},
"x402Version": {
"const": 2
}
},
"additionalProperties": false
},
{
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"enum": [
"payment_pending",
"rate_limited"
]
},
"message": {
"$ref": "#a0"
},
"retryable": {
"const": true
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Retrieves retained US economic events in one ticker research scope. Filter by event text, region, scheduled/reported/unconfirmed state and scheduled-date bounds. Returns typed actual, previous, consensus and forecast literals, revision markers, native times and source support; an unverified timezone stays unknown. Current requests recheck stale mirror metadata; historical and pinned reads never refresh. This is retained calendar context, with snapshot freshness separate from event time. Continue with the returned snapshot, cutoff, filters and cursor or next_offset. Per-call x402 price: 0.02 USDC on Base.
| Parameter | Type | Description |
|---|---|---|
| as_of | string | Availability cutoff, separate from event/period filters. Historical reads never refresh. |
| limit | integer | Matching typed observations per page; default32. |
| state | string | one of ["scheduled","reported","unconfirmed"] |
| cursor | string | Archive continuation token; reuse with snapshot ID/hash, as_of and unchanged filters. |
| offset | integer | |
| region | string | |
| ticker * | string | |
| date_to | string | Inclusive native date upper bound, selected by date_field. |
Retrieves source-reported insider transactions for one ticker. Filter by reporting owner name or CIK, transaction codes, derivative status and transaction or filing dates. Returns typed owners, security units, prices, acquisition/disposition codes, filing dates and exact support; SEC codes distinguish market purchases/sales (P/S), gifts (G), tax withholding (F) and exercises (M). Owner names use reported SEC spelling; resolve ambiguous or unfamiliar aliases from returned owners. Current requests recheck stale retained mirror metadata; historical and pinned reads remain fixed. Use returned snapshot and cursor or next_offset for further pages; coverage and held records remain explicit. Per-call x402 price: 0.02 USDC on Base.
| Parameter | Type | Description |
|---|---|---|
| as_of | string | Availability cutoff, separate from event/period filters. Historical reads never refresh. |
| limit | integer | Matching typed observations per page; default32. |
| cursor | string | Archive continuation token; reuse with snapshot ID/hash, as_of and unchanged filters. |
| offset | integer | |
| ticker * | string | |
| date_to | string | Inclusive native date upper bound, selected by date_field. |
| date_from | string | Inclusive native date lower bound, selected by date_field. |
| owner_cik |
Retrieves reported institutional holdings for one ticker across supported retained 13F history. Filter by manager name or CIK, report period, filing dates, amendments, share class and shares versus PUT/CALL positions. Returns typed quantities, native reported values, manager identities and source support. Identifier and filing-join checks hold ambiguous records; report dates differ from filing dates, and native value scales remain explicit. Current requests recheck stale mirror metadata; historical/pinned reads never switch snapshots. Continue with the returned snapshot ID/hash, as_of, filters and cursor or next_offset. Per-call x402 price: 0.02 USDC on Base.
| Parameter | Type | Description |
|---|---|---|
| as_of | string | Availability cutoff, separate from event/period filters. Historical reads never refresh. |
| limit | integer | Matching typed observations per page; default32. |
| cursor | string | Archive continuation token; reuse with snapshot ID/hash, as_of and unchanged filters. |
| offset | integer | |
| ticker * | string | |
| date_to | string | Inclusive native date upper bound, selected by date_field. |
| put_call | string | Reported 13F position category; SHARES excludes PUT/CALL reports. |
| date_from | string |
Retrieves an investor's stored publication-based outcomes for one company, research subject, investment case or the explicitly selected released corpus. Returns action, entry-price and horizon cohorts, verified exits, losses, pending results and ineligible counts. Useful for reviewing measured thesis outcomes and their sample limitations. Filter by source and publication window; narrow a scope that exceeds the returned bound. Uses stored market observations, with historical source completeness explicitly unknown. Per-call x402 price: 0.02 USDC on Base.
| Parameter | Type | Description |
|---|---|---|
| as_of | string | |
| corpus | string | |
| ticker | string | |
| belief_id | string | |
| entity_id | string | |
| person_id * | string | |
| source_id | string | |
| published_from | string | |
| published_through | string |
Retrieves retained government macroeconomic observations in one ticker research scope. Filter by native series_ids, agency, measurement_names and period dates; returns typed values, units, seasonal bases, scales, native periods and source support. Supported archive formats cover Treasury, NY Fed, BLS, BEA, EIA, CFTC and metadata-qualified Federal Reserve Board series; other admitted context is explicitly bounded. Macro backdrop does not establish company exposure or a historical data vintage; FRED and rights-held series are unavailable. Current requests recheck stale mirror metadata; historical/pinned reads remain fixed. Continue with the returned snapshot, cutoff, filters and cursor or next_offset. Per-call x402 price: 0.02 USDC on Base.
| Parameter | Type | Description |
|---|---|---|
| as_of | string | Availability cutoff, separate from event/period filters. Historical reads never refresh. |
| limit | integer | Matching typed observations per page; default32. |
| agency | string | |
| cursor | string | Archive continuation token; reuse with snapshot ID/hash, as_of and unchanged filters. |
| offset | integer | |
| ticker * | string | |
| date_to | string | Inclusive native date upper bound, selected by date_field. |
| date_from | string |
Retrieves supported split-adjusted close-price returns for one ticker versus SPY. Request session_intervals from 1 to 252; date bounds select return end sessions, while an omitted date range uses the latest completed official session. Returns typed security and benchmark returns, excess percentage points, exact session dates and retained support. Complete security/SPY paths, official calendars and verified adjustment basis are required; missing or ambiguous inputs remain held. Price returns exclude dividends, fees and execution effects, and do not measure investor account performance. Current requests refresh only missing, incomplete or stale closing-price references from the delayed consolidated market data; historical/pinned queries preserve input availability; use the returned snapshot, as_of, filters and next_offset for further pages. Per-call x402 price: 0.02 USDC on Base.
| Parameter | Type | Description |
|---|---|---|
| as_of | string | Availability cutoff, separate from event/period filters. Historical reads never refresh. |
| limit | integer | Matching typed observations per page; default32. |
| cursor | string | Archive continuation token; reuse with snapshot ID/hash, as_of and unchanged filters. |
| offset | integer | |
| ticker * | string | |
| date_to | string | Inclusive native date upper bound, selected by date_field. |
| date_from | string |
Check recent SEC filings for one verified ticker. Set include_earnings to also read issuer-announced earnings schedules when available. Free without an account or wallet.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| ticker * | string | |
| include_earnings | boolean | Include issuer-announced earnings schedules supported by admitted SEC evidence. |
{
"name": "get_news",
"title": "Get SEC filing news",
"description": "Check recent SEC filings for one verified ticker. Set include_earnings to also read issuer-announced earnings schedules when available. Free without an account or wallet.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"ticker"
],
"properties": {
"limit": {
"type": "integer",
"default": 5,
"maximum": 10,
"minimum": 1
},
"ticker": {
"type": "string",
"pattern": "^[A-Z][A-Z0-9.-]{0,9}$"
},
"include_earnings": {
"type": "boolean",
"description": "Include issuer-announced earnings schedules supported by admitted SEC evidence."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$defs": {
"0": {
"type": "string",
"format": "date-time",
"$anchor": "a0",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"1": {
"anyOf": [
{
"$ref": "#a0"
},
{
"type": "null"
}
],
"$anchor": "a1"
},
"2": {
"type": "string",
"format": "date",
"$anchor": "a2",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
}
},
"anyOf": [
{
"required": [
"resource",
"access",
"ticker",
"source",
"scope",
"status",
"observed_at",
"checked_at",
"data"
],
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"required": [
"accession_number",
"form",
"filed_on",
"accepted_at",
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"form": {
"type": "string"
},
"filed_on": {
"$ref": "#a2"
},
"accepted_at": {
"$ref": "#a1"
},
"accession_number": {
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 10
},
"scope": {
"enum": [
"retained_recent_filings",
"current_recent_filings"
]
},
"access": {
"const": "free"
},
"source": {
"const": "SEC EDGAR"
},
"status": {
"enum": [
"available",
"stale",
"unavailable"
]
},
"ticker": {
"type": "string"
},
"resource": {
"const": "issuer_news"
},
"checked_at": {
"$ref": "#a1"
},
"observed_at": {
"$ref": "#a1"
},
"earnings_schedule": {
"type": "object",
"required": [
"status",
"data"
],
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"required": [
"fiscal_year",
"fiscal_quarter",
"release_date",
"release_session",
"webcast_at",
"filed_on",
"accepted_at",
"observed_at",
"available_at",
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"filed_on": {
"$ref": "#a2"
},
"webcast_at": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
{
"type": "null"
}
]
},
"accepted_at": {
"$ref": "#a0"
},
"fiscal_year": {
"type": "integer",
"maximum": 2100,
"minimum": 2000
},
"observed_at": {
"$ref": "#a0"
},
"available_at": {
"$ref": "#a0"
},
"release_date": {
"$ref": "#a2"
},
"fiscal_quarter": {
"type": "integer",
"maximum": 4,
"minimum": 1
},
"release_session": {
"anyOf": [
{
"enum": [
"before_market_open",
"after_market_close"
]
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"maxItems": 10
},
"status": {
"enum": [
"available",
"unavailable"
]
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message",
"recovery",
"retryable"
],
"properties": {
"code": {
"enum": [
"unauthorized",
"invalid_input",
"entity_not_found",
"entity_ambiguous",
"outside_entitlement",
"rate_limited",
"data_unavailable",
"insufficient_sample",
"unsupported_security",
"duplicate_request"
]
},
"message": {
"type": "string",
"minLength": 1
},
"recovery": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "null"
}
]
},
"retryable": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Retrieves retained options bars, flow aggregates and open interest for one ticker. Select activity_type, call/put right, expiration, strike and observation-date filters; returns typed instrument fields, OHLC, volume or open interest with units and source support. Open interest is a position measure; trading volume is a flow. Use explicit date/instrument filters for large histories; source-file order is not a globally sorted latest option chain. Current requests recheck stale mirror metadata; historical/pinned reads remain fixed. Continue with the returned snapshot, cutoff, filters and cursor or next_offset; partial scans are not proof of no matches. Per-call x402 price: 0.02 USDC on Base.
| Parameter | Type | Description |
|---|---|---|
| as_of | string | Availability cutoff, separate from event/period filters. Historical reads never refresh. |
| limit | integer | Matching typed observations per page; default32. |
| right | string | one of ["C","P"] |
| cursor | string | Archive continuation token; reuse with snapshot ID/hash, as_of and unchanged filters. |
| family | string | one of ["options","open_interest"] |
| offset | integer | |
| ticker * | string | |
| date_to | string | Inclusive native date upper bound, selected by date_field. |
Retrieves evidence-linked risks for one company, research subject, investment case or the explicitly selected released corpus. Returns recorded severity, lifecycle status, supporting evidence and unknown assessments. Useful for investigating a thesis's downside and invalidation conditions. Filter by investor, source, publication dates, status or severity. Empty filtered results reflect available assessed coverage; unknown risks remain separate. Continue with the returned cursor and unchanged filters. Per-call x402 price: 0.02 USDC on Base.
| Parameter | Type | Description |
|---|---|---|
| as_of | string | |
| limit | integer | |
| corpus | string | |
| cursor | string | |
| ticker | string | |
| severity | string | one of ["low","medium","high"] |
| belief_id | string | |
| entity_id | string | |
| person_id | string | |
| source_id | string | |
| object_status |
Retrieves ranked published investment cases matching thesis, investment theme or trade setup, with an optional company or subject filter. Returns ranked matching passages, attributed investors, dates, case IDs and citations. Useful for finding research about a business trend or investment question without knowing a ticker. Open selected cases with get_case for more depth. Ranking reflects library matches and coverage, rather than market-wide consensus. Continue with the returned cursor and unchanged query, filters and as_of cutoff. Per-call x402 price: 1.50 USDC on Base.
| Parameter | Type | Description |
|---|---|---|
| q | string | Thesis, topic or trade setup. Required on the first page. |
| as_of | string | |
| limit | integer | Requested page size. For ticker/entity belief lists, MCP returns up to twelve complete summaries within its response budget; pagination.limit is the effective size. Continue with next_cursor and the same ticker/entity_id. REST supports larger pages. |
| cursor | string | Use next_cursor for another page of the same search. |
| status | string | one of ["forming","active","strengthened","weakened","reversed","resolved","abandoned","unknown"] |
| ticker | string | |
| direction | string | one of ["bullish","bearish","mixed","neutral","non_directional","unknown"] |
| entity_id |
Retrieves retained short-interest and short-volume history for one ticker. Select family and date bounds; short_interest uses settlement periods, while short_volume uses observation dates. Returns typed outstanding short shares, average daily volume and days to cover, or daily short/exempt/total volumes, with exact source support. Short volume does not establish an outstanding position. Current requests recheck stale mirror metadata; historical and pinned reads never refresh. Continue with the returned snapshot, as_of, filters and cursor or next_offset; coverage gaps remain explicit. Per-call x402 price: 0.02 USDC on Base.
| Parameter | Type | Description |
|---|---|---|
| as_of | string | Availability cutoff, separate from event/period filters. Historical reads never refresh. |
| limit | integer | Matching typed observations per page; default32. |
| cursor | string | Archive continuation token; reuse with snapshot ID/hash, as_of and unchanged filters. |
| family | string | one of ["short_interest","short_volume"] |
| offset | integer | |
| ticker * | string | |
| date_to | string | Inclusive native date upper bound, selected by date_field. |
| date_from | string | Inclusive native date lower bound, selected by date_field. |
Retrieves matching released research subjects by name or kind, including companies, industries and investment themes. Returns matching subject identifiers and available research coverage. Useful for resolving a non-company topic before requesting a brief or cases. Use the returned entity_id for follow-up research and preserve ambiguity when multiple subjects match; a ticker is optional for non-company subjects. Per-call x402 price: 0.02 USDC on Base.
| Parameter | Type | Description |
|---|---|---|
| q | string | |
| kind | string | one of ["company","instrument","commodity","macro_variable","industry","sector","theme","country","geography","person","policy","event_series","event_occurrence","currency","index"] |
| as_of | string | |
| limit | integer | Requested page size. For ticker/entity belief lists, MCP returns up to twelve complete summaries within its response budget; pagination.limit is the effective size. Continue with next_cursor and the same ticker/entity_id. REST supports larger pages. |
| cursor | string |
{
"name": "get_subjects",
"title": "Get research subjects",
"description": "Retrieves matching released research subjects by name or kind, including companies, industries and investment themes. Returns matching subject identifiers and available research coverage. Useful for resolving a non-company topic before requesting a brief or cases. Use the returned entity_id for follow-up research and preserve ambiguity when multiple subjects match; a ticker is optional for non-company subjects. Per-call x402 price: 0.02 USDC on Base.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"q": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"kind": {
"enum": [
"company",
"instrument",
"commodity",
"macro_variable",
"industry",
"sector",
"theme",
"country",
"geography",
"person",
"policy",
"event_series",
"event_occurrence",
"currency",
"index"
],
"type": "string"
},
"as_of": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Requested page size. For ticker/entity belief lists, MCP returns up to twelve complete summaries within its response budget; pagination.limit is the effective size. Continue with next_cursor and the same ticker/entity_id. REST supports larger pages."
},
"cursor": {
"type": "string",
"maxLength": 2048,
"minLength": 1
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$defs": {
"0": {
"type": "string",
"$anchor": "a0",
"minLength": 1
},
"1": {
"type": "string",
"format": "date-time",
"$anchor": "a1",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"2": {
"anyOf": [
{
"$ref": "#a0"
},
{
"type": "null"
}
],
"$anchor": "a4"
},
"3": {
"type": "string",
"format": "uri",
"$anchor": "a3"
},
"4": {
"type": "string",
"format": "uuid",
"$anchor": "a2",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"5": {
"type": "object",
"$anchor": "a5",
"additionalProperties": {}
},
"6": {
"anyOf": [
{
"$ref": "#a1"
},
{
"type": "null"
}
]
},
"7": {
"type": "array",
"items": {
"$ref": "#a0"
}
},
"8": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"9": {
"anyOf": [
{
"$ref": "#a2"
},
{
"type": "null"
}
]
}
},
"anyOf": [
{
"required": [
"schema_version",
"generated_at",
"as_of",
"resource",
"data_status",
"methodology_versions",
"citations",
"warnings",
"pagination",
"data"
],
"properties": {
"data": {
"type": "object",
"required": [
"view",
"entities"
],
"properties": {
"view": {
"const": "entities"
},
"entities": {
"type": "array",
"items": {
"type": "object",
"required": [
"entity_id",
"kind",
"namespace",
"canonical_key",
"name",
"security_id",
"parent_entity_id",
"recorded_at",
"available_at",
"release_effective_at",
"aliases"
],
"properties": {
"kind": {
"enum": [
"company",
"instrument",
"commodity",
"macro_variable",
"industry",
"sector",
"theme",
"country",
"geography",
"person",
"policy",
"event_series",
"event_occurrence",
"currency",
"index"
]
},
"name": {
"$ref": "#a0"
},
"aliases": {
"type": "array",
"items": {
"type": "object",
"required": [
"alias",
"assertion_id",
"evidence_id",
"confidence",
"available_at",
"citation_ids"
],
"properties": {
"alias": {
"$ref": "#a0"
},
"confidence": {
"type": "number",
"maximum": 1,
"minimum": 0.8
},
"evidence_id": {
"$ref": "#a0"
},
"assertion_id": {
"$ref": "#a2"
},
"available_at": {
"$ref": "#a1"
},
"citation_ids": {
"type": "array",
"items": {
"$ref": "#a0"
},
"minItems": 1
}
},
"additionalProperties": false
},
"minItems": 1
},
"entity_id": {
"$ref": "#a2"
},
"namespace": {
"$ref": "#a0"
},
"recorded_at": {
"$ref": "#a1"
},
"security_id": {
"$ref": "#/$defs/9"
},
"available_at": {
"$ref": "#a1"
},
"canonical_key": {
"$ref": "#a0"
},
"parent_entity_id": {
"$ref": "#/$defs/9"
},
"release_effective_at": {
"$ref": "#a1"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"as_of": {
"$ref": "#a1"
},
"resource": {
"const": "beliefs"
},
"warnings": {
"$ref": "#/$defs/7"
},
"citations": {
"type": "array",
"items": {
"type": "object",
"required": [
"citation_id",
"evidence_id",
"source_url",
"source_title",
"author_name",
"published_at",
"observed_at",
"excerpt",
"source_type",
"source_provider",
"source_revision_id",
"source_content_hash",
"review_state"
],
"properties": {
"excerpt": {
"$ref": "#a4"
},
"source_url": {
"$ref": "#a3"
},
"author_name": {
"$ref": "#a4"
},
"citation_id": {
"$ref": "#a0"
},
"evidence_id": {
"$ref": "#a0"
},
"observed_at": {
"$ref": "#a1"
},
"source_type": {
"$ref": "#a4"
},
"published_at": {
"$ref": "#/$defs/6"
},
"review_state": {
"enum": [
"machine_validated",
"human_reviewed",
"creator_corrected"
]
},
"source_title": {
"$ref": "#a0"
},
"source_provider": {
"$ref": "#a4"
},
"source_revision_id": {
"$ref": "#a4"
},
"source_content_hash": {
"anyOf": [
{
"type": "string",
"maxLength": 64,
"minLength": 64
},
{
"type": "null"
}
]
},
"full_document_stored": {
"type": [
"boolean",
"null"
],
"description": "Recorded storage flag, separate from verified source completeness. Null or absent means unknown."
},
"source_text_coverage": {
"anyOf": [
{
"enum": [
"partial",
"feed_body_field_unverified",
"context_article_unverified"
]
},
{
"type": "null"
}
],
"description": "Stored source-capture scope. Null or absent means unknown; no value here verifies complete article coverage."
}
},
"additionalProperties": false
}
},
"pagination": {
"type": "object",
"required": [
"limit",
"returned",
"total_available",
"has_more",
"next_cursor",
"next_page_url"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"has_more": {
"type": "boolean"
},
"returned": {
"$ref": "#/$defs/8"
},
"next_cursor": {
"type": [
"string",
"null"
]
},
"next_page_url": {
"anyOf": [
{
"$ref": "#a3"
},
{
"type": "null"
}
]
},
"total_available": {
"$ref": "#/$defs/8"
},
"total_observed_at": {
"$ref": "#a1"
}
},
"additionalProperties": false
},
"data_status": {
"type": "object",
"required": [
"mode",
"freshness",
"coverage",
"latest_observation_at",
"limitations"
],
"properties": {
"mode": {
"enum": [
"live",
"preview"
]
},
"coverage": {
"enum": [
"complete",
"partial",
"insufficient"
]
},
"freshness": {
"enum": [
"current",
"delayed",
"stale"
]
},
"limitations": {
"$ref": "#/$defs/7"
},
"latest_observation_at": {
"$ref": "#/$defs/6"
}
},
"additionalProperties": false
},
"generated_at": {
"$ref": "#a1"
},
"billing_notice": {
"type": "object",
"required": [
"code",
"message",
"remaining_requests",
"add_credits_url",
"plans_url"
],
"properties": {
"code": {
"const": "signup_credit_exhausted"
},
"message": {
"$ref": "#a0"
},
"plans_url": {
"$ref": "#a3"
},
"add_credits_url": {
"$ref": "#a3"
},
"remaining_requests": {
"const": 0
}
},
"additionalProperties": false
},
"schema_version": {
"const": "1"
},
"methodology_versions": {
"type": "object",
"required": [
"belief_dataset"
],
"properties": {
"belief_dataset": {
"const": "belief-dataset-v11"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message",
"recovery",
"retryable"
],
"properties": {
"code": {
"enum": [
"unauthorized",
"invalid_input",
"entity_not_found",
"entity_ambiguous",
"outside_entitlement",
"rate_limited",
"data_unavailable",
"insufficient_sample",
"unsupported_security",
"duplicate_request"
]
},
"message": {
"$ref": "#a0"
},
"recovery": {
"$ref": "#a4"
},
"retryable": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"required": [
"accepts",
"resource",
"x402Version"
],
"properties": {
"error": {
"type": "string"
},
"accepts": {
"type": "array",
"items": {
"type": "object",
"required": [
"amount",
"asset",
"maxTimeoutSeconds",
"network",
"payTo",
"scheme"
],
"properties": {
"asset": {
"$ref": "#a0"
},
"extra": {
"$ref": "#a5"
},
"payTo": {
"$ref": "#a0"
},
"amount": {
"type": "string",
"pattern": "^\\d+$"
},
"scheme": {
"enum": [
"exact"
]
},
"network": {
"type": "string",
"pattern": "^eip155:\\d+$"
},
"maxTimeoutSeconds": {
"type": "number"
}
},
"additionalProperties": false
},
"minItems": 1
},
"resource": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"$ref": "#a0"
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"iconUrl": {
"type": "string"
},
"mimeType": {
"type": "string"
},
"description": {
"type": "string"
},
"serviceName": {
"type": "string"
}
},
"additionalProperties": false
},
"extensions": {
"type": "object",
"additionalProperties": {
"type": "object",
"required": [
"info",
"schema"
],
"properties": {
"info": {
"$ref": "#a5"
},
"schema": {
"$ref": "#a5"
}
},
"additionalProperties": false
}
},
"x402Version": {
"const": 2
}
},
"additionalProperties": false
},
{
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"enum": [
"payment_pending",
"rate_limited"
]
},
"message": {
"$ref": "#a0"
},
"retryable": {
"const": true
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Retrieves public direct-company research coverage and counts. Account tracking requires the authenticated MCP server.
| Parameter | Type | Description |
|---|---|---|
| as_of | string |
{
"name": "get_tickers",
"title": "Get research coverage",
"description": "Retrieves public direct-company research coverage and counts. Account tracking requires the authenticated MCP server.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"as_of": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$defs": {
"0": {
"type": "string",
"format": "date-time",
"$anchor": "a0",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"1": {
"type": [
"string",
"null"
],
"$anchor": "a3"
},
"2": {
"type": "string",
"$anchor": "a1",
"minLength": 1
},
"3": {
"type": "array",
"items": {
"type": "string"
},
"$anchor": "a5"
},
"4": {
"type": "string",
"format": "uri",
"$anchor": "a2"
},
"5": {
"type": "integer",
"$anchor": "a4",
"maximum": 9007199254740991,
"minimum": 0
},
"6": {
"anyOf": [
{
"$ref": "#a0"
},
{
"type": "null"
}
],
"$anchor": "a6"
},
"7": {
"anyOf": [
{
"$ref": "#/$defs/9"
},
{
"type": "null"
}
],
"$anchor": "a7"
},
"8": {
"type": "array",
"items": {
"$ref": "#a1"
}
},
"9": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
"a": {
"anyOf": [
{
"$ref": "#a1"
},
{
"type": "null"
}
]
},
"b": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
},
"anyOf": [
{
"required": [
"schema_version",
"generated_at",
"as_of",
"resource",
"tickers",
"totals",
"coverage"
],
"properties": {
"as_of": {
"$ref": "#a0"
},
"totals": {
"type": "object",
"required": [
"ticker_count",
"belief_count"
],
"properties": {
"belief_count": {
"$ref": "#a4"
},
"ticker_count": {
"$ref": "#a4"
}
},
"additionalProperties": false
},
"tickers": {
"$ref": "#/$defs/8"
},
"coverage": {
"type": "array",
"items": {
"type": "object",
"required": [
"ticker",
"security_id",
"security_name",
"release_state",
"release_effective_at",
"belief_count",
"investor_count",
"first_belief_observed_at",
"latest_belief_observed_at"
],
"properties": {
"ticker": {
"$ref": "#a1"
},
"security_id": {
"$ref": "#a1"
},
"belief_count": {
"$ref": "#/$defs/b"
},
"release_state": {
"const": "released"
},
"security_name": {
"$ref": "#a1"
},
"investor_count": {
"$ref": "#/$defs/b"
},
"security_exchange": {
"$ref": "#/$defs/a"
},
"release_effective_at": {
"$ref": "#a0"
},
"first_belief_observed_at": {
"$ref": "#a0"
},
"latest_belief_observed_at": {
"$ref": "#a0"
}
},
"additionalProperties": false
}
},
"resource": {
"const": "beliefs"
},
"tracking": {
"type": "object",
"required": [
"limit",
"active",
"paused",
"unavailable",
"manage_url"
],
"properties": {
"limit": {
"$ref": "#a4"
},
"active": {
"$ref": "#a4"
},
"paused": {
"$ref": "#a5"
},
"changes": {
"type": "object",
"required": [
"checked_at",
"macro_since",
"companies",
"changes",
"omitted_changes",
"unavailable_macro_feeds",
"limitations"
],
"properties": {
"changes": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"kind",
"ticker",
"title",
"source_url",
"publisher",
"published_at",
"published_on",
"observed_at",
"available_at",
"fiscal_period",
"scheduled_on",
"actuals",
"guidance"
],
"properties": {
"id": {
"type": "string"
},
"kind": {
"enum": [
"earnings_results",
"earnings_schedule",
"guidance",
"macro_release"
]
},
"title": {
"type": "string"
},
"ticker": {
"$ref": "#a3"
},
"actuals": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"value",
"unit",
"period_start",
"period_end",
"source_url"
],
"properties": {
"unit": {
"type": "string"
},
"label": {
"type": "string"
},
"value": {
"type": "string"
},
"period_end": {
"$ref": "#/$defs/9"
},
"source_url": {
"$ref": "#a2"
},
"period_start": {
"$ref": "#a7"
}
},
"additionalProperties": false
},
"maxItems": 6
},
"guidance": {
"anyOf": [
{
"type": "object",
"required": [
"status",
"point",
"lower",
"upper",
"unit",
"basis",
"range_origin",
"qualifications"
],
"properties": {
"unit": {
"$ref": "#a3"
},
"basis": {
"type": "string"
},
"lower": {
"$ref": "#a3"
},
"point": {
"$ref": "#a3"
},
"upper": {
"$ref": "#a3"
},
"status": {
"enum": [
"unspecified",
"revised",
"reaffirmed",
"withdrawn"
]
},
"range_origin": {
"enum": [
"reported",
"computed_from_reported_tolerance",
"none"
]
},
"qualifications": {
"$ref": "#a5"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"publisher": {
"type": "string"
},
"source_url": {
"$ref": "#a2"
},
"observed_at": {
"$ref": "#a0"
},
"available_at": {
"$ref": "#a6"
},
"published_at": {
"$ref": "#a6"
},
"published_on": {
"$ref": "#a7"
},
"scheduled_on": {
"$ref": "#a7"
},
"fiscal_period": {
"$ref": "#a3"
}
},
"additionalProperties": false
},
"maxItems": 50
},
"companies": {
"type": "array",
"items": {
"type": "object",
"required": [
"ticker",
"since",
"basis",
"earnings_filings_checked_at",
"guidance_checked_at"
],
"properties": {
"basis": {
"enum": [
"saved_review",
"saved_outlook",
"recent_window"
]
},
"since": {
"$ref": "#a0"
},
"ticker": {
"type": "string"
},
"guidance_checked_at": {
"$ref": "#a6"
},
"earnings_filings_checked_at": {
"$ref": "#a6"
}
},
"additionalProperties": false
}
},
"checked_at": {
"$ref": "#a0"
},
"limitations": {
"$ref": "#a5"
},
"macro_since": {
"$ref": "#a6"
},
"omitted_changes": {
"$ref": "#a4"
},
"unavailable_macro_feeds": {
"$ref": "#a5"
}
},
"additionalProperties": false
},
"manage_url": {
"type": "string"
},
"unavailable": {
"$ref": "#a5"
},
"related_or_pending": {
"$ref": "#a5"
}
},
"additionalProperties": false
},
"discovery": {
"type": "object",
"required": [
"query",
"scope",
"source_url",
"results"
],
"properties": {
"query": {
"type": "string"
},
"scope": {
"const": "sec_registered_us_listings"
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"ticker",
"name",
"exchange",
"cik",
"direct_research"
],
"properties": {
"cik": {
"type": "number"
},
"name": {
"type": "string"
},
"ticker": {
"type": "string"
},
"exchange": {
"$ref": "#a3"
},
"direct_research": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"source_url": {
"$ref": "#a2"
}
},
"additionalProperties": false
},
"limitations": {
"$ref": "#/$defs/8"
},
"generated_at": {
"$ref": "#a0"
},
"coverage_scope": {
"enum": [
"released_library",
"query_matches"
]
},
"fund_discovery": {
"type": "object",
"required": [
"query",
"scope",
"results",
"limitation"
],
"properties": {
"query": {
"type": "string"
},
"scope": {
"const": "fund_identity"
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"ticker",
"name",
"source_url",
"research_tool"
],
"properties": {
"name": {
"type": "string"
},
"ticker": {
"type": "string"
},
"source_url": {
"$ref": "#a2"
},
"research_tool": {
"const": "get_brief"
}
},
"additionalProperties": false
}
},
"limitation": {
"type": "string"
}
},
"additionalProperties": false
},
"schema_version": {
"const": "1"
},
"listing_references": {
"type": "object",
"required": [
"query",
"scope",
"results"
],
"properties": {
"query": {
"type": "string"
},
"scope": {
"const": "venue_qualified_pilot"
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"selector",
"ticker",
"exchange",
"country",
"currency",
"isin",
"name",
"instrument",
"source_url"
],
"properties": {
"isin": {
"type": "string",
"maxLength": 12,
"minLength": 12
},
"name": {
"type": "string"
},
"ticker": {
"type": "string"
},
"country": {
"type": "string",
"maxLength": 2,
"minLength": 2
},
"currency": {
"type": "string",
"maxLength": 3,
"minLength": 3
},
"exchange": {
"type": "string",
"maxLength": 4,
"minLength": 4
},
"selector": {
"type": "string"
},
"instrument": {
"enum": [
"ordinary_share",
"depositary_share",
"preferred_share"
]
},
"source_url": {
"$ref": "#a2"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message",
"recovery",
"retryable"
],
"properties": {
"code": {
"enum": [
"unauthorized",
"invalid_input",
"entity_not_found",
"entity_ambiguous",
"outside_entitlement",
"rate_limited",
"data_unavailable",
"insufficient_sample",
"unsupported_security",
"duplicate_request"
]
},
"message": {
"$ref": "#a1"
},
"recovery": {
"$ref": "#/$defs/a"
},
"retryable": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
},
"annotations": {
"title": "Get research coverage",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Retrieves saved research charts and tables for one investment case or context assessment. Without visual_id, returns available visual and region descriptors; with visual_id, returns the selected visual's regions. Supply region_id for available structured chart/table data, with bounded row pagination. Results preserve citations, recorded coverage, historical cutoffs and text-access restrictions. Use visual_offset for another descriptor page, without visual_id. Per-call x402 price: 0.02 USDC on Base.
| Parameter | Type | Description |
|---|---|---|
| as_of | string | |
| belief_id | string | |
| region_id | string | Use a region_id returned in the selected visual's regions to retrieve structured data. |
| row_limit | integer | Rows or chart points per read; defaults to 50, maximum 100. |
| visual_id | string | Omit to list saved visuals; supply a returned visual_id to inspect it. |
| row_offset | integer | Zero-based starting row or chart-point index in the selected region. |
| region_offset | integer | Continue a selected visual's region descriptors using next_region_offset. |
| visual_offset | integer | Continue visual descriptors using next_visual_offset; requires belief_id and cannot accompany visual_id. |
The free catalog at https://beliefstate.ai/v1/research lists every current paid operation, exact price, input/output contract, compatibility route and free discovery option. An unsigned call returns a quote for the exact request.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| support_text_offset |
| integer |
| UTF-16 offset within the selected supporting passage; defaults to 0. Use next_text_offset to continue its text. |
{
"name": "get_case",
"title": "Get investment case",
"description": "Retrieves one complete investment case by returned belief_id: investor, reasoning, evidence, risks, catalysts, conditions, revisions, outcomes, provenance and coverage gaps. Useful for deeper follow-ups; start company overviews with get_brief. Use paragraph_index only when returned in investment_case and follow support/text offsets for exact evidence. Optional relationship_paths inspects supported dependencies; scenario applies up to eight hypothetical conditions. Both preserve evidence and investor statements. Per-call x402 price: 0.02 USDC on Base.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"belief_id"
],
"properties": {
"as_of": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"scenario": {
"type": "object",
"required": [
"assumptions"
],
"properties": {
"assumptions": {
"type": "array",
"items": {
"type": "object",
"required": [
"condition_id",
"status"
],
"properties": {
"status": {
"enum": [
"pending",
"met",
"missed",
"triggered",
"not_triggered",
"unknown"
],
"type": "string"
},
"condition_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 8,
"minItems": 1
}
},
"description": "Optional hypothetical condition assumptions for this belief. Does not change evidence or predict the investor's response. REST: JSON-encode this query parameter.",
"additionalProperties": false
},
"belief_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"support_index": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Source support within the selected paragraph; defaults to 0. Use next_support_index for another passage."
},
"paragraph_index": {
"type": "integer",
"maximum": 44,
"minimum": 0,
"description": "Read exact source support only for a paragraph_index present in the returned investment_case. Records without investment_case do not support this selector. Requires belief_id. Continue with returned as_of and support/text offsets."
},
"relationship_paths": {
"type": "object",
"required": [
"from_entity_id",
"max_depth",
"edge_budget"
],
"properties": {
"max_depth": {
"type": "integer",
"maximum": 3,
"minimum": 1
},
"edge_budget": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"to_entity_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"from_entity_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"description": "Inspect directed edge sequences within this Belief's originating case. Maximum depth is 3; edge_budget bounds examined edge steps. Requires belief_id. REST: JSON-encode relationship_paths.",
"additionalProperties": false
},
"support_text_offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "UTF-16 offset within the selected supporting passage; defaults to 0. Use next_text_offset to continue its text."
}
},
"additionalProperties": false
},
"outputSchema": {
"truncated": true,
"chars": 80346
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}| time_horizon | string |
| changed_since | string | Find initial research, author revisions, condition checks/plans or released outcomes becoming available after this cutoff. Keeps author dates and stance separate from system activity. Release changes and a complete ordered event-history checkpoint are not yet included. |
{
"name": "get_cases",
"title": "Get investment cases",
"description": "Retrieves dated investment cases for one company or research subject, with optional investor, direction and time filters. Returns attributed thesis records, case IDs, dates, citations and coverage information. Use get_brief first for who covers a ticker and what each investor thinks. Use get_cases for an article-by-article inventory. Each page costs a request. Continue only if the user wants more pages, using unchanged selectors and the returned cursor. Use get_search_results for a thesis or topic question. Per-call x402 price: 0.02 USDC on Base.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"as_of": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Requested page size. For ticker/entity belief lists, MCP returns up to twelve complete summaries within its response budget; pagination.limit is the effective size. Continue with next_cursor and the same ticker/entity_id. REST supports larger pages."
},
"cursor": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"status": {
"enum": [
"forming",
"active",
"strengthened",
"weakened",
"reversed",
"resolved",
"abandoned",
"unknown"
],
"type": "string"
},
"ticker": {
"type": "string",
"maxLength": 32,
"minLength": 1
},
"direction": {
"enum": [
"bullish",
"bearish",
"mixed",
"neutral",
"non_directional",
"unknown"
],
"type": "string"
},
"entity_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "Released subject ID returned by get_subjects."
},
"person_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"time_horizon": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"changed_since": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
"description": "Find initial research, author revisions, condition checks/plans or released outcomes becoming available after this cutoff. Keeps author dates and stance separate from system activity. Release changes and a complete ordered event-history checkpoint are not yet included."
}
},
"additionalProperties": false
},
"outputSchema": {
"truncated": true,
"chars": 22751
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}| published_through | string |
{
"name": "get_catalysts",
"title": "Get case catalysts",
"description": "Retrieves evidence-linked catalysts for one company, research subject, investment case or the explicitly selected released corpus. Returns recorded conditions, lifecycle status, dates and supporting evidence. Useful for checking which thesis events remain pending, were met or missed, or have been superseded. Filter by investor, source, publication dates or status. Unassessed conditions retain unknown status. Continue with the returned cursor and unchanged filters. Per-call x402 price: 0.02 USDC on Base.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"as_of": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1
},
"corpus": {
"type": "string",
"const": "released"
},
"cursor": {
"type": "string",
"maxLength": 4096
},
"ticker": {
"type": "string",
"maxLength": 32,
"minLength": 1
},
"belief_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"entity_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"person_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"source_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"object_status": {
"type": "string"
},
"published_from": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"published_through": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$defs": {
"0": {
"type": "string",
"format": "date-time",
"$anchor": "a0",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"1": {
"type": "string",
"format": "uuid",
"$anchor": "a1",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"2": {
"type": "string",
"$anchor": "a2",
"minLength": 1
},
"3": {
"type": "integer",
"$anchor": "a5",
"maximum": 9007199254740991,
"minimum": 0
},
"4": {
"type": [
"string",
"null"
],
"$anchor": "a7"
},
"5": {
"anyOf": [
{
"$ref": "#a0"
},
{
"type": "null"
}
],
"$anchor": "a6"
},
"6": {
"type": "string",
"format": "uri",
"$anchor": "a3"
},
"7": {
"type": "string",
"$anchor": "a4",
"maxLength": 64,
"minLength": 64
},
"8": {
"anyOf": [
{
"$ref": "#a1"
},
{
"type": "null"
}
],
"$anchor": "a8"
},
"9": {
"type": "string",
"$anchor": "a9",
"pattern": "^[a-f0-9]{64}$"
},
"a": {
"type": "array",
"items": {
"type": "string"
},
"$anchor": "aa"
},
"b": {
"type": "object",
"$anchor": "ab",
"additionalProperties": {}
},
"c": {
"type": "object",
"required": [
"code",
"message",
"remaining_requests",
"add_credits_url",
"plans_url"
],
"properties": {
"code": {
"const": "signup_credit_exhausted"
},
"message": {
"$ref": "#a2"
},
"plans_url": {
"$ref": "#a3"
},
"add_credits_url": {
"$ref": "#a3"
},
"remaining_requests": {
"const": 0
}
},
"additionalProperties": false
},
"d": {
"type": "array",
"items": {
"type": "object",
"oneOf": [
{
"required": [
"object_id",
"version_id",
"belief_id",
"statement",
"statement_ordinal",
"effective_at",
"recorded_at",
"status_assessed_at",
"evidence",
"unknowns",
"kind",
"status",
"severity",
"severity_basis",
"severity_rationale",
"severity_methodology",
"continuing_relevance"
],
"properties": {
"kind": {
"const": "risk"
},
"status": {
"enum": [
"open",
"materialized",
"resolved",
"superseded",
"unknown"
]
},
"evidence": {
"$ref": "#/$defs/g"
},
"severity": {
"anyOf": [
{
"enum": [
"low",
"medium",
"high"
]
},
{
"type": "null"
}
]
},
"unknowns": {
"$ref": "#/$defs/h"
},
"belief_id": {
"$ref": "#a1"
},
"object_id": {
"$ref": "#a1"
},
"statement": {
"$ref": "#a2"
},
"version_id": {
"$ref": "#a4"
},
"recorded_at": {
"$ref": "#a0"
},
"effective_at": {
"$ref": "#a0"
},
"assessment_id": {
"$ref": "#a1"
},
"severity_basis": {
"enum": [
"source_stated",
"engine_assessed",
"unknown"
]
},
"assessment_cutoff": {
"$ref": "#a0"
},
"checking_evidence": {
"$ref": "#/$defs/i"
},
"statement_ordinal": {
"$ref": "#a5"
},
"severity_rationale": {
"$ref": "#a7"
},
"status_assessed_at": {
"$ref": "#a6"
},
"continuing_relevance": {
"type": [
"boolean",
"null"
]
},
"severity_methodology": {
"$ref": "#a7"
},
"assessment_available_at": {
"$ref": "#a0"
}
},
"additionalProperties": false
},
{
"required": [
"object_id",
"version_id",
"belief_id",
"statement",
"statement_ordinal",
"effective_at",
"recorded_at",
"status_assessed_at",
"evidence",
"unknowns",
"kind",
"status",
"expected_by",
"condition_id",
"superseded",
"checking_evidence",
"recorded_status",
"assessment",
"checking_support"
],
"properties": {
"kind": {
"const": "catalyst"
},
"status": {
"enum": [
"pending",
"met",
"missed",
"unknown"
]
},
"evidence": {
"$ref": "#/$defs/g"
},
"unknowns": {
"$ref": "#/$defs/h"
},
"belief_id": {
"$ref": "#a1"
},
"object_id": {
"$ref": "#a1"
},
"statement": {
"$ref": "#a2"
},
"assessment": {
"anyOf": [
{
"type": "object",
"required": [
"state",
"usable_as_current",
"assessed_at",
"provider_capability",
"reason",
"methodology_version"
],
"properties": {
"state": {
"enum": [
"not_checked",
"checked_unknown",
"unqualified",
"superseded",
"stale",
"current",
"historically_resolved"
]
},
"reason": {
"$ref": "#a2"
},
"assessed_at": {
"$ref": "#a0"
},
"usable_as_current": {
"type": "boolean"
},
"methodology_version": {
"const": "condition-read-qualification-v1"
},
"provider_capability": {
"enum": [
"share_price",
"sec_issuer",
"unsupported"
]
}
},
"description": "Qualification at this read cutoff, separate from the unchanged recorded status. Provider capability describes supported inputs, not enabled monitoring. A current check does not validate the whole investment case.",
"additionalProperties": false
},
{
"type": "null"
}
]
},
"superseded": {
"type": [
"boolean",
"null"
]
},
"version_id": {
"$ref": "#a4"
},
"expected_by": {
"$ref": "#a6"
},
"recorded_at": {
"$ref": "#a0"
},
"condition_id": {
"$ref": "#a8"
},
"effective_at": {
"$ref": "#a0"
},
"recorded_status": {
"$ref": "#a7"
},
"checking_support": {
"type": "object",
"oneOf": [
{
"required": [
"lineage",
"result"
],
"properties": {
"result": {
"type": "object",
"anyOf": [
{
"required": [
"kind",
"schema_version",
"result_id",
"provider",
"source_type",
"source_content_hash",
"facts"
],
"properties": {
"kind": {
"const": "provider_result"
},
"facts": {
"type": "object",
"required": [
"ticker",
"price",
"market_data_at",
"provider_observed_at",
"feed"
],
"properties": {
"feed": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"price": {
"type": "number",
"exclusiveMinimum": 0
},
"ticker": {
"$ref": "#/$defs/j"
},
"market_data_at": {
"$ref": "#a0"
},
"provider_observed_at": {
"$ref": "#a0"
}
},
"additionalProperties": false
},
"provider": {
"const": "alpaca"
},
"result_id": {
"type": "string",
"pattern": "^alpaca:market_price_snapshot:[a-f0-9]{64}$"
},
"source_type": {
"const": "market_price_snapshot"
},
"schema_version": {
"const": "condition-market-support-v1"
},
"source_content_hash": {
"$ref": "#a9"
}
},
"additionalProperties": false
},
{
"required": [
"kind",
"schema_version",
"result_id",
"provider",
"source_type",
"source_content_hash",
"facts",
"evidence"
],
"properties": {
"kind": {
"const": "provider_result"
},
"facts": {
"type": "object",
"required": [
"ticker",
"provider_observed_at"
],
"properties": {
"ticker": {
"$ref": "#/$defs/j"
},
"provider_observed_at": {
"$ref": "#a0"
}
},
"additionalProperties": false
},
"evidence": {
"type": "array",
"items": {
"type": "object",
"required": [
"document_id",
"quote",
"source_url",
"published_at",
"publication_time_basis",
"content_hash",
"start",
"end",
"representation"
],
"properties": {
"end": {
"$ref": "#/$defs/e"
},
"quote": {
"type": "string",
"maxLength": 1200,
"minLength": 12
},
"start": {
"$ref": "#a5"
},
"source_url": {
"$ref": "#a3"
},
"document_id": {
"$ref": "#a2"
},
"content_hash": {
"$ref": "#a4"
},
"published_at": {
"$ref": "#a0"
},
"representation": {
"enum": [
"issuer_text",
"structured_issuer_facts"
]
},
"publication_time_basis": {
"const": "filing_date_or_observation_bound"
}
},
"additionalProperties": false
},
"maxItems": 3,
"minItems": 1
},
"provider": {
"const": "sec_edgar"
},
"result_id": {
"$ref": "#a1"
},
"source_type": {
"const": "sec_edgar_issuer_snapshot"
},
"schema_version": {
"const": "condition-issuer-support-v1"
},
"source_content_hash": {
"$ref": "#a9"
}
},
"additionalProperties": false
}
]
},
"lineage": {
"const": "retained_provider_result"
}
},
"additionalProperties": false
},
{
"required": [
"lineage",
"result"
],
"properties": {
"result": {
"type": "object",
"required": [
"kind",
"schema_version",
"evidence"
],
"properties": {
"kind": {
"const": "retained_evidence"
},
"evidence": {
"type": "object",
"required": [
"source_id",
"evidence_id",
"source_revision_id",
"attributed_identity_id",
"source_content_hash",
"source_url",
"published_at",
"first_observed_at",
"captured_at",
"available_at",
"representation",
"visual_asset_id",
"quote",
"start",
"end"
],
"properties": {
"end": {
"$ref": "#/$defs/e"
},
"quote": {
"$ref": "#a2"
},
"start": {
"$ref": "#a5"
},
"source_id": {
"$ref": "#a1"
},
"source_url": {
"$ref": "#a3"
},
"captured_at": {
"$ref": "#a0"
},
"evidence_id": {
"$ref": "#a1"
},
"available_at": {
"$ref": "#a0"
},
"published_at": {
"$ref": "#a6"
},
"representation": {
"enum": [
"source_text",
"visual_transcription"
]
},
"visual_asset_id": {
"$ref": "#a8"
},
"first_observed_at": {
"$ref": "#a0"
},
"source_revision_id": {
"$ref": "#a1"
},
"source_content_hash": {
"$ref": "#a9"
},
"revision_published_at": {
"$ref": "#a6"
},
"attributed_identity_id": {
"$ref": "#a8"
}
},
"additionalProperties": false
},
"schema_version": {
"const": "condition-evidence-support-v1"
}
},
"additionalProperties": false
},
"lineage": {
"const": "retained_evidence"
}
},
"additionalProperties": false
},
{
"required": [
"lineage",
"result"
],
"properties": {
"result": {
"type": "null"
},
"lineage": {
"const": "limited_url_or_hash"
}
},
"additionalProperties": false
},
{
"required": [
"lineage",
"result"
],
"properties": {
"result": {
"type": "null"
},
"lineage": {
"const": "not_checked"
}
},
"additionalProperties": false
}
]
},
"checking_evidence": {
"$ref": "#/$defs/i"
},
"statement_ordinal": {
"$ref": "#a5"
},
"status_assessed_at": {
"$ref": "#a6"
}
},
"additionalProperties": false
}
]
}
},
"e": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"f": {
"type": "object",
"required": [
"evidence_id",
"source_id",
"source_url",
"source_title",
"published_at",
"first_observed_at",
"captured_at",
"content_hash",
"representation",
"source_coverage",
"support_ids"
],
"properties": {
"source_id": {
"$ref": "#a1"
},
"source_url": {
"$ref": "#a3"
},
"captured_at": {
"$ref": "#a0"
},
"citation_id": {
"$ref": "#a2"
},
"evidence_id": {
"$ref": "#a1"
},
"support_ids": {
"type": "array",
"items": {
"$ref": "#a1"
}
},
"content_hash": {
"$ref": "#a4"
},
"published_at": {
"$ref": "#a6"
},
"source_title": {
"type": "string"
},
"representation": {
"type": "string"
},
"source_coverage": {
"enum": [
"full",
"partial",
"unknown"
]
},
"first_observed_at": {
"$ref": "#a0"
},
"projection_receipt_id": {
"$ref": "#a1"
}
},
"additionalProperties": false
},
"g": {
"type": "array",
"items": {
"$ref": "#/$defs/f"
},
"minItems": 1
},
"h": {
"type": "array",
"items": {
"type": "object",
"required": [
"field",
"reason"
],
"properties": {
"field": {
"type": "string"
},
"reason": {
"type": "string"
}
},
"additionalProperties": false
}
},
"i": {
"type": "array",
"items": {
"$ref": "#/$defs/f"
}
},
"j": {
"type": "string",
"pattern": "^[A-Z][A-Z0-9.-]{0,19}$"
},
"k": {
"enum": [
"complete_within_scope",
"bounded",
"no_fit"
]
},
"l": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"m": {
"type": "object",
"required": [
"limit",
"returned",
"has_more",
"next_cursor"
],
"properties": {
"limit": {
"$ref": "#/$defs/l"
},
"has_more": {
"type": "boolean"
},
"returned": {
"$ref": "#/$defs/l"
},
"next_cursor": {
"$ref": "#a7"
}
},
"additionalProperties": false
},
"rf": {
"required": [
"detail_reference",
"schema_version",
"methodology_version",
"resource",
"view",
"generated_at",
"as_of",
"objects",
"coverage",
"pagination",
"warnings"
]
},
"rg": {
"required": [
"available_belief_count",
"omitted_belief_count",
"unassessed_status_count",
"unassessed_severity_count",
"history_state",
"selection_policy",
"completeness"
]
}
},
"anyOf": [
{
"anyOf": [
{
"allOf": [
{
"$ref": "#/$defs/rf"
}
],
"properties": {
"view": {
"enum": [
"risks",
"catalysts"
]
},
"as_of": {
"$ref": "#a0"
},
"objects": {
"$ref": "#/$defs/d"
},
"coverage": {
"type": "object",
"allOf": [
{
"$ref": "#/$defs/rg"
}
],
"properties": {
"completeness": {
"$ref": "#/$defs/k"
},
"history_state": {
"const": "unknown"
},
"selection_policy": {
"const": "current-beliefs-v7"
},
"omitted_belief_count": {
"$ref": "#a5"
},
"available_belief_count": {
"$ref": "#a5"
},
"unassessed_status_count": {
"$ref": "#a5"
},
"unassessed_severity_count": {
"$ref": "#a5"
}
},
"additionalProperties": false
},
"resource": {
"const": "beliefs"
},
"warnings": {
"$ref": "#aa"
},
"pagination": {
"$ref": "#/$defs/m"
},
"generated_at": {
"$ref": "#a0"
},
"billing_notice": {
"$ref": "#/$defs/c"
},
"schema_version": {
"const": "1"
},
"detail_reference": {
"$ref": "#a7"
},
"methodology_version": {
"const": "belief-objects-v1"
}
},
"additionalProperties": false
},
{
"allOf": [
{
"$ref": "#/$defs/rf"
}
],
"properties": {
"view": {
"enum": [
"risks",
"catalysts"
]
},
"as_of": {
"$ref": "#a0"
},
"objects": {
"$ref": "#/$defs/d"
},
"coverage": {
"type": "object",
"allOf": [
{
"$ref": "#/$defs/rg"
}
],
"properties": {
"completeness": {
"$ref": "#/$defs/k"
},
"history_state": {
"const": "unknown"
},
"selection_policy": {
"enum": [
"current-beliefs-v3",
"current-beliefs-v4",
"current-beliefs-v5"
]
},
"omitted_belief_count": {
"$ref": "#a5"
},
"available_belief_count": {
"$ref": "#a5"
},
"unassessed_status_count": {
"$ref": "#a5"
},
"unassessed_severity_count": {
"$ref": "#a5"
}
},
"additionalProperties": false
},
"resource": {
"const": "beliefs"
},
"warnings": {
"$ref": "#aa"
},
"pagination": {
"$ref": "#/$defs/m"
},
"generated_at": {
"$ref": "#a0"
},
"billing_notice": {
"$ref": "#/$defs/c"
},
"schema_version": {
"const": "1"
},
"detail_reference": {
"$ref": "#a7"
},
"methodology_version": {
"const": "belief-objects-v1"
}
},
"additionalProperties": false
}
]
},
{
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message",
"recovery",
"retryable"
],
"properties": {
"code": {
"enum": [
"unauthorized",
"invalid_input",
"entity_not_found",
"entity_ambiguous",
"outside_entitlement",
"rate_limited",
"data_unavailable",
"insufficient_sample",
"unsupported_security",
"duplicate_request"
]
},
"message": {
"$ref": "#a2"
},
"recovery": {
"anyOf": [
{
"$ref": "#a2"
},
{
"type": "null"
}
]
},
"retryable": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"required": [
"accepts",
"resource",
"x402Version"
],
"properties": {
"error": {
"type": "string"
},
"accepts": {
"type": "array",
"items": {
"type": "object",
"required": [
"amount",
"asset",
"maxTimeoutSeconds",
"network",
"payTo",
"scheme"
],
"properties": {
"asset": {
"$ref": "#a2"
},
"extra": {
"$ref": "#ab"
},
"payTo": {
"$ref": "#a2"
},
"amount": {
"type": "string",
"pattern": "^\\d+$"
},
"scheme": {
"enum": [
"exact"
]
},
"network": {
"type": "string",
"pattern": "^eip155:\\d+$"
},
"maxTimeoutSeconds": {
"type": "number"
}
},
"additionalProperties": false
},
"minItems": 1
},
"resource": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"$ref": "#a2"
},
"tags": {
"$ref": "#aa"
},
"iconUrl": {
"type": "string"
},
"mimeType": {
"type": "string"
},
"description": {
"type": "string"
},
"serviceName": {
"type": "string"
}
},
"additionalProperties": false
},
"extensions": {
"type": "object",
"additionalProperties": {
"type": "object",
"required": [
"info",
"schema"
],
"properties": {
"info": {
"$ref": "#ab"
},
"schema": {
"$ref": "#ab"
}
},
"additionalProperties": false
}
},
"x402Version": {
"const": 2
}
},
"additionalProperties": false
},
{
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"enum": [
"payment_pending",
"rate_limited"
]
},
"message": {
"$ref": "#a2"
},
"retryable": {
"const": true
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}| person_id | string |
| source_id | string |
| checkpoint | string |
| event_kind | string |
| changed_since | string |
| revision_only | boolean |
{
"name": "get_changes",
"title": "Get research changes",
"description": "Retrieves the ordered research change journal for a company, subject, case or explicitly selected released corpus. Returns dated events, citations and available before/after values, separating author revisions, distribution changes and calculated publication outcomes. Use domain=author_view for investor-view changes and revision_only=true for authored revisions only; get_brief provides a current synthesis. Preserve publication, observation and availability clocks. Drain a requested window with unchanged selectors; its continuation cursor differs from the completed next-poll checkpoint. Coverage and resynchronization gaps remain explicit. Per-call x402 price: 0.02 USDC on Base.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"as_of": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1
},
"corpus": {
"type": "string",
"const": "released"
},
"cursor": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"domain": {
"enum": [
"author_view",
"author_condition",
"engine_assessment",
"calculated_publication_outcome",
"distribution",
"identity_resolution",
"provenance",
"engine_quality",
"engine_plan"
],
"type": "string"
},
"resync": {
"type": "boolean"
},
"ticker": {
"type": "string"
},
"belief_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"entity_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"person_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"source_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"checkpoint": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"event_kind": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"changed_since": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"revision_only": {
"type": "boolean"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$defs": {
"0": {
"type": "string",
"$anchor": "a2",
"minLength": 1
},
"1": {
"anyOf": [
{
"$ref": "#a0"
},
{
"type": "null"
}
],
"$anchor": "a3"
},
"2": {
"type": "string",
"format": "date-time",
"$anchor": "a0",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"3": {
"anyOf": [
{
"$ref": "#a1"
},
{
"type": "null"
}
],
"$anchor": "a5"
},
"4": {
"type": "object",
"$anchor": "a6",
"additionalProperties": {}
},
"5": {
"type": "string",
"format": "uuid",
"$anchor": "a1",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"6": {
"type": "array",
"items": {
"$ref": "#a2"
},
"$anchor": "a4"
},
"7": {
"anyOf": [
{
"$ref": "#a2"
},
{
"type": "null"
}
],
"$anchor": "a7"
},
"8": {
"type": "array",
"items": {
"$ref": "#a2"
},
"minItems": 1
}
},
"anyOf": [
{
"required": [
"schema_version",
"methodology_version",
"generated_at",
"as_of",
"scope",
"data_status",
"entitlement",
"data",
"citations",
"warnings"
],
"properties": {
"data": {
"type": "object",
"required": [
"mode",
"status",
"changes",
"inventory",
"continuation_cursor",
"polling_checkpoint",
"projection_epoch",
"history_coverage"
],
"properties": {
"mode": {
"enum": [
"changes",
"resync"
]
},
"status": {
"enum": [
"available",
"resync_required",
"projection_catching_up",
"history_uninitialized"
]
},
"changes": {
"type": "array",
"items": {
"type": "object",
"required": [
"event_id",
"kind",
"belief_id",
"entity_id",
"security_id",
"domain",
"changed_dimensions",
"before",
"after",
"clocks",
"reconstructed",
"methodology",
"citation_ids",
"omitted_fields"
],
"properties": {
"kind": {
"$ref": "#a2"
},
"after": {
"$ref": "#a6"
},
"before": {
"anyOf": [
{
"$ref": "#a6"
},
{
"type": "null"
}
]
},
"clocks": {
"type": "object",
"required": [
"author_published_at",
"effective_at",
"occurrence_at",
"observed_at",
"source_observed_at",
"source_captured_at",
"assessed_at",
"canonical_recorded_at",
"promotion_recorded_at",
"post_commit_observed_at",
"available_at"
],
"properties": {
"assessed_at": {
"$ref": "#a3"
},
"observed_at": {
"$ref": "#a3"
},
"available_at": {
"$ref": "#a3"
},
"effective_at": {
"$ref": "#a3"
},
"occurrence_at": {
"$ref": "#a3"
},
"source_captured_at": {
"$ref": "#a0"
},
"source_observed_at": {
"$ref": "#a0"
},
"author_published_at": {
"$ref": "#a3"
},
"canonical_recorded_at": {
"$ref": "#a0"
},
"promotion_recorded_at": {
"$ref": "#a0"
},
"post_commit_observed_at": {
"$ref": "#a0"
}
},
"additionalProperties": false
},
"domain": {
"enum": [
"author_view",
"author_condition",
"engine_assessment",
"calculated_publication_outcome",
"distribution",
"identity_resolution",
"provenance",
"engine_quality",
"engine_plan"
]
},
"event_id": {
"$ref": "#a1"
},
"belief_id": {
"$ref": "#a5"
},
"entity_id": {
"$ref": "#a5"
},
"methodology": {
"$ref": "#a6"
},
"security_id": {
"$ref": "#a5"
},
"citation_ids": {
"$ref": "#/$defs/8"
},
"reconstructed": {
"type": "boolean"
},
"omitted_fields": {
"$ref": "#a4"
},
"changed_dimensions": {
"$ref": "#a4"
},
"context_assessment_id": {
"$ref": "#a5"
}
},
"additionalProperties": false
}
},
"inventory": {
"type": "array",
"items": {
"type": "object",
"required": [
"belief_id",
"entity_id",
"security_id",
"citation_ids"
],
"properties": {
"belief_id": {
"$ref": "#a5"
},
"entity_id": {
"$ref": "#a5"
},
"security_id": {
"$ref": "#a5"
},
"citation_ids": {
"$ref": "#/$defs/8"
},
"context_assessment_id": {
"$ref": "#a5"
}
},
"additionalProperties": false
}
},
"history_coverage": {
"type": "object",
"additionalProperties": {
"type": "object",
"required": [
"earliest_complete_at",
"reconstructed"
],
"properties": {
"reconstructed": {
"type": "boolean"
},
"earliest_complete_at": {
"$ref": "#a3"
}
},
"additionalProperties": false
}
},
"projection_epoch": {
"$ref": "#a5"
},
"polling_checkpoint": {
"type": [
"string",
"null"
]
},
"continuation_cursor": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"as_of": {
"$ref": "#a0"
},
"scope": {
"type": "object",
"anyOf": [
{
"required": [
"ticker"
],
"properties": {
"ticker": {
"type": "string",
"pattern": "^[A-Z0-9][A-Z0-9.-]{0,14}$"
}
},
"additionalProperties": false
},
{
"required": [
"entity_id"
],
"properties": {
"entity_id": {
"$ref": "#a1"
}
},
"additionalProperties": false
},
{
"required": [
"belief_id"
],
"properties": {
"belief_id": {
"$ref": "#a1"
}
},
"additionalProperties": false
},
{
"required": [
"corpus"
],
"properties": {
"corpus": {
"const": "released"
}
},
"additionalProperties": false
}
]
},
"warnings": {
"$ref": "#a4"
},
"citations": {
"type": "array",
"items": {
"type": "object",
"required": [
"citation_id",
"evidence_id",
"source_url",
"source_title",
"author_name",
"published_at",
"observed_at",
"excerpt"
],
"properties": {
"excerpt": {
"$ref": "#a7"
},
"source_url": {
"type": "string",
"format": "uri"
},
"author_name": {
"$ref": "#a7"
},
"citation_id": {
"$ref": "#a2"
},
"evidence_id": {
"$ref": "#a2"
},
"observed_at": {
"$ref": "#a0"
},
"published_at": {
"$ref": "#a3"
},
"source_title": {
"$ref": "#a2"
},
"full_document_stored": {
"type": [
"boolean",
"null"
],
"description": "Recorded storage flag, separate from verified source completeness. Null or absent means unknown."
},
"source_text_coverage": {
"anyOf": [
{
"enum": [
"partial",
"feed_body_field_unverified",
"context_article_unverified"
]
},
{
"type": "null"
}
],
"description": "Stored source-capture scope. Null or absent means unknown; no value here verifies complete article coverage."
}
},
"additionalProperties": false
}
},
"data_status": {
"type": "object",
"required": [
"mode",
"freshness",
"coverage",
"latest_observation_at",
"limitations"
],
"properties": {
"mode": {
"enum": [
"live",
"preview"
]
},
"coverage": {
"enum": [
"complete",
"partial",
"insufficient"
]
},
"freshness": {
"enum": [
"current",
"delayed",
"stale"
]
},
"limitations": {
"$ref": "#a4"
},
"latest_observation_at": {
"$ref": "#a3"
}
},
"additionalProperties": false
},
"entitlement": {
"type": "object",
"required": [
"freshness",
"history_start",
"result_limit"
],
"properties": {
"freshness": {
"$ref": "#a2"
},
"result_limit": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"history_start": {
"$ref": "#a3"
}
},
"additionalProperties": false
},
"generated_at": {
"$ref": "#a0"
},
"billing_notice": {
"type": "object",
"required": [
"code",
"message",
"remaining_requests",
"add_credits_url",
"plans_url"
],
"properties": {
"code": {
"const": "signup_credit_exhausted"
},
"message": {
"$ref": "#a2"
},
"plans_url": {
"type": "string",
"format": "uri"
},
"add_credits_url": {
"type": "string",
"format": "uri"
},
"remaining_requests": {
"const": 0
}
},
"additionalProperties": false
},
"schema_version": {
"const": "1"
},
"methodology_version": {
"const": "belief-changes-v1"
}
},
"additionalProperties": false
},
{
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message",
"recovery",
"retryable"
],
"properties": {
"code": {
"enum": [
"unauthorized",
"invalid_input",
"entity_not_found",
"entity_ambiguous",
"outside_entitlement",
"rate_limited",
"data_unavailable",
"insufficient_sample",
"unsupported_security",
"duplicate_request"
]
},
"message": {
"$ref": "#a2"
},
"recovery": {
"$ref": "#a7"
},
"retryable": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"required": [
"accepts",
"resource",
"x402Version"
],
"properties": {
"error": {
"type": "string"
},
"accepts": {
"type": "array",
"items": {
"type": "object",
"required": [
"amount",
"asset",
"maxTimeoutSeconds",
"network",
"payTo",
"scheme"
],
"properties": {
"asset": {
"$ref": "#a2"
},
"extra": {
"$ref": "#a6"
},
"payTo": {
"$ref": "#a2"
},
"amount": {
"type": "string",
"pattern": "^\\d+$"
},
"scheme": {
"enum": [
"exact"
]
},
"network": {
"type": "string",
"pattern": "^eip155:\\d+$"
},
"maxTimeoutSeconds": {
"type": "number"
}
},
"additionalProperties": false
},
"minItems": 1
},
"resource": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"$ref": "#a2"
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"iconUrl": {
"type": "string"
},
"mimeType": {
"type": "string"
},
"description": {
"type": "string"
},
"serviceName": {
"type": "string"
}
},
"additionalProperties": false
},
"extensions": {
"type": "object",
"additionalProperties": {
"type": "object",
"required": [
"info",
"schema"
],
"properties": {
"info": {
"$ref": "#a6"
},
"schema": {
"$ref": "#a6"
}
},
"additionalProperties": false
}
},
"x402Version": {
"const": 2
}
},
"additionalProperties": false
},
{
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"enum": [
"payment_pending",
"rate_limited"
]
},
"message": {
"$ref": "#a2"
},
"retryable": {
"const": true
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}| ticker * | string |
| date_to | string | Inclusive native date upper bound, selected by date_field. |
| metrics | array |
| taxonomy | string |
| date_from | string | Inclusive native date lower bound, selected by date_field. |
| dimension | string | Issuer-reported segment, product or geography label substring; requires an issuer-metric record_type. |
| date_field | string | Date meaning; defaults to period for facts/macro/holdings/returns, event for insider trades, observation for options/short volume, scheduled for calendar. |
| fiscal_year | integer | Issuer's stated fiscal year; requires an issuer-metric record_type. Does not imply calendar-year dates. |
| power_stage | string | Match the site milestone or its power measurements at this stage. Requires site_milestone. |
| record_type | string | Select financial_fact, financial_statement, company_reference, segment_metric, operating_kpi, management_guidance or site_milestone. Site milestones keep permit, contract, delivery, billing and plan stages distinct. Issuer metrics use selected admitted SEC disclosures, not complete history; guidance… |
| snapshot_id | string | Pin continuation to the returned snapshot ID; reuse with snapshot_hash and as_of. |
| period_label | string | Exact returned fiscal period label; requires an issuer-metric record_type. Use for guidance targets whose calendar dates are unknown; date_field=report instead filters issuance dates. |
| period_start | string | Exact reported fact period start; distinguish quarterly and annual facts with the same end date. |
| snapshot_hash | string |
| filters_sha256 | string | Reuse the returned filter hash unchanged with continuation pages. |
| fiscal_quarter | integer | Issuer's stated fiscal quarter, 1 through 4; use with fiscal_year for requested fiscal periods. |
| reported_quarters | integer |
| max_snapshot_age_hours | number | Requested verification-age tolerance: default1hour for retained archives,24hours for closing-price references. Record dates and publication cadence are separate. |
{
"name": "get_company_facts",
"title": "Get company facts",
"description": "Returns retained financial facts, company references, segment metrics, operating KPIs, management guidance and site milestones for one ticker. Use record_type=site_milestone for cited permit, contract, delivery and billing stages and source-specific dates. Use fiscal_year/fiscal_quarter for fiscal periods and date_field=report for issuance. Guidance is a forecast; reported tolerances and computed bounds stay separate. Inspect available_issuer_selectors for empty metric or dimension results. Coverage is bounded. Current archive reads recheck stale metadata. Historical and pinned reads use saved records. Reuse snapshot, cutoff and filters with the returned cursor or next_offset. Per-call x402 price: 0.02 USDC on Base.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"ticker"
],
"properties": {
"site": {
"type": "string",
"maxLength": 160,
"minLength": 1,
"description": "Site name substring. Requires site_milestone."
},
"unit": {
"type": "string",
"maxLength": 64
},
"as_of": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
"description": "Availability cutoff, separate from event/period filters. Historical reads never refresh."
},
"basis": {
"enum": [
"GAAP",
"IFRS",
"non_gaap",
"operational",
"unknown"
],
"type": "string",
"description": "Accounting or operating basis; requires an issuer-metric record_type."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Matching typed observations per page; default32."
},
"cursor": {
"type": "string",
"maxLength": 4096,
"description": "Archive continuation token; reuse with snapshot ID/hash, as_of and unchanged filters."
},
"family": {
"enum": [
"financial",
"market_reference",
"site_milestones"
],
"type": "string"
},
"offset": {
"type": "integer",
"maximum": 10000000,
"minimum": 0
},
"ticker": {
"type": "string",
"pattern": "^[A-Z][A-Z0-9.-]{0,15}$"
},
"date_to": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Inclusive native date upper bound, selected by date_field."
},
"metrics": {
"type": "array",
"items": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"maxItems": 20,
"minItems": 1
},
"taxonomy": {
"type": "string",
"maxLength": 128
},
"date_from": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Inclusive native date lower bound, selected by date_field."
},
"dimension": {
"type": "string",
"maxLength": 128,
"description": "Issuer-reported segment, product or geography label substring; requires an issuer-metric record_type."
},
"date_field": {
"enum": [
"period",
"report",
"event"
],
"type": "string",
"description": "Date meaning; defaults to period for facts/macro/holdings/returns, event for insider trades, observation for options/short volume, scheduled for calendar."
},
"fiscal_year": {
"type": "integer",
"maximum": 2200,
"minimum": 1900,
"description": "Issuer's stated fiscal year; requires an issuer-metric record_type. Does not imply calendar-year dates."
},
"power_stage": {
"enum": [
"permitted",
"contracted",
"delivered",
"billable",
"planned"
],
"type": "string",
"description": "Match the site milestone or its power measurements at this stage. Requires site_milestone."
},
"record_type": {
"enum": [
"financial_fact",
"financial_statement",
"company_reference",
"segment_metric",
"operating_kpi",
"management_guidance",
"site_milestone"
],
"type": "string",
"description": "Select financial_fact, financial_statement, company_reference, segment_metric, operating_kpi, management_guidance or site_milestone. Site milestones keep permit, contract, delivery, billing and plan stages distinct. Issuer metrics use selected admitted SEC disclosures, not complete history; guidance is a forecast, not an actual result."
},
"snapshot_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "Pin continuation to the returned snapshot ID; reuse with snapshot_hash and as_of."
},
"period_label": {
"type": "string",
"maxLength": 128,
"description": "Exact returned fiscal period label; requires an issuer-metric record_type. Use for guidance targets whose calendar dates are unknown; date_field=report instead filters issuance dates."
},
"period_start": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Exact reported fact period start; distinguish quarterly and annual facts with the same end date."
},
"snapshot_hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"filters_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "Reuse the returned filter hash unchanged with continuation pages."
},
"fiscal_quarter": {
"type": "integer",
"maximum": 4,
"minimum": 1,
"description": "Issuer's stated fiscal quarter, 1 through 4; use with fiscal_year for requested fiscal periods."
},
"reported_quarters": {
"type": "integer",
"maximum": 4,
"minimum": 0
},
"max_snapshot_age_hours": {
"type": "number",
"maximum": 87600,
"description": "Requested verification-age tolerance: default1hour for retained archives,24hours for closing-price references. Record dates and publication cadence are separate.",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"outputSchema": {
"truncated": true,
"chars": 23840
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}| date_from |
| string |
| Inclusive native date lower bound, selected by date_field. |
| date_field | string | Date meaning; defaults to period for facts/macro/holdings/returns, event for insider trades, observation for options/short volume, scheduled for calendar. |
| snapshot_id | string | Pin continuation to the returned snapshot ID; reuse with snapshot_hash and as_of. |
| snapshot_hash | string |
| event_contains | string |
| filters_sha256 | string | Reuse the returned filter hash unchanged with continuation pages. |
| max_snapshot_age_hours | number | Requested verification-age tolerance: default1hour for retained archives,24hours for closing-price references. Record dates and publication cadence are separate. |
{
"name": "get_economic_calendar",
"title": "Get economic calendar",
"description": "Retrieves retained US economic events in one ticker research scope. Filter by event text, region, scheduled/reported/unconfirmed state and scheduled-date bounds. Returns typed actual, previous, consensus and forecast literals, revision markers, native times and source support; an unverified timezone stays unknown. Current requests recheck stale mirror metadata; historical and pinned reads never refresh. This is retained calendar context, with snapshot freshness separate from event time. Continue with the returned snapshot, cutoff, filters and cursor or next_offset. Per-call x402 price: 0.02 USDC on Base.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"ticker"
],
"properties": {
"as_of": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
"description": "Availability cutoff, separate from event/period filters. Historical reads never refresh."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Matching typed observations per page; default32."
},
"state": {
"enum": [
"scheduled",
"reported",
"unconfirmed"
],
"type": "string"
},
"cursor": {
"type": "string",
"maxLength": 4096,
"description": "Archive continuation token; reuse with snapshot ID/hash, as_of and unchanged filters."
},
"offset": {
"type": "integer",
"maximum": 10000000,
"minimum": 0
},
"region": {
"type": "string",
"maxLength": 16,
"minLength": 1
},
"ticker": {
"type": "string",
"pattern": "^[A-Z][A-Z0-9.-]{0,15}$"
},
"date_to": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Inclusive native date upper bound, selected by date_field."
},
"date_from": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Inclusive native date lower bound, selected by date_field."
},
"date_field": {
"enum": [
"scheduled",
"report"
],
"type": "string",
"description": "Date meaning; defaults to period for facts/macro/holdings/returns, event for insider trades, observation for options/short volume, scheduled for calendar."
},
"snapshot_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "Pin continuation to the returned snapshot ID; reuse with snapshot_hash and as_of."
},
"snapshot_hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"event_contains": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"filters_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "Reuse the returned filter hash unchanged with continuation pages."
},
"max_snapshot_age_hours": {
"type": "number",
"maximum": 87600,
"description": "Requested verification-age tolerance: default1hour for retained archives,24hours for closing-price references. Record dates and publication cadence are separate.",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$defs": {
"0": {
"type": [
"string",
"null"
],
"$anchor": "a2"
},
"1": {
"type": "string",
"$anchor": "a4",
"minLength": 1
},
"2": {
"type": "string",
"format": "date-time",
"$anchor": "a1",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"3": {
"type": "string",
"$anchor": "a3",
"pattern": "^[a-f0-9]{64}$"
},
"4": {
"type": "integer",
"$anchor": "a0",
"maximum": 9007199254740991,
"minimum": 0
},
"5": {
"anyOf": [
{
"$ref": "#a0"
},
{
"type": "null"
}
],
"$anchor": "aa"
},
"6": {
"type": "string",
"format": "uuid",
"$anchor": "a6",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"7": {
"anyOf": [
{
"$ref": "#a1"
},
{
"type": "null"
}
],
"$anchor": "a7"
},
"8": {
"type": "string",
"format": "uri",
"$anchor": "a5"
},
"9": {
"type": "object",
"$anchor": "a9",
"required": [
"value",
"unit"
],
"properties": {
"unit": {
"$ref": "#a2"
},
"value": {
"$ref": "#a2"
}
},
"additionalProperties": false
},
"a": {
"type": "array",
"items": {
"type": "string"
},
"$anchor": "ac"
},
"b": {
"anyOf": [
{
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
{
"type": "null"
}
],
"$anchor": "a8"
},
"c": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"$anchor": "ab"
},
"d": {
"type": "object",
"$anchor": "ad",
"additionalProperties": {}
},
"e": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 100
},
"f": {
"anyOf": [
{
"$ref": "#a3"
},
{
"type": "null"
}
]
}
},
"anyOf": [
{
"required": [
"schema_version",
"resource",
"operation",
"ticker",
"as_of",
"generated_at",
"status",
"context",
"snapshot_captured_at",
"historical_issuer_ownership_verified",
"data",
"sources",
"pagination",
"limitations"
],
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"required": [
"family",
"status",
"records",
"retained_records",
"matched_records",
"omitted_records",
"held_records",
"freshness",
"coverage",
"limitations"
],
"properties": {
"family": {
"const": "economic_calendar"
},
"status": {
"type": "string"
},
"records": {
"type": "array",
"items": {
"type": "object",
"required": [
"record_id",
"source_kind",
"support",
"observed_at",
"period_end",
"reported_at",
"native_details",
"type",
"event",
"region",
"scheduled_date",
"native_time",
"timezone",
"period_hint",
"actual",
"previous",
"consensus",
"forecast",
"revision_marker",
"state"
],
"properties": {
"type": {
"const": "economic_event"
},
"event": {
"$ref": "#a2"
},
"state": {
"enum": [
"scheduled",
"reported",
"unconfirmed"
]
},
"actual": {
"$ref": "#a9"
},
"region": {
"$ref": "#a2"
},
"support": {
"type": "object",
"required": [
"document_id",
"content_hash",
"json_pointer"
],
"properties": {
"text_span": {
"type": "object",
"required": [
"start",
"end"
],
"properties": {
"end": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"start": {
"$ref": "#a0"
}
},
"additionalProperties": false
},
"document_id": {
"type": "string"
},
"content_hash": {
"$ref": "#a3"
},
"json_pointer": {
"$ref": "#a2"
}
},
"additionalProperties": false
},
"forecast": {
"$ref": "#a9"
},
"previous": {
"$ref": "#a9"
},
"timezone": {
"type": "null"
},
"consensus": {
"$ref": "#a9"
},
"record_id": {
"type": "string"
},
"period_end": {
"$ref": "#a2"
},
"native_time": {
"$ref": "#a2"
},
"observed_at": {
"$ref": "#a2"
},
"period_hint": {
"$ref": "#a2"
},
"reported_at": {
"$ref": "#a2"
},
"source_kind": {
"type": "string"
},
"native_details": {
"anyOf": [
{
"type": "object",
"required": [
"attributes",
"measurements",
"clocks"
],
"properties": {
"clocks": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"role",
"value",
"precision"
],
"properties": {
"name": {
"$ref": "#a4"
},
"role": {
"enum": [
"period",
"event",
"report",
"expiration",
"scheduled",
"observation"
]
},
"value": {
"$ref": "#a2"
},
"precision": {
"enum": [
"instant",
"date",
"period",
"unknown"
]
}
},
"additionalProperties": false
},
"maxItems": 8
},
"attributes": {
"type": "object",
"additionalProperties": {
"$ref": "#a2"
}
},
"measurements": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"value",
"unit"
],
"properties": {
"name": {
"$ref": "#a4"
},
"unit": {
"$ref": "#a2"
},
"value": {
"type": [
"string",
"number",
"null"
]
}
},
"additionalProperties": false
},
"maxItems": 128
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"scheduled_date": {
"$ref": "#a2"
},
"revision_marker": {
"$ref": "#a2"
}
},
"additionalProperties": false
},
"maxItems": 100
},
"coverage": {
"enum": [
"complete_for_retained_scope",
"partial_archive_scan",
"bounded_snapshot",
"unavailable"
]
},
"freshness": {
"type": "object",
"required": [
"status",
"evaluated_at",
"source_captured_at",
"age_seconds",
"max_snapshot_age_seconds",
"latest_record_at",
"publication_cadence_verified",
"refresh_status"
],
"properties": {
"status": {
"enum": [
"fresh",
"stale",
"unknown",
"historical"
]
},
"age_seconds": {
"$ref": "#ab"
},
"evaluated_at": {
"$ref": "#a1"
},
"refresh_status": {
"enum": [
"not_required",
"historical_no_refresh",
"newer_admission_unverified",
"source_clock_unknown"
]
},
"latest_record_at": {
"$ref": "#a2"
},
"source_captured_at": {
"$ref": "#a7"
},
"source_verified_at": {
"$ref": "#a7"
},
"verification_scope": {
"const": "filing_inventory"
},
"capture_age_seconds": {
"$ref": "#ab"
},
"max_snapshot_age_seconds": {
"type": "number",
"exclusiveMinimum": 0
},
"verification_age_seconds": {
"$ref": "#ab"
},
"publication_cadence_verified": {
"const": false
}
},
"additionalProperties": false
},
"limitations": {
"$ref": "#ac"
},
"held_records": {
"$ref": "#aa"
},
"matched_records": {
"$ref": "#aa"
},
"omitted_records": {
"$ref": "#aa"
},
"retained_records": {
"$ref": "#aa"
},
"available_issuer_selectors": {
"type": "object",
"required": [
"metrics",
"dimensions",
"fiscal_years",
"scope",
"truncated"
],
"properties": {
"scope": {
"const": "retained_issuer_observations"
},
"metrics": {
"$ref": "#/$defs/e"
},
"truncated": {
"type": "boolean"
},
"dimensions": {
"$ref": "#/$defs/e"
},
"fiscal_years": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"maxItems": 100
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"maxItems": 1
},
"as_of": {
"$ref": "#a1"
},
"status": {
"enum": [
"available",
"partial",
"unavailable"
]
},
"ticker": {
"type": "string"
},
"context": {
"anyOf": [
{
"type": "object",
"required": [
"artifact_id",
"content_hash",
"observed_through",
"available_at"
],
"properties": {
"artifact_id": {
"$ref": "#a6"
},
"available_at": {
"$ref": "#a1"
},
"content_hash": {
"type": "string"
},
"observed_through": {
"$ref": "#a1"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"sources": {
"type": "array",
"items": {
"type": "object",
"anyOf": [
{
"required": [
"id",
"source_id",
"kind",
"title",
"url",
"published_at",
"publication_date",
"publication_precision",
"observed_at",
"content_hash",
"raw_capture_hash",
"retained_record_hash",
"capture_basis",
"representation"
],
"properties": {
"id": {
"$ref": "#a4"
},
"url": {
"$ref": "#a5"
},
"kind": {
"enum": [
"sec_disclosure",
"government_award",
"issuer_disclosure",
"research_input"
]
},
"title": {
"type": "string"
},
"source_id": {
"$ref": "#a6"
},
"observed_at": {
"$ref": "#a1"
},
"content_hash": {
"$ref": "#a3"
},
"published_at": {
"$ref": "#a7"
},
"capture_basis": {
"enum": [
"http_response_bytes",
"retained_export",
"retained_case"
]
},
"representation": {
"enum": [
"provider_json",
"sec_xbrl",
"visible_text",
"retained_research_case"
]
},
"publication_date": {
"$ref": "#a8"
},
"raw_capture_hash": {
"$ref": "#/$defs/f"
},
"retained_record_hash": {
"$ref": "#/$defs/f"
},
"publication_precision": {
"enum": [
"instant",
"date",
"unknown"
]
}
},
"additionalProperties": false
},
{
"required": [
"id",
"kind",
"title",
"url",
"observed_at",
"content_hash",
"observation_hashes_sha256",
"observation_count",
"calendar_artifact_id",
"calendar_content_hash",
"representation"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"$ref": "#a5"
},
"kind": {
"const": "stored_market_data"
},
"title": {
"type": "string"
},
"providers": {
"$ref": "#ac"
},
"observed_at": {
"$ref": "#a1"
},
"content_hash": {
"$ref": "#a3"
},
"representation": {
"const": "reconciled_daily_bars"
},
"observation_count": {
"$ref": "#a0"
},
"calendar_artifact_id": {
"$ref": "#a6"
},
"calendar_content_hash": {
"$ref": "#a3"
},
"observation_hashes_sha256": {
"$ref": "#a3"
}
},
"additionalProperties": false
}
]
}
},
"resource": {
"const": "company_dataset"
},
"operation": {
"const": "get_economic_calendar"
},
"pagination": {
"type": "object",
"required": [
"offset",
"returned",
"total_retained_records",
"total_matching_records",
"next_offset",
"snapshot_id",
"snapshot_hash",
"filters_sha256"
],
"properties": {
"offset": {
"$ref": "#a0"
},
"returned": {
"$ref": "#a0"
},
"next_cursor": {
"$ref": "#a2"
},
"next_offset": {
"$ref": "#aa"
},
"snapshot_id": {
"anyOf": [
{
"$ref": "#a6"
},
{
"type": "null"
}
]
},
"scanned_rows": {
"$ref": "#a0"
},
"scan_complete": {
"type": "boolean"
},
"snapshot_hash": {
"$ref": "#a2"
},
"filters_sha256": {
"type": "string"
},
"total_matching_records": {
"$ref": "#aa"
},
"total_retained_records": {
"$ref": "#aa"
}
},
"additionalProperties": false
},
"limitations": {
"$ref": "#ac"
},
"generated_at": {
"$ref": "#a1"
},
"query_binding": {
"type": "object",
"required": [
"artifactId",
"contentHash"
],
"properties": {
"artifactId": {
"$ref": "#a6"
},
"contentHash": {
"$ref": "#a3"
}
},
"additionalProperties": false
},
"billing_notice": {
"type": "object",
"required": [
"code",
"message",
"remaining_requests",
"add_credits_url",
"plans_url"
],
"properties": {
"code": {
"const": "signup_credit_exhausted"
},
"message": {
"$ref": "#a4"
},
"plans_url": {
"$ref": "#a5"
},
"add_credits_url": {
"$ref": "#a5"
},
"remaining_requests": {
"const": 0
}
},
"additionalProperties": false
},
"issuer_refresh": {
"type": "object",
"required": [
"status",
"filing_inventory_verified_at",
"backfill_from",
"backfill_through",
"history_complete",
"held_documents"
],
"properties": {
"status": {
"enum": [
"not_required",
"queued",
"unavailable",
"saved_only"
]
},
"backfill_from": {
"$ref": "#a8"
},
"held_documents": {
"$ref": "#a0"
},
"backfill_through": {
"$ref": "#a8"
},
"history_complete": {
"type": "boolean"
},
"filing_inventory_verified_at": {
"$ref": "#a7"
}
},
"additionalProperties": false
},
"schema_version": {
"const": "2"
},
"snapshot_captured_at": {
"$ref": "#a7"
},
"historical_issuer_ownership_verified": {
"anyOf": [
{
"const": false
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message",
"recovery",
"retryable"
],
"properties": {
"code": {
"enum": [
"unauthorized",
"invalid_input",
"entity_not_found",
"entity_ambiguous",
"outside_entitlement",
"rate_limited",
"data_unavailable",
"insufficient_sample",
"unsupported_security",
"duplicate_request"
]
},
"message": {
"$ref": "#a4"
},
"recovery": {
"anyOf": [
{
"$ref": "#a4"
},
{
"type": "null"
}
]
},
"retryable": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"required": [
"accepts",
"resource",
"x402Version"
],
"properties": {
"error": {
"type": "string"
},
"accepts": {
"type": "array",
"items": {
"type": "object",
"required": [
"amount",
"asset",
"maxTimeoutSeconds",
"network",
"payTo",
"scheme"
],
"properties": {
"asset": {
"$ref": "#a4"
},
"extra": {
"$ref": "#ad"
},
"payTo": {
"$ref": "#a4"
},
"amount": {
"type": "string",
"pattern": "^\\d+$"
},
"scheme": {
"enum": [
"exact"
]
},
"network": {
"type": "string",
"pattern": "^eip155:\\d+$"
},
"maxTimeoutSeconds": {
"type": "number"
}
},
"additionalProperties": false
},
"minItems": 1
},
"resource": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"$ref": "#a4"
},
"tags": {
"$ref": "#ac"
},
"iconUrl": {
"type": "string"
},
"mimeType": {
"type": "string"
},
"description": {
"type": "string"
},
"serviceName": {
"type": "string"
}
},
"additionalProperties": false
},
"extensions": {
"type": "object",
"additionalProperties": {
"type": "object",
"required": [
"info",
"schema"
],
"properties": {
"info": {
"$ref": "#ad"
},
"schema": {
"$ref": "#ad"
}
},
"additionalProperties": false
}
},
"x402Version": {
"const": 2
}
},
"additionalProperties": false
},
{
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"enum": [
"payment_pending",
"rate_limited"
]
},
"message": {
"$ref": "#a4"
},
"retryable": {
"const": true
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}| string |
| date_field | string | Date meaning; defaults to period for facts/macro/holdings/returns, event for insider trades, observation for options/short volume, scheduled for calendar. |
| owner_name | string |
| snapshot_id | string | Pin continuation to the returned snapshot ID; reuse with snapshot_hash and as_of. |
| security_type | string | one of ["derivative","non_derivative"] |
| snapshot_hash | string |
| filters_sha256 | string | Reuse the returned filter hash unchanged with continuation pages. |
| transaction_codes | array |
| max_snapshot_age_hours | number | Requested verification-age tolerance: default1hour for retained archives,24hours for closing-price references. Record dates and publication cadence are separate. |
{
"name": "get_insider_trades",
"title": "Get insider transactions",
"description": "Retrieves source-reported insider transactions for one ticker. Filter by reporting owner name or CIK, transaction codes, derivative status and transaction or filing dates. Returns typed owners, security units, prices, acquisition/disposition codes, filing dates and exact support; SEC codes distinguish market purchases/sales (P/S), gifts (G), tax withholding (F) and exercises (M). Owner names use reported SEC spelling; resolve ambiguous or unfamiliar aliases from returned owners. Current requests recheck stale retained mirror metadata; historical and pinned reads remain fixed. Use returned snapshot and cursor or next_offset for further pages; coverage and held records remain explicit. Per-call x402 price: 0.02 USDC on Base.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"ticker"
],
"properties": {
"as_of": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
"description": "Availability cutoff, separate from event/period filters. Historical reads never refresh."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Matching typed observations per page; default32."
},
"cursor": {
"type": "string",
"maxLength": 4096,
"description": "Archive continuation token; reuse with snapshot ID/hash, as_of and unchanged filters."
},
"offset": {
"type": "integer",
"maximum": 10000000,
"minimum": 0
},
"ticker": {
"type": "string",
"pattern": "^[A-Z][A-Z0-9.-]{0,15}$"
},
"date_to": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Inclusive native date upper bound, selected by date_field."
},
"date_from": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Inclusive native date lower bound, selected by date_field."
},
"owner_cik": {
"type": "string",
"pattern": "^\\d{1,10}$"
},
"date_field": {
"enum": [
"event",
"report"
],
"type": "string",
"description": "Date meaning; defaults to period for facts/macro/holdings/returns, event for insider trades, observation for options/short volume, scheduled for calendar."
},
"owner_name": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"snapshot_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "Pin continuation to the returned snapshot ID; reuse with snapshot_hash and as_of."
},
"security_type": {
"enum": [
"derivative",
"non_derivative"
],
"type": "string"
},
"snapshot_hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"filters_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "Reuse the returned filter hash unchanged with continuation pages."
},
"transaction_codes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 32,
"minLength": 1
},
"maxItems": 20,
"minItems": 1
},
"max_snapshot_age_hours": {
"type": "number",
"maximum": 87600,
"description": "Requested verification-age tolerance: default1hour for retained archives,24hours for closing-price references. Record dates and publication cadence are separate.",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$defs": {
"0": {
"type": [
"string",
"null"
],
"$anchor": "a2"
},
"1": {
"type": "string",
"$anchor": "a4",
"minLength": 1
},
"2": {
"type": "string",
"format": "date-time",
"$anchor": "a1",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"3": {
"type": "string",
"$anchor": "a3",
"pattern": "^[a-f0-9]{64}$"
},
"4": {
"type": "integer",
"$anchor": "a0",
"maximum": 9007199254740991,
"minimum": 0
},
"5": {
"anyOf": [
{
"$ref": "#a0"
},
{
"type": "null"
}
],
"$anchor": "ab"
},
"6": {
"type": "string",
"format": "uuid",
"$anchor": "a6",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"7": {
"anyOf": [
{
"$ref": "#a1"
},
{
"type": "null"
}
],
"$anchor": "a7"
},
"8": {
"type": "string",
"format": "uri",
"$anchor": "a5"
},
"9": {
"type": "object",
"$anchor": "aa",
"additionalProperties": {}
},
"a": {
"type": "array",
"items": {
"type": "string"
},
"$anchor": "ad"
},
"b": {
"anyOf": [
{
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
{
"type": "null"
}
],
"$anchor": "a8"
},
"c": {
"type": "object",
"$anchor": "a9",
"required": [
"value",
"unit"
],
"properties": {
"unit": {
"$ref": "#a2"
},
"value": {
"$ref": "#a2"
}
},
"additionalProperties": false
},
"d": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"$anchor": "ac"
},
"e": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 100
},
"f": {
"anyOf": [
{
"$ref": "#a3"
},
{
"type": "null"
}
]
}
},
"anyOf": [
{
"required": [
"schema_version",
"resource",
"operation",
"ticker",
"as_of",
"generated_at",
"status",
"context",
"snapshot_captured_at",
"historical_issuer_ownership_verified",
"data",
"sources",
"pagination",
"limitations"
],
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"required": [
"family",
"status",
"records",
"retained_records",
"matched_records",
"omitted_records",
"held_records",
"freshness",
"coverage",
"limitations"
],
"properties": {
"family": {
"const": "insider"
},
"status": {
"type": "string"
},
"records": {
"type": "array",
"items": {
"type": "object",
"required": [
"record_id",
"source_kind",
"support",
"observed_at",
"period_end",
"reported_at",
"native_details",
"type",
"issuer_cik",
"accession",
"security_title",
"derivative",
"transaction_date",
"filing_date",
"transaction_code",
"acquired_or_disposed",
"owners",
"shares",
"price_per_unit",
"units_owned_after",
"ownership",
"footnote_references",
"currency"
],
"properties": {
"type": {
"const": "insider_transaction"
},
"owners": {
"type": "array",
"items": {
"type": "object",
"required": [
"cik",
"name",
"relationship",
"title"
],
"properties": {
"cik": {
"$ref": "#a2"
},
"name": {
"$ref": "#a2"
},
"title": {
"$ref": "#a2"
},
"relationship": {
"$ref": "#a2"
}
},
"additionalProperties": false
}
},
"shares": {
"$ref": "#a9"
},
"support": {
"type": "object",
"required": [
"document_id",
"content_hash",
"json_pointer"
],
"properties": {
"text_span": {
"type": "object",
"required": [
"start",
"end"
],
"properties": {
"end": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"start": {
"$ref": "#a0"
}
},
"additionalProperties": false
},
"document_id": {
"type": "string"
},
"content_hash": {
"$ref": "#a3"
},
"json_pointer": {
"$ref": "#a2"
}
},
"additionalProperties": false
},
"currency": {
"$ref": "#a2"
},
"accession": {
"$ref": "#a2"
},
"ownership": {
"$ref": "#a2"
},
"record_id": {
"type": "string"
},
"derivative": {
"type": [
"boolean",
"null"
]
},
"issuer_cik": {
"$ref": "#a2"
},
"period_end": {
"$ref": "#a2"
},
"filing_date": {
"$ref": "#a2"
},
"observed_at": {
"$ref": "#a2"
},
"reported_at": {
"$ref": "#a2"
},
"source_kind": {
"type": "string"
},
"native_details": {
"anyOf": [
{
"type": "object",
"required": [
"attributes",
"measurements",
"clocks"
],
"properties": {
"clocks": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"role",
"value",
"precision"
],
"properties": {
"name": {
"$ref": "#a4"
},
"role": {
"enum": [
"period",
"event",
"report",
"expiration",
"scheduled",
"observation"
]
},
"value": {
"$ref": "#a2"
},
"precision": {
"enum": [
"instant",
"date",
"period",
"unknown"
]
}
},
"additionalProperties": false
},
"maxItems": 8
},
"attributes": {
"type": "object",
"additionalProperties": {
"$ref": "#a2"
}
},
"measurements": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"value",
"unit"
],
"properties": {
"name": {
"$ref": "#a4"
},
"unit": {
"$ref": "#a2"
},
"value": {
"type": [
"string",
"number",
"null"
]
}
},
"additionalProperties": false
},
"maxItems": 128
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"price_per_unit": {
"$ref": "#a9"
},
"security_title": {
"$ref": "#a2"
},
"transaction_code": {
"$ref": "#a2"
},
"transaction_date": {
"$ref": "#a2"
},
"units_owned_after": {
"$ref": "#a9"
},
"footnote_references": {
"$ref": "#aa"
},
"acquired_or_disposed": {
"$ref": "#a2"
}
},
"additionalProperties": false
},
"maxItems": 100
},
"coverage": {
"enum": [
"complete_for_retained_scope",
"partial_archive_scan",
"bounded_snapshot",
"unavailable"
]
},
"freshness": {
"type": "object",
"required": [
"status",
"evaluated_at",
"source_captured_at",
"age_seconds",
"max_snapshot_age_seconds",
"latest_record_at",
"publication_cadence_verified",
"refresh_status"
],
"properties": {
"status": {
"enum": [
"fresh",
"stale",
"unknown",
"historical"
]
},
"age_seconds": {
"$ref": "#ac"
},
"evaluated_at": {
"$ref": "#a1"
},
"refresh_status": {
"enum": [
"not_required",
"historical_no_refresh",
"newer_admission_unverified",
"source_clock_unknown"
]
},
"latest_record_at": {
"$ref": "#a2"
},
"source_captured_at": {
"$ref": "#a7"
},
"source_verified_at": {
"$ref": "#a7"
},
"verification_scope": {
"const": "filing_inventory"
},
"capture_age_seconds": {
"$ref": "#ac"
},
"max_snapshot_age_seconds": {
"type": "number",
"exclusiveMinimum": 0
},
"verification_age_seconds": {
"$ref": "#ac"
},
"publication_cadence_verified": {
"const": false
}
},
"additionalProperties": false
},
"limitations": {
"$ref": "#ad"
},
"held_records": {
"$ref": "#ab"
},
"matched_records": {
"$ref": "#ab"
},
"omitted_records": {
"$ref": "#ab"
},
"retained_records": {
"$ref": "#ab"
},
"available_issuer_selectors": {
"type": "object",
"required": [
"metrics",
"dimensions",
"fiscal_years",
"scope",
"truncated"
],
"properties": {
"scope": {
"const": "retained_issuer_observations"
},
"metrics": {
"$ref": "#/$defs/e"
},
"truncated": {
"type": "boolean"
},
"dimensions": {
"$ref": "#/$defs/e"
},
"fiscal_years": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"maxItems": 100
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"maxItems": 1
},
"as_of": {
"$ref": "#a1"
},
"status": {
"enum": [
"available",
"partial",
"unavailable"
]
},
"ticker": {
"type": "string"
},
"context": {
"anyOf": [
{
"type": "object",
"required": [
"artifact_id",
"content_hash",
"observed_through",
"available_at"
],
"properties": {
"artifact_id": {
"$ref": "#a6"
},
"available_at": {
"$ref": "#a1"
},
"content_hash": {
"type": "string"
},
"observed_through": {
"$ref": "#a1"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"sources": {
"type": "array",
"items": {
"type": "object",
"anyOf": [
{
"required": [
"id",
"source_id",
"kind",
"title",
"url",
"published_at",
"publication_date",
"publication_precision",
"observed_at",
"content_hash",
"raw_capture_hash",
"retained_record_hash",
"capture_basis",
"representation"
],
"properties": {
"id": {
"$ref": "#a4"
},
"url": {
"$ref": "#a5"
},
"kind": {
"enum": [
"sec_disclosure",
"government_award",
"issuer_disclosure",
"research_input"
]
},
"title": {
"type": "string"
},
"source_id": {
"$ref": "#a6"
},
"observed_at": {
"$ref": "#a1"
},
"content_hash": {
"$ref": "#a3"
},
"published_at": {
"$ref": "#a7"
},
"capture_basis": {
"enum": [
"http_response_bytes",
"retained_export",
"retained_case"
]
},
"representation": {
"enum": [
"provider_json",
"sec_xbrl",
"visible_text",
"retained_research_case"
]
},
"publication_date": {
"$ref": "#a8"
},
"raw_capture_hash": {
"$ref": "#/$defs/f"
},
"retained_record_hash": {
"$ref": "#/$defs/f"
},
"publication_precision": {
"enum": [
"instant",
"date",
"unknown"
]
}
},
"additionalProperties": false
},
{
"required": [
"id",
"kind",
"title",
"url",
"observed_at",
"content_hash",
"observation_hashes_sha256",
"observation_count",
"calendar_artifact_id",
"calendar_content_hash",
"representation"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"$ref": "#a5"
},
"kind": {
"const": "stored_market_data"
},
"title": {
"type": "string"
},
"providers": {
"$ref": "#ad"
},
"observed_at": {
"$ref": "#a1"
},
"content_hash": {
"$ref": "#a3"
},
"representation": {
"const": "reconciled_daily_bars"
},
"observation_count": {
"$ref": "#a0"
},
"calendar_artifact_id": {
"$ref": "#a6"
},
"calendar_content_hash": {
"$ref": "#a3"
},
"observation_hashes_sha256": {
"$ref": "#a3"
}
},
"additionalProperties": false
}
]
}
},
"resource": {
"const": "company_dataset"
},
"operation": {
"const": "get_insider_trades"
},
"pagination": {
"type": "object",
"required": [
"offset",
"returned",
"total_retained_records",
"total_matching_records",
"next_offset",
"snapshot_id",
"snapshot_hash",
"filters_sha256"
],
"properties": {
"offset": {
"$ref": "#a0"
},
"returned": {
"$ref": "#a0"
},
"next_cursor": {
"$ref": "#a2"
},
"next_offset": {
"$ref": "#ab"
},
"snapshot_id": {
"anyOf": [
{
"$ref": "#a6"
},
{
"type": "null"
}
]
},
"scanned_rows": {
"$ref": "#a0"
},
"scan_complete": {
"type": "boolean"
},
"snapshot_hash": {
"$ref": "#a2"
},
"filters_sha256": {
"type": "string"
},
"total_matching_records": {
"$ref": "#ab"
},
"total_retained_records": {
"$ref": "#ab"
}
},
"additionalProperties": false
},
"limitations": {
"$ref": "#ad"
},
"generated_at": {
"$ref": "#a1"
},
"query_binding": {
"type": "object",
"required": [
"artifactId",
"contentHash"
],
"properties": {
"artifactId": {
"$ref": "#a6"
},
"contentHash": {
"$ref": "#a3"
}
},
"additionalProperties": false
},
"billing_notice": {
"type": "object",
"required": [
"code",
"message",
"remaining_requests",
"add_credits_url",
"plans_url"
],
"properties": {
"code": {
"const": "signup_credit_exhausted"
},
"message": {
"$ref": "#a4"
},
"plans_url": {
"$ref": "#a5"
},
"add_credits_url": {
"$ref": "#a5"
},
"remaining_requests": {
"const": 0
}
},
"additionalProperties": false
},
"issuer_refresh": {
"type": "object",
"required": [
"status",
"filing_inventory_verified_at",
"backfill_from",
"backfill_through",
"history_complete",
"held_documents"
],
"properties": {
"status": {
"enum": [
"not_required",
"queued",
"unavailable",
"saved_only"
]
},
"backfill_from": {
"$ref": "#a8"
},
"held_documents": {
"$ref": "#a0"
},
"backfill_through": {
"$ref": "#a8"
},
"history_complete": {
"type": "boolean"
},
"filing_inventory_verified_at": {
"$ref": "#a7"
}
},
"additionalProperties": false
},
"schema_version": {
"const": "2"
},
"snapshot_captured_at": {
"$ref": "#a7"
},
"historical_issuer_ownership_verified": {
"anyOf": [
{
"const": false
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message",
"recovery",
"retryable"
],
"properties": {
"code": {
"enum": [
"unauthorized",
"invalid_input",
"entity_not_found",
"entity_ambiguous",
"outside_entitlement",
"rate_limited",
"data_unavailable",
"insufficient_sample",
"unsupported_security",
"duplicate_request"
]
},
"message": {
"$ref": "#a4"
},
"recovery": {
"anyOf": [
{
"$ref": "#a4"
},
{
"type": "null"
}
]
},
"retryable": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"required": [
"accepts",
"resource",
"x402Version"
],
"properties": {
"error": {
"type": "string"
},
"accepts": {
"type": "array",
"items": {
"type": "object",
"required": [
"amount",
"asset",
"maxTimeoutSeconds",
"network",
"payTo",
"scheme"
],
"properties": {
"asset": {
"$ref": "#a4"
},
"extra": {
"$ref": "#aa"
},
"payTo": {
"$ref": "#a4"
},
"amount": {
"type": "string",
"pattern": "^\\d+$"
},
"scheme": {
"enum": [
"exact"
]
},
"network": {
"type": "string",
"pattern": "^eip155:\\d+$"
},
"maxTimeoutSeconds": {
"type": "number"
}
},
"additionalProperties": false
},
"minItems": 1
},
"resource": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"$ref": "#a4"
},
"tags": {
"$ref": "#ad"
},
"iconUrl": {
"type": "string"
},
"mimeType": {
"type": "string"
},
"description": {
"type": "string"
},
"serviceName": {
"type": "string"
}
},
"additionalProperties": false
},
"extensions": {
"type": "object",
"additionalProperties": {
"type": "object",
"required": [
"info",
"schema"
],
"properties": {
"info": {
"$ref": "#aa"
},
"schema": {
"$ref": "#aa"
}
},
"additionalProperties": false
}
},
"x402Version": {
"const": 2
}
},
"additionalProperties": false
},
{
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"enum": [
"payment_pending",
"rate_limited"
]
},
"message": {
"$ref": "#a4"
},
"retryable": {
"const": true
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}| Inclusive native date lower bound, selected by date_field. |
| date_field | string | Date meaning; defaults to period for facts/macro/holdings/returns, event for insider trades, observation for options/short volume, scheduled for calendar. |
| manager_cik | string |
| share_class | string |
| snapshot_id | string | Pin continuation to the returned snapshot ID; reuse with snapshot_hash and as_of. |
| manager_name | string |
| report_period | string |
| snapshot_hash | string |
| filters_sha256 | string | Reuse the returned filter hash unchanged with continuation pages. |
| include_amendments | boolean |
| max_snapshot_age_hours | number | Requested verification-age tolerance: default1hour for retained archives,24hours for closing-price references. Record dates and publication cadence are separate. |
{
"name": "get_institutional_holdings",
"title": "Get institutional holdings",
"description": "Retrieves reported institutional holdings for one ticker across supported retained 13F history. Filter by manager name or CIK, report period, filing dates, amendments, share class and shares versus PUT/CALL positions. Returns typed quantities, native reported values, manager identities and source support. Identifier and filing-join checks hold ambiguous records; report dates differ from filing dates, and native value scales remain explicit. Current requests recheck stale mirror metadata; historical/pinned reads never switch snapshots. Continue with the returned snapshot ID/hash, as_of, filters and cursor or next_offset. Per-call x402 price: 0.02 USDC on Base.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"ticker"
],
"properties": {
"as_of": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
"description": "Availability cutoff, separate from event/period filters. Historical reads never refresh."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Matching typed observations per page; default32."
},
"cursor": {
"type": "string",
"maxLength": 4096,
"description": "Archive continuation token; reuse with snapshot ID/hash, as_of and unchanged filters."
},
"offset": {
"type": "integer",
"maximum": 10000000,
"minimum": 0
},
"ticker": {
"type": "string",
"pattern": "^[A-Z][A-Z0-9.-]{0,15}$"
},
"date_to": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Inclusive native date upper bound, selected by date_field."
},
"put_call": {
"enum": [
"PUT",
"CALL",
"SHARES"
],
"type": "string",
"description": "Reported 13F position category; SHARES excludes PUT/CALL reports."
},
"date_from": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Inclusive native date lower bound, selected by date_field."
},
"date_field": {
"enum": [
"period",
"report"
],
"type": "string",
"description": "Date meaning; defaults to period for facts/macro/holdings/returns, event for insider trades, observation for options/short volume, scheduled for calendar."
},
"manager_cik": {
"type": "string",
"pattern": "^\\d{1,10}$"
},
"share_class": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"snapshot_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "Pin continuation to the returned snapshot ID; reuse with snapshot_hash and as_of."
},
"manager_name": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"report_period": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
"snapshot_hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"filters_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "Reuse the returned filter hash unchanged with continuation pages."
},
"include_amendments": {
"type": "boolean"
},
"max_snapshot_age_hours": {
"type": "number",
"maximum": 87600,
"description": "Requested verification-age tolerance: default1hour for retained archives,24hours for closing-price references. Record dates and publication cadence are separate.",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$defs": {
"0": {
"type": [
"string",
"null"
],
"$anchor": "a2"
},
"1": {
"type": "string",
"$anchor": "a4",
"minLength": 1
},
"2": {
"type": "string",
"format": "date-time",
"$anchor": "a1",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"3": {
"type": "string",
"$anchor": "a3",
"pattern": "^[a-f0-9]{64}$"
},
"4": {
"type": "integer",
"$anchor": "a0",
"maximum": 9007199254740991,
"minimum": 0
},
"5": {
"anyOf": [
{
"$ref": "#a0"
},
{
"type": "null"
}
],
"$anchor": "a9"
},
"6": {
"type": "string",
"format": "uuid",
"$anchor": "a6",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"7": {
"anyOf": [
{
"$ref": "#a1"
},
{
"type": "null"
}
],
"$anchor": "a7"
},
"8": {
"type": "string",
"format": "uri",
"$anchor": "a5"
},
"9": {
"type": "array",
"items": {
"type": "string"
},
"$anchor": "ab"
},
"a": {
"anyOf": [
{
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
{
"type": "null"
}
],
"$anchor": "a8"
},
"b": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"$anchor": "aa"
},
"c": {
"type": "object",
"$anchor": "ac",
"additionalProperties": {}
},
"d": {
"type": "object",
"required": [
"value",
"unit"
],
"properties": {
"unit": {
"$ref": "#a2"
},
"value": {
"$ref": "#a2"
}
},
"additionalProperties": false
},
"e": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 100
},
"f": {
"anyOf": [
{
"$ref": "#a3"
},
{
"type": "null"
}
]
}
},
"anyOf": [
{
"required": [
"schema_version",
"resource",
"operation",
"ticker",
"as_of",
"generated_at",
"status",
"context",
"snapshot_captured_at",
"historical_issuer_ownership_verified",
"data",
"sources",
"pagination",
"limitations"
],
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"required": [
"family",
"status",
"records",
"retained_records",
"matched_records",
"omitted_records",
"held_records",
"freshness",
"coverage",
"limitations"
],
"properties": {
"family": {
"const": "institutional_holdings"
},
"status": {
"type": "string"
},
"records": {
"type": "array",
"items": {
"type": "object",
"required": [
"record_id",
"source_kind",
"support",
"observed_at",
"period_end",
"reported_at",
"native_details",
"type",
"manager_cik",
"manager_name",
"accession",
"report_period",
"filing_date",
"cusip",
"figi",
"share_class",
"put_call",
"position",
"reported_value",
"value_scale",
"is_amendment",
"amendment_type"
],
"properties": {
"figi": {
"$ref": "#a2"
},
"type": {
"const": "institutional_holding"
},
"cusip": {
"$ref": "#a2"
},
"support": {
"type": "object",
"required": [
"document_id",
"content_hash",
"json_pointer"
],
"properties": {
"text_span": {
"type": "object",
"required": [
"start",
"end"
],
"properties": {
"end": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"start": {
"$ref": "#a0"
}
},
"additionalProperties": false
},
"document_id": {
"type": "string"
},
"content_hash": {
"$ref": "#a3"
},
"json_pointer": {
"$ref": "#a2"
}
},
"additionalProperties": false
},
"position": {
"$ref": "#/$defs/d"
},
"put_call": {
"$ref": "#a2"
},
"accession": {
"$ref": "#a2"
},
"record_id": {
"type": "string"
},
"period_end": {
"$ref": "#a2"
},
"filing_date": {
"$ref": "#a2"
},
"manager_cik": {
"$ref": "#a2"
},
"observed_at": {
"$ref": "#a2"
},
"reported_at": {
"$ref": "#a2"
},
"share_class": {
"$ref": "#a2"
},
"source_kind": {
"type": "string"
},
"value_scale": {
"$ref": "#a2"
},
"is_amendment": {
"$ref": "#a2"
},
"manager_name": {
"$ref": "#a2"
},
"report_period": {
"$ref": "#a2"
},
"amendment_type": {
"$ref": "#a2"
},
"native_details": {
"anyOf": [
{
"type": "object",
"required": [
"attributes",
"measurements",
"clocks"
],
"properties": {
"clocks": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"role",
"value",
"precision"
],
"properties": {
"name": {
"$ref": "#a4"
},
"role": {
"enum": [
"period",
"event",
"report",
"expiration",
"scheduled",
"observation"
]
},
"value": {
"$ref": "#a2"
},
"precision": {
"enum": [
"instant",
"date",
"period",
"unknown"
]
}
},
"additionalProperties": false
},
"maxItems": 8
},
"attributes": {
"type": "object",
"additionalProperties": {
"$ref": "#a2"
}
},
"measurements": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"value",
"unit"
],
"properties": {
"name": {
"$ref": "#a4"
},
"unit": {
"$ref": "#a2"
},
"value": {
"type": [
"string",
"number",
"null"
]
}
},
"additionalProperties": false
},
"maxItems": 128
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"reported_value": {
"$ref": "#/$defs/d"
}
},
"additionalProperties": false
},
"maxItems": 100
},
"coverage": {
"enum": [
"complete_for_retained_scope",
"partial_archive_scan",
"bounded_snapshot",
"unavailable"
]
},
"freshness": {
"type": "object",
"required": [
"status",
"evaluated_at",
"source_captured_at",
"age_seconds",
"max_snapshot_age_seconds",
"latest_record_at",
"publication_cadence_verified",
"refresh_status"
],
"properties": {
"status": {
"enum": [
"fresh",
"stale",
"unknown",
"historical"
]
},
"age_seconds": {
"$ref": "#aa"
},
"evaluated_at": {
"$ref": "#a1"
},
"refresh_status": {
"enum": [
"not_required",
"historical_no_refresh",
"newer_admission_unverified",
"source_clock_unknown"
]
},
"latest_record_at": {
"$ref": "#a2"
},
"source_captured_at": {
"$ref": "#a7"
},
"source_verified_at": {
"$ref": "#a7"
},
"verification_scope": {
"const": "filing_inventory"
},
"capture_age_seconds": {
"$ref": "#aa"
},
"max_snapshot_age_seconds": {
"type": "number",
"exclusiveMinimum": 0
},
"verification_age_seconds": {
"$ref": "#aa"
},
"publication_cadence_verified": {
"const": false
}
},
"additionalProperties": false
},
"limitations": {
"$ref": "#ab"
},
"held_records": {
"$ref": "#a9"
},
"matched_records": {
"$ref": "#a9"
},
"omitted_records": {
"$ref": "#a9"
},
"retained_records": {
"$ref": "#a9"
},
"available_issuer_selectors": {
"type": "object",
"required": [
"metrics",
"dimensions",
"fiscal_years",
"scope",
"truncated"
],
"properties": {
"scope": {
"const": "retained_issuer_observations"
},
"metrics": {
"$ref": "#/$defs/e"
},
"truncated": {
"type": "boolean"
},
"dimensions": {
"$ref": "#/$defs/e"
},
"fiscal_years": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"maxItems": 100
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"maxItems": 1
},
"as_of": {
"$ref": "#a1"
},
"status": {
"enum": [
"available",
"partial",
"unavailable"
]
},
"ticker": {
"type": "string"
},
"context": {
"anyOf": [
{
"type": "object",
"required": [
"artifact_id",
"content_hash",
"observed_through",
"available_at"
],
"properties": {
"artifact_id": {
"$ref": "#a6"
},
"available_at": {
"$ref": "#a1"
},
"content_hash": {
"type": "string"
},
"observed_through": {
"$ref": "#a1"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"sources": {
"type": "array",
"items": {
"type": "object",
"anyOf": [
{
"required": [
"id",
"source_id",
"kind",
"title",
"url",
"published_at",
"publication_date",
"publication_precision",
"observed_at",
"content_hash",
"raw_capture_hash",
"retained_record_hash",
"capture_basis",
"representation"
],
"properties": {
"id": {
"$ref": "#a4"
},
"url": {
"$ref": "#a5"
},
"kind": {
"enum": [
"sec_disclosure",
"government_award",
"issuer_disclosure",
"research_input"
]
},
"title": {
"type": "string"
},
"source_id": {
"$ref": "#a6"
},
"observed_at": {
"$ref": "#a1"
},
"content_hash": {
"$ref": "#a3"
},
"published_at": {
"$ref": "#a7"
},
"capture_basis": {
"enum": [
"http_response_bytes",
"retained_export",
"retained_case"
]
},
"representation": {
"enum": [
"provider_json",
"sec_xbrl",
"visible_text",
"retained_research_case"
]
},
"publication_date": {
"$ref": "#a8"
},
"raw_capture_hash": {
"$ref": "#/$defs/f"
},
"retained_record_hash": {
"$ref": "#/$defs/f"
},
"publication_precision": {
"enum": [
"instant",
"date",
"unknown"
]
}
},
"additionalProperties": false
},
{
"required": [
"id",
"kind",
"title",
"url",
"observed_at",
"content_hash",
"observation_hashes_sha256",
"observation_count",
"calendar_artifact_id",
"calendar_content_hash",
"representation"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"$ref": "#a5"
},
"kind": {
"const": "stored_market_data"
},
"title": {
"type": "string"
},
"providers": {
"$ref": "#ab"
},
"observed_at": {
"$ref": "#a1"
},
"content_hash": {
"$ref": "#a3"
},
"representation": {
"const": "reconciled_daily_bars"
},
"observation_count": {
"$ref": "#a0"
},
"calendar_artifact_id": {
"$ref": "#a6"
},
"calendar_content_hash": {
"$ref": "#a3"
},
"observation_hashes_sha256": {
"$ref": "#a3"
}
},
"additionalProperties": false
}
]
}
},
"resource": {
"const": "company_dataset"
},
"operation": {
"const": "get_institutional_holdings"
},
"pagination": {
"type": "object",
"required": [
"offset",
"returned",
"total_retained_records",
"total_matching_records",
"next_offset",
"snapshot_id",
"snapshot_hash",
"filters_sha256"
],
"properties": {
"offset": {
"$ref": "#a0"
},
"returned": {
"$ref": "#a0"
},
"next_cursor": {
"$ref": "#a2"
},
"next_offset": {
"$ref": "#a9"
},
"snapshot_id": {
"anyOf": [
{
"$ref": "#a6"
},
{
"type": "null"
}
]
},
"scanned_rows": {
"$ref": "#a0"
},
"scan_complete": {
"type": "boolean"
},
"snapshot_hash": {
"$ref": "#a2"
},
"filters_sha256": {
"type": "string"
},
"total_matching_records": {
"$ref": "#a9"
},
"total_retained_records": {
"$ref": "#a9"
}
},
"additionalProperties": false
},
"limitations": {
"$ref": "#ab"
},
"generated_at": {
"$ref": "#a1"
},
"query_binding": {
"type": "object",
"required": [
"artifactId",
"contentHash"
],
"properties": {
"artifactId": {
"$ref": "#a6"
},
"contentHash": {
"$ref": "#a3"
}
},
"additionalProperties": false
},
"billing_notice": {
"type": "object",
"required": [
"code",
"message",
"remaining_requests",
"add_credits_url",
"plans_url"
],
"properties": {
"code": {
"const": "signup_credit_exhausted"
},
"message": {
"$ref": "#a4"
},
"plans_url": {
"$ref": "#a5"
},
"add_credits_url": {
"$ref": "#a5"
},
"remaining_requests": {
"const": 0
}
},
"additionalProperties": false
},
"issuer_refresh": {
"type": "object",
"required": [
"status",
"filing_inventory_verified_at",
"backfill_from",
"backfill_through",
"history_complete",
"held_documents"
],
"properties": {
"status": {
"enum": [
"not_required",
"queued",
"unavailable",
"saved_only"
]
},
"backfill_from": {
"$ref": "#a8"
},
"held_documents": {
"$ref": "#a0"
},
"backfill_through": {
"$ref": "#a8"
},
"history_complete": {
"type": "boolean"
},
"filing_inventory_verified_at": {
"$ref": "#a7"
}
},
"additionalProperties": false
},
"schema_version": {
"const": "2"
},
"snapshot_captured_at": {
"$ref": "#a7"
},
"historical_issuer_ownership_verified": {
"anyOf": [
{
"const": false
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message",
"recovery",
"retryable"
],
"properties": {
"code": {
"enum": [
"unauthorized",
"invalid_input",
"entity_not_found",
"entity_ambiguous",
"outside_entitlement",
"rate_limited",
"data_unavailable",
"insufficient_sample",
"unsupported_security",
"duplicate_request"
]
},
"message": {
"$ref": "#a4"
},
"recovery": {
"anyOf": [
{
"$ref": "#a4"
},
{
"type": "null"
}
]
},
"retryable": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"required": [
"accepts",
"resource",
"x402Version"
],
"properties": {
"error": {
"type": "string"
},
"accepts": {
"type": "array",
"items": {
"type": "object",
"required": [
"amount",
"asset",
"maxTimeoutSeconds",
"network",
"payTo",
"scheme"
],
"properties": {
"asset": {
"$ref": "#a4"
},
"extra": {
"$ref": "#ac"
},
"payTo": {
"$ref": "#a4"
},
"amount": {
"type": "string",
"pattern": "^\\d+$"
},
"scheme": {
"enum": [
"exact"
]
},
"network": {
"type": "string",
"pattern": "^eip155:\\d+$"
},
"maxTimeoutSeconds": {
"type": "number"
}
},
"additionalProperties": false
},
"minItems": 1
},
"resource": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"$ref": "#a4"
},
"tags": {
"$ref": "#ab"
},
"iconUrl": {
"type": "string"
},
"mimeType": {
"type": "string"
},
"description": {
"type": "string"
},
"serviceName": {
"type": "string"
}
},
"additionalProperties": false
},
"extensions": {
"type": "object",
"additionalProperties": {
"type": "object",
"required": [
"info",
"schema"
],
"properties": {
"info": {
"$ref": "#ac"
},
"schema": {
"$ref": "#ac"
}
},
"additionalProperties": false
}
},
"x402Version": {
"const": 2
}
},
"additionalProperties": false
},
{
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"enum": [
"payment_pending",
"rate_limited"
]
},
"message": {
"$ref": "#a4"
},
"retryable": {
"const": true
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}{
"name": "get_investor_outcomes",
"title": "Get investor track record",
"description": "Retrieves an investor's stored publication-based outcomes for one company, research subject, investment case or the explicitly selected released corpus. Returns action, entry-price and horizon cohorts, verified exits, losses, pending results and ineligible counts. Useful for reviewing measured thesis outcomes and their sample limitations. Filter by source and publication window; narrow a scope that exceeds the returned bound. Uses stored market observations, with historical source completeness explicitly unknown. Per-call x402 price: 0.02 USDC on Base.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"person_id"
],
"properties": {
"as_of": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"corpus": {
"type": "string",
"const": "released"
},
"ticker": {
"type": "string",
"maxLength": 32,
"minLength": 1
},
"belief_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"entity_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"person_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"source_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"published_from": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"published_through": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$defs": {
"0": {
"type": "integer",
"$anchor": "a3",
"maximum": 9007199254740991,
"minimum": 0
},
"1": {
"type": [
"number",
"null"
],
"$anchor": "a6"
},
"2": {
"type": "string",
"$anchor": "a1",
"minLength": 1
},
"3": {
"type": "string",
"format": "date-time",
"$anchor": "a0",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"4": {
"type": "string",
"format": "uuid",
"$anchor": "a2",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"5": {
"type": "array",
"items": {
"type": "string"
},
"$anchor": "a4"
},
"6": {
"anyOf": [
{
"$ref": "#a0"
},
{
"type": "null"
}
],
"$anchor": "a5"
},
"7": {
"type": "object",
"$anchor": "a7",
"additionalProperties": {}
},
"8": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
},
"anyOf": [
{
"required": [
"schema_version",
"resource",
"view",
"generated_at",
"as_of",
"scope",
"methodology_version",
"aggregation",
"dividends_and_costs_included",
"history_state",
"observed_belief_count",
"author",
"evidence",
"omitted_evidence_count",
"detail_reference",
"limitations"
],
"properties": {
"view": {
"const": "track_record"
},
"as_of": {
"$ref": "#a0"
},
"scope": {
"type": "object",
"required": [
"view",
"person_id"
],
"properties": {
"view": {
"const": "track_record"
},
"as_of": {
"$ref": "#a0"
},
"corpus": {
"const": "released"
},
"ticker": {
"type": "string",
"maxLength": 32,
"minLength": 1
},
"belief_id": {
"$ref": "#a2"
},
"entity_id": {
"$ref": "#a2"
},
"person_id": {
"$ref": "#a2"
},
"source_id": {
"$ref": "#a2"
},
"published_from": {
"$ref": "#a0"
},
"published_through": {
"$ref": "#a0"
}
},
"additionalProperties": false
},
"author": {
"anyOf": [
{
"type": "object",
"required": [
"person",
"observed_belief_count",
"unassessed_belief_count",
"non_exposure_belief_count",
"unmeasured_window_count",
"ineligible_window_count",
"unpriced_exit_window_count",
"cohorts"
],
"properties": {
"person": {
"type": "object",
"required": [
"id",
"name",
"handle"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"handle": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"cohorts": {
"type": "array",
"items": {
"type": "object",
"required": [
"action",
"basis",
"horizon_sessions",
"baseline_method",
"price_source",
"benchmark_ticker",
"benchmark_comparison",
"security_ids",
"tickers",
"measured_count",
"sample_count",
"unmeasured_window_count",
"ineligible_window_count",
"exit_adjusted_sample_count",
"history_from",
"history_through",
"ranking",
"excluded_repeated_or_overlapping_count",
"profitable_count",
"losing_count",
"flat_count",
"win_rate_percent",
"benchmark_outperformance_rate_percent",
"average_return_percent",
"average_benchmark_return_percent",
"average_excess_return_percentage_points",
"median_return_percent",
"worst_return_percent",
"average_maximum_adverse_excursion_percent",
"retrospectively_observed_count",
"citation_ids"
],
"properties": {
"basis": {
"enum": [
"recommendation",
"self_reported_position",
"self_reported_trade"
]
},
"action": {
"enum": [
"buy",
"hold",
"short"
]
},
"ranking": {
"type": "object",
"required": [
"status",
"score",
"rank",
"peer_count",
"sample_weight",
"components",
"profitability",
"win_rate_interval_95_percent",
"reasons"
],
"properties": {
"rank": {
"anyOf": [
{
"$ref": "#/$defs/8"
},
{
"type": "null"
}
]
},
"score": {
"$ref": "#a6"
},
"status": {
"enum": [
"insufficient_sample",
"missing_risk",
"incomplete_history",
"provisional",
"insufficient_peers",
"ranked"
]
},
"reasons": {
"$ref": "#a4"
},
"components": {
"type": "object",
"required": [
"excess_return",
"profitable_call_rate",
"downside_control"
],
"properties": {
"excess_return": {
"$ref": "#a6"
},
"downside_control": {
"$ref": "#a6"
},
"profitable_call_rate": {
"$ref": "#a6"
}
},
"additionalProperties": false
},
"peer_count": {
"$ref": "#a3"
},
"profitability": {
"enum": [
"positive",
"negative",
"flat",
"unmeasured"
]
},
"sample_weight": {
"type": "number",
"maximum": 1,
"minimum": 0
},
"win_rate_interval_95_percent": {
"anyOf": [
{
"type": "object",
"required": [
"lower",
"upper"
],
"properties": {
"lower": {
"type": "number"
},
"upper": {
"type": "number"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"tickers": {
"$ref": "#a4"
},
"flat_count": {
"$ref": "#a3"
},
"citation_ids": {
"$ref": "#a4"
},
"history_from": {
"$ref": "#a5"
},
"losing_count": {
"$ref": "#a3"
},
"price_source": {
"$ref": "#a1"
},
"sample_count": {
"$ref": "#a3"
},
"security_ids": {
"$ref": "#a4"
},
"measured_count": {
"$ref": "#a3"
},
"baseline_method": {
"enum": [
"next_session_open",
"source_quote"
]
},
"history_through": {
"$ref": "#a5"
},
"benchmark_ticker": {
"const": "SPY"
},
"horizon_sessions": {
"$ref": "#/$defs/8"
},
"profitable_count": {
"$ref": "#a3"
},
"win_rate_percent": {
"$ref": "#a6"
},
"benchmark_comparison": {
"const": "same_direction_same_sessions"
},
"worst_return_percent": {
"$ref": "#a6"
},
"median_return_percent": {
"$ref": "#a6"
},
"average_return_percent": {
"$ref": "#a6"
},
"ineligible_window_count": {
"$ref": "#a3"
},
"unmeasured_window_count": {
"$ref": "#a3"
},
"exit_adjusted_sample_count": {
"$ref": "#a3"
},
"retrospectively_observed_count": {
"$ref": "#a3"
},
"average_benchmark_return_percent": {
"$ref": "#a6"
},
"benchmark_outperformance_rate_percent": {
"$ref": "#a6"
},
"excluded_repeated_or_overlapping_count": {
"$ref": "#a3"
},
"average_excess_return_percentage_points": {
"$ref": "#a6"
},
"average_maximum_adverse_excursion_percent": {
"$ref": "#a6"
}
},
"additionalProperties": false
}
},
"observed_belief_count": {
"$ref": "#a3"
},
"ineligible_window_count": {
"$ref": "#a3"
},
"unassessed_belief_count": {
"$ref": "#a3"
},
"unmeasured_window_count": {
"$ref": "#a3"
},
"non_exposure_belief_count": {
"$ref": "#a3"
},
"unpriced_exit_window_count": {
"$ref": "#a3"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"evidence": {
"type": "array",
"items": {
"type": "object",
"required": [
"citation_id",
"evidence_id",
"source_id",
"source_url",
"source_title",
"published_at",
"first_observed_at",
"captured_at",
"content_hash",
"representation",
"source_coverage",
"support_ids"
],
"properties": {
"source_id": {
"$ref": "#a2"
},
"source_url": {
"type": "string",
"format": "uri"
},
"captured_at": {
"$ref": "#a0"
},
"citation_id": {
"type": "string"
},
"evidence_id": {
"$ref": "#a2"
},
"support_ids": {
"type": "array",
"items": {
"$ref": "#a2"
}
},
"content_hash": {
"type": "string",
"maxLength": 64,
"minLength": 64
},
"published_at": {
"$ref": "#a5"
},
"source_title": {
"type": "string"
},
"representation": {
"type": "string"
},
"source_coverage": {
"enum": [
"full",
"partial",
"unknown"
]
},
"first_observed_at": {
"$ref": "#a0"
},
"projection_receipt_id": {
"$ref": "#a2"
}
},
"additionalProperties": false
}
},
"resource": {
"const": "beliefs"
},
"aggregation": {
"const": "equal_weight_non_overlapping_windows_with_verified_exits"
},
"limitations": {
"$ref": "#a4"
},
"generated_at": {
"$ref": "#a0"
},
"history_state": {
"const": "unknown"
},
"billing_notice": {
"type": "object",
"required": [
"code",
"message",
"remaining_requests",
"add_credits_url",
"plans_url"
],
"properties": {
"code": {
"const": "signup_credit_exhausted"
},
"message": {
"$ref": "#a1"
},
"plans_url": {
"type": "string",
"format": "uri"
},
"add_credits_url": {
"type": "string",
"format": "uri"
},
"remaining_requests": {
"const": 0
}
},
"additionalProperties": false
},
"schema_version": {
"const": "1"
},
"detail_reference": {
"type": [
"string",
"null"
]
},
"methodology_version": {
"const": "author-track-record-v4"
},
"observed_belief_count": {
"$ref": "#a3"
},
"omitted_evidence_count": {
"$ref": "#a3"
},
"dividends_and_costs_included": {
"const": false
}
},
"additionalProperties": false
},
{
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message",
"recovery",
"retryable"
],
"properties": {
"code": {
"enum": [
"unauthorized",
"invalid_input",
"entity_not_found",
"entity_ambiguous",
"outside_entitlement",
"rate_limited",
"data_unavailable",
"insufficient_sample",
"unsupported_security",
"duplicate_request"
]
},
"message": {
"$ref": "#a1"
},
"recovery": {
"anyOf": [
{
"$ref": "#a1"
},
{
"type": "null"
}
]
},
"retryable": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"required": [
"accepts",
"resource",
"x402Version"
],
"properties": {
"error": {
"type": "string"
},
"accepts": {
"type": "array",
"items": {
"type": "object",
"required": [
"amount",
"asset",
"maxTimeoutSeconds",
"network",
"payTo",
"scheme"
],
"properties": {
"asset": {
"$ref": "#a1"
},
"extra": {
"$ref": "#a7"
},
"payTo": {
"$ref": "#a1"
},
"amount": {
"type": "string",
"pattern": "^\\d+$"
},
"scheme": {
"enum": [
"exact"
]
},
"network": {
"type": "string",
"pattern": "^eip155:\\d+$"
},
"maxTimeoutSeconds": {
"type": "number"
}
},
"additionalProperties": false
},
"minItems": 1
},
"resource": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"$ref": "#a1"
},
"tags": {
"$ref": "#a4"
},
"iconUrl": {
"type": "string"
},
"mimeType": {
"type": "string"
},
"description": {
"type": "string"
},
"serviceName": {
"type": "string"
}
},
"additionalProperties": false
},
"extensions": {
"type": "object",
"additionalProperties": {
"type": "object",
"required": [
"info",
"schema"
],
"properties": {
"info": {
"$ref": "#a7"
},
"schema": {
"$ref": "#a7"
}
},
"additionalProperties": false
}
},
"x402Version": {
"const": 2
}
},
"additionalProperties": false
},
{
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"enum": [
"payment_pending",
"rate_limited"
]
},
"message": {
"$ref": "#a1"
},
"retryable": {
"const": true
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}| Inclusive native date lower bound, selected by date_field. |
| date_field | string | Date meaning; defaults to period for facts/macro/holdings/returns, event for insider trades, observation for options/short volume, scheduled for calendar. |
| series_ids | array |
| snapshot_id | string | Pin continuation to the returned snapshot ID; reuse with snapshot_hash and as_of. |
| snapshot_hash | string |
| filters_sha256 | string | Reuse the returned filter hash unchanged with continuation pages. |
| measurement_names | array | Exact native measurements, such as a Treasury maturity column. |
| max_snapshot_age_hours | number | Requested verification-age tolerance: default1hour for retained archives,24hours for closing-price references. Record dates and publication cadence are separate. |
{
"name": "get_macro_context",
"title": "Get macroeconomic context",
"description": "Retrieves retained government macroeconomic observations in one ticker research scope. Filter by native series_ids, agency, measurement_names and period dates; returns typed values, units, seasonal bases, scales, native periods and source support. Supported archive formats cover Treasury, NY Fed, BLS, BEA, EIA, CFTC and metadata-qualified Federal Reserve Board series; other admitted context is explicitly bounded. Macro backdrop does not establish company exposure or a historical data vintage; FRED and rights-held series are unavailable. Current requests recheck stale mirror metadata; historical/pinned reads remain fixed. Continue with the returned snapshot, cutoff, filters and cursor or next_offset. Per-call x402 price: 0.02 USDC on Base.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"ticker"
],
"properties": {
"as_of": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
"description": "Availability cutoff, separate from event/period filters. Historical reads never refresh."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Matching typed observations per page; default32."
},
"agency": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"cursor": {
"type": "string",
"maxLength": 4096,
"description": "Archive continuation token; reuse with snapshot ID/hash, as_of and unchanged filters."
},
"offset": {
"type": "integer",
"maximum": 10000000,
"minimum": 0
},
"ticker": {
"type": "string",
"pattern": "^[A-Z][A-Z0-9.-]{0,15}$"
},
"date_to": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Inclusive native date upper bound, selected by date_field."
},
"date_from": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Inclusive native date lower bound, selected by date_field."
},
"date_field": {
"enum": [
"period"
],
"type": "string",
"description": "Date meaning; defaults to period for facts/macro/holdings/returns, event for insider trades, observation for options/short volume, scheduled for calendar."
},
"series_ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"maxItems": 20,
"minItems": 1
},
"snapshot_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "Pin continuation to the returned snapshot ID; reuse with snapshot_hash and as_of."
},
"snapshot_hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"filters_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "Reuse the returned filter hash unchanged with continuation pages."
},
"measurement_names": {
"type": "array",
"items": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"maxItems": 20,
"minItems": 1,
"description": "Exact native measurements, such as a Treasury maturity column."
},
"max_snapshot_age_hours": {
"type": "number",
"maximum": 87600,
"description": "Requested verification-age tolerance: default1hour for retained archives,24hours for closing-price references. Record dates and publication cadence are separate.",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$defs": {
"0": {
"type": [
"string",
"null"
],
"$anchor": "a8"
},
"1": {
"type": "string",
"$anchor": "a3",
"minLength": 1
},
"2": {
"type": "string",
"format": "date-time",
"$anchor": "a1",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"3": {
"type": "string",
"$anchor": "a2",
"pattern": "^[a-f0-9]{64}$"
},
"4": {
"type": "integer",
"$anchor": "a0",
"maximum": 9007199254740991,
"minimum": 0
},
"5": {
"anyOf": [
{
"$ref": "#a0"
},
{
"type": "null"
}
],
"$anchor": "a9"
},
"6": {
"type": "string",
"format": "uuid",
"$anchor": "a5",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"7": {
"anyOf": [
{
"$ref": "#a1"
},
{
"type": "null"
}
],
"$anchor": "a6"
},
"8": {
"type": "string",
"format": "uri",
"$anchor": "a4"
},
"9": {
"type": "array",
"items": {
"type": "string"
},
"$anchor": "ab"
},
"a": {
"anyOf": [
{
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
{
"type": "null"
}
],
"$anchor": "a7"
},
"b": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"$anchor": "aa"
},
"c": {
"type": "object",
"$anchor": "ac",
"additionalProperties": {}
},
"d": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 100
},
"e": {
"anyOf": [
{
"$ref": "#a2"
},
{
"type": "null"
}
]
}
},
"anyOf": [
{
"required": [
"schema_version",
"resource",
"operation",
"ticker",
"as_of",
"generated_at",
"status",
"context",
"snapshot_captured_at",
"historical_issuer_ownership_verified",
"data",
"sources",
"pagination",
"limitations"
],
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"required": [
"family",
"status",
"records",
"retained_records",
"matched_records",
"omitted_records",
"held_records",
"freshness",
"coverage",
"limitations"
],
"properties": {
"family": {
"const": "macro"
},
"status": {
"type": "string"
},
"records": {
"type": "array",
"items": {
"type": "object",
"required": [
"record_id",
"source_kind",
"support",
"observed_at",
"period_end",
"reported_at",
"native_details",
"type",
"agency",
"series_id",
"title",
"seasonal_adjustment",
"base_period",
"native_period",
"measurement",
"value",
"unit",
"issuer_exposure",
"historical_vintage_verified"
],
"properties": {
"type": {
"const": "macro_observation"
},
"unit": {
"$ref": "#a8"
},
"title": {
"$ref": "#a8"
},
"value": {
"$ref": "#a8"
},
"agency": {
"$ref": "#a8"
},
"support": {
"type": "object",
"required": [
"document_id",
"content_hash",
"json_pointer"
],
"properties": {
"text_span": {
"type": "object",
"required": [
"start",
"end"
],
"properties": {
"end": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"start": {
"$ref": "#a0"
}
},
"additionalProperties": false
},
"document_id": {
"type": "string"
},
"content_hash": {
"$ref": "#a2"
},
"json_pointer": {
"$ref": "#a8"
}
},
"additionalProperties": false
},
"record_id": {
"type": "string"
},
"series_id": {
"type": "string"
},
"period_end": {
"$ref": "#a8"
},
"base_period": {
"$ref": "#a8"
},
"measurement": {
"type": "string"
},
"observed_at": {
"$ref": "#a8"
},
"reported_at": {
"$ref": "#a8"
},
"source_kind": {
"type": "string"
},
"native_period": {
"$ref": "#a8"
},
"native_details": {
"anyOf": [
{
"type": "object",
"required": [
"attributes",
"measurements",
"clocks"
],
"properties": {
"clocks": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"role",
"value",
"precision"
],
"properties": {
"name": {
"$ref": "#a3"
},
"role": {
"enum": [
"period",
"event",
"report",
"expiration",
"scheduled",
"observation"
]
},
"value": {
"$ref": "#a8"
},
"precision": {
"enum": [
"instant",
"date",
"period",
"unknown"
]
}
},
"additionalProperties": false
},
"maxItems": 8
},
"attributes": {
"type": "object",
"additionalProperties": {
"$ref": "#a8"
}
},
"measurements": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"value",
"unit"
],
"properties": {
"name": {
"$ref": "#a3"
},
"unit": {
"$ref": "#a8"
},
"value": {
"type": [
"string",
"number",
"null"
]
}
},
"additionalProperties": false
},
"maxItems": 128
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"issuer_exposure": {
"const": "not_established"
},
"seasonal_adjustment": {
"$ref": "#a8"
},
"historical_vintage_verified": {
"const": false
}
},
"additionalProperties": false
},
"maxItems": 100
},
"coverage": {
"enum": [
"complete_for_retained_scope",
"partial_archive_scan",
"bounded_snapshot",
"unavailable"
]
},
"freshness": {
"type": "object",
"required": [
"status",
"evaluated_at",
"source_captured_at",
"age_seconds",
"max_snapshot_age_seconds",
"latest_record_at",
"publication_cadence_verified",
"refresh_status"
],
"properties": {
"status": {
"enum": [
"fresh",
"stale",
"unknown",
"historical"
]
},
"age_seconds": {
"$ref": "#aa"
},
"evaluated_at": {
"$ref": "#a1"
},
"refresh_status": {
"enum": [
"not_required",
"historical_no_refresh",
"newer_admission_unverified",
"source_clock_unknown"
]
},
"latest_record_at": {
"$ref": "#a8"
},
"source_captured_at": {
"$ref": "#a6"
},
"source_verified_at": {
"$ref": "#a6"
},
"verification_scope": {
"const": "filing_inventory"
},
"capture_age_seconds": {
"$ref": "#aa"
},
"max_snapshot_age_seconds": {
"type": "number",
"exclusiveMinimum": 0
},
"verification_age_seconds": {
"$ref": "#aa"
},
"publication_cadence_verified": {
"const": false
}
},
"additionalProperties": false
},
"limitations": {
"$ref": "#ab"
},
"held_records": {
"$ref": "#a9"
},
"matched_records": {
"$ref": "#a9"
},
"omitted_records": {
"$ref": "#a9"
},
"retained_records": {
"$ref": "#a9"
},
"available_issuer_selectors": {
"type": "object",
"required": [
"metrics",
"dimensions",
"fiscal_years",
"scope",
"truncated"
],
"properties": {
"scope": {
"const": "retained_issuer_observations"
},
"metrics": {
"$ref": "#/$defs/d"
},
"truncated": {
"type": "boolean"
},
"dimensions": {
"$ref": "#/$defs/d"
},
"fiscal_years": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"maxItems": 100
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"maxItems": 1
},
"as_of": {
"$ref": "#a1"
},
"status": {
"enum": [
"available",
"partial",
"unavailable"
]
},
"ticker": {
"type": "string"
},
"context": {
"anyOf": [
{
"type": "object",
"required": [
"artifact_id",
"content_hash",
"observed_through",
"available_at"
],
"properties": {
"artifact_id": {
"$ref": "#a5"
},
"available_at": {
"$ref": "#a1"
},
"content_hash": {
"type": "string"
},
"observed_through": {
"$ref": "#a1"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"sources": {
"type": "array",
"items": {
"type": "object",
"anyOf": [
{
"required": [
"id",
"source_id",
"kind",
"title",
"url",
"published_at",
"publication_date",
"publication_precision",
"observed_at",
"content_hash",
"raw_capture_hash",
"retained_record_hash",
"capture_basis",
"representation"
],
"properties": {
"id": {
"$ref": "#a3"
},
"url": {
"$ref": "#a4"
},
"kind": {
"enum": [
"sec_disclosure",
"government_award",
"issuer_disclosure",
"research_input"
]
},
"title": {
"type": "string"
},
"source_id": {
"$ref": "#a5"
},
"observed_at": {
"$ref": "#a1"
},
"content_hash": {
"$ref": "#a2"
},
"published_at": {
"$ref": "#a6"
},
"capture_basis": {
"enum": [
"http_response_bytes",
"retained_export",
"retained_case"
]
},
"representation": {
"enum": [
"provider_json",
"sec_xbrl",
"visible_text",
"retained_research_case"
]
},
"publication_date": {
"$ref": "#a7"
},
"raw_capture_hash": {
"$ref": "#/$defs/e"
},
"retained_record_hash": {
"$ref": "#/$defs/e"
},
"publication_precision": {
"enum": [
"instant",
"date",
"unknown"
]
}
},
"additionalProperties": false
},
{
"required": [
"id",
"kind",
"title",
"url",
"observed_at",
"content_hash",
"observation_hashes_sha256",
"observation_count",
"calendar_artifact_id",
"calendar_content_hash",
"representation"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"$ref": "#a4"
},
"kind": {
"const": "stored_market_data"
},
"title": {
"type": "string"
},
"providers": {
"$ref": "#ab"
},
"observed_at": {
"$ref": "#a1"
},
"content_hash": {
"$ref": "#a2"
},
"representation": {
"const": "reconciled_daily_bars"
},
"observation_count": {
"$ref": "#a0"
},
"calendar_artifact_id": {
"$ref": "#a5"
},
"calendar_content_hash": {
"$ref": "#a2"
},
"observation_hashes_sha256": {
"$ref": "#a2"
}
},
"additionalProperties": false
}
]
}
},
"resource": {
"const": "company_dataset"
},
"operation": {
"const": "get_macro_context"
},
"pagination": {
"type": "object",
"required": [
"offset",
"returned",
"total_retained_records",
"total_matching_records",
"next_offset",
"snapshot_id",
"snapshot_hash",
"filters_sha256"
],
"properties": {
"offset": {
"$ref": "#a0"
},
"returned": {
"$ref": "#a0"
},
"next_cursor": {
"$ref": "#a8"
},
"next_offset": {
"$ref": "#a9"
},
"snapshot_id": {
"anyOf": [
{
"$ref": "#a5"
},
{
"type": "null"
}
]
},
"scanned_rows": {
"$ref": "#a0"
},
"scan_complete": {
"type": "boolean"
},
"snapshot_hash": {
"$ref": "#a8"
},
"filters_sha256": {
"type": "string"
},
"total_matching_records": {
"$ref": "#a9"
},
"total_retained_records": {
"$ref": "#a9"
}
},
"additionalProperties": false
},
"limitations": {
"$ref": "#ab"
},
"generated_at": {
"$ref": "#a1"
},
"query_binding": {
"type": "object",
"required": [
"artifactId",
"contentHash"
],
"properties": {
"artifactId": {
"$ref": "#a5"
},
"contentHash": {
"$ref": "#a2"
}
},
"additionalProperties": false
},
"billing_notice": {
"type": "object",
"required": [
"code",
"message",
"remaining_requests",
"add_credits_url",
"plans_url"
],
"properties": {
"code": {
"const": "signup_credit_exhausted"
},
"message": {
"$ref": "#a3"
},
"plans_url": {
"$ref": "#a4"
},
"add_credits_url": {
"$ref": "#a4"
},
"remaining_requests": {
"const": 0
}
},
"additionalProperties": false
},
"issuer_refresh": {
"type": "object",
"required": [
"status",
"filing_inventory_verified_at",
"backfill_from",
"backfill_through",
"history_complete",
"held_documents"
],
"properties": {
"status": {
"enum": [
"not_required",
"queued",
"unavailable",
"saved_only"
]
},
"backfill_from": {
"$ref": "#a7"
},
"held_documents": {
"$ref": "#a0"
},
"backfill_through": {
"$ref": "#a7"
},
"history_complete": {
"type": "boolean"
},
"filing_inventory_verified_at": {
"$ref": "#a6"
}
},
"additionalProperties": false
},
"schema_version": {
"const": "2"
},
"snapshot_captured_at": {
"$ref": "#a6"
},
"historical_issuer_ownership_verified": {
"anyOf": [
{
"const": false
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message",
"recovery",
"retryable"
],
"properties": {
"code": {
"enum": [
"unauthorized",
"invalid_input",
"entity_not_found",
"entity_ambiguous",
"outside_entitlement",
"rate_limited",
"data_unavailable",
"insufficient_sample",
"unsupported_security",
"duplicate_request"
]
},
"message": {
"$ref": "#a3"
},
"recovery": {
"anyOf": [
{
"$ref": "#a3"
},
{
"type": "null"
}
]
},
"retryable": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"required": [
"accepts",
"resource",
"x402Version"
],
"properties": {
"error": {
"type": "string"
},
"accepts": {
"type": "array",
"items": {
"type": "object",
"required": [
"amount",
"asset",
"maxTimeoutSeconds",
"network",
"payTo",
"scheme"
],
"properties": {
"asset": {
"$ref": "#a3"
},
"extra": {
"$ref": "#ac"
},
"payTo": {
"$ref": "#a3"
},
"amount": {
"type": "string",
"pattern": "^\\d+$"
},
"scheme": {
"enum": [
"exact"
]
},
"network": {
"type": "string",
"pattern": "^eip155:\\d+$"
},
"maxTimeoutSeconds": {
"type": "number"
}
},
"additionalProperties": false
},
"minItems": 1
},
"resource": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"$ref": "#a3"
},
"tags": {
"$ref": "#ab"
},
"iconUrl": {
"type": "string"
},
"mimeType": {
"type": "string"
},
"description": {
"type": "string"
},
"serviceName": {
"type": "string"
}
},
"additionalProperties": false
},
"extensions": {
"type": "object",
"additionalProperties": {
"type": "object",
"required": [
"info",
"schema"
],
"properties": {
"info": {
"$ref": "#ac"
},
"schema": {
"$ref": "#ac"
}
},
"additionalProperties": false
}
},
"x402Version": {
"const": 2
}
},
"additionalProperties": false
},
{
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"enum": [
"payment_pending",
"rate_limited"
]
},
"message": {
"$ref": "#a3"
},
"retryable": {
"const": true
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}| Inclusive native date lower bound, selected by date_field. |
| date_field | string | Date meaning; defaults to period for facts/macro/holdings/returns, event for insider trades, observation for options/short volume, scheduled for calendar. |
| snapshot_id | string | Pin continuation to the returned snapshot ID; reuse with snapshot_hash and as_of. |
| snapshot_hash | string |
| filters_sha256 | string | Reuse the returned filter hash unchanged with continuation pages. |
| session_intervals | array |
| max_snapshot_age_hours | number | Requested verification-age tolerance: default1hour for retained archives,24hours for closing-price references. Record dates and publication cadence are separate. |
{
"name": "get_market_returns",
"title": "Get market returns",
"description": "Retrieves supported split-adjusted close-price returns for one ticker versus SPY. Request session_intervals from 1 to 252; date bounds select return end sessions, while an omitted date range uses the latest completed official session. Returns typed security and benchmark returns, excess percentage points, exact session dates and retained support. Complete security/SPY paths, official calendars and verified adjustment basis are required; missing or ambiguous inputs remain held. Price returns exclude dividends, fees and execution effects, and do not measure investor account performance. Current requests refresh only missing, incomplete or stale closing-price references from the delayed consolidated market data; historical/pinned queries preserve input availability; use the returned snapshot, as_of, filters and next_offset for further pages. Per-call x402 price: 0.02 USDC on Base.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"ticker"
],
"properties": {
"as_of": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
"description": "Availability cutoff, separate from event/period filters. Historical reads never refresh."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Matching typed observations per page; default32."
},
"cursor": {
"type": "string",
"maxLength": 4096,
"description": "Archive continuation token; reuse with snapshot ID/hash, as_of and unchanged filters."
},
"offset": {
"type": "integer",
"maximum": 10000000,
"minimum": 0
},
"ticker": {
"type": "string",
"pattern": "^[A-Z][A-Z0-9.-]{0,15}$"
},
"date_to": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Inclusive native date upper bound, selected by date_field."
},
"date_from": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Inclusive native date lower bound, selected by date_field."
},
"date_field": {
"enum": [
"period",
"observation"
],
"type": "string",
"description": "Date meaning; defaults to period for facts/macro/holdings/returns, event for insider trades, observation for options/short volume, scheduled for calendar."
},
"snapshot_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "Pin continuation to the returned snapshot ID; reuse with snapshot_hash and as_of."
},
"snapshot_hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"filters_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "Reuse the returned filter hash unchanged with continuation pages."
},
"session_intervals": {
"type": "array",
"items": {
"type": "integer",
"maximum": 252,
"minimum": 1
},
"maxItems": 8,
"minItems": 1
},
"max_snapshot_age_hours": {
"type": "number",
"maximum": 87600,
"description": "Requested verification-age tolerance: default1hour for retained archives,24hours for closing-price references. Record dates and publication cadence are separate.",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$defs": {
"0": {
"type": "string",
"$anchor": "a3",
"minLength": 1
},
"1": {
"type": [
"string",
"null"
],
"$anchor": "a8"
},
"2": {
"type": "string",
"format": "date-time",
"$anchor": "a1",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"3": {
"type": "string",
"$anchor": "a2",
"pattern": "^[a-f0-9]{64}$"
},
"4": {
"type": "integer",
"$anchor": "a0",
"maximum": 9007199254740991,
"minimum": 0
},
"5": {
"anyOf": [
{
"$ref": "#a0"
},
{
"type": "null"
}
],
"$anchor": "a9"
},
"6": {
"type": "string",
"format": "uuid",
"$anchor": "a5",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"7": {
"anyOf": [
{
"$ref": "#a1"
},
{
"type": "null"
}
],
"$anchor": "a6"
},
"8": {
"type": "string",
"format": "uri",
"$anchor": "a4"
},
"9": {
"type": "array",
"items": {
"type": "string"
},
"$anchor": "ab"
},
"a": {
"anyOf": [
{
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
{
"type": "null"
}
],
"$anchor": "a7"
},
"b": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"$anchor": "aa"
},
"c": {
"type": "object",
"$anchor": "ac",
"additionalProperties": {}
},
"d": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"e": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 100
},
"f": {
"anyOf": [
{
"$ref": "#a2"
},
{
"type": "null"
}
]
}
},
"anyOf": [
{
"required": [
"schema_version",
"resource",
"operation",
"ticker",
"as_of",
"generated_at",
"status",
"context",
"snapshot_captured_at",
"historical_issuer_ownership_verified",
"data",
"sources",
"pagination",
"limitations"
],
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"required": [
"family",
"status",
"records",
"retained_records",
"matched_records",
"omitted_records",
"held_records",
"freshness",
"coverage",
"limitations"
],
"properties": {
"family": {
"const": "market_returns"
},
"status": {
"type": "string"
},
"records": {
"type": "array",
"items": {
"type": "object",
"required": [
"record_id",
"source_kind",
"support",
"observed_at",
"period_end",
"reported_at",
"native_details",
"type",
"session_intervals",
"from_session",
"to_session",
"security_return_pct",
"benchmark_ticker",
"benchmark_return_pct",
"excess_return_pp",
"basis"
],
"properties": {
"type": {
"const": "market_return"
},
"basis": {
"const": "split_adjusted_close_price_return"
},
"support": {
"type": "object",
"required": [
"document_id",
"content_hash",
"json_pointer"
],
"properties": {
"text_span": {
"type": "object",
"required": [
"start",
"end"
],
"properties": {
"end": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"start": {
"$ref": "#a0"
}
},
"additionalProperties": false
},
"document_id": {
"type": "string"
},
"content_hash": {
"$ref": "#a2"
},
"json_pointer": {
"$ref": "#a8"
}
},
"additionalProperties": false
},
"record_id": {
"type": "string"
},
"period_end": {
"$ref": "#a8"
},
"to_session": {
"type": "string"
},
"observed_at": {
"$ref": "#a8"
},
"reported_at": {
"$ref": "#a8"
},
"source_kind": {
"type": "string"
},
"from_session": {
"type": "string"
},
"native_details": {
"anyOf": [
{
"type": "object",
"required": [
"attributes",
"measurements",
"clocks"
],
"properties": {
"clocks": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"role",
"value",
"precision"
],
"properties": {
"name": {
"$ref": "#a3"
},
"role": {
"enum": [
"period",
"event",
"report",
"expiration",
"scheduled",
"observation"
]
},
"value": {
"$ref": "#a8"
},
"precision": {
"enum": [
"instant",
"date",
"period",
"unknown"
]
}
},
"additionalProperties": false
},
"maxItems": 8
},
"attributes": {
"type": "object",
"additionalProperties": {
"$ref": "#a8"
}
},
"measurements": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"value",
"unit"
],
"properties": {
"name": {
"$ref": "#a3"
},
"unit": {
"$ref": "#a8"
},
"value": {
"type": [
"string",
"number",
"null"
]
}
},
"additionalProperties": false
},
"maxItems": 128
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"benchmark_ticker": {
"const": "SPY"
},
"excess_return_pp": {
"type": "number"
},
"session_intervals": {
"$ref": "#/$defs/d"
},
"security_return_pct": {
"type": "number"
},
"benchmark_return_pct": {
"type": "number"
}
},
"additionalProperties": false
},
"maxItems": 100
},
"coverage": {
"enum": [
"complete_for_retained_scope",
"partial_archive_scan",
"bounded_snapshot",
"unavailable"
]
},
"freshness": {
"type": "object",
"required": [
"status",
"evaluated_at",
"source_captured_at",
"age_seconds",
"max_snapshot_age_seconds",
"latest_record_at",
"publication_cadence_verified",
"refresh_status"
],
"properties": {
"status": {
"enum": [
"fresh",
"stale",
"unknown",
"historical"
]
},
"age_seconds": {
"$ref": "#aa"
},
"evaluated_at": {
"$ref": "#a1"
},
"refresh_status": {
"enum": [
"not_required",
"historical_no_refresh",
"newer_admission_unverified",
"source_clock_unknown"
]
},
"latest_record_at": {
"$ref": "#a8"
},
"source_captured_at": {
"$ref": "#a6"
},
"source_verified_at": {
"$ref": "#a6"
},
"verification_scope": {
"const": "filing_inventory"
},
"capture_age_seconds": {
"$ref": "#aa"
},
"max_snapshot_age_seconds": {
"type": "number",
"exclusiveMinimum": 0
},
"verification_age_seconds": {
"$ref": "#aa"
},
"publication_cadence_verified": {
"const": false
}
},
"additionalProperties": false
},
"limitations": {
"$ref": "#ab"
},
"held_records": {
"$ref": "#a9"
},
"matched_records": {
"$ref": "#a9"
},
"omitted_records": {
"$ref": "#a9"
},
"retained_records": {
"$ref": "#a9"
},
"available_issuer_selectors": {
"type": "object",
"required": [
"metrics",
"dimensions",
"fiscal_years",
"scope",
"truncated"
],
"properties": {
"scope": {
"const": "retained_issuer_observations"
},
"metrics": {
"$ref": "#/$defs/e"
},
"truncated": {
"type": "boolean"
},
"dimensions": {
"$ref": "#/$defs/e"
},
"fiscal_years": {
"type": "array",
"items": {
"$ref": "#/$defs/d"
},
"maxItems": 100
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"maxItems": 1
},
"as_of": {
"$ref": "#a1"
},
"status": {
"enum": [
"available",
"partial",
"unavailable"
]
},
"ticker": {
"type": "string"
},
"context": {
"anyOf": [
{
"type": "object",
"required": [
"artifact_id",
"content_hash",
"observed_through",
"available_at"
],
"properties": {
"artifact_id": {
"$ref": "#a5"
},
"available_at": {
"$ref": "#a1"
},
"content_hash": {
"type": "string"
},
"observed_through": {
"$ref": "#a1"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"sources": {
"type": "array",
"items": {
"type": "object",
"anyOf": [
{
"required": [
"id",
"source_id",
"kind",
"title",
"url",
"published_at",
"publication_date",
"publication_precision",
"observed_at",
"content_hash",
"raw_capture_hash",
"retained_record_hash",
"capture_basis",
"representation"
],
"properties": {
"id": {
"$ref": "#a3"
},
"url": {
"$ref": "#a4"
},
"kind": {
"enum": [
"sec_disclosure",
"government_award",
"issuer_disclosure",
"research_input"
]
},
"title": {
"type": "string"
},
"source_id": {
"$ref": "#a5"
},
"observed_at": {
"$ref": "#a1"
},
"content_hash": {
"$ref": "#a2"
},
"published_at": {
"$ref": "#a6"
},
"capture_basis": {
"enum": [
"http_response_bytes",
"retained_export",
"retained_case"
]
},
"representation": {
"enum": [
"provider_json",
"sec_xbrl",
"visible_text",
"retained_research_case"
]
},
"publication_date": {
"$ref": "#a7"
},
"raw_capture_hash": {
"$ref": "#/$defs/f"
},
"retained_record_hash": {
"$ref": "#/$defs/f"
},
"publication_precision": {
"enum": [
"instant",
"date",
"unknown"
]
}
},
"additionalProperties": false
},
{
"required": [
"id",
"kind",
"title",
"url",
"observed_at",
"content_hash",
"observation_hashes_sha256",
"observation_count",
"calendar_artifact_id",
"calendar_content_hash",
"representation"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"$ref": "#a4"
},
"kind": {
"const": "stored_market_data"
},
"title": {
"type": "string"
},
"providers": {
"$ref": "#ab"
},
"observed_at": {
"$ref": "#a1"
},
"content_hash": {
"$ref": "#a2"
},
"representation": {
"const": "reconciled_daily_bars"
},
"observation_count": {
"$ref": "#a0"
},
"calendar_artifact_id": {
"$ref": "#a5"
},
"calendar_content_hash": {
"$ref": "#a2"
},
"observation_hashes_sha256": {
"$ref": "#a2"
}
},
"additionalProperties": false
}
]
}
},
"resource": {
"const": "company_dataset"
},
"operation": {
"const": "get_market_returns"
},
"pagination": {
"type": "object",
"required": [
"offset",
"returned",
"total_retained_records",
"total_matching_records",
"next_offset",
"snapshot_id",
"snapshot_hash",
"filters_sha256"
],
"properties": {
"offset": {
"$ref": "#a0"
},
"returned": {
"$ref": "#a0"
},
"next_cursor": {
"$ref": "#a8"
},
"next_offset": {
"$ref": "#a9"
},
"snapshot_id": {
"anyOf": [
{
"$ref": "#a5"
},
{
"type": "null"
}
]
},
"scanned_rows": {
"$ref": "#a0"
},
"scan_complete": {
"type": "boolean"
},
"snapshot_hash": {
"$ref": "#a8"
},
"filters_sha256": {
"type": "string"
},
"total_matching_records": {
"$ref": "#a9"
},
"total_retained_records": {
"$ref": "#a9"
}
},
"additionalProperties": false
},
"limitations": {
"$ref": "#ab"
},
"generated_at": {
"$ref": "#a1"
},
"query_binding": {
"type": "object",
"required": [
"artifactId",
"contentHash"
],
"properties": {
"artifactId": {
"$ref": "#a5"
},
"contentHash": {
"$ref": "#a2"
}
},
"additionalProperties": false
},
"billing_notice": {
"type": "object",
"required": [
"code",
"message",
"remaining_requests",
"add_credits_url",
"plans_url"
],
"properties": {
"code": {
"const": "signup_credit_exhausted"
},
"message": {
"$ref": "#a3"
},
"plans_url": {
"$ref": "#a4"
},
"add_credits_url": {
"$ref": "#a4"
},
"remaining_requests": {
"const": 0
}
},
"additionalProperties": false
},
"issuer_refresh": {
"type": "object",
"required": [
"status",
"filing_inventory_verified_at",
"backfill_from",
"backfill_through",
"history_complete",
"held_documents"
],
"properties": {
"status": {
"enum": [
"not_required",
"queued",
"unavailable",
"saved_only"
]
},
"backfill_from": {
"$ref": "#a7"
},
"held_documents": {
"$ref": "#a0"
},
"backfill_through": {
"$ref": "#a7"
},
"history_complete": {
"type": "boolean"
},
"filing_inventory_verified_at": {
"$ref": "#a6"
}
},
"additionalProperties": false
},
"schema_version": {
"const": "2"
},
"snapshot_captured_at": {
"$ref": "#a6"
},
"historical_issuer_ownership_verified": {
"anyOf": [
{
"const": false
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message",
"recovery",
"retryable"
],
"properties": {
"code": {
"enum": [
"unauthorized",
"invalid_input",
"entity_not_found",
"entity_ambiguous",
"outside_entitlement",
"rate_limited",
"data_unavailable",
"insufficient_sample",
"unsupported_security",
"duplicate_request"
]
},
"message": {
"$ref": "#a3"
},
"recovery": {
"anyOf": [
{
"$ref": "#a3"
},
{
"type": "null"
}
]
},
"retryable": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"required": [
"accepts",
"resource",
"x402Version"
],
"properties": {
"error": {
"type": "string"
},
"accepts": {
"type": "array",
"items": {
"type": "object",
"required": [
"amount",
"asset",
"maxTimeoutSeconds",
"network",
"payTo",
"scheme"
],
"properties": {
"asset": {
"$ref": "#a3"
},
"extra": {
"$ref": "#ac"
},
"payTo": {
"$ref": "#a3"
},
"amount": {
"type": "string",
"pattern": "^\\d+$"
},
"scheme": {
"enum": [
"exact"
]
},
"network": {
"type": "string",
"pattern": "^eip155:\\d+$"
},
"maxTimeoutSeconds": {
"type": "number"
}
},
"additionalProperties": false
},
"minItems": 1
},
"resource": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"$ref": "#a3"
},
"tags": {
"$ref": "#ab"
},
"iconUrl": {
"type": "string"
},
"mimeType": {
"type": "string"
},
"description": {
"type": "string"
},
"serviceName": {
"type": "string"
}
},
"additionalProperties": false
},
"extensions": {
"type": "object",
"additionalProperties": {
"type": "object",
"required": [
"info",
"schema"
],
"properties": {
"info": {
"$ref": "#ac"
},
"schema": {
"$ref": "#ac"
}
},
"additionalProperties": false
}
},
"x402Version": {
"const": 2
}
},
"additionalProperties": false
},
{
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"enum": [
"payment_pending",
"rate_limited"
]
},
"message": {
"$ref": "#a3"
},
"retryable": {
"const": true
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}| date_from | string | Inclusive native date lower bound, selected by date_field. |
| date_field | string | Date meaning; defaults to period for facts/macro/holdings/returns, event for insider trades, observation for options/short volume, scheduled for calendar. |
| strike_max | number |
| strike_min | number |
| snapshot_id | string | Pin continuation to the returned snapshot ID; reuse with snapshot_hash and as_of. |
| activity_type | string | one of ["option_bar","flow_aggregate","open_interest"] |
| expiration_to | string |
| snapshot_hash | string |
| filters_sha256 | string | Reuse the returned filter hash unchanged with continuation pages. |
| expiration_from | string |
| max_snapshot_age_hours | number | Requested verification-age tolerance: default1hour for retained archives,24hours for closing-price references. Record dates and publication cadence are separate. |
{
"name": "get_options_activity",
"title": "Get options activity",
"description": "Retrieves retained options bars, flow aggregates and open interest for one ticker. Select activity_type, call/put right, expiration, strike and observation-date filters; returns typed instrument fields, OHLC, volume or open interest with units and source support. Open interest is a position measure; trading volume is a flow. Use explicit date/instrument filters for large histories; source-file order is not a globally sorted latest option chain. Current requests recheck stale mirror metadata; historical/pinned reads remain fixed. Continue with the returned snapshot, cutoff, filters and cursor or next_offset; partial scans are not proof of no matches. Per-call x402 price: 0.02 USDC on Base.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"ticker"
],
"properties": {
"as_of": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
"description": "Availability cutoff, separate from event/period filters. Historical reads never refresh."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Matching typed observations per page; default32."
},
"right": {
"enum": [
"C",
"P"
],
"type": "string"
},
"cursor": {
"type": "string",
"maxLength": 4096,
"description": "Archive continuation token; reuse with snapshot ID/hash, as_of and unchanged filters."
},
"family": {
"enum": [
"options",
"open_interest"
],
"type": "string"
},
"offset": {
"type": "integer",
"maximum": 10000000,
"minimum": 0
},
"ticker": {
"type": "string",
"pattern": "^[A-Z][A-Z0-9.-]{0,15}$"
},
"date_to": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Inclusive native date upper bound, selected by date_field."
},
"date_from": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Inclusive native date lower bound, selected by date_field."
},
"date_field": {
"enum": [
"observation"
],
"type": "string",
"description": "Date meaning; defaults to period for facts/macro/holdings/returns, event for insider trades, observation for options/short volume, scheduled for calendar."
},
"strike_max": {
"type": "number",
"minimum": 0
},
"strike_min": {
"type": "number",
"minimum": 0
},
"snapshot_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "Pin continuation to the returned snapshot ID; reuse with snapshot_hash and as_of."
},
"activity_type": {
"enum": [
"option_bar",
"flow_aggregate",
"open_interest"
],
"type": "string"
},
"expiration_to": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
"snapshot_hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"filters_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "Reuse the returned filter hash unchanged with continuation pages."
},
"expiration_from": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
"max_snapshot_age_hours": {
"type": "number",
"maximum": 87600,
"description": "Requested verification-age tolerance: default1hour for retained archives,24hours for closing-price references. Record dates and publication cadence are separate.",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$defs": {
"0": {
"type": "object",
"$anchor": "a5",
"required": [
"value",
"unit"
],
"properties": {
"unit": {
"$ref": "#a0"
},
"value": {
"$ref": "#a0"
}
},
"additionalProperties": false
},
"1": {
"type": [
"string",
"null"
],
"$anchor": "a0"
},
"2": {
"anyOf": [
{
"$ref": "#a1"
},
{
"type": "null"
}
],
"$anchor": "ab"
},
"3": {
"type": "string",
"$anchor": "a4",
"minLength": 1
},
"4": {
"type": "string",
"format": "date-time",
"$anchor": "a2",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"5": {
"type": "string",
"$anchor": "a3",
"pattern": "^[a-f0-9]{64}$"
},
"6": {
"type": "integer",
"$anchor": "a1",
"maximum": 9007199254740991,
"minimum": 0
},
"7": {
"type": "string",
"format": "uuid",
"$anchor": "a9",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"8": {
"anyOf": [
{
"$ref": "#a2"
},
{
"type": "null"
}
],
"$anchor": "a6"
},
"9": {
"type": "array",
"items": {
"type": "string"
},
"$anchor": "ac"
},
"a": {
"type": "string",
"format": "uri",
"$anchor": "a8"
},
"b": {
"anyOf": [
{
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
{
"type": "null"
}
],
"$anchor": "aa"
},
"c": {
"type": "object",
"$anchor": "ad",
"additionalProperties": {}
},
"d": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"$anchor": "a7"
},
"e": {
"type": "object",
"required": [
"document_id",
"content_hash",
"json_pointer"
],
"properties": {
"text_span": {
"type": "object",
"required": [
"start",
"end"
],
"properties": {
"end": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"start": {
"$ref": "#a1"
}
},
"additionalProperties": false
},
"document_id": {
"type": "string"
},
"content_hash": {
"$ref": "#a3"
},
"json_pointer": {
"$ref": "#a0"
}
},
"additionalProperties": false
},
"f": {
"anyOf": [
{
"$ref": "#a3"
},
{
"type": "null"
}
]
},
"g": {
"anyOf": [
{
"type": "object",
"required": [
"attributes",
"measurements",
"clocks"
],
"properties": {
"clocks": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"role",
"value",
"precision"
],
"properties": {
"name": {
"$ref": "#a4"
},
"role": {
"enum": [
"period",
"event",
"report",
"expiration",
"scheduled",
"observation"
]
},
"value": {
"$ref": "#a0"
},
"precision": {
"enum": [
"instant",
"date",
"period",
"unknown"
]
}
},
"additionalProperties": false
},
"maxItems": 8
},
"attributes": {
"type": "object",
"additionalProperties": {
"$ref": "#a0"
}
},
"measurements": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"value",
"unit"
],
"properties": {
"name": {
"$ref": "#a4"
},
"unit": {
"$ref": "#a0"
},
"value": {
"type": [
"string",
"number",
"null"
]
}
},
"additionalProperties": false
},
"maxItems": 128
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"h": {
"type": "object",
"additionalProperties": {
"$ref": "#a5"
}
},
"i": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 100
},
"j": {
"type": "object",
"required": [
"metrics",
"dimensions",
"fiscal_years",
"scope",
"truncated"
],
"properties": {
"scope": {
"const": "retained_issuer_observations"
},
"metrics": {
"$ref": "#/$defs/i"
},
"truncated": {
"type": "boolean"
},
"dimensions": {
"$ref": "#/$defs/i"
},
"fiscal_years": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"maxItems": 100
}
},
"additionalProperties": false
},
"k": {
"type": "object",
"required": [
"status",
"evaluated_at",
"source_captured_at",
"age_seconds",
"max_snapshot_age_seconds",
"latest_record_at",
"publication_cadence_verified",
"refresh_status"
],
"properties": {
"status": {
"enum": [
"fresh",
"stale",
"unknown",
"historical"
]
},
"age_seconds": {
"$ref": "#a7"
},
"evaluated_at": {
"$ref": "#a2"
},
"refresh_status": {
"enum": [
"not_required",
"historical_no_refresh",
"newer_admission_unverified",
"source_clock_unknown"
]
},
"latest_record_at": {
"$ref": "#a0"
},
"source_captured_at": {
"$ref": "#a6"
},
"source_verified_at": {
"$ref": "#a6"
},
"verification_scope": {
"const": "filing_inventory"
},
"capture_age_seconds": {
"$ref": "#a7"
},
"max_snapshot_age_seconds": {
"type": "number",
"exclusiveMinimum": 0
},
"verification_age_seconds": {
"$ref": "#a7"
},
"publication_cadence_verified": {
"const": false
}
},
"additionalProperties": false
},
"l": {
"enum": [
"complete_for_retained_scope",
"partial_archive_scan",
"bounded_snapshot",
"unavailable"
]
},
"rd": {
"required": [
"family",
"status",
"records",
"retained_records",
"matched_records",
"omitted_records",
"held_records",
"freshness",
"coverage",
"limitations"
]
},
"re": {
"required": [
"record_id",
"source_kind",
"support",
"observed_at",
"period_end",
"reported_at",
"native_details",
"type",
"activity_type",
"right",
"strike",
"expiration",
"open",
"high",
"low",
"close",
"volume",
"open_interest",
"call_volume",
"put_volume",
"call_premium",
"put_premium",
"multiplier",
"currency",
"additional_reported_measures"
]
}
},
"anyOf": [
{
"required": [
"schema_version",
"resource",
"operation",
"ticker",
"as_of",
"generated_at",
"status",
"context",
"snapshot_captured_at",
"historical_issuer_ownership_verified",
"data",
"sources",
"pagination",
"limitations"
],
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"anyOf": [
{
"allOf": [
{
"$ref": "#/$defs/rd"
}
],
"properties": {
"family": {
"const": "options"
},
"status": {
"type": "string"
},
"records": {
"type": "array",
"items": {
"type": "object",
"allOf": [
{
"$ref": "#/$defs/re"
}
],
"properties": {
"low": {
"$ref": "#a5"
},
"high": {
"$ref": "#a5"
},
"open": {
"$ref": "#a5"
},
"type": {
"const": "option_activity"
},
"close": {
"$ref": "#a5"
},
"right": {
"$ref": "#a0"
},
"strike": {
"$ref": "#a5"
},
"volume": {
"$ref": "#a5"
},
"support": {
"$ref": "#/$defs/e"
},
"currency": {
"$ref": "#a0"
},
"record_id": {
"type": "string"
},
"expiration": {
"$ref": "#a0"
},
"multiplier": {
"type": [
"number",
"null"
]
},
"period_end": {
"$ref": "#a0"
},
"put_volume": {
"$ref": "#a5"
},
"call_volume": {
"$ref": "#a5"
},
"observed_at": {
"$ref": "#a0"
},
"put_premium": {
"$ref": "#a5"
},
"reported_at": {
"$ref": "#a0"
},
"source_kind": {
"type": "string"
},
"call_premium": {
"$ref": "#a5"
},
"activity_type": {
"enum": [
"option_bar",
"flow_aggregate"
]
},
"open_interest": {
"$ref": "#a5"
},
"native_details": {
"$ref": "#/$defs/g"
},
"additional_reported_measures": {
"$ref": "#/$defs/h"
}
},
"additionalProperties": false
},
"maxItems": 100
},
"coverage": {
"$ref": "#/$defs/l"
},
"freshness": {
"$ref": "#/$defs/k"
},
"limitations": {
"$ref": "#ac"
},
"held_records": {
"$ref": "#ab"
},
"matched_records": {
"$ref": "#ab"
},
"omitted_records": {
"$ref": "#ab"
},
"retained_records": {
"$ref": "#ab"
},
"available_issuer_selectors": {
"$ref": "#/$defs/j"
}
},
"additionalProperties": false
},
{
"allOf": [
{
"$ref": "#/$defs/rd"
}
],
"properties": {
"family": {
"const": "open_interest"
},
"status": {
"type": "string"
},
"records": {
"type": "array",
"items": {
"type": "object",
"allOf": [
{
"$ref": "#/$defs/re"
}
],
"properties": {
"low": {
"$ref": "#a5"
},
"high": {
"$ref": "#a5"
},
"open": {
"$ref": "#a5"
},
"type": {
"const": "option_activity"
},
"close": {
"$ref": "#a5"
},
"right": {
"$ref": "#a0"
},
"strike": {
"$ref": "#a5"
},
"volume": {
"$ref": "#a5"
},
"support": {
"$ref": "#/$defs/e"
},
"currency": {
"$ref": "#a0"
},
"record_id": {
"type": "string"
},
"expiration": {
"$ref": "#a0"
},
"multiplier": {
"type": [
"number",
"null"
]
},
"period_end": {
"$ref": "#a0"
},
"put_volume": {
"$ref": "#a5"
},
"call_volume": {
"$ref": "#a5"
},
"observed_at": {
"$ref": "#a0"
},
"put_premium": {
"$ref": "#a5"
},
"reported_at": {
"$ref": "#a0"
},
"source_kind": {
"type": "string"
},
"call_premium": {
"$ref": "#a5"
},
"activity_type": {
"const": "open_interest"
},
"open_interest": {
"$ref": "#a5"
},
"native_details": {
"$ref": "#/$defs/g"
},
"additional_reported_measures": {
"$ref": "#/$defs/h"
}
},
"additionalProperties": false
},
"maxItems": 100
},
"coverage": {
"$ref": "#/$defs/l"
},
"freshness": {
"$ref": "#/$defs/k"
},
"limitations": {
"$ref": "#ac"
},
"held_records": {
"$ref": "#ab"
},
"matched_records": {
"$ref": "#ab"
},
"omitted_records": {
"$ref": "#ab"
},
"retained_records": {
"$ref": "#ab"
},
"available_issuer_selectors": {
"$ref": "#/$defs/j"
}
},
"additionalProperties": false
}
]
},
"maxItems": 2
},
"as_of": {
"$ref": "#a2"
},
"status": {
"enum": [
"available",
"partial",
"unavailable"
]
},
"ticker": {
"type": "string"
},
"context": {
"anyOf": [
{
"type": "object",
"required": [
"artifact_id",
"content_hash",
"observed_through",
"available_at"
],
"properties": {
"artifact_id": {
"$ref": "#a9"
},
"available_at": {
"$ref": "#a2"
},
"content_hash": {
"type": "string"
},
"observed_through": {
"$ref": "#a2"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"sources": {
"type": "array",
"items": {
"type": "object",
"anyOf": [
{
"required": [
"id",
"source_id",
"kind",
"title",
"url",
"published_at",
"publication_date",
"publication_precision",
"observed_at",
"content_hash",
"raw_capture_hash",
"retained_record_hash",
"capture_basis",
"representation"
],
"properties": {
"id": {
"$ref": "#a4"
},
"url": {
"$ref": "#a8"
},
"kind": {
"enum": [
"sec_disclosure",
"government_award",
"issuer_disclosure",
"research_input"
]
},
"title": {
"type": "string"
},
"source_id": {
"$ref": "#a9"
},
"observed_at": {
"$ref": "#a2"
},
"content_hash": {
"$ref": "#a3"
},
"published_at": {
"$ref": "#a6"
},
"capture_basis": {
"enum": [
"http_response_bytes",
"retained_export",
"retained_case"
]
},
"representation": {
"enum": [
"provider_json",
"sec_xbrl",
"visible_text",
"retained_research_case"
]
},
"publication_date": {
"$ref": "#aa"
},
"raw_capture_hash": {
"$ref": "#/$defs/f"
},
"retained_record_hash": {
"$ref": "#/$defs/f"
},
"publication_precision": {
"enum": [
"instant",
"date",
"unknown"
]
}
},
"additionalProperties": false
},
{
"required": [
"id",
"kind",
"title",
"url",
"observed_at",
"content_hash",
"observation_hashes_sha256",
"observation_count",
"calendar_artifact_id",
"calendar_content_hash",
"representation"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"$ref": "#a8"
},
"kind": {
"const": "stored_market_data"
},
"title": {
"type": "string"
},
"providers": {
"$ref": "#ac"
},
"observed_at": {
"$ref": "#a2"
},
"content_hash": {
"$ref": "#a3"
},
"representation": {
"const": "reconciled_daily_bars"
},
"observation_count": {
"$ref": "#a1"
},
"calendar_artifact_id": {
"$ref": "#a9"
},
"calendar_content_hash": {
"$ref": "#a3"
},
"observation_hashes_sha256": {
"$ref": "#a3"
}
},
"additionalProperties": false
}
]
}
},
"resource": {
"const": "company_dataset"
},
"operation": {
"const": "get_options_activity"
},
"pagination": {
"type": "object",
"required": [
"offset",
"returned",
"total_retained_records",
"total_matching_records",
"next_offset",
"snapshot_id",
"snapshot_hash",
"filters_sha256"
],
"properties": {
"offset": {
"$ref": "#a1"
},
"returned": {
"$ref": "#a1"
},
"next_cursor": {
"$ref": "#a0"
},
"next_offset": {
"$ref": "#ab"
},
"snapshot_id": {
"anyOf": [
{
"$ref": "#a9"
},
{
"type": "null"
}
]
},
"scanned_rows": {
"$ref": "#a1"
},
"scan_complete": {
"type": "boolean"
},
"snapshot_hash": {
"$ref": "#a0"
},
"filters_sha256": {
"type": "string"
},
"total_matching_records": {
"$ref": "#ab"
},
"total_retained_records": {
"$ref": "#ab"
}
},
"additionalProperties": false
},
"limitations": {
"$ref": "#ac"
},
"generated_at": {
"$ref": "#a2"
},
"query_binding": {
"type": "object",
"required": [
"artifactId",
"contentHash"
],
"properties": {
"artifactId": {
"$ref": "#a9"
},
"contentHash": {
"$ref": "#a3"
}
},
"additionalProperties": false
},
"billing_notice": {
"type": "object",
"required": [
"code",
"message",
"remaining_requests",
"add_credits_url",
"plans_url"
],
"properties": {
"code": {
"const": "signup_credit_exhausted"
},
"message": {
"$ref": "#a4"
},
"plans_url": {
"$ref": "#a8"
},
"add_credits_url": {
"$ref": "#a8"
},
"remaining_requests": {
"const": 0
}
},
"additionalProperties": false
},
"issuer_refresh": {
"type": "object",
"required": [
"status",
"filing_inventory_verified_at",
"backfill_from",
"backfill_through",
"history_complete",
"held_documents"
],
"properties": {
"status": {
"enum": [
"not_required",
"queued",
"unavailable",
"saved_only"
]
},
"backfill_from": {
"$ref": "#aa"
},
"held_documents": {
"$ref": "#a1"
},
"backfill_through": {
"$ref": "#aa"
},
"history_complete": {
"type": "boolean"
},
"filing_inventory_verified_at": {
"$ref": "#a6"
}
},
"additionalProperties": false
},
"schema_version": {
"const": "2"
},
"snapshot_captured_at": {
"$ref": "#a6"
},
"historical_issuer_ownership_verified": {
"anyOf": [
{
"const": false
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message",
"recovery",
"retryable"
],
"properties": {
"code": {
"enum": [
"unauthorized",
"invalid_input",
"entity_not_found",
"entity_ambiguous",
"outside_entitlement",
"rate_limited",
"data_unavailable",
"insufficient_sample",
"unsupported_security",
"duplicate_request"
]
},
"message": {
"$ref": "#a4"
},
"recovery": {
"anyOf": [
{
"$ref": "#a4"
},
{
"type": "null"
}
]
},
"retryable": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"required": [
"accepts",
"resource",
"x402Version"
],
"properties": {
"error": {
"type": "string"
},
"accepts": {
"type": "array",
"items": {
"type": "object",
"required": [
"amount",
"asset",
"maxTimeoutSeconds",
"network",
"payTo",
"scheme"
],
"properties": {
"asset": {
"$ref": "#a4"
},
"extra": {
"$ref": "#ad"
},
"payTo": {
"$ref": "#a4"
},
"amount": {
"type": "string",
"pattern": "^\\d+$"
},
"scheme": {
"enum": [
"exact"
]
},
"network": {
"type": "string",
"pattern": "^eip155:\\d+$"
},
"maxTimeoutSeconds": {
"type": "number"
}
},
"additionalProperties": false
},
"minItems": 1
},
"resource": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"$ref": "#a4"
},
"tags": {
"$ref": "#ac"
},
"iconUrl": {
"type": "string"
},
"mimeType": {
"type": "string"
},
"description": {
"type": "string"
},
"serviceName": {
"type": "string"
}
},
"additionalProperties": false
},
"extensions": {
"type": "object",
"additionalProperties": {
"type": "object",
"required": [
"info",
"schema"
],
"properties": {
"info": {
"$ref": "#ad"
},
"schema": {
"$ref": "#ad"
}
},
"additionalProperties": false
}
},
"x402Version": {
"const": 2
}
},
"additionalProperties": false
},
{
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"enum": [
"payment_pending",
"rate_limited"
]
},
"message": {
"$ref": "#a4"
},
"retryable": {
"const": true
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}| string |
| published_from | string |
| published_through | string |
{
"name": "get_risks",
"title": "Get case risks",
"description": "Retrieves evidence-linked risks for one company, research subject, investment case or the explicitly selected released corpus. Returns recorded severity, lifecycle status, supporting evidence and unknown assessments. Useful for investigating a thesis's downside and invalidation conditions. Filter by investor, source, publication dates, status or severity. Empty filtered results reflect available assessed coverage; unknown risks remain separate. Continue with the returned cursor and unchanged filters. Per-call x402 price: 0.02 USDC on Base.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"as_of": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1
},
"corpus": {
"type": "string",
"const": "released"
},
"cursor": {
"type": "string",
"maxLength": 4096
},
"ticker": {
"type": "string",
"maxLength": 32,
"minLength": 1
},
"severity": {
"enum": [
"low",
"medium",
"high"
],
"type": "string"
},
"belief_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"entity_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"person_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"source_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"object_status": {
"type": "string"
},
"published_from": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"published_through": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$defs": {
"0": {
"type": "string",
"format": "date-time",
"$anchor": "a0",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"1": {
"type": "string",
"format": "uuid",
"$anchor": "a1",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"2": {
"type": "string",
"$anchor": "a2",
"minLength": 1
},
"3": {
"type": "integer",
"$anchor": "a5",
"maximum": 9007199254740991,
"minimum": 0
},
"4": {
"type": [
"string",
"null"
],
"$anchor": "a7"
},
"5": {
"anyOf": [
{
"$ref": "#a0"
},
{
"type": "null"
}
],
"$anchor": "a6"
},
"6": {
"type": "string",
"format": "uri",
"$anchor": "a3"
},
"7": {
"type": "string",
"$anchor": "a4",
"maxLength": 64,
"minLength": 64
},
"8": {
"anyOf": [
{
"$ref": "#a1"
},
{
"type": "null"
}
],
"$anchor": "a8"
},
"9": {
"type": "string",
"$anchor": "a9",
"pattern": "^[a-f0-9]{64}$"
},
"a": {
"type": "array",
"items": {
"type": "string"
},
"$anchor": "aa"
},
"b": {
"type": "object",
"$anchor": "ab",
"additionalProperties": {}
},
"c": {
"type": "object",
"required": [
"code",
"message",
"remaining_requests",
"add_credits_url",
"plans_url"
],
"properties": {
"code": {
"const": "signup_credit_exhausted"
},
"message": {
"$ref": "#a2"
},
"plans_url": {
"$ref": "#a3"
},
"add_credits_url": {
"$ref": "#a3"
},
"remaining_requests": {
"const": 0
}
},
"additionalProperties": false
},
"d": {
"type": "array",
"items": {
"type": "object",
"oneOf": [
{
"required": [
"object_id",
"version_id",
"belief_id",
"statement",
"statement_ordinal",
"effective_at",
"recorded_at",
"status_assessed_at",
"evidence",
"unknowns",
"kind",
"status",
"severity",
"severity_basis",
"severity_rationale",
"severity_methodology",
"continuing_relevance"
],
"properties": {
"kind": {
"const": "risk"
},
"status": {
"enum": [
"open",
"materialized",
"resolved",
"superseded",
"unknown"
]
},
"evidence": {
"$ref": "#/$defs/g"
},
"severity": {
"anyOf": [
{
"enum": [
"low",
"medium",
"high"
]
},
{
"type": "null"
}
]
},
"unknowns": {
"$ref": "#/$defs/h"
},
"belief_id": {
"$ref": "#a1"
},
"object_id": {
"$ref": "#a1"
},
"statement": {
"$ref": "#a2"
},
"version_id": {
"$ref": "#a4"
},
"recorded_at": {
"$ref": "#a0"
},
"effective_at": {
"$ref": "#a0"
},
"assessment_id": {
"$ref": "#a1"
},
"severity_basis": {
"enum": [
"source_stated",
"engine_assessed",
"unknown"
]
},
"assessment_cutoff": {
"$ref": "#a0"
},
"checking_evidence": {
"$ref": "#/$defs/i"
},
"statement_ordinal": {
"$ref": "#a5"
},
"severity_rationale": {
"$ref": "#a7"
},
"status_assessed_at": {
"$ref": "#a6"
},
"continuing_relevance": {
"type": [
"boolean",
"null"
]
},
"severity_methodology": {
"$ref": "#a7"
},
"assessment_available_at": {
"$ref": "#a0"
}
},
"additionalProperties": false
},
{
"required": [
"object_id",
"version_id",
"belief_id",
"statement",
"statement_ordinal",
"effective_at",
"recorded_at",
"status_assessed_at",
"evidence",
"unknowns",
"kind",
"status",
"expected_by",
"condition_id",
"superseded",
"checking_evidence",
"recorded_status",
"assessment",
"checking_support"
],
"properties": {
"kind": {
"const": "catalyst"
},
"status": {
"enum": [
"pending",
"met",
"missed",
"unknown"
]
},
"evidence": {
"$ref": "#/$defs/g"
},
"unknowns": {
"$ref": "#/$defs/h"
},
"belief_id": {
"$ref": "#a1"
},
"object_id": {
"$ref": "#a1"
},
"statement": {
"$ref": "#a2"
},
"assessment": {
"anyOf": [
{
"type": "object",
"required": [
"state",
"usable_as_current",
"assessed_at",
"provider_capability",
"reason",
"methodology_version"
],
"properties": {
"state": {
"enum": [
"not_checked",
"checked_unknown",
"unqualified",
"superseded",
"stale",
"current",
"historically_resolved"
]
},
"reason": {
"$ref": "#a2"
},
"assessed_at": {
"$ref": "#a0"
},
"usable_as_current": {
"type": "boolean"
},
"methodology_version": {
"const": "condition-read-qualification-v1"
},
"provider_capability": {
"enum": [
"share_price",
"sec_issuer",
"unsupported"
]
}
},
"description": "Qualification at this read cutoff, separate from the unchanged recorded status. Provider capability describes supported inputs, not enabled monitoring. A current check does not validate the whole investment case.",
"additionalProperties": false
},
{
"type": "null"
}
]
},
"superseded": {
"type": [
"boolean",
"null"
]
},
"version_id": {
"$ref": "#a4"
},
"expected_by": {
"$ref": "#a6"
},
"recorded_at": {
"$ref": "#a0"
},
"condition_id": {
"$ref": "#a8"
},
"effective_at": {
"$ref": "#a0"
},
"recorded_status": {
"$ref": "#a7"
},
"checking_support": {
"type": "object",
"oneOf": [
{
"required": [
"lineage",
"result"
],
"properties": {
"result": {
"type": "object",
"anyOf": [
{
"required": [
"kind",
"schema_version",
"result_id",
"provider",
"source_type",
"source_content_hash",
"facts"
],
"properties": {
"kind": {
"const": "provider_result"
},
"facts": {
"type": "object",
"required": [
"ticker",
"price",
"market_data_at",
"provider_observed_at",
"feed"
],
"properties": {
"feed": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"price": {
"type": "number",
"exclusiveMinimum": 0
},
"ticker": {
"$ref": "#/$defs/j"
},
"market_data_at": {
"$ref": "#a0"
},
"provider_observed_at": {
"$ref": "#a0"
}
},
"additionalProperties": false
},
"provider": {
"const": "alpaca"
},
"result_id": {
"type": "string",
"pattern": "^alpaca:market_price_snapshot:[a-f0-9]{64}$"
},
"source_type": {
"const": "market_price_snapshot"
},
"schema_version": {
"const": "condition-market-support-v1"
},
"source_content_hash": {
"$ref": "#a9"
}
},
"additionalProperties": false
},
{
"required": [
"kind",
"schema_version",
"result_id",
"provider",
"source_type",
"source_content_hash",
"facts",
"evidence"
],
"properties": {
"kind": {
"const": "provider_result"
},
"facts": {
"type": "object",
"required": [
"ticker",
"provider_observed_at"
],
"properties": {
"ticker": {
"$ref": "#/$defs/j"
},
"provider_observed_at": {
"$ref": "#a0"
}
},
"additionalProperties": false
},
"evidence": {
"type": "array",
"items": {
"type": "object",
"required": [
"document_id",
"quote",
"source_url",
"published_at",
"publication_time_basis",
"content_hash",
"start",
"end",
"representation"
],
"properties": {
"end": {
"$ref": "#/$defs/e"
},
"quote": {
"type": "string",
"maxLength": 1200,
"minLength": 12
},
"start": {
"$ref": "#a5"
},
"source_url": {
"$ref": "#a3"
},
"document_id": {
"$ref": "#a2"
},
"content_hash": {
"$ref": "#a4"
},
"published_at": {
"$ref": "#a0"
},
"representation": {
"enum": [
"issuer_text",
"structured_issuer_facts"
]
},
"publication_time_basis": {
"const": "filing_date_or_observation_bound"
}
},
"additionalProperties": false
},
"maxItems": 3,
"minItems": 1
},
"provider": {
"const": "sec_edgar"
},
"result_id": {
"$ref": "#a1"
},
"source_type": {
"const": "sec_edgar_issuer_snapshot"
},
"schema_version": {
"const": "condition-issuer-support-v1"
},
"source_content_hash": {
"$ref": "#a9"
}
},
"additionalProperties": false
}
]
},
"lineage": {
"const": "retained_provider_result"
}
},
"additionalProperties": false
},
{
"required": [
"lineage",
"result"
],
"properties": {
"result": {
"type": "object",
"required": [
"kind",
"schema_version",
"evidence"
],
"properties": {
"kind": {
"const": "retained_evidence"
},
"evidence": {
"type": "object",
"required": [
"source_id",
"evidence_id",
"source_revision_id",
"attributed_identity_id",
"source_content_hash",
"source_url",
"published_at",
"first_observed_at",
"captured_at",
"available_at",
"representation",
"visual_asset_id",
"quote",
"start",
"end"
],
"properties": {
"end": {
"$ref": "#/$defs/e"
},
"quote": {
"$ref": "#a2"
},
"start": {
"$ref": "#a5"
},
"source_id": {
"$ref": "#a1"
},
"source_url": {
"$ref": "#a3"
},
"captured_at": {
"$ref": "#a0"
},
"evidence_id": {
"$ref": "#a1"
},
"available_at": {
"$ref": "#a0"
},
"published_at": {
"$ref": "#a6"
},
"representation": {
"enum": [
"source_text",
"visual_transcription"
]
},
"visual_asset_id": {
"$ref": "#a8"
},
"first_observed_at": {
"$ref": "#a0"
},
"source_revision_id": {
"$ref": "#a1"
},
"source_content_hash": {
"$ref": "#a9"
},
"revision_published_at": {
"$ref": "#a6"
},
"attributed_identity_id": {
"$ref": "#a8"
}
},
"additionalProperties": false
},
"schema_version": {
"const": "condition-evidence-support-v1"
}
},
"additionalProperties": false
},
"lineage": {
"const": "retained_evidence"
}
},
"additionalProperties": false
},
{
"required": [
"lineage",
"result"
],
"properties": {
"result": {
"type": "null"
},
"lineage": {
"const": "limited_url_or_hash"
}
},
"additionalProperties": false
},
{
"required": [
"lineage",
"result"
],
"properties": {
"result": {
"type": "null"
},
"lineage": {
"const": "not_checked"
}
},
"additionalProperties": false
}
]
},
"checking_evidence": {
"$ref": "#/$defs/i"
},
"statement_ordinal": {
"$ref": "#a5"
},
"status_assessed_at": {
"$ref": "#a6"
}
},
"additionalProperties": false
}
]
}
},
"e": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"f": {
"type": "object",
"required": [
"evidence_id",
"source_id",
"source_url",
"source_title",
"published_at",
"first_observed_at",
"captured_at",
"content_hash",
"representation",
"source_coverage",
"support_ids"
],
"properties": {
"source_id": {
"$ref": "#a1"
},
"source_url": {
"$ref": "#a3"
},
"captured_at": {
"$ref": "#a0"
},
"citation_id": {
"$ref": "#a2"
},
"evidence_id": {
"$ref": "#a1"
},
"support_ids": {
"type": "array",
"items": {
"$ref": "#a1"
}
},
"content_hash": {
"$ref": "#a4"
},
"published_at": {
"$ref": "#a6"
},
"source_title": {
"type": "string"
},
"representation": {
"type": "string"
},
"source_coverage": {
"enum": [
"full",
"partial",
"unknown"
]
},
"first_observed_at": {
"$ref": "#a0"
},
"projection_receipt_id": {
"$ref": "#a1"
}
},
"additionalProperties": false
},
"g": {
"type": "array",
"items": {
"$ref": "#/$defs/f"
},
"minItems": 1
},
"h": {
"type": "array",
"items": {
"type": "object",
"required": [
"field",
"reason"
],
"properties": {
"field": {
"type": "string"
},
"reason": {
"type": "string"
}
},
"additionalProperties": false
}
},
"i": {
"type": "array",
"items": {
"$ref": "#/$defs/f"
}
},
"j": {
"type": "string",
"pattern": "^[A-Z][A-Z0-9.-]{0,19}$"
},
"k": {
"enum": [
"complete_within_scope",
"bounded",
"no_fit"
]
},
"l": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"m": {
"type": "object",
"required": [
"limit",
"returned",
"has_more",
"next_cursor"
],
"properties": {
"limit": {
"$ref": "#/$defs/l"
},
"has_more": {
"type": "boolean"
},
"returned": {
"$ref": "#/$defs/l"
},
"next_cursor": {
"$ref": "#a7"
}
},
"additionalProperties": false
},
"rf": {
"required": [
"detail_reference",
"schema_version",
"methodology_version",
"resource",
"view",
"generated_at",
"as_of",
"objects",
"coverage",
"pagination",
"warnings"
]
},
"rg": {
"required": [
"available_belief_count",
"omitted_belief_count",
"unassessed_status_count",
"unassessed_severity_count",
"history_state",
"selection_policy",
"completeness"
]
}
},
"anyOf": [
{
"anyOf": [
{
"allOf": [
{
"$ref": "#/$defs/rf"
}
],
"properties": {
"view": {
"enum": [
"risks",
"catalysts"
]
},
"as_of": {
"$ref": "#a0"
},
"objects": {
"$ref": "#/$defs/d"
},
"coverage": {
"type": "object",
"allOf": [
{
"$ref": "#/$defs/rg"
}
],
"properties": {
"completeness": {
"$ref": "#/$defs/k"
},
"history_state": {
"const": "unknown"
},
"selection_policy": {
"const": "current-beliefs-v7"
},
"omitted_belief_count": {
"$ref": "#a5"
},
"available_belief_count": {
"$ref": "#a5"
},
"unassessed_status_count": {
"$ref": "#a5"
},
"unassessed_severity_count": {
"$ref": "#a5"
}
},
"additionalProperties": false
},
"resource": {
"const": "beliefs"
},
"warnings": {
"$ref": "#aa"
},
"pagination": {
"$ref": "#/$defs/m"
},
"generated_at": {
"$ref": "#a0"
},
"billing_notice": {
"$ref": "#/$defs/c"
},
"schema_version": {
"const": "1"
},
"detail_reference": {
"$ref": "#a7"
},
"methodology_version": {
"const": "belief-objects-v1"
}
},
"additionalProperties": false
},
{
"allOf": [
{
"$ref": "#/$defs/rf"
}
],
"properties": {
"view": {
"enum": [
"risks",
"catalysts"
]
},
"as_of": {
"$ref": "#a0"
},
"objects": {
"$ref": "#/$defs/d"
},
"coverage": {
"type": "object",
"allOf": [
{
"$ref": "#/$defs/rg"
}
],
"properties": {
"completeness": {
"$ref": "#/$defs/k"
},
"history_state": {
"const": "unknown"
},
"selection_policy": {
"enum": [
"current-beliefs-v3",
"current-beliefs-v4",
"current-beliefs-v5"
]
},
"omitted_belief_count": {
"$ref": "#a5"
},
"available_belief_count": {
"$ref": "#a5"
},
"unassessed_status_count": {
"$ref": "#a5"
},
"unassessed_severity_count": {
"$ref": "#a5"
}
},
"additionalProperties": false
},
"resource": {
"const": "beliefs"
},
"warnings": {
"$ref": "#aa"
},
"pagination": {
"$ref": "#/$defs/m"
},
"generated_at": {
"$ref": "#a0"
},
"billing_notice": {
"$ref": "#/$defs/c"
},
"schema_version": {
"const": "1"
},
"detail_reference": {
"$ref": "#a7"
},
"methodology_version": {
"const": "belief-objects-v1"
}
},
"additionalProperties": false
}
]
},
{
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message",
"recovery",
"retryable"
],
"properties": {
"code": {
"enum": [
"unauthorized",
"invalid_input",
"entity_not_found",
"entity_ambiguous",
"outside_entitlement",
"rate_limited",
"data_unavailable",
"insufficient_sample",
"unsupported_security",
"duplicate_request"
]
},
"message": {
"$ref": "#a2"
},
"recovery": {
"anyOf": [
{
"$ref": "#a2"
},
{
"type": "null"
}
]
},
"retryable": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"required": [
"accepts",
"resource",
"x402Version"
],
"properties": {
"error": {
"type": "string"
},
"accepts": {
"type": "array",
"items": {
"type": "object",
"required": [
"amount",
"asset",
"maxTimeoutSeconds",
"network",
"payTo",
"scheme"
],
"properties": {
"asset": {
"$ref": "#a2"
},
"extra": {
"$ref": "#ab"
},
"payTo": {
"$ref": "#a2"
},
"amount": {
"type": "string",
"pattern": "^\\d+$"
},
"scheme": {
"enum": [
"exact"
]
},
"network": {
"type": "string",
"pattern": "^eip155:\\d+$"
},
"maxTimeoutSeconds": {
"type": "number"
}
},
"additionalProperties": false
},
"minItems": 1
},
"resource": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"$ref": "#a2"
},
"tags": {
"$ref": "#aa"
},
"iconUrl": {
"type": "string"
},
"mimeType": {
"type": "string"
},
"description": {
"type": "string"
},
"serviceName": {
"type": "string"
}
},
"additionalProperties": false
},
"extensions": {
"type": "object",
"additionalProperties": {
"type": "object",
"required": [
"info",
"schema"
],
"properties": {
"info": {
"$ref": "#ab"
},
"schema": {
"$ref": "#ab"
}
},
"additionalProperties": false
}
},
"x402Version": {
"const": 2
}
},
"additionalProperties": false
},
{
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"enum": [
"payment_pending",
"rate_limited"
]
},
"message": {
"$ref": "#a2"
},
"retryable": {
"const": true
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}| string |
| Released subject ID returned by get_subjects. |
| person_id | string |
| time_horizon | string |
| changed_since | string | Find initial research, author revisions, condition checks/plans or released outcomes becoming available after this cutoff. Keeps author dates and stance separate from system activity. Release changes and a complete ordered event-history checkpoint are not yet included. |
{
"name": "get_search_results",
"title": "Get matching investment cases",
"description": "Retrieves ranked published investment cases matching thesis, investment theme or trade setup, with an optional company or subject filter. Returns ranked matching passages, attributed investors, dates, case IDs and citations. Useful for finding research about a business trend or investment question without knowing a ticker. Open selected cases with get_case for more depth. Ranking reflects library matches and coverage, rather than market-wide consensus. Continue with the returned cursor and unchanged query, filters and as_of cutoff. Per-call x402 price: 1.50 USDC on Base.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"q": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "Thesis, topic or trade setup. Required on the first page."
},
"as_of": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Requested page size. For ticker/entity belief lists, MCP returns up to twelve complete summaries within its response budget; pagination.limit is the effective size. Continue with next_cursor and the same ticker/entity_id. REST supports larger pages."
},
"cursor": {
"type": "string",
"maxLength": 2048,
"minLength": 1,
"description": "Use next_cursor for another page of the same search."
},
"status": {
"enum": [
"forming",
"active",
"strengthened",
"weakened",
"reversed",
"resolved",
"abandoned",
"unknown"
],
"type": "string"
},
"ticker": {
"type": "string",
"maxLength": 32,
"minLength": 1
},
"direction": {
"enum": [
"bullish",
"bearish",
"mixed",
"neutral",
"non_directional",
"unknown"
],
"type": "string"
},
"entity_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "Released subject ID returned by get_subjects."
},
"person_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"time_horizon": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"changed_since": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
"description": "Find initial research, author revisions, condition checks/plans or released outcomes becoming available after this cutoff. Keeps author dates and stance separate from system activity. Release changes and a complete ordered event-history checkpoint are not yet included."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$defs": {
"0": {
"type": "string",
"$anchor": "a0",
"minLength": 1
},
"1": {
"type": "string",
"format": "date-time",
"$anchor": "a1",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"2": {
"anyOf": [
{
"$ref": "#a0"
},
{
"type": "null"
}
],
"$anchor": "a2"
},
"3": {
"type": "object",
"$anchor": "a3",
"additionalProperties": {}
},
"4": {
"type": "object",
"required": [
"passage_id",
"text",
"citation_ids"
],
"properties": {
"text": {
"type": "string",
"maxLength": 4000,
"minLength": 1
},
"passage_id": {
"$ref": "#a0"
},
"citation_ids": {
"type": "array",
"items": {
"$ref": "#a0"
},
"minItems": 1
}
},
"additionalProperties": false
},
"5": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
}
},
"anyOf": [
{
"required": [
"schema_version",
"methodology_version",
"generated_at",
"as_of",
"resource",
"view",
"data",
"citations",
"coverage",
"ranking",
"pagination",
"limitations"
],
"properties": {
"data": {
"type": "object",
"required": [
"matches"
],
"properties": {
"matches": {
"type": "array",
"items": {
"type": "object",
"required": [
"belief_id",
"ticker",
"entity_id",
"subject",
"person_id",
"investor",
"summary",
"direction",
"effective_at",
"first_observed_at",
"rank",
"match_basis",
"matched_passages",
"case_context"
],
"properties": {
"rank": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"ticker": {
"type": [
"string",
"null"
]
},
"subject": {
"$ref": "#a0"
},
"summary": {
"$ref": "#a0"
},
"investor": {
"$ref": "#a0"
},
"belief_id": {
"$ref": "#a0"
},
"direction": {
"type": "string"
},
"entity_id": {
"type": [
"string",
"null"
]
},
"person_id": {
"$ref": "#a0"
},
"match_basis": {
"enum": [
"lexical",
"semantic",
"hybrid"
]
},
"case_context": {
"type": "array",
"items": {
"$ref": "#/$defs/4"
},
"maxItems": 8,
"description": "Additional cited paragraphs used for the structured relevance support check. These provide case context; they are not separate matches."
},
"effective_at": {
"$ref": "#a1"
},
"matched_passages": {
"type": "array",
"items": {
"$ref": "#/$defs/4"
},
"maxItems": 8,
"minItems": 1
},
"first_observed_at": {
"$ref": "#a1"
}
},
"additionalProperties": false
},
"maxItems": 50
}
},
"additionalProperties": false
},
"view": {
"const": "search"
},
"as_of": {
"$ref": "#a1"
},
"ranking": {
"type": "object",
"required": [
"status",
"refused_candidates"
],
"properties": {
"status": {
"enum": [
"complete",
"partial"
]
},
"refused_candidates": {
"type": "integer",
"maximum": 40,
"minimum": 0
}
},
"additionalProperties": false
},
"coverage": {
"type": "object",
"required": [
"status",
"eligible_beliefs",
"indexed_beliefs",
"generation",
"model",
"dimensions",
"retrieval",
"relevance_model",
"support_model"
],
"properties": {
"as_of": {
"$ref": "#a1"
},
"model": {
"const": "text-embedding-3-small"
},
"scope": {
"const": "library"
},
"status": {
"enum": [
"complete",
"partial"
],
"description": "Library indexing coverage, not completion of this query. pagination.has_more reports whether further search work remains."
},
"retrieval": {
"const": "hybrid_decisions"
},
"dimensions": {
"const": 1536
},
"generation": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"observed_at": {
"$ref": "#a1"
},
"support_model": {
"$ref": "#a0"
},
"indexed_beliefs": {
"$ref": "#/$defs/5"
},
"relevance_model": {
"const": "gpt-6-luna"
},
"eligible_beliefs": {
"$ref": "#/$defs/5"
},
"measurement_status": {
"enum": [
"current",
"stale",
"pending"
]
}
},
"additionalProperties": false
},
"resource": {
"const": "beliefs"
},
"citations": {
"type": "array",
"items": {
"type": "object",
"required": [
"citation_id",
"evidence_id",
"source_url",
"source_title",
"author_name",
"published_at",
"observed_at",
"excerpt"
],
"properties": {
"excerpt": {
"$ref": "#a2"
},
"source_url": {
"type": "string",
"format": "uri"
},
"author_name": {
"$ref": "#a2"
},
"citation_id": {
"$ref": "#a0"
},
"evidence_id": {
"$ref": "#a0"
},
"observed_at": {
"$ref": "#a1"
},
"published_at": {
"anyOf": [
{
"$ref": "#a1"
},
{
"type": "null"
}
]
},
"source_title": {
"$ref": "#a0"
},
"full_document_stored": {
"type": [
"boolean",
"null"
],
"description": "Recorded storage flag, separate from verified source completeness. Null or absent means unknown."
},
"source_text_coverage": {
"anyOf": [
{
"enum": [
"partial",
"feed_body_field_unverified",
"context_article_unverified"
]
},
{
"type": "null"
}
],
"description": "Stored source-capture scope. Null or absent means unknown; no value here verifies complete article coverage."
}
},
"additionalProperties": false
}
},
"pagination": {
"type": "object",
"required": [
"limit",
"returned",
"has_more",
"next_cursor",
"candidate_window",
"window_exhausted"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1
},
"has_more": {
"type": "boolean"
},
"returned": {
"type": "integer",
"maximum": 50,
"minimum": 0
},
"next_cursor": {
"type": [
"string",
"null"
]
},
"candidate_window": {
"const": 40
},
"window_exhausted": {
"type": "boolean"
}
},
"additionalProperties": false
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"generated_at": {
"$ref": "#a1"
},
"billing_notice": {
"type": "object",
"required": [
"code",
"message",
"remaining_requests",
"add_credits_url",
"plans_url"
],
"properties": {
"code": {
"const": "signup_credit_exhausted"
},
"message": {
"$ref": "#a0"
},
"plans_url": {
"type": "string",
"format": "uri"
},
"add_credits_url": {
"type": "string",
"format": "uri"
},
"remaining_requests": {
"const": 0
}
},
"additionalProperties": false
},
"schema_version": {
"const": "1"
},
"methodology_version": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Search ranking methodology identifier; schema_version governs the response format."
}
},
"additionalProperties": false
},
{
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message",
"recovery",
"retryable"
],
"properties": {
"code": {
"enum": [
"unauthorized",
"invalid_input",
"entity_not_found",
"entity_ambiguous",
"outside_entitlement",
"rate_limited",
"data_unavailable",
"insufficient_sample",
"unsupported_security",
"duplicate_request"
]
},
"message": {
"$ref": "#a0"
},
"recovery": {
"$ref": "#a2"
},
"retryable": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"required": [
"accepts",
"resource",
"x402Version"
],
"properties": {
"error": {
"type": "string"
},
"accepts": {
"type": "array",
"items": {
"type": "object",
"required": [
"amount",
"asset",
"maxTimeoutSeconds",
"network",
"payTo",
"scheme"
],
"properties": {
"asset": {
"$ref": "#a0"
},
"extra": {
"$ref": "#a3"
},
"payTo": {
"$ref": "#a0"
},
"amount": {
"type": "string",
"pattern": "^\\d+$"
},
"scheme": {
"enum": [
"exact"
]
},
"network": {
"type": "string",
"pattern": "^eip155:\\d+$"
},
"maxTimeoutSeconds": {
"type": "number"
}
},
"additionalProperties": false
},
"minItems": 1
},
"resource": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"$ref": "#a0"
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"iconUrl": {
"type": "string"
},
"mimeType": {
"type": "string"
},
"description": {
"type": "string"
},
"serviceName": {
"type": "string"
}
},
"additionalProperties": false
},
"extensions": {
"type": "object",
"additionalProperties": {
"type": "object",
"required": [
"info",
"schema"
],
"properties": {
"info": {
"$ref": "#a3"
},
"schema": {
"$ref": "#a3"
}
},
"additionalProperties": false
}
},
"x402Version": {
"const": 2
}
},
"additionalProperties": false
},
{
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"enum": [
"payment_pending",
"rate_limited"
]
},
"message": {
"$ref": "#a0"
},
"retryable": {
"const": true
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}| date_field | string | Date meaning; defaults to period for facts/macro/holdings/returns, event for insider trades, observation for options/short volume, scheduled for calendar. |
| snapshot_id | string | Pin continuation to the returned snapshot ID; reuse with snapshot_hash and as_of. |
| snapshot_hash | string |
| filters_sha256 | string | Reuse the returned filter hash unchanged with continuation pages. |
| max_snapshot_age_hours | number | Requested verification-age tolerance: default1hour for retained archives,24hours for closing-price references. Record dates and publication cadence are separate. |
{
"name": "get_short_activity",
"title": "Get short activity",
"description": "Retrieves retained short-interest and short-volume history for one ticker. Select family and date bounds; short_interest uses settlement periods, while short_volume uses observation dates. Returns typed outstanding short shares, average daily volume and days to cover, or daily short/exempt/total volumes, with exact source support. Short volume does not establish an outstanding position. Current requests recheck stale mirror metadata; historical and pinned reads never refresh. Continue with the returned snapshot, as_of, filters and cursor or next_offset; coverage gaps remain explicit. Per-call x402 price: 0.02 USDC on Base.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"ticker"
],
"properties": {
"as_of": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
"description": "Availability cutoff, separate from event/period filters. Historical reads never refresh."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Matching typed observations per page; default32."
},
"cursor": {
"type": "string",
"maxLength": 4096,
"description": "Archive continuation token; reuse with snapshot ID/hash, as_of and unchanged filters."
},
"family": {
"enum": [
"short_interest",
"short_volume"
],
"type": "string"
},
"offset": {
"type": "integer",
"maximum": 10000000,
"minimum": 0
},
"ticker": {
"type": "string",
"pattern": "^[A-Z][A-Z0-9.-]{0,15}$"
},
"date_to": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Inclusive native date upper bound, selected by date_field."
},
"date_from": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Inclusive native date lower bound, selected by date_field."
},
"date_field": {
"enum": [
"period",
"observation"
],
"type": "string",
"description": "Date meaning; defaults to period for facts/macro/holdings/returns, event for insider trades, observation for options/short volume, scheduled for calendar."
},
"snapshot_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "Pin continuation to the returned snapshot ID; reuse with snapshot_hash and as_of."
},
"snapshot_hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"filters_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "Reuse the returned filter hash unchanged with continuation pages."
},
"max_snapshot_age_hours": {
"type": "number",
"maximum": 87600,
"description": "Requested verification-age tolerance: default1hour for retained archives,24hours for closing-price references. Record dates and publication cadence are separate.",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$defs": {
"0": {
"type": [
"string",
"null"
],
"$anchor": "a1"
},
"1": {
"anyOf": [
{
"$ref": "#a0"
},
{
"type": "null"
}
],
"$anchor": "ab"
},
"2": {
"type": "string",
"$anchor": "a4",
"minLength": 1
},
"3": {
"type": "string",
"format": "date-time",
"$anchor": "a2",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"4": {
"type": "string",
"$anchor": "a3",
"pattern": "^[a-f0-9]{64}$"
},
"5": {
"type": "integer",
"$anchor": "a0",
"maximum": 9007199254740991,
"minimum": 0
},
"6": {
"type": "object",
"$anchor": "aa",
"required": [
"value",
"unit"
],
"properties": {
"unit": {
"$ref": "#a1"
},
"value": {
"$ref": "#a1"
}
},
"additionalProperties": false
},
"7": {
"type": "string",
"format": "uuid",
"$anchor": "a8",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"8": {
"anyOf": [
{
"$ref": "#a2"
},
{
"type": "null"
}
],
"$anchor": "a5"
},
"9": {
"type": "array",
"items": {
"type": "string"
},
"$anchor": "ac"
},
"a": {
"type": "string",
"format": "uri",
"$anchor": "a7"
},
"b": {
"anyOf": [
{
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
{
"type": "null"
}
],
"$anchor": "a9"
},
"c": {
"type": "object",
"$anchor": "ad",
"additionalProperties": {}
},
"d": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"$anchor": "a6"
},
"e": {
"type": "object",
"required": [
"document_id",
"content_hash",
"json_pointer"
],
"properties": {
"text_span": {
"type": "object",
"required": [
"start",
"end"
],
"properties": {
"end": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"start": {
"$ref": "#a0"
}
},
"additionalProperties": false
},
"document_id": {
"type": "string"
},
"content_hash": {
"$ref": "#a3"
},
"json_pointer": {
"$ref": "#a1"
}
},
"additionalProperties": false
},
"f": {
"anyOf": [
{
"type": "object",
"required": [
"attributes",
"measurements",
"clocks"
],
"properties": {
"clocks": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"role",
"value",
"precision"
],
"properties": {
"name": {
"$ref": "#a4"
},
"role": {
"enum": [
"period",
"event",
"report",
"expiration",
"scheduled",
"observation"
]
},
"value": {
"$ref": "#a1"
},
"precision": {
"enum": [
"instant",
"date",
"period",
"unknown"
]
}
},
"additionalProperties": false
},
"maxItems": 8
},
"attributes": {
"type": "object",
"additionalProperties": {
"$ref": "#a1"
}
},
"measurements": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"value",
"unit"
],
"properties": {
"name": {
"$ref": "#a4"
},
"unit": {
"$ref": "#a1"
},
"value": {
"type": [
"string",
"number",
"null"
]
}
},
"additionalProperties": false
},
"maxItems": 128
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"g": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 100
},
"h": {
"type": "object",
"required": [
"metrics",
"dimensions",
"fiscal_years",
"scope",
"truncated"
],
"properties": {
"scope": {
"const": "retained_issuer_observations"
},
"metrics": {
"$ref": "#/$defs/g"
},
"truncated": {
"type": "boolean"
},
"dimensions": {
"$ref": "#/$defs/g"
},
"fiscal_years": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"maxItems": 100
}
},
"additionalProperties": false
},
"i": {
"type": "object",
"required": [
"status",
"evaluated_at",
"source_captured_at",
"age_seconds",
"max_snapshot_age_seconds",
"latest_record_at",
"publication_cadence_verified",
"refresh_status"
],
"properties": {
"status": {
"enum": [
"fresh",
"stale",
"unknown",
"historical"
]
},
"age_seconds": {
"$ref": "#a6"
},
"evaluated_at": {
"$ref": "#a2"
},
"refresh_status": {
"enum": [
"not_required",
"historical_no_refresh",
"newer_admission_unverified",
"source_clock_unknown"
]
},
"latest_record_at": {
"$ref": "#a1"
},
"source_captured_at": {
"$ref": "#a5"
},
"source_verified_at": {
"$ref": "#a5"
},
"verification_scope": {
"const": "filing_inventory"
},
"capture_age_seconds": {
"$ref": "#a6"
},
"max_snapshot_age_seconds": {
"type": "number",
"exclusiveMinimum": 0
},
"verification_age_seconds": {
"$ref": "#a6"
},
"publication_cadence_verified": {
"const": false
}
},
"additionalProperties": false
},
"j": {
"enum": [
"complete_for_retained_scope",
"partial_archive_scan",
"bounded_snapshot",
"unavailable"
]
},
"k": {
"anyOf": [
{
"$ref": "#a3"
},
{
"type": "null"
}
]
},
"rd": {
"required": [
"family",
"status",
"records",
"retained_records",
"matched_records",
"omitted_records",
"held_records",
"freshness",
"coverage",
"limitations"
]
}
},
"anyOf": [
{
"required": [
"schema_version",
"resource",
"operation",
"ticker",
"as_of",
"generated_at",
"status",
"context",
"snapshot_captured_at",
"historical_issuer_ownership_verified",
"data",
"sources",
"pagination",
"limitations"
],
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"anyOf": [
{
"allOf": [
{
"$ref": "#/$defs/rd"
}
],
"properties": {
"family": {
"const": "short_interest"
},
"status": {
"type": "string"
},
"records": {
"type": "array",
"items": {
"type": "object",
"required": [
"record_id",
"source_kind",
"support",
"observed_at",
"period_end",
"reported_at",
"native_details",
"type",
"settlement_date",
"short_shares",
"average_daily_volume",
"days_to_cover"
],
"properties": {
"type": {
"const": "short_interest"
},
"support": {
"$ref": "#/$defs/e"
},
"record_id": {
"type": "string"
},
"period_end": {
"$ref": "#a1"
},
"observed_at": {
"$ref": "#a1"
},
"reported_at": {
"$ref": "#a1"
},
"source_kind": {
"type": "string"
},
"short_shares": {
"$ref": "#aa"
},
"days_to_cover": {
"$ref": "#aa"
},
"native_details": {
"$ref": "#/$defs/f"
},
"settlement_date": {
"$ref": "#a1"
},
"average_daily_volume": {
"$ref": "#aa"
}
},
"additionalProperties": false
},
"maxItems": 100
},
"coverage": {
"$ref": "#/$defs/j"
},
"freshness": {
"$ref": "#/$defs/i"
},
"limitations": {
"$ref": "#ac"
},
"held_records": {
"$ref": "#ab"
},
"matched_records": {
"$ref": "#ab"
},
"omitted_records": {
"$ref": "#ab"
},
"retained_records": {
"$ref": "#ab"
},
"available_issuer_selectors": {
"$ref": "#/$defs/h"
}
},
"additionalProperties": false
},
{
"allOf": [
{
"$ref": "#/$defs/rd"
}
],
"properties": {
"family": {
"const": "short_volume"
},
"status": {
"type": "string"
},
"records": {
"type": "array",
"items": {
"type": "object",
"required": [
"record_id",
"source_kind",
"support",
"observed_at",
"period_end",
"reported_at",
"native_details",
"type",
"observation_date",
"short_volume",
"short_exempt_volume",
"total_volume"
],
"properties": {
"type": {
"const": "short_volume"
},
"support": {
"$ref": "#/$defs/e"
},
"record_id": {
"type": "string"
},
"period_end": {
"$ref": "#a1"
},
"observed_at": {
"$ref": "#a1"
},
"reported_at": {
"$ref": "#a1"
},
"source_kind": {
"type": "string"
},
"short_volume": {
"$ref": "#aa"
},
"total_volume": {
"$ref": "#aa"
},
"native_details": {
"$ref": "#/$defs/f"
},
"observation_date": {
"$ref": "#a1"
},
"short_exempt_volume": {
"$ref": "#aa"
}
},
"additionalProperties": false
},
"maxItems": 100
},
"coverage": {
"$ref": "#/$defs/j"
},
"freshness": {
"$ref": "#/$defs/i"
},
"limitations": {
"$ref": "#ac"
},
"held_records": {
"$ref": "#ab"
},
"matched_records": {
"$ref": "#ab"
},
"omitted_records": {
"$ref": "#ab"
},
"retained_records": {
"$ref": "#ab"
},
"available_issuer_selectors": {
"$ref": "#/$defs/h"
}
},
"additionalProperties": false
}
]
},
"maxItems": 2
},
"as_of": {
"$ref": "#a2"
},
"status": {
"enum": [
"available",
"partial",
"unavailable"
]
},
"ticker": {
"type": "string"
},
"context": {
"anyOf": [
{
"type": "object",
"required": [
"artifact_id",
"content_hash",
"observed_through",
"available_at"
],
"properties": {
"artifact_id": {
"$ref": "#a8"
},
"available_at": {
"$ref": "#a2"
},
"content_hash": {
"type": "string"
},
"observed_through": {
"$ref": "#a2"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"sources": {
"type": "array",
"items": {
"type": "object",
"anyOf": [
{
"required": [
"id",
"source_id",
"kind",
"title",
"url",
"published_at",
"publication_date",
"publication_precision",
"observed_at",
"content_hash",
"raw_capture_hash",
"retained_record_hash",
"capture_basis",
"representation"
],
"properties": {
"id": {
"$ref": "#a4"
},
"url": {
"$ref": "#a7"
},
"kind": {
"enum": [
"sec_disclosure",
"government_award",
"issuer_disclosure",
"research_input"
]
},
"title": {
"type": "string"
},
"source_id": {
"$ref": "#a8"
},
"observed_at": {
"$ref": "#a2"
},
"content_hash": {
"$ref": "#a3"
},
"published_at": {
"$ref": "#a5"
},
"capture_basis": {
"enum": [
"http_response_bytes",
"retained_export",
"retained_case"
]
},
"representation": {
"enum": [
"provider_json",
"sec_xbrl",
"visible_text",
"retained_research_case"
]
},
"publication_date": {
"$ref": "#a9"
},
"raw_capture_hash": {
"$ref": "#/$defs/k"
},
"retained_record_hash": {
"$ref": "#/$defs/k"
},
"publication_precision": {
"enum": [
"instant",
"date",
"unknown"
]
}
},
"additionalProperties": false
},
{
"required": [
"id",
"kind",
"title",
"url",
"observed_at",
"content_hash",
"observation_hashes_sha256",
"observation_count",
"calendar_artifact_id",
"calendar_content_hash",
"representation"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"$ref": "#a7"
},
"kind": {
"const": "stored_market_data"
},
"title": {
"type": "string"
},
"providers": {
"$ref": "#ac"
},
"observed_at": {
"$ref": "#a2"
},
"content_hash": {
"$ref": "#a3"
},
"representation": {
"const": "reconciled_daily_bars"
},
"observation_count": {
"$ref": "#a0"
},
"calendar_artifact_id": {
"$ref": "#a8"
},
"calendar_content_hash": {
"$ref": "#a3"
},
"observation_hashes_sha256": {
"$ref": "#a3"
}
},
"additionalProperties": false
}
]
}
},
"resource": {
"const": "company_dataset"
},
"operation": {
"const": "get_short_activity"
},
"pagination": {
"type": "object",
"required": [
"offset",
"returned",
"total_retained_records",
"total_matching_records",
"next_offset",
"snapshot_id",
"snapshot_hash",
"filters_sha256"
],
"properties": {
"offset": {
"$ref": "#a0"
},
"returned": {
"$ref": "#a0"
},
"next_cursor": {
"$ref": "#a1"
},
"next_offset": {
"$ref": "#ab"
},
"snapshot_id": {
"anyOf": [
{
"$ref": "#a8"
},
{
"type": "null"
}
]
},
"scanned_rows": {
"$ref": "#a0"
},
"scan_complete": {
"type": "boolean"
},
"snapshot_hash": {
"$ref": "#a1"
},
"filters_sha256": {
"type": "string"
},
"total_matching_records": {
"$ref": "#ab"
},
"total_retained_records": {
"$ref": "#ab"
}
},
"additionalProperties": false
},
"limitations": {
"$ref": "#ac"
},
"generated_at": {
"$ref": "#a2"
},
"query_binding": {
"type": "object",
"required": [
"artifactId",
"contentHash"
],
"properties": {
"artifactId": {
"$ref": "#a8"
},
"contentHash": {
"$ref": "#a3"
}
},
"additionalProperties": false
},
"billing_notice": {
"type": "object",
"required": [
"code",
"message",
"remaining_requests",
"add_credits_url",
"plans_url"
],
"properties": {
"code": {
"const": "signup_credit_exhausted"
},
"message": {
"$ref": "#a4"
},
"plans_url": {
"$ref": "#a7"
},
"add_credits_url": {
"$ref": "#a7"
},
"remaining_requests": {
"const": 0
}
},
"additionalProperties": false
},
"issuer_refresh": {
"type": "object",
"required": [
"status",
"filing_inventory_verified_at",
"backfill_from",
"backfill_through",
"history_complete",
"held_documents"
],
"properties": {
"status": {
"enum": [
"not_required",
"queued",
"unavailable",
"saved_only"
]
},
"backfill_from": {
"$ref": "#a9"
},
"held_documents": {
"$ref": "#a0"
},
"backfill_through": {
"$ref": "#a9"
},
"history_complete": {
"type": "boolean"
},
"filing_inventory_verified_at": {
"$ref": "#a5"
}
},
"additionalProperties": false
},
"schema_version": {
"const": "2"
},
"snapshot_captured_at": {
"$ref": "#a5"
},
"historical_issuer_ownership_verified": {
"anyOf": [
{
"const": false
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message",
"recovery",
"retryable"
],
"properties": {
"code": {
"enum": [
"unauthorized",
"invalid_input",
"entity_not_found",
"entity_ambiguous",
"outside_entitlement",
"rate_limited",
"data_unavailable",
"insufficient_sample",
"unsupported_security",
"duplicate_request"
]
},
"message": {
"$ref": "#a4"
},
"recovery": {
"anyOf": [
{
"$ref": "#a4"
},
{
"type": "null"
}
]
},
"retryable": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"required": [
"accepts",
"resource",
"x402Version"
],
"properties": {
"error": {
"type": "string"
},
"accepts": {
"type": "array",
"items": {
"type": "object",
"required": [
"amount",
"asset",
"maxTimeoutSeconds",
"network",
"payTo",
"scheme"
],
"properties": {
"asset": {
"$ref": "#a4"
},
"extra": {
"$ref": "#ad"
},
"payTo": {
"$ref": "#a4"
},
"amount": {
"type": "string",
"pattern": "^\\d+$"
},
"scheme": {
"enum": [
"exact"
]
},
"network": {
"type": "string",
"pattern": "^eip155:\\d+$"
},
"maxTimeoutSeconds": {
"type": "number"
}
},
"additionalProperties": false
},
"minItems": 1
},
"resource": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"$ref": "#a4"
},
"tags": {
"$ref": "#ac"
},
"iconUrl": {
"type": "string"
},
"mimeType": {
"type": "string"
},
"description": {
"type": "string"
},
"serviceName": {
"type": "string"
}
},
"additionalProperties": false
},
"extensions": {
"type": "object",
"additionalProperties": {
"type": "object",
"required": [
"info",
"schema"
],
"properties": {
"info": {
"$ref": "#ad"
},
"schema": {
"$ref": "#ad"
}
},
"additionalProperties": false
}
},
"x402Version": {
"const": 2
}
},
"additionalProperties": false
},
{
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"enum": [
"payment_pending",
"rate_limited"
]
},
"message": {
"$ref": "#a4"
},
"retryable": {
"const": true
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}| context_assessment_id | string | Open a neutral engine context assessment returned by a brief or ordered change. It is not an author Belief. |
{
"name": "get_visual",
"title": "Get research visual",
"description": "Retrieves saved research charts and tables for one investment case or context assessment. Without visual_id, returns available visual and region descriptors; with visual_id, returns the selected visual's regions. Supply region_id for available structured chart/table data, with bounded row pagination. Results preserve citations, recorded coverage, historical cutoffs and text-access restrictions. Use visual_offset for another descriptor page, without visual_id. Per-call x402 price: 0.02 USDC on Base.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"as_of": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"belief_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"region_id": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "Use a region_id returned in the selected visual's regions to retrieve structured data."
},
"row_limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Rows or chart points per read; defaults to 50, maximum 100."
},
"visual_id": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "Omit to list saved visuals; supply a returned visual_id to inspect it."
},
"row_offset": {
"type": "integer",
"maximum": 999,
"minimum": 0,
"description": "Zero-based starting row or chart-point index in the selected region."
},
"region_offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Continue a selected visual's region descriptors using next_region_offset."
},
"visual_offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Continue visual descriptors using next_visual_offset; requires belief_id and cannot accompany visual_id."
},
"context_assessment_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "Open a neutral engine context assessment returned by a brief or ordered change. It is not an author Belief."
}
},
"additionalProperties": false
},
"outputSchema": {
"truncated": true,
"chars": 80889
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}