What you get#
Onekey exposes Us Congress Trades as 17 endpoints behind one API key: 4 endpoints return one record (data is an object) and 13 endpoints return a list (data is an array). Every answer uses the same envelope (success, data, metadata, error), the cost is reported in metadata.credits_charged, and fields are mapped onto the unified schema so the code you write for Us Congress Trades also works for the rest of the government & public data category.
Endpoints#
| Endpoint | What it does | Parameters | Credits | Status |
|---|---|---|---|---|
members | Members of Congress who have disclosed stock trades, with trade counts. | - | 1 | beta |
politician | A politician's disclosed-trading summary: counts, estimated volume and most traded tickers. | handle* | 1 | beta |
politician_trades | Trades disclosed by one member of Congress (by name), by chamber. | handle*, chamber | 1 | beta |
state_trades | Disclosed trades by a state's House delegation (newest first, up to 100). | state* | 1 | beta |
stats | Summary of the congressional trades dataset: sizes, date range and freshness. | - | 1 | beta |
stats_buy_sell | Congressional buys versus sells: counts, ratio and estimated volume. | - | 1 | beta |
stats_issuers | Most-traded issuers in Congress by number of disclosed trades. | limit | 1 | beta |
stats_party | Disclosed trade counts and volume compared by party. | - | 1 | beta |
stats_politicians | Most active congressional traders by number of disclosed trades. | limit | 1 | beta |
stats_reporting_gaps | Politicians ranked by late STOCK Act disclosures (more than 45 days from trade to filing). | limit | 1 | beta |
stats_sectors | Disclosed trade counts and volume by industry sector (sector known for classified tickers only). | - | 1 | beta |
stats_tickers | Most-traded tickers in Congress by number of disclosed trades. | limit | 1 | beta |
stats_unusual | Tickers with unusual congressional activity: recent trade count far above their own average. | limit | 1 | beta |
stats_volume | Disclosed congressional trade volume by month. | - | 1 | beta |
ticker | Congressional trading statistics for one stock ticker. | keyword* | 1 | beta |
ticker_trades | Congressional trades of one stock ticker, by chamber. | keyword*, chamber | 1 | beta |
trades | Latest disclosed US Congress stock trades (newest first), by chamber. | chamber | 1 | beta |
A * marks a required parameter. Each endpoint name links to its reference page with the full parameter table, caching window and a recorded response.
Make a request#
This calls us_congress_trades.politician (1 credit, beta). Replace YOUR_API_KEY with your key; sign up, no card. 1,000 free credits cover the open-platform endpoints. Hard-to-reach platforms (X, TikTok, Instagram, Reddit, and others marked on their page) need a verified email and a purchased pack.
curl "https://api.onekey.dev/v1/us_congress_trades/politician?handle=Alford" \
-H "x-api-key: YOUR_API_KEY"Fields you get back#
These unified fields come back from Us Congress Trades, with the same names as on every other platform. The count is how many of its 17 mapped endpoints return the field; a field the source lacks is null, never missing. 39 platform-specific fields (ext.<name>) come on top, documented on each endpoint page.
| Field | Type | Endpoints |
|---|---|---|
author.displayName | string | 8 |
market.symbol | string | 8 |
author.id | string | 5 |
author.location | string | 5 |
content.createdAt | ISO 8601 date | 5 |
entity.name | string | 5 |
entity.stats.rank | integer | 5 |
author.contentCount | integer | 4 |
content.title | string | 4 |
content.type | string | 4 |
content.updatedAt | ISO 8601 date | 4 |
content.url | URL | 4 |
author.username | string | 3 |
entity.category | string | 2 |
content.id | string | 1 |
entity.stats.score | number | 1 |
The full schema is in Unified schema.
Pricing#
Every Us Congress Trades endpoint costs 1 credit per call. Free when served from cache (0.2 credit for a cached response over 100 KB). Invalid, failed or not-found calls are not charged. See pricing for credit packs.