PRIMARY discovery tool — lightweight catalog over 10k+ SEC filings (fi_listings_portfolio).
[COST: low xpay per-call fee]
Does NOT return alpha_signals, causality_events, or financial_metrics (use get_filing_sample / purchase_filing).
Always returns agent_readiness_score (higher = better structured data) and edgar_url.
Required: at least one of ticker, form_type, company_name, fiscal_period, cik (avoids full-table scans).
Agent workflow after this call:
1. Shortlist by agent_readiness_score and optional agent_one_liner
2. get_filing_sample(document_id) — free preview
3. purchase_filing(document_id) — paid full JSON (x402)
[EXAMPLE ARGUMENTS - MINIMAL]:
{"ticker": "AAPL", "limit": 5}
[EXAMPLE ARGUMENTS - MAXIMAL]:
{
"ticker": "ADM",
"form_type": "10-Q",
"company_name": "Archer",
"fiscal_period": "2026Q1",
"min_agent_readiness_score": 70,
"limit": 20,
"offset": 0,
"include_one_liner": true
}
[EXAMPLE ARGUMENTS - PAGINATION (page 2)]:
{"ticker": "MSFT", "form_type": "10-K", "limit": 10, "offset": 10}