# x402stock Congress Trades API

> x402stock Congress Trades API is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-16).

Returns recent STOCK Act-disclosed trades made by US Congress members, parsed live from official House and Senate Periodic Transaction Reports

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/congress-trades
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-xyz-fb79fbd2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_G6I13ztR_ozS3a58YuOna

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 x402stock-xyz-fb79fbd2
```

Example prompt: Pull the 10 most recent STOCK Act trade disclosures from both the House and Senate — I want to see who's trading what, including the ticker, buy/sell type, and the disclosed dollar range.

## When to prefer this

Use this endpoint when you need real-time, structured data on congressional stock trades sourced directly from official STOCK Act filings. It is ideal for financial transparency research, political sentiment analysis, and monitoring whether Congress members are trading specific equities. Prefer this over scraping House/Senate disclosure sites manually or using delayed aggregator datasets.

## Known failure modes

- Invalid chamber value (not house/senate/both) returns a 400 error
- Limit exceeding 20 returns a validation error
- Unknown or unrecognized ticker returns an empty trades array rather than an error
- Payment not completed (x402 protocol) returns a 402 Payment Required response
- Upstream House/Senate disclosure site unavailable may delay or return stale data

## How this service works

Recent stock trades disclosed by US members of Congress under the STOCK Act, parsed live from official House and Senate Periodic Transaction Reports: per trade the member, chamber, ticker, asset, buy/sell type, date, and disclosed dollar range. ?chamber=house|senate|both, ?ticker=AAPL, ?limit= recent filings per chamber (max 20). From US House & Senate. From x402stock

## Output

A JSON object containing an array of recent congressional trade disclosures, each with the member's name, chamber, state, district, ticker symbol, asset name, asset type, owner, transaction type and code, transaction date, filing date, disclosed dollar amount range (min/max), document ID, and a link to the source PDF. Also includes metadata like the data source and as-of timestamp.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "limit": 10,
   "chamber": "both"
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "limit",
      "chamber"
     ],
     "properties": {
      "limit": {
       "type": "integer",
       "default": 7,
       "maximum": 20,
       "exclusiveMinimum": 0
      },
      "ticker": {
       "type": "string",
       "maxLength": 10,
       "minLength": 1
      },
      "chamber": {
       "enum": [
        "house",
        "senate",
        "both"
       ],
       "type": "string",
       "default": "house"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "source",
      "as_of",
      "chamber",
      "disclosure",
      "trade_count",
      "trades"
     ],
     "properties": {
      "as_of": {
       "anyOf": [
        {
         "type": "string"
        },
        {
         "type": "null"
        }
       ]
      },
      "source": {
       "enum": [
        "us_house",
        "us_senate",
        "us_congress"
       ],
       "type": "string"
      },
      "trades": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "chamber",
         "member",
         "state",
         "district",
         "filing_date",
         "doc_id",
         "pdf_url",
         "asset",
         "ticker",
         "asset_type",
         "owner",
         "transaction_type",
         "transaction_code",
         "transaction_date",
         "notification_date",
         "amount_range",
         "amount_min",
         "amount_max"
        ],
        "properties": {
         "asset": {
          "type": "string"
         },
         "owner": {
          "anyOf": [
           {
            "type": "string"
           },
           {
            "type": "null"
           }
          
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "as_of": "2026-05-31T00:00:00.000Z",
  "source": "us_house",
  "trades": [
   {
    "asset": "Apple Inc. - Common Stock",
    "owner": null,
    "state": "HI",
    "doc_id": "20034668",
    "member": "Hon. Ed Case",
    "ticker": "AAPL",
    "chamber": "house",
    "pdf_url": "https://disclosures-clerk.house.gov/public_disc/ptr-pdfs/2026/20034668.pdf",
    "district": "HI01",
    "amount_max": 15000,
    "amount_min": 1001,
    "asset_type": "ST",
    "filing_date": "2026-05-31",
    "amount_range": "$1,001 - $15,000",
    "transaction_code": "P",
    "transaction_date": "2026-05-14",
    "transaction_type": "purchase",
    "notification_date": "2026-05-14"
   }
  ],
  "chamber": "house",
  "disclosure": "stock_act_periodic_transaction_report",
  "trade_count": 1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-xyz-fb79fbd2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402stock.xyz](https://www.zero.xyz/host/x402stock.xyz/llms.txt)