Context Query mode
For broad historical requests, useresponseShape="evidence_only" and request includeDataUrl. Context can keep large datasets outside the agent’s context window while returning bounded evidence and a durable data reference.
If a query becomes an asynchronous job, poll the returned jobId. Do not submit the original query again.
Custom bars
custom_bars accepts:
return_next_cursor to false so a request such as limit: 5 remains exactly one five-row page. Set it to true only when the caller explicitly wants pagination information.
custom_bars_catalog supports up to 5,000 entries per page.
Safe historical access
- Request only the columns needed for the calculation.
- Split very broad histories into deterministic time windows.
- Preserve the exchange, product, resolution, and interval in every output artifact.
- Do not automatically follow cursors from an LLM unless the user requested all pages.