{"uid":"cap_WAib_WuchINTpE0eL-A_s","slug":"octodamus-congressional-stock-trade-disclosures-32932865","name":"Octodamus Congressional Stock Trade Disclosures","description":"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.","url":"https://api.octodamus.com/v2/congress/trades","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9WDXNYh5QFvzTjGYYIz_k","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns structured congressional stock-trade disclosure records including politician, party, chamber, ticker, BUY/SELL action, dollar-amount range, filing date, and excess return.","exampleAgentPrompt":"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.","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:46:42.820Z","isFirstParty":false}