# Congressional Stock Trade Disclosures API

> Congressional Stock Trade Disclosures API is a paid API for AI agents from x402.forgemesh.io, paid per call via x402, $0.02/call, status healthy (last checked 2026-10-12, last successful call 2026-10-08).

Returns parsed STOCK Act filings of House members' stock trades, filterable by member, ticker, trade type, state, and date range.

## Facts

- Endpoint: POST https://x402.forgemesh.io/congress-stock-trades?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: healthy
- Last checked: 2026-10-12
- Last successful call: 2026-10-08
- Success rate: 100% of calls made through Zero
- Activations on Zero: 1
- Tags: x402
- Canonical page: https://www.zero.xyz/c/congressional-stock-trade-disclosures-api-692a4a06
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rAHYRRwoRYDbszYEBbAaL

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability congressional-stock-trade-disclosures-api-692a4a06 -d '<json body>'
```

Example prompt: Pull all House stock trade disclosures for NVDA since January 1 2025 — show me up to 50 results including the member name, trade type, amount range, and transaction date.

## When to prefer this

Use this endpoint when you need structured, filterable access to STOCK Act trade disclosures from House members — specifically when you need to filter by ticker, member, state, date window, or trade type. Prefer this over scraping the House Clerk website directly. Best for trading-signal research, political accountability monitoring, and journalism agents that need parsed, query-ready congressional trade data rather than raw PDF filings.

## Known failure modes

- No matching trades found for the given filters — returns empty trades array with matched:0
- Invalid ticker format or member name substring returns empty results rather than an error
- Date range outside coverage window (pre-2025) returns empty results
- Limit exceeds maximum of 100 — request rejected with validation error
- Stale data: disclosures lag actual trades by up to 45 days, so very recent trades may not appear yet

## How this service works

Congressional stock trade disclosures parsed from official STOCK Act filings: every reported House trade with member, ticker, asset, buy/sell, transaction date, and amount range. Filter by member, ticker, trade type, state, or date window. Amounts are the legally disclosed ranges; disclosures lag trades by up to 45 days. For trading-signal, accountability, and news agents.

## Output

Returns a JSON object with a 'trades' array, each entry containing member name, ticker, asset name, trade type (purchase/sale/partial sale/exchange), chamber, state district, amount range (legally disclosed bracket), transaction date, notification date, and document ID. Also includes total matched count, returned count, years and chambers covered, and attribution to the US House Clerk.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "type": {
   "enum": [
    "purchase",
    "sale",
    "sale_partial",
    "exchange"
   ],
   "type": "string"
  },
  "limit": {
   "type": "integer",
   "maximum": 100,
   "minimum": 1
  },
  "since": {
   "type": "string",
   "description": "ISO date lower bound on transaction date"
  },
  "state": {
   "type": "string",
   "description": "state or district prefix, e.g. 'VA' or 'VA01'"
  },
  "until": {
   "type": "string",
   "description": "ISO date upper bound on transaction date"
  },
  "member": {
   "type": "string",
   "description": "member name substring, e.g. 'wittman'"
  },
  "ticker": {
   "type": "string",
   "description": "exact ticker, e.g. 'NVDA'"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "trades": [
   {
    "type": "sale",
    "asset": "Crown Castle Inc. Common Stock",
    "owner": null,
    "doc_id": "20034916",
    "member": "Robert J. Wittman",
    "ticker": "CCI",
    "chamber": "house",
    "amount_range": "$1,001 - $15,000",
    "state_district": "VA01",
    "transaction_date": "2026-06-30",
    "notification_date": "2026-07-02"
   }
  ],
  "matched": 12,
  "coverage": {
   "years": [
    2025,
    2026
   ],
   "chambers": [
    "house"
   ]
  },
  "returned": 5,
  "attribution": "US House Clerk financial disclosures (public domain)"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/congressional-stock-trade-disclosures-api-692a4a06/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.forgemesh.io](https://www.zero.xyz/host/x402.forgemesh.io/llms.txt)