Search individual US Congress member stock trades, parsed from STOCK Act Periodic Transaction Reports into clean rows. Filter by member name (q, e.g. "Pelosi"), ticker (e.g. NVDA), transaction type (purchase | sale | exchange | partial_sale), party (D | R | I), 2-letter state, chamber, or transaction-date range (dateFrom/dateTo). Each trade returns the member + party + state/district, owner (self/spouse/joint/dependent), ticker + asset description, buy/sell, the disclosed dollar RANGE (amountMin/amountMax — disclosures are ranges, not exact), the transaction date, the disclosure date, days-to-disclose (compliance lag), and a link to the source filing PDF. The envelope total is the full count matching your filter — so ticker=NVDA&type=purchase counts who bought NVIDIA. Amounts are ranges by law; trades are disclosed up to 45 days after they happen (current-to-the-filing). Coverage: US House + Senate e-filed PTRs; scanned/handwritten reports are parsed separately. Data: US House Clerk / US Senate eFD (public domain). Cross-ref /api/gov/congress-filings for the raw filing index.
/api/gov/congress-tradesPAYMENT-SIGNATURE.The congress trades API is a pay-per-call gov endpoint built for AI agents and autonomous software. Search individual US Congress member stock trades, parsed from STOCK Act Periodic Transaction Reports into clean rows.
There is no signup and no API key. An agent (or any HTTP client) hits the endpoint, receives an x402 "402 Payment Required" challenge, signs a sub-cent USDC payment on Base or Solana, and retries — the data comes back on the paid request. That makes it a drop-in congress trades data source for an agent tool-use loop, an MCP host, or a backend that needs gov data on demand without onboarding to yet another vendor portal.
| Name | Type | Description |
|---|---|---|
q | string | min 1 chars · max 80 chars |
ticker | string | min 1 chars · max 10 chars |
type | string | min 1 chars · max 20 chars |
chamber | string | one of: house | senate |
party | string | min 1 chars · max 11 chars |
state | string | min 2 chars · max 2 chars |
dateFrom | string | match ^\d{4}-\d{2}-\d{2}$ |
dateTo | string | match ^\d{4}-\d{2}-\d{2}$ |
limit | integer | min 1 · max 100 |
offset | integer | min 0 · max 100000 |
# 1. Probe with no auth → 402 envelope with PaymentRequirements curl -sS 'https://2s.io/api/gov/congress-trades?q=example&ticker=example&type=example&chamber=house&party=example&state=xx&dateFrom=2024-01-01&dateTo=2024-01-01&limit=25&offset=0' # 2. Sign + retry with PAYMENT-SIGNATURE: curl -sS 'https://2s.io/api/gov/congress-trades?q=example&ticker=example&type=example&chamber=house&party=example&state=xx&dateFrom=2024-01-01&dateTo=2024-01-01&limit=25&offset=0' \ -H 'PAYMENT-SIGNATURE: <base64-json-payload>' # Or use the canonical runner (handles probe → sign → retry): # EVM_PRIVATE_KEY=0x... node --env-file=.env.local \ # --experimental-strip-types scripts/x402-pay.ts \ # 'https://2s.io/api/gov/congress-trades?q=example&ticker=example&type=example&chamber=house&party=example&state=xx&dateFrom=2024-01-01&dateTo=2024-01-01&limit=25&offset=0'
import { TwoS } from '@2sio/sdk'
const client = new TwoS({
privateKey: process.env.EVM_PRIVATE_KEY as `0x${string}`,
})
const result = await client.gov.congressTrades({
"q": "example",
"ticker": "example",
"type": "example",
"chamber": "house",
"party": "example",
"state": "xx",
"dateFrom": "2024-01-01",
"dateTo": "2024-01-01",
"limit": 25,
"offset": 0
})
console.log('endpoint:', result.endpoint)
console.log('cost:', result.costUsd, 'USDC')
console.log('tx:', result.settlement?.txHash)
console.log('data:', result.data)import os
from twosio import TwoS
client = TwoS(private_key=os.environ["EVM_PRIVATE_KEY"])
result = client.gov.congress_trades(q="example", ticker="example", type="example", chamber="house", party="example", state="xx", dateFrom="2024-01-01", dateTo="2024-01-01", limit=25, offset=0)
print("endpoint:", result.endpoint)
print("cost:", result.cost_usd, "USDC")
print("tx:", (result.settlement or {}).get("tx_hash"))
print("data:", result.data)// 1. Add @2sio/mcp to your MCP host config (Claude Desktop example below).
// EVM_PRIVATE_KEY funds x402 payments per call.
// claude_desktop_config.json
{
"mcpServers": {
"2sio": {
"command": "npx",
"args": ["-y", "@2sio/mcp"],
"env": { "EVM_PRIVATE_KEY": "0x..." }
}
}
}
// 2. Once the server is running, agents call this tool via standard MCP:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "gov.congress-trades",
"arguments": {
"q": "example",
"ticker": "example",
"type": "example",
"chamber": "house",
"party": "example",
"state": "xx",
"dateFrom": "2024-01-01",
"dateTo": "2024-01-01",
"limit": 25,
"offset": 0
}
}
}| Field | Type | Description |
|---|---|---|
ok | boolean | one of: true |
items | array | |
total | integer | Total matching rows upstream; null when unknown. |
source | object |
{
"ok": true,
"items": [
{
"member": "example",
"chamber": "example",
"party": "example",
"state": "example",
"district": "example",
"owner": "example",
"ticker": "example",
"assetDescription": "example",
"assetType": "example",
"transactionType": "example",
"amountMin": 1,
"amountMax": 1,
"transactionDate": "example",
"disclosureDate": "example",
"daysToDisclose": 1,
"docUrl": "example",
"source": "example"
}
],
"total": 1,
"source": {
"provider": "example",
"url": "example",
"license": "example"
}
}