# Us Congress Trades on Onekey

> 17 endpoints for Us Congress Trades (0 stable, 17 beta), 1 credit each. Category: Government & public data. One key, one JSON shape.

Base URL: https://api.onekey.dev
Auth: header `x-api-key: <key>`. Call shape: `GET /v1/{platform}/{endpoint}?{params}`.
Every response is `{success, data, metadata, error}`; check `success` first. Cost is in `metadata.credits_charged`. Free when served from cache (0.2 credit for a cached response over 100 KB). Failed and not-found calls are refunded.
Status: stable = verified against the live source; beta = not yet verified, fields may be missing.

Page: https://onekey.dev/platforms/us_congress_trades
Reference (Markdown): https://onekey.dev/docs/api/us_congress_trades.md
All docs: https://onekey.dev/llms.txt

## Canonical fields returned

Unified-schema fields (same names on every platform), with how many of the 17 mapped Us Congress Trades endpoints return each:

- `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
- plus 39 platform-specific fields under `ext.`

## Endpoints

### us_congress_trades.members

Members of Congress who have disclosed stock trades, with trade counts.
- Price: 1 credit per fresh call. Status: beta. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/us_congress_trades/members` with header `x-api-key: YOUR_API_KEY`
- Parameters: none
- Fields returned: `author.id`, `author.displayName`, `author.location`, `author.contentCount`, `ext.party`, `ext.chamber`, `ext.district`, `ext.volumeMid`, `ext.latestTradeDate`, `ext.bioguide`
- Reference: https://onekey.dev/docs/api/us_congress_trades/members.md

### us_congress_trades.politician

A politician's disclosed-trading summary: counts, estimated volume and most traded tickers.
- Price: 1 credit per fresh call. Status: beta. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/us_congress_trades/politician?handle=Alford` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `handle` (string, required): Politician's last name, case-insensitive (Pelosi)
- Fields returned: `author.id`, `author.displayName`, `author.location`, `author.contentCount`, `ext.party`, `ext.chamber`, `ext.district`, `ext.volumeMid`, `ext.latestTradeDate`, `ext.buyCount`, `ext.sellCount`, `ext.exchangeCount`, `ext.firstTradeDate`, `ext.tickerCount`, `ext.filingCount`, `ext.topTickers`, `ext.otherMatches`
- Reference: https://onekey.dev/docs/api/us_congress_trades/politician.md

### us_congress_trades.politician_trades

Trades disclosed by one member of Congress (by name), by chamber.
- Price: 1 credit per fresh call. Status: beta. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/us_congress_trades/politician_trades?handle=Pelosi` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `handle` (string, required): Member name or last name, e.g. Pelosi
  - `chamber` (string, optional, default senate): senate or house
- Fields returned: `market.symbol`, `content.createdAt`, `content.updatedAt`, `content.type`, `content.title`, `author.displayName`, `author.username`, `content.url`, `ext.amountRange`, `ext.office`, `ext.owner`
- Reference: https://onekey.dev/docs/api/us_congress_trades/politician_trades.md

### us_congress_trades.state_trades

Disclosed trades by a state's House delegation (newest first, up to 100).
- Price: 1 credit per fresh call. Status: beta. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/us_congress_trades/state_trades?state=MO` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `state` (string, required): Two-letter USPS state code, CA or TX
- Fields returned: `content.id`, `market.symbol`, `content.createdAt`, `content.updatedAt`, `content.type`, `content.title`, `author.displayName`, `author.id`, `author.location`, `content.url`, `ext.party`, `ext.chamber`, `ext.owner`, `ext.assetType`, `ext.amountMin`, `ext.amountMax`, `ext.notificationDate`
- Reference: https://onekey.dev/docs/api/us_congress_trades/state_trades.md

### us_congress_trades.stats

Summary of the congressional trades dataset: sizes, date range and freshness.
- Price: 1 credit per fresh call. Status: beta. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/us_congress_trades/stats` with header `x-api-key: YOUR_API_KEY`
- Parameters: none
- Fields returned: `ext.tradeCount`, `ext.memberCount`, `ext.tickerCount`, `ext.filingCount`, `ext.filingsIndexed`, `ext.filingsParsed`, `ext.firstTradeDate`, `ext.latestTradeDate`, `ext.chambers`, `ext.lastIngestAt`, `ext.source`
- Reference: https://onekey.dev/docs/api/us_congress_trades/stats.md

### us_congress_trades.stats_buy_sell

Congressional buys versus sells: counts, ratio and estimated volume.
- Price: 1 credit per fresh call. Status: beta. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/us_congress_trades/stats_buy_sell` with header `x-api-key: YOUR_API_KEY`
- Parameters: none
- Fields returned: `ext.buyCount`, `ext.sellCount`, `ext.exchangeCount`, `ext.buySellRatio`, `ext.buyVolume`, `ext.sellVolume`
- Reference: https://onekey.dev/docs/api/us_congress_trades/stats_buy_sell.md

### us_congress_trades.stats_issuers

Most-traded issuers in Congress by number of disclosed trades.
- Price: 1 credit per fresh call. Status: beta. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/us_congress_trades/stats_issuers` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `limit` (string, optional, default 25): Rows to return (1-100)
- Fields returned: `entity.name`, `market.symbol`, `entity.stats.rank`, `ext.tradeCount`, `ext.memberCount`, `ext.volumeMid`
- Reference: https://onekey.dev/docs/api/us_congress_trades/stats_issuers.md

### us_congress_trades.stats_party

Disclosed trade counts and volume compared by party.
- Price: 1 credit per fresh call. Status: beta. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/us_congress_trades/stats_party` with header `x-api-key: YOUR_API_KEY`
- Parameters: none
- Fields returned: `entity.name`, `ext.tradeCount`, `ext.buyCount`, `ext.sellCount`, `ext.memberCount`, `ext.volumeMid`
- Reference: https://onekey.dev/docs/api/us_congress_trades/stats_party.md

### us_congress_trades.stats_politicians

Most active congressional traders by number of disclosed trades.
- Price: 1 credit per fresh call. Status: beta. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/us_congress_trades/stats_politicians` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `limit` (string, optional, default 25): Rows to return (1-100)
- Fields returned: `author.id`, `author.displayName`, `author.location`, `author.contentCount`, `entity.stats.rank`, `ext.party`, `ext.volumeMid`, `ext.latestTradeDate`
- Reference: https://onekey.dev/docs/api/us_congress_trades/stats_politicians.md

### us_congress_trades.stats_reporting_gaps

Politicians ranked by late STOCK Act disclosures (more than 45 days from trade to filing).
- Price: 1 credit per fresh call. Status: beta. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/us_congress_trades/stats_reporting_gaps` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `limit` (string, optional, default 25): Rows to return (1-100)
- Fields returned: `author.id`, `author.displayName`, `author.location`, `author.contentCount`, `entity.stats.rank`, `ext.party`, `ext.lateCount`, `ext.lateShare`, `ext.avgDaysToDisclose`, `ext.maxDaysToDisclose`
- Reference: https://onekey.dev/docs/api/us_congress_trades/stats_reporting_gaps.md

### us_congress_trades.stats_sectors

Disclosed trade counts and volume by industry sector (sector known for classified tickers only).
- Price: 1 credit per fresh call. Status: beta. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/us_congress_trades/stats_sectors` with header `x-api-key: YOUR_API_KEY`
- Parameters: none
- Fields returned: `entity.category`, `ext.tradeCount`, `ext.buyCount`, `ext.sellCount`, `ext.volumeMid`
- Reference: https://onekey.dev/docs/api/us_congress_trades/stats_sectors.md

### us_congress_trades.stats_tickers

Most-traded tickers in Congress by number of disclosed trades.
- Price: 1 credit per fresh call. Status: beta. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/us_congress_trades/stats_tickers` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `limit` (string, optional, default 25): Rows to return (1-100)
- Fields returned: `market.symbol`, `entity.name`, `entity.stats.rank`, `ext.tradeCount`, `ext.buyCount`, `ext.sellCount`, `ext.memberCount`, `ext.volumeMid`
- Reference: https://onekey.dev/docs/api/us_congress_trades/stats_tickers.md

### us_congress_trades.stats_unusual

Tickers with unusual congressional activity: recent trade count far above their own average.
- Price: 1 credit per fresh call. Status: beta. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/us_congress_trades/stats_unusual` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `limit` (string, optional, default 25): Rows to return (1-100)
- Fields returned: `market.symbol`, `entity.name`, `entity.stats.score`, `entity.stats.rank`, `ext.recentTradeCount`, `ext.recentMemberCount`, `ext.baselineTradeCount`, `ext.windowDays`
- Reference: https://onekey.dev/docs/api/us_congress_trades/stats_unusual.md

### us_congress_trades.stats_volume

Disclosed congressional trade volume by month.
- Price: 1 credit per fresh call. Status: beta. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/us_congress_trades/stats_volume` with header `x-api-key: YOUR_API_KEY`
- Parameters: none
- Fields returned: `content.createdAt`, `ext.tradeCount`, `ext.buyCount`, `ext.sellCount`, `ext.volumeMid`
- Reference: https://onekey.dev/docs/api/us_congress_trades/stats_volume.md

### us_congress_trades.ticker

Congressional trading statistics for one stock ticker.
- Price: 1 credit per fresh call. Status: beta. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/us_congress_trades/ticker?keyword=AAPL` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `keyword` (string, required): Stock ticker, AAPL or AAPL:US
- Fields returned: `market.symbol`, `entity.name`, `entity.category`, `ext.tradeCount`, `ext.buyCount`, `ext.sellCount`, `ext.memberCount`, `ext.volumeMid`, `ext.firstTradeDate`, `ext.latestTradeDate`
- Reference: https://onekey.dev/docs/api/us_congress_trades/ticker.md

### us_congress_trades.ticker_trades

Congressional trades of one stock ticker, by chamber.
- Price: 1 credit per fresh call. Status: beta. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/us_congress_trades/ticker_trades?keyword=AAPL` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `keyword` (string, required): Stock ticker, e.g. AAPL
  - `chamber` (string, optional, default senate): senate or house
- Fields returned: `market.symbol`, `content.createdAt`, `content.updatedAt`, `content.type`, `content.title`, `author.displayName`, `author.username`, `content.url`, `ext.amountRange`, `ext.office`, `ext.owner`
- Reference: https://onekey.dev/docs/api/us_congress_trades/ticker_trades.md

### us_congress_trades.trades

Latest disclosed US Congress stock trades (newest first), by chamber.
- Price: 1 credit per fresh call. Status: beta. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/us_congress_trades/trades?chamber=senate` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `chamber` (string, optional, default senate): senate or house
- Fields returned: `market.symbol`, `content.createdAt`, `content.updatedAt`, `content.type`, `content.title`, `author.displayName`, `author.username`, `content.url`, `ext.amountRange`, `ext.office`, `ext.owner`
- Reference: https://onekey.dev/docs/api/us_congress_trades/trades.md

## Sample request

```bash
curl "https://api.onekey.dev/v1/us_congress_trades/politician?handle=Alford" \
  -H "x-api-key: YOUR_API_KEY"
```