{
 "schema_version": 1,
 "generated": "2026-10-20",
 "id": "fidetolabs-qanat--measure-returns-between-filing-dates",
 "repo": "fidetolabs/qanat",
 "repo_url": "https://github.com/fidetolabs/qanat",
 "repo_slug": "fidetolabs-qanat",
 "title": "Measure what screened companies did between filings",
 "page_title": "How to measure what screened companies did between filings with Qanat",
 "summary": "Run a screen over a date window and read each passing company's return between its own filing dates.",
 "who": "A researcher who has a screen rule and wants to see how the companies that passed performed over the following filing periods.",
 "problem": "Companies file on different calendars, so comparing their results over one shared period is unreliable and easy to get wrong by hand.",
 "outcome": "For each date in the window, the companies that passed, each with its return from its own filing to its next filing, and the evaluated and unevaluated counts.",
 "steps": [
  "Install Qanat with `uv tool install qanat-fdtl` (or `pip install qanat-fdtl`).",
  "Set your contact address with `export SEC_USER_AGENT=\"your name you@example.com\"`.",
  "Create a demo project with `qanat init my-research --demo && cd my-research`.",
  "Run the windowed screen with `qanat screen --filter '[{\"metric\":\"pe\",\"op\":\"<\",\"value\":30}]' --from 2021-12-31 --to 2025-12-31`.",
  "Read the per-company returns and the counts, then decide any averaging or position sizing yourself outside Qanat."
 ],
 "agent_prompt": "Using the Qanat project at <project-folder>, run a windowed screen from <start-date> to <end-date> on the metric and threshold <rule>. Report the per-company return from each company's own filing to its next filing, along with the evaluated and unevaluated counts. Verify that no average or aggregate has been added, since Qanat reports per-company returns only.",
 "agents": [
  "any"
 ],
 "difficulty": "Intermediate",
 "time": "30 minutes",
 "basis": "readme",
 "caveat": "Qanat does not add up returns or compare against failed companies, so any portfolio-level result must be built outside the tool.",
 "category": "Money",
 "tags": [
  "Money"
 ],
 "lang": "python",
 "requirements": [
  "Python 3.10 or newer",
  "uv or pip to install qanat-fdtl",
  "A contact email for the SEC_USER_AGENT setting, which the SEC uses to identify requests (no API key or account)",
  "An MCP-capable agent client, only for the agent use case"
 ],
 "risk": "none",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [],
 "best": false,
 "score": 0.9,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/fidetolabs-qanat/measure-returns-between-filing-dates/",
 "md": "https://dedupedai.com/use-cases/fidetolabs-qanat/measure-returns-between-filing-dates/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/fidetolabs-qanat--measure-returns-between-filing-dates.json",
 "api_version": "v1"
}
