Skip to main content
POST
/
query
curl --request POST \
  --url https://api-beta.ai-baseline.xyz/v2/sandp_500/query \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "query": "What supply chain risks did Apple disclose in its 10-K filings?"
}
'
{
  "request_id": "req_...",
  "evidence": "<source_registry>\n  ...\n</source_registry>\n\n<evidence_chain relevance_score=\"9\">\n  ...\n</evidence_chain>\n\n<source_key>\n  ...\n</source_key>",
  "evidence_instructions": "Use the evidence field as the grounded context for answer generation. Base factual claims only on the evidence, cite source IDs exactly as shown, and say when the evidence does not support an answer.",
  "summary": {
    "domain": "sandp_500",
    "mode": "basic",
    "effort": "medium",
    "evidence_count": 8
  }
}

Authorizations

​
X-API-Key
string
header
required

Body

application/json
​
query
string
required
​
mode
enum<string>
default:basic
Available options:
basic,
research,
agentic_research
​
effort
enum<string>
default:medium
Available options:
low,
medium,
high
​
stream
boolean
default:false
​
metadata_filters
Metadata Filters · object
​
include
IncludeOptions · object
​
retrieval
RetrievalOptions · object

Public retrieval controls. Currently supports max_evidence only.

Response

Successful Response

​
request_id
string
required
​
answer
Answer · object
​
metadata_distribution
Metadata Distribution · object
​
analysis
Analysis · object
​
metadata_dashboard
string
​
evidence
string
​
evidence_instructions
string

Instructions for downstream LLMs on how to use the returned evidence.

​
agent_context
Agent Context · object
​
summary
Summary · object
​
retrieval_plan
Retrieval Plan · object