Build testable filing cohorts
Define a cohort from the filing event you care about, add deal terms and listing fields, then test what happened after that date.
Keep active candidates, follow-ons, and post-listing outcomes separate so a screen does not accidentally compare different kinds of opportunities.
Newly effective, awaiting trading
Find operating-company IPOs with effective/priced status, exchange listing, recent filings, and no current-cycle trading detected.
Final prospectus join
Pull recent 424B4/424B1 events and join to consensus and outcomes to study pricing cadence.
Post-listing 1D/7D movement
Use outcome rows or stored market bars to track first close and week-one closes against offer price.
Filing-change review
Use MCP to ask what changed in the latest amendment and cite timeline source rows.
curl -H "Authorization: Bearer $IPOGRID_API_KEY" \
"https://ipogrid.com/api/v1/companies?scope=all&kind=operating&offering_status=effective&include=latest_terms,classification,consensus"
curl "https://ipogrid.com/api/charts?metric=day1_return_pct&group=sector&bucket=week&scope=all&range=26w"
curl -H "Authorization: Bearer $IPOGRID_API_KEY" \
"https://ipogrid.com/api/v1/filings?form_type=424B4&filing_date_from=2026-06-01&include=company,terms"
curl -H "Authorization: Bearer $IPOGRID_API_KEY" \
"https://ipogrid.com/api/v1/outcomes?trading_start_date_from=2026-06-01&trading_start_date_to=2026-06-30"
Backtest shape
Freeze the cohort definition first: issuer kind, filing form, filing date window, offering status, exchange, deal size, and trading status. Join market bars and outcomes only after the cohort date so future information does not leak into the test.
For historical tests, use the filing events and market bars available around the event date.