# Octodamus Congressional Stock Trade Disclosures

> Octodamus Congressional Stock Trade Disclosures is a paid API for AI agents from api.octodamus.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Returns structured congressional stock-trade disclosure records including politician, party, chamber, ticker, BUY/SELL action, dollar-amount range, filing date, and excess return.

## Facts

- Endpoint: GET https://api.octodamus.com/v2/congress/trades
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/octodamus-congressional-stock-trade-disclosures-32932865
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WAib_WuchINTpE0eL-A_s

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 octodamus-congressional-stock-trade-disclosures-32932865
```

Example prompt: Pull the latest congressional stock trades from Octodamus for the past 30 days and filter for any BUY or SELL activity on NVDA — I want to see which politicians traded it, their party, chamber, dollar range, and the excess return.

## When to prefer this

Use this endpoint when you need structured, factual congressional stock trade disclosures with financial metadata like excess return and dollar ranges. Prefer this over general news APIs when you need machine-readable trade-level data tied to specific politicians, parties, and tickers rather than narrative summaries.

## Known failure modes

- Invalid or missing PAYMENT-SIGNATURE header returns 402 Payment Required
- Unrecognized ticker symbol returns empty results or 400 Bad Request
- Days parameter out of valid range returns 400 Bad Request
- Network timeout or server error returns 500
- Insufficient USDC balance or invalid Base mainnet signature returns payment failure

## How this service works

Structured congressional stock-trade disclosures: politician, party, chamber, ticker, BUY/SELL, dollar-amount range, filing date, excess return. Optional days + ticker filter. Factual event feed.

## Output

Returns a list of congressional stock trade disclosure records, each containing the politician's name, party affiliation, chamber (House/Senate), stock ticker, trade action (BUY/SELL/HOLD), dollar amount range, filing date, and excess return percentage.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "method"
   ],
   "properties": {
    "method": {
     "type": "string",
     "const": "GET"
    },
    "headers": {
     "type": "object",
     "required": [
      "PAYMENT-SIGNATURE"
     ],
     "properties": {
      "PAYMENT-SIGNATURE": {
       "type": "string",
       "description": "x402 EIP-3009 USDC payment signature (Base mainnet)"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "action": {
     "enum": [
      "BUY",
      "SELL",
      "HOLD"
     ],
     "type": "string"
    },
    "signal": {
     "enum": [
      "BULLISH",
      "BEARISH",
      "NEUTRAL"
     ],
     "type": "string"
    },
    "btc_trend": {
     "enum": [
      "UP",
      "DOWN",
      "SIDEWAYS"
     ],
     "type": "string"
    },
    "reasoning": {
     "type": "string"
    },
    "confidence": {
     "type": "number",
     "maximum": 1,
     "minimum": 0
    },
    "fear_greed": {
     "type": "number",
     "maximum": 100,
     "minimum": 0
    },
    "polymarket_edge": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

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