Skip to main content

​
Query mode

Use Query mode when your application starts with a research question and benefits from Context selecting the correct Meridian method, validating the evidence, and assembling a response. Pin Meridian with its tool ID when the workflow must use this provider: 
const result = await client.query.run({
  query: "Use Meridian to compare BTC funding and dollar open interest across venues.",
  tools: [MERIDIAN_TOOL_ID],
  responseShape: "evidence_only",
  includeDataUrl: true,
});
Use answer_with_evidence when Context should also write the answer. Use evidence_only when your own application or agent will perform the analysis.

​
Execute mode

Use Execute mode when you already know the exact Meridian method and arguments and want the structured result directly. 
const matches = await client.discovery.search({
  query: "Meridian crypto market data",
  mode: "execute",
  surface: "execute",
  requireExecutePricing: true,
});
Only call client.tools.execute() after discovery confirms that the requested Meridian method is Execute-eligible.

​
Decision table

RequirementUse
Natural-language market questionQuery
Context should select futures or spotQuery
Your agent writes the final analysisQuery with evidence_only
Exact tool method and exact argumentsExecute, when eligible
Long or broad historical queryQuery with a data URL or asynchronous job
Lowest orchestration ambiguityExecute, when eligible