Read the contract
Start with the Agent Card, OpenAPI or llms.txt. Do not scrape the human page to infer a request.
Agents can discover a small set of stable research products, call them directly and receive bounded answers with coverage, freshness, tools used and lineage. Free and machine-payable queries share the same evidence contract.
These compact examples were captured from production on 1 September 2026. They show the response shape and evidence metadata; values remain historical rather than silently presenting themselves as live quotes.
The machine contract is the product. It tells the caller what can be invoked, what it costs, which scope is required and what evidence fields will be returned before the agent spends time or money.
Start with the Agent Card, OpenAPI or llms.txt. Do not scrape the human page to infer a request.
Call no-auth products directly. Register an OAuth client only when the chosen operation requires agents:query.
Use the exact schema and limits from OpenAPI. Paid endpoints return the x402 challenge before execution.
Preserve coverage, as-of dates, freshness, tools used, warnings and lineage references with the answer.
The free company snapshot needs no QJ account and no payment. A browser-only chat session may be able to read the contract but still lack permission to send outbound POST requests; coding agents and API clients can execute it directly.
The response separates facts from interpretation and reports missing coverage rather than filling gaps.
Use another ticker by changing only the bounded ticker field.
Discover QuantJourney at:
https://agents.quantjourney.cloud/openapi.json
Call POST /v1/query/company-snapshot-lite with:
{"ticker":"AAPL"}
Return the exact artifact, then summarize the facts,
freshness, missing coverage and lineage. Do not turn
the result into an investment recommendation.