RalliesAPI

Introduction

OverviewReferenceSandbox
Retail Intent
AskQuestionsTopicsMoversSnapshot
Retail Positioning
HoldingsFlowsRotationOptions
AI Funds
TradesPositionsLeaderboardConsensus
Filings
SearchAskSummariesFinancialsMetrics
Miscellaneous
Screener
API reference/Filings/Ask Filings
Contact us

Ask Filings

POST/filings/ask

Ask filing-grounded questions and get cited answers.

Body Parameters

questionstringrequired
Natural language question to answer.
tickersarray<string>required
Ticker symbols to include.
filing_typesarray<string>optional
Allowed values: 10-K, 10-Q, 8-K
SEC filing types, such as 10-K or 10-Q.
start_datedateoptional
Earliest filing date to include.
end_datedateoptional
Latest filing date to include.
limitintegeroptional
Default: 12
Maximum number of rows to return.
streambooleanoptional
Allowed values: false, true
Default: false
Return a server-sent event stream when true.
Was this page helpful?
POST/filings/ask
curl https://api.rallies.ai/v1/filings/ask \
  -H "X-Rallies-API-Key: $RALLIES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "question": "What changed in data center revenue and margin commentary?",
    "tickers": ["NVDA"],
    "filing_types": ["10-K", "10-Q"],
    "limit": 12
  }'

RESPONSE

JSON
{
  "answer": "Nvidia's filing commentary points to data center revenue growth as the primary driver, while margin risk is mostly tied to product mix and supply costs.",
  "key_findings": [
    {
      "title": "Data center remains the main growth driver",
      "detail": "The cited filing passages emphasize demand from accelerated computing and AI infrastructure."
    }
  ],
  "citations": [
    {
      "id": "c1",
      "ticker": "NVDA",
      "filing": {
        "type": "10-Q",
        "date": "2026-05-22",
        "url": "https://www.sec.gov/Archives/edgar/data/0001045810/example.htm"
      }
    }
  ]
}