API reference / Structured query
Structured query
Ask a market question and receive structured facts plus evidence.
Overview
Query plans a research request across exact financial facts and relevant filing passages. It returns the structured result rather than streaming prose.
Coverage
| Records | Sources | Updated |
|---|---|---|
| Financials, companies and indexed filings | Canonical data plus retrieval index | Uses current indexed coverage |
Parameters
| Parameter | Type | Description |
|---|---|---|
queryrequired | string | Natural-language research request |
plan | object | Optional explicit retrieval plan |
limit | integer | Maximum evidence items |
Getting started
Issue a key
Sign in, choose a plan and create an API key from your workspace dashboard.
Send the request
Call /v1/query 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 planner selects from documented datasets; it does not write model-authored SQL.
- →Use GET endpoints for deterministic application flows with known filters.
Marked provides market data, not financial advice. Verify material decisions against the authoritative source.