StockClock is a static research dashboard that aggregates publicly available U.S. federal contract data and presents it in a format designed for retail investors, independent analysts, and journalists tracking the defense and government contracting space.
All data originates from two government sources: USASpending.gov, the official federal spending database maintained by the U.S. Department of the Treasury, and SEC EDGAR, the Securities and Exchange Commission's public filing system. No proprietary, paid, or scraped data is used.
The platform is built as a zero-cost static site. There is no backend server, no database, and no real-time API calls from the browser. All data is pre-processed by a Python pipeline and delivered as a single cached JSON file.
Data is collected and processed offline in a three part (data pipeline) before being committed to the project as a static file. The browser never makes API calls to government systems directly.
USASpending.gov is the official open data source for U.S. federal spending, operated by the Bureau of the Fiscal Service under the Department of the Treasury. StockClock queries the /api/v2/search/spending_by_award/ endpoint using the company's full legal entity name as registered with the federal government.
What is pulled: Total obligated contract value, top individual award value, awarding agency name, contract description, and award start date.
Federal contracts can show negative values on USASpending due to deobligations reductions or cancellations of previously awarded funds. StockClock floors all negative contract values to $0 to avoid misleading displays.
If the USASpending API could not be reached for a company during the last pipeline run, that company's page will show a DATA INCOMPLETE warning banner.
The Securities and Exchange Commission's EDGAR system provides public access to corporate filings for all publicly registered U.S. companies. StockClock uses EDGAR to retrieve SIC codes and company identifiers.
Due to the increasing prevalence of iXBRL formatting in recent filings, some descriptions contain machine-readable XBRL markup rather than readable prose. When this is detected, the platform displays a notice directing users to the original EDGAR filing instead.
The starting universe is defined by classified_tickers.csv the single source of truth for all company classifications. Sector and tier assignments are made only in this file.
Only S&P 500, NYSE and NASDAQ listed securities with valid tickers are tracked. Private companies are excluded. The current tracked universe spans approximately 500+ entities across six sectors.
| TIER | LABEL | DESCRIPTION |
|---|---|---|
| TIER 1 | Prime Contractor | Direct recipients of federal contract awards. Primary focus of the dashboard. |
| TIER 2 | Supplier | Companies that supply materials or subsystems to Tier 1 primes. Shown in supplier mappings. |
| TIER 2 | Watchlist | Companies tracked for potential supply chain exposure but not yet confirmed in either role. |
Each tracked company has a list of materials required for its operations, derived from SEC 10-K filings and SIC code classification. The pipeline matches these material requirements against other companies in the universe that produce or supply those materials.
A supplier link is created when a company in the universe produces a material that another company in the universe requires. The relationship is tagged as either OFFICIAL or INFERRED depending on how it was identified.
Every supplier relationship carries one of two confidence labels.
Relationship confirmed through a government record such as a federal contract, subcontract award, or official supplier registry (e.g., SAM.gov, FPDS). These represent known, documented supply chain links.
Relationship derived from material matching such as a company produces a material that the prime contractor is known to require. These are plausible but unconfirmed links. Treat them as leads for further research, not established facts.
Companies are assigned to one of six sectors based on their primary SIC code and business activity. Assignment is made in classified_tickers.csv and does not change unless the CSV is manually updated.
StockClock is a research tool, not an authoritative data source.
| LIMITATION | DETAIL |
|---|---|
| CACHED DATA | All data reflects the date of the last pipeline run. Contract values are not updated in real time. |
| ENTITY NAME MATCHING | USASpending requires exact legal entity names. Companies with unusual registered names may show $0 in contracts even if awards exist. |
| INFERRED SUPPLIERS | The majority of supplier relationships are inferred from material matching, not confirmed records. |
| DEOBLIGATIONS | Negative contract values caused by funding reductions are floored to $0. |
| XBRL DESCRIPTIONS | Some SEC filings use iXBRL formatting that cannot be cleanly extracted. |
| UNIVERSE SCOPE | Only NYSE and NASDAQ listed companies are tracked. Private contractors and foreign entities are excluded. |
| SUBCONTRACTS | USASpending's API primarily covers prime contract awards. Subcontract data is not currently included. |
Data sourced from USASpending.gov and SEC EDGAR is in the public domain and is reproduced here for research and informational purposes only.
Nothing on StockClock constitutes financial advice, investment recommendations, or solicitation to buy or sell any security. Contract values, supplier relationships, and company profiles are provided as reference material for independent research only.
StockClock is not affiliated with, endorsed by, or connected to the U.S. Department of Defense, the U.S. Treasury, the SEC, or any other government agency. Use of this platform is at your own risk.