The federal record, as a tool your agent can call

resolve_entity

Map an organization name (a contract recipient, a subsidiary, a PAC sponsor, a Form D issuer) to its public-company ticker. Exact normalized match against SEC legal names, aliases and the Exhibit 21 subsidiary map; returns the method and a confidence, or the reason for a miss. Never guesses.

args: name

get_entity

One company in the federal record: contracts won, PACs, patents, private raises, members of Congress who hold board seats there, insider trades, and its connections graph. Look up by ticker, entity_id, or a name (resolved exactly).

args: ticker, entity_id, name

search_awards

Search federal contract awards (USAspending, $10M+) by recipient, ticker, awarding agency, keyword, date range or minimum amount. Returns total_matching and pages with offset (up to 50 per call), sorted by date or amount. For "who won the most" questions use award_totals instead, which counts every match.

args: recipient, ticker, agency, keyword, since, until, min_amount, sort, offset, limit

award_totals

Aggregate every matching federal award (same filters as search_awards) into totals per recipient, per resolved ticker, or per awarding agency: award count, total dollars, share, first and last award, largest award. Use this for "who won the most from the Navy this year" and similar questions; it counts all matches, not a page.

args: group_by, recipient, ticker, agency, keyword, since, until, min_amount, limit

search_opportunities

Search SAM.gov notices: Sources Sought and Pre-solicitations (the earliest public signal of a purchase), solicitations and combined synopses. Filter by keyword, NAICS, agency, notice type, date.

args: keyword, naics, agency, notice_type, since, limit

congressional_trades

Stock trades disclosed by members of Congress (House and Senate Periodic Transaction Reports), by member name, ticker, transaction type or date. Returns one row per transaction with the disclosed amount range and the filing PDF.

args: politician, ticker, transaction_type, since, limit

get_politician

A member of Congress: committees, board seats and other positions from annual Financial Disclosures (with resolved tickers), recent stock trades, and top PAC contributors from FEC data. Look up by name or bioguide_id; ambiguous names return candidates.

args: name, bioguide_id

insider_trades

SEC Form 4 insider transactions by ticker or insider name; filter to buys or sells, minimum value, date.

args: ticker, insider, type, min_value, since, limit

search_bills

Full-text search over bills, contract awards and other government events with their analysed sector and ticker exposure. Filter by bill number, ticker, sector, date or event type.

args: query, bill_number, ticker, sector, event_type, since, limit

executive_orders

Executive orders, proclamations and memoranda with affected sectors and tickers.

args: query, sector, since, limit

pac_lookup

Corporate and trade PACs linked to an issuer (by ticker) or by committee name, with their top recipient candidates aggregated from FEC disbursements.

args: ticker, committee_name, limit

pac_totals

Which PACs give the most: contributors to tracked candidates ranked by total dollars (FEC Schedule A), by election cycle, with donor-processing conduits like ActBlue and WinRed separated out. mode=disbursers ranks committees by their own reported disbursements instead. Use for "which PACs donate the most" questions.

args: mode, cycle, query, limit

data_coverage

Row counts and the latest dated row for every dataset behind these tools, plus entity-resolution coverage. Call it when an answer depends on how complete the data is, or before saying something does not exist.

args: none

list_themes

The themes the government is currently funding across bills, contracts, solicitations and filings, each with a permanent page and a verdict.

args: none

get_theme

One theme in full: the setup, the dated chronology with each beat linked to its source record, why it matters, what to watch, and the evidence.

args: theme_id

latest_events

The newest events across every source (awards, trades, filings, bills, orders, themes), with provenance. Optional filters by category, ticker or source id.

args: categories, tickers, sources, limit

track_record

Every forward call HillSignal made since May 2025, verified against SPY 30 days later, with the inclusion rules and the miss rate.

args: none

institutional_holders

Largest institutional holders of a ticker from 13F-HR filings HillSignal has ingested, latest position per institution.

args: ticker, limit

form_d_raises

SEC Form D private placements of $5M and up, by issuer name, resolved ticker, date or minimum amount.

args: query, ticker, since, min_amount, limit