MarkedDocs Research answer

API reference / Research answer

Research answer

Stream an evidence-grounded answer with visible execution steps.

POST/v1/askOpenAPI ↗

Overview

Ask runs the same structured retrieval path as Query, then streams the plan, execution stages and final answer as server-sent events. The answer is written from the retrieved evidence packet.

Coverage

RecordsSourcesUpdated
Canonical facts and indexed narrative evidenceSame data layer as REST and MCPSession-scoped research

Parameters

ParameterTypeDescription
queryrequiredstring1–2000 character question
sessionrequiredstring1–64 character session ID
limitinteger1–50 evidence items; default 10

Getting started

Issue a key

Sign in, choose a plan and create an API key from your workspace dashboard.

Send the request

Call /v1/ask with X-API-Key or an Authorization bearer token.

Read data and metadata

Use data for records and meta for timestamps, counts and request context.

Implementation notes

  • The response content type is text/event-stream.
  • Sessions have an internal safety ceiling; create a new session for a separate research task.

Marked provides market data, not financial advice. Verify material decisions against the authoritative source.