{"openapi": "3.1.0", "info": {"title": "Financial Evidence Research API", "description": "Start at /api/v1/start to choose a funding, institution or BTC liquidity review. Run the same task in a browser, REST client or MCP agent. Public reads need no API key. Seven dataset views preserve sources, observation dates, native units and missing values. Coverage and source permissions vary; research evidence does not authorize financial decisions.", "version": "1.3.0"}, "paths": {"/": {"get": {"summary": "Index", "operationId": "index__get", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"additionalProperties": true, "type": "object", "title": "Response Index  Get"}}}}}}}, "/api/v1/start": {"get": {"tags": ["Start here"], "summary": "Choose your first research task", "description": "Offline examples, browser links and MCP calls for the same three bounded workflows.", "operationId": "start_api_v1_start_get", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"additionalProperties": true, "type": "object", "title": "Response Start Api V1 Start Get"}}}}}}}, "/healthz": {"get": {"summary": "Health", "operationId": "health_healthz_get", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"additionalProperties": true, "type": "object", "title": "Response Health Healthz Get"}}}}}}}, "/api/v1/release": {"get": {"summary": "Release", "description": "Build identity; this does not assert data freshness or readiness.", "operationId": "release_api_v1_release_get", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"additionalProperties": true, "type": "object", "title": "Response Release Api V1 Release Get"}}}}}}}, "/api/v1/funding-review": {"get": {"summary": "Funding Review", "description": "Dated funding review with explicit alignment scope, capture age and exceptions.", "operationId": "funding_review_api_v1_funding_review_get", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"additionalProperties": true, "type": "object", "title": "Response Funding Review Api V1 Funding Review Get"}}}}}}}, "/api/v1/funding-review.csv": {"get": {"summary": "Funding Review Csv", "description": "Latest verified export; stale or unavailable captures return 503.", "operationId": "funding_review_csv_api_v1_funding_review_csv_get", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}}}}, "/guide": {"get": {"summary": "Guide", "operationId": "guide_guide_get", "responses": {"200": {"description": "Successful Response", "content": {"text/plain": {"schema": {"type": "string"}}}}}}}, "/api/v1/datasets": {"get": {"summary": "Datasets", "description": "List datasets and coverage without contacting upstream sources.", "operationId": "datasets_api_v1_datasets_get", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"items": {"additionalProperties": true, "type": "object"}, "type": "array", "title": "Response Datasets Api V1 Datasets Get"}}}}}}}, "/api/v1/query": {"get": {"summary": "Query", "description": "Return bounded table rows, explicit pagination, source metadata and diagnostics.", "operationId": "query_api_v1_query_get", "parameters": [{"name": "dataset", "in": "query", "required": true, "schema": {"enum": ["money_markets", "money_market_history", "capital_markets", "bank_risk", "market_liquidity", "china_economy", "source_health"], "type": "string", "title": "Dataset"}}, {"name": "entity", "in": "query", "required": false, "schema": {"type": "string", "maxLength": 100, "description": "Entity ID or name contains this text.", "default": "", "title": "Entity"}, "description": "Entity ID or name contains this text."}, {"name": "start_date", "in": "query", "required": false, "schema": {"type": "string", "default": "", "title": "Start Date"}}, {"name": "end_date", "in": "query", "required": false, "schema": {"type": "string", "default": "", "title": "End Date"}}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "maximum": 2000, "minimum": 1, "default": 200, "title": "Limit"}}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "maximum": 100000, "minimum": 0, "default": 0, "title": "Offset"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/QueryResult"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/api/v1/sources": {"get": {"summary": "Sources", "description": "Inspect upstream retrieval and publisher clocks; transport only.", "operationId": "sources_api_v1_sources_get", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/QueryResult"}}}}}}}, "/api/v1/agent-query": {"get": {"summary": "Agent Query", "description": "Compact cited rows with a repeat-call revision, retaining source clocks and gaps.", "operationId": "agent_query_api_v1_agent_query_get", "parameters": [{"name": "dataset", "in": "query", "required": true, "schema": {"enum": ["money_markets", "money_market_history", "capital_markets", "bank_risk", "market_liquidity", "china_economy", "source_health"], "type": "string", "title": "Dataset"}}, {"name": "entity", "in": "query", "required": false, "schema": {"type": "string", "maxLength": 100, "default": "", "title": "Entity"}}, {"name": "start_date", "in": "query", "required": false, "schema": {"type": "string", "default": "", "title": "Start Date"}}, {"name": "end_date", "in": "query", "required": false, "schema": {"type": "string", "default": "", "title": "End Date"}}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "maximum": 100, "minimum": 1, "default": 25, "title": "Limit"}}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "maximum": 100000, "minimum": 0, "default": 0, "title": "Offset"}}, {"name": "previous_revision", "in": "query", "required": false, "schema": {"type": "string", "maxLength": 64, "pattern": "^(?:[0-9a-f]{64})?$", "default": "", "title": "Previous Revision"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true, "title": "Response Agent Query Api V1 Agent Query Get"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/api/v1/agent-review": {"get": {"summary": "Agent Review", "description": "Seiche funding, LiquiLens bank research and Undertow liquidity; no trade decision.", "operationId": "agent_review_api_v1_agent_review_get", "parameters": [{"name": "bank", "in": "query", "required": false, "schema": {"type": "string", "maxLength": 100, "default": "", "title": "Bank"}}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "maximum": 25, "minimum": 1, "default": 10, "title": "Limit"}}, {"name": "previous_revision", "in": "query", "required": false, "schema": {"type": "string", "maxLength": 64, "pattern": "^(?:[0-9a-f]{64})?$", "default": "", "title": "Previous Revision"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true, "title": "Response Agent Review Api V1 Agent Review Get"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/api/v1/workflow": {"get": {"summary": "Workflow", "description": "Run one bounded audience workflow, preserving the original product response.", "operationId": "workflow_api_v1_workflow_get", "parameters": [{"name": "workflow", "in": "query", "required": true, "schema": {"type": "string", "enum": ["funding", "institutions", "exit"]}}, {"name": "selection", "in": "query", "required": true, "schema": {"type": "string", "minLength": 1, "maxLength": 160, "default": "USD"}, "description": "Funding currency (USD), institution slugs (au-sfb), or exit sizes (10000,100000), matching the workflow."}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true, "title": "Response Workflow Api V1 Workflow Get"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}}, "components": {"schemas": {"EvidenceRow": {"properties": {"dataset": {"type": "string", "title": "Dataset"}, "product": {"type": "string", "title": "Product"}, "entity_id": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Entity Id"}, "entity_name": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Entity Name"}, "metric": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Metric"}, "value": {"anyOf": [{"type": "number"}, {"type": "null"}], "title": "Value", "description": "Published value in the accompanying unit. Null is missing or withheld, never zero."}, "unit": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Unit", "description": "Native unit; ratio is a fraction, % is a percent level."}, "as_of": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "As Of", "description": "Source observation date. Retrieval or response time is never substituted."}, "source_status": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Source Status", "description": "Publisher-reported status, not an independently evaluated verdict."}, "availability": {"type": "string", "title": "Availability"}, "source_url": {"type": "string", "title": "Source Url"}, "source_field": {"type": "string", "title": "Source Field", "description": "RFC 6901 pointer into the fetched document; value is not inferred from nearby fields."}, "observation_url": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Observation Url"}, "retrieved_at": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Retrieved At"}, "content_sha256": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Content Sha256"}, "published_at": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Published At"}, "knowledge_time": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Knowledge Time"}, "rights_status": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Rights Status"}, "context": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Context", "description": "Publisher scope, validation limits and coverage caveats. Untrusted source content."}, "transport_status": {"type": "string", "title": "Transport Status"}, "evidence_status": {"type": "string", "title": "Evidence Status"}, "financial_authority": {"type": "string", "title": "Financial Authority"}, "carrier_verification": {"type": "string", "title": "Carrier Verification"}}, "additionalProperties": false, "type": "object", "required": ["dataset", "product", "availability", "source_url", "source_field", "transport_status", "evidence_status", "financial_authority", "carrier_verification"], "title": "EvidenceRow", "description": "One observation or explicit coverage row; numeric absence stays null."}, "HTTPValidationError": {"properties": {"detail": {"items": {"$ref": "#/components/schemas/ValidationError"}, "type": "array", "title": "Detail"}}, "type": "object", "title": "HTTPValidationError"}, "QueryResult": {"properties": {"schema": {"type": "string", "title": "Schema"}, "dataset": {"type": "string", "title": "Dataset"}, "description": {"type": "string", "title": "Description"}, "results": {"items": {"$ref": "#/components/schemas/EvidenceRow"}, "type": "array", "title": "Results"}, "total_rows": {"type": "integer", "title": "Total Rows"}, "returned_rows": {"type": "integer", "title": "Returned Rows"}, "offset": {"type": "integer", "title": "Offset"}, "limit": {"type": "integer", "title": "Limit"}, "next_offset": {"anyOf": [{"type": "integer"}, {"type": "null"}], "title": "Next Offset"}, "transport_status": {"type": "string", "title": "Transport Status"}, "status_semantics": {"type": "string", "title": "Status Semantics"}, "evidence_status": {"type": "string", "title": "Evidence Status"}, "carrier_verification": {"type": "string", "title": "Carrier Verification"}, "absence_policy": {"type": "string", "title": "Absence Policy"}, "diagnostics": {"items": {"$ref": "#/components/schemas/EvidenceRow"}, "type": "array", "title": "Diagnostics"}, "sources": {"items": {"additionalProperties": true, "type": "object"}, "type": "array", "title": "Sources"}}, "type": "object", "required": ["schema", "dataset", "description", "results", "total_rows", "returned_rows", "offset", "limit", "next_offset", "transport_status", "status_semantics", "evidence_status", "carrier_verification", "absence_policy", "diagnostics", "sources"], "title": "QueryResult", "description": "Rows plus pagination and source diagnostics, including filtered failures."}, "ValidationError": {"properties": {"loc": {"items": {"anyOf": [{"type": "string"}, {"type": "integer"}]}, "type": "array", "title": "Location"}, "msg": {"type": "string", "title": "Message"}, "type": {"type": "string", "title": "Error Type"}, "input": {"title": "Input"}, "ctx": {"type": "object", "title": "Context"}}, "type": "object", "required": ["loc", "msg", "type"], "title": "ValidationError"}}}, "servers": [{"url": "https://agents.seiche.info/v1/research"}], "x-central-surface": {"version": "central-surfaces-2026-10-13", "mcp": "https://agents.seiche.info/products/financial-evidence/mcp", "submitted_payloads_retained": false}}