US Congress Trades APIFetch House and Senate STOCK Act disclosures as structured JSON with one SocialCrawl API key. Search by ticker, politician last name, party, chamber, and date. Reads are priced in credits.
19 active endpoints
19 live read endpoints for House and Senate STOCK Act filings. Search the corpus, look up one member or ticker, then pull party, sector, unusual-activity, and late-filer stats. Flagship cards below. The rest are in docs.
/v1/us_congress_trades/tradesHouse and Senate filings filterable by ticker, last name, party, chamber, sector, buy/sell/exchange, and publication date. Each row has the member, issuer, ticker, disclosed value, dates, and reporting gap. Bare tickers such as NVDA are accepted. Empty lists are refunded.
ticker, politician, party, chamber, tx_type, start_date, end_date, cursor
/v1/us_congress_trades/trades/latestSTOCK Act disclosures published in the last 48 hours, newest first. Same row shape as the search route. For a 7-day window call trades/recent.
cursor
/v1/us_congress_trades/membersPoliticians with at least one disclosed trade: first name, last name, party, and state. Filter by party or USPS state. Pass the last name as handle to politician.
party, state, cursor
/v1/us_congress_trades/politicianAggregated stats for one last name: counts, buy vs sell, disclosed value, average reporting gap, top tickers, and top sectors. A missing name returns 404 and is not charged.
handle
/v1/us_congress_trades/politician/tradesEvery STOCK Act row for one last name. Same shape as the search route. Sort by publication date, trade date, value, or reporting gap.
handle, sort, order, cursor
/v1/us_congress_trades/tickerCongressional trading stats for one stock: counts, buy vs sell, disclosed value, unique politicians, and the members who trade it most. Accepts AAPL or AAPL:US.
keyword
/v1/us_congress_trades/ticker/tradesSTOCK Act rows for one stock, filterable by chamber, party, transaction type, and date. Pass the same keyword used on the ticker summary.
keyword, chamber, party, tx_type, start_date, end_date, cursor
/v1/us_congress_trades/state/tradesFilings from one US state's congressional delegation. Pass the two-letter USPS code (CA, TX, NY). An unknown state returns 404 and is not charged.
state, cursor
/v1/us_congress_trades/statsCorpus size: total trades, total politicians, and the earliest and latest trade dates. Call this first before paging the search route.
none
/v1/us_congress_trades/stats/unusualTickers whose recent disclosed-trade count is well above their historical average, with the politicians involved. Pass a ticker as keyword to ticker/trades.
days, limit
Returns STOCK Act disclosures across the House and Senate, filterable by ticker, politician, party, chamber, sector, and date.
Use it to search congressional trades. For one member pass handle to politician/trades; for one stock pass keyword to ticker/trades.
1 credit
$ curl https://www.socialcrawl.dev/v1/us_congress_trades/trades?ticker=NVDA&chamber=senate&tx_type=buy \
-H "x-api-key: sc_YOUR_API_KEY"// Running this live needs your own API key. Hit "Try it" to see an example responseUS Congress Trades is a normal SocialCrawl read surface. You call GET /v1/us_congress_trades/… with an API key, spend credits on live misses, and get a single JSON envelope back. Identity params are last name, ticker, and USPS state.
Send your key in the x-api-key header. The same key works across the SocialCrawl catalog.
Routes are GET. Pass handle for a last name, keyword for a ticker, and state for a USPS code. Invalid enums return 400 before a credit is spent.
Every US Congress Trades route is 1 credit on a live miss. Cache hits cost 0. Empty lists and missing politicians, tickers, or states are never charged.
Every response is the same shape: success, data, credits_used, credits_remaining, request_id, cached.
Most products resolve a last name from the directory, read the summary, then page that member's filings. Flip the same pattern onto a ticker when the question starts with a stock.
GET /v1/us_congress_trades/membersPoliticians with at least one disclosed trade
Find the last name you will pass as handle.
GET /v1/us_congress_trades/politician?handle=…Counts, value, gap, top tickers, and top sectors for one member
Confirm the member before paging every filing.
GET /v1/us_congress_trades/politician/trades?handle=…SearchResult pages of that member's STOCK Act rows
Walk with cursor until it comes back absent.
GET /v1/us_congress_trades/ticker?keyword=…Rollup for one stock, then ticker/trades for the rows
Use it when the question is who in Congress traded NVDA, not who Pelosi traded.
GET /v1/us_congress_trades/trades
?ticker=NVDA
&tx_type=buy
&limit=20
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here
GET /v1/us_congress_trades/politician?handle=Pelosi{
"success": true,
"data": {
"items": [
{
"politician": "Nancy Pelosi",
"ticker": "NVDA",
"tx_type": "buy",
"value": "$1,000,001 - $5,000,000"
}
]
},
"credits_used": 1,
"credits_remaining": 9999,
"request_id": "req_…",
"cached": false
}List routes return SearchResult. Summaries return Analytics. Field names stay inside those archetypes.
items[] with politician, issuer, ticker, tx_type, value, dates, reporting gap
politician summary: counts, buy vs sell, value, gap, top tickers, top sectors
ticker summary: counts, buy vs sell, value, unique politicians, top members
dataset coverage: total trades, total politicians, earliest and latest trade dates
Same request lifecycle as every other /v1 platform endpoint.
Next.js catch-all routes into the Hono social API. We mint a request_id, authenticate the key, then enforce rate limit and concurrency.
Registry lookup finds the route. Handle, ticker, state, and enum formats run first, so a bad chamber value returns 400 with no charge.
A deterministic cache key is built from platform, resource, and params. Hit: credits_used is 0. Miss: live fetch with retries and circuit breaker.
The filing or rollup is mapped onto SearchResult or Analytics, validated, wrapped in the success envelope, and logged for billing audit.
Billing rules that matter in production
US Congress Trades is public-read STOCK Act data on SocialCrawl. House and Senate filings are normalized into the shared envelope so your code does not parse two government portals.
Periodic transaction reports filed under the STOCK Act by members of the House and Senate. Read-only for research, monitoring, and product jobs.
A public-read upstream behind one gateway. You do not hold a House Clerk or Senate EFD session.
Unified JSON envelope: success, data, credits_used, request_id, cached. Lists are SearchResult. Summaries are Analytics.
No live quotes, no options chains, and no write endpoints. This is disclosure data, not a market-data feed. Health pings are not wrapped as customer routes.
The jobs this API is most often used for.
Congressional trade monitoring and STOCK Act research
Callers concentrate on filtered trade search, then deepen one politician or one ticker. House and Senate STOCK Act rows behind one key, with last-name and ticker lookups plus unusual-activity and late-filer stats, at 1 credit a call.
Reads are typically a few seconds on a live miss. Cache hits return immediately.
Common ways teams put this data to work, and the stack each one tends to run.
Watch a ticker's congressional flow, then join unusual-activity spikes to your own price series.
Poll trades/latest and alert when a named member files, or when a sector spikes.
Rank late filers, then page that member's filings with the same handle.
Live misses spend 1 credit. Cache hits are free. Empty lists and missing identities are never charged.
curl "https://www.socialcrawl.dev/v1/us_congress_trades/trades?ticker=NVDA&tx_type=buy&limit=20" \
-H "x-api-key: sc_your_api_key_here"curl "https://www.socialcrawl.dev/v1/us_congress_trades/politician?handle=Pelosi" \
-H "x-api-key: sc_your_api_key_here"Same key as the rest of the catalog
Every endpoint returns structured JSON in a unified envelope. Computed fields such as engagement rate and content category are included only where the endpoint supports them and the required source inputs are present.
Same US Congress Trades data, two very different paths. Auth, rate limits, schema, and cost, side by side.
| Feature | SocialCrawl | House and Senate disclosure portals |
|---|---|---|
| Chambers in one call | House and Senate STOCK Act rows on one search route | Two portals, two formats, per-member documents |
| Lookup by ticker or last name | ticker=NVDA or handle=Pelosi as query params | Browse filings one member at a time |
| Response shape | Same JSON envelope as the rest of the catalog | HTML, XML, and scanned PDFs mixed by chamber |
| Stats | Party, sector, unusual activity, and late filers included | You compute aggregates after downloading files |
| Auth and price | One x-api-key, 1 credit per live miss | No API. Manual download from each portal |
Chambers in one call
Lookup by ticker or last name
Response shape
Stats
Auth and price
Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.
Contact usAsk AI about SocialCrawl