{"openapi":"3.1.0","info":{"title":"Benzinga (BYOK) API","version":"0.1.0","description":"Benzinga (BYOK) lets an AI assistant read your own Benzinga data through the Benzinga API with a key you supply (Benzinga API key). Read-only: 10 tools (get_earnings_calendar, get_economic_calendar, get_dividends_calendar, get_analyst_ratings, get_consensus_ratings, get_splits_calendar, get_ipo_calendar, get_mergers_acquisitions, list_insider_transaction_filings, list_congress_trades). The BYOK...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-benzinga.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-benzinga/docs"},"termsOfService":"https://connectorbay.com/byok-benzinga/terms"},"servers":[{"url":"https://byok-benzinga.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-benzinga/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/get_earnings_calendar":{"post":{"operationId":"get_earnings_calendar","summary":"List earnings events with date, time, period, EPS and revenue estimate, prior and actual values and surprises. Filter by","description":"List earnings events with date, time, period, EPS and revenue estimate, prior and actual values and surprises. Filter by date range, tickers and importance. Use for \"When does Apple report earnings next\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"date":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Single date YYYY-MM-DD (shorthand for date_from and date_to being equal; the API defaults to the latest).","title":"Date"},"date_from":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Start date YYYY-MM-DD.","title":"Date From"},"date_to":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"End date YYYY-MM-DD.","title":"Date To"},"tickers":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated ticker symbols, at most 50, for example 'AAPL,MSFT'.","title":"Tickers"},"importance":{"anyOf":[{"maximum":5,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Minimum importance level to include (greater than or equal; 0 to 5).","title":"Importance"},"page":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Page offset starting at 0 (the API allows 0 to 100000).","title":"Page"},"page_size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"Records per page (1 to 1000).","title":"Page Size"}},"title":"get_earnings_calendarArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_economic_calendar":{"post":{"operationId":"get_economic_calendar","summary":"List economic releases (CPI, GDP, jobs and others) with country, event name, time, actual, consensus and prior values. F","description":"List economic releases (CPI, GDP, jobs and others) with country, event name, time, actual, consensus and prior values. Filter by country code, event name prefix and category. Use for \"What US economic releases are scheduled this week\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"date":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Single date YYYY-MM-DD (shorthand for date_from and date_to being equal; the API defaults to the latest).","title":"Date"},"date_from":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Start date YYYY-MM-DD.","title":"Date From"},"date_to":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"End date YYYY-MM-DD.","title":"Date To"},"country":{"anyOf":[{"maxLength":3,"type":"string"},{"type":"null"}],"default":null,"description":"3-letter country code, for example USA, CAN or GBR.","title":"Country"},"event_name":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"One or more event name prefixes, comma-separated, for example 'CPI,GDP'.","title":"Event Name"},"event_category":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"One or more event categories, comma-separated, for example 'Employment'.","title":"Event Category"},"importance":{"anyOf":[{"maximum":3,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Minimum importance level to include (greater than or equal; 1 to 3).","title":"Importance"},"page":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Page offset starting at 0 (the API allows 0 to 100000).","title":"Page"},"page_size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"Records per page (1 to 1000).","title":"Page Size"}},"title":"get_economic_calendarArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_dividends_calendar":{"post":{"operationId":"get_dividends_calendar","summary":"List dividends with ex-dividend, record and payable dates, amount, prior amount, frequency, yield and whether the date i","description":"List dividends with ex-dividend, record and payable dates, amount, prior amount, frequency, yield and whether the date is confirmed. Use for \"Which of my tickers go ex-dividend next month\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"date":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Single date YYYY-MM-DD (shorthand for date_from and date_to being equal; the API defaults to the latest).","title":"Date"},"date_from":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Start date YYYY-MM-DD.","title":"Date From"},"date_to":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"End date YYYY-MM-DD.","title":"Date To"},"tickers":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated ticker symbols, at most 50, for example 'AAPL,MSFT'.","title":"Tickers"},"date_sort":{"anyOf":[{"enum":["announced","ex","payable","record"],"type":"string"},{"type":"null"}],"default":null,"description":"Date field to sort on: announced, ex, payable or record.","title":"Date Sort"},"dividend_yield":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Dividend yield to filter by as a fraction (1 = 100%).","title":"Dividend Yield"},"dividend_yield_operation":{"anyOf":[{"enum":["gt","gte","eq","lte","lt"],"type":"string"},{"type":"null"}],"default":null,"description":"How to compare the yield: gt, gte, eq, lt or lte.","title":"Dividend Yield Operation"},"importance":{"anyOf":[{"maximum":5,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Minimum importance level to include (greater than or equal; 0 to 5).","title":"Importance"},"page":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Page offset starting at 0 (the API allows 0 to 100000).","title":"Page"},"page_size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"Records per page (1 to 1000).","title":"Page Size"}},"title":"get_dividends_calendarArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_analyst_ratings":{"post":{"operationId":"get_analyst_ratings","summary":"List analyst rating changes and price target changes (upgrades, downgrades, initiations) with firm, analyst, current and","description":"List analyst rating changes and price target changes (upgrades, downgrades, initiations) with firm, analyst, current and prior rating and target. Use for \"Which analysts changed their Nvidia price target recently\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"date":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Single date YYYY-MM-DD (shorthand for date_from and date_to being equal; the API defaults to the latest).","title":"Date"},"date_from":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Start date YYYY-MM-DD.","title":"Date From"},"date_to":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"End date YYYY-MM-DD.","title":"Date To"},"tickers":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated ticker symbols, at most 50, for example 'AAPL,MSFT'.","title":"Tickers"},"action":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Rating action filter, for example Upgrades, Downgrades, Maintains, Initiates Coverage On, Reiterates.","title":"Action"},"importance":{"anyOf":[{"maximum":5,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Minimum importance level to include (greater than or equal; 0 to 5).","title":"Importance"},"page":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Page offset starting at 0 (the API allows 0 to 100000).","title":"Page"},"page_size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"Records per page (1 to 1000).","title":"Page Size"}},"title":"get_analyst_ratingsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_consensus_ratings":{"post":{"operationId":"get_consensus_ratings","summary":"Get the analyst consensus for one ticker: rating distribution, consensus rating and price target (low, high, average) an","description":"Get the analyst consensus for one ticker: rating distribution, consensus rating and price target (low, high, average) and analyst counts. Use for \"What is the analyst consensus rating and price target for MSFT\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"ticker":{"description":"Exactly one ticker symbol, for example MSFT.","maxLength":12,"title":"Ticker","type":"string"},"simplify":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to collapse ratings to BUY, HOLD and SELL.","title":"Simplify"},"aggregate_type":{"anyOf":[{"enum":["number","percentage"],"type":"string"},{"type":"null"}],"default":"number","description":"Show counts as 'number' or 'percentage'.","title":"Aggregate Type"}},"required":["ticker"],"title":"get_consensus_ratingsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_splits_calendar":{"post":{"operationId":"get_splits_calendar","summary":"List stock splits with ratio, split type and announced, ex, record and distribution dates. Use for \"Which stock splits w","description":"List stock splits with ratio, split type and announced, ex, record and distribution dates. Use for \"Which stock splits were announced this month\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"date":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Single date YYYY-MM-DD (shorthand for date_from and date_to being equal; the API defaults to the latest).","title":"Date"},"date_from":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Start date YYYY-MM-DD.","title":"Date From"},"date_to":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"End date YYYY-MM-DD.","title":"Date To"},"tickers":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated ticker symbols, at most 50, for example 'AAPL,MSFT'.","title":"Tickers"},"date_search_field":{"anyOf":[{"enum":["announced","ex"],"type":"string"},{"type":"null"}],"default":null,"description":"Which date to filter and sort by: announced or ex.","title":"Date Search Field"},"importance":{"anyOf":[{"maximum":5,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Minimum importance level to include (greater than or equal; 0 to 5).","title":"Importance"},"page":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Page offset starting at 0 (the API allows 0 to 100000).","title":"Page"},"page_size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"Records per page (1 to 1000).","title":"Page Size"}},"title":"get_splits_calendarArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_ipo_calendar":{"post":{"operationId":"get_ipo_calendar","summary":"List IPOs with company, exchange, deal status, pricing date, price range, offering size and lead underwriters. Use for \"","description":"List IPOs with company, exchange, deal status, pricing date, price range, offering size and lead underwriters. Use for \"Which IPOs are scheduled for next week\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"ipo_date":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Single IPO date YYYY-MM-DD.","title":"Ipo Date"},"date_from":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Start date YYYY-MM-DD.","title":"Date From"},"date_to":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"End date YYYY-MM-DD.","title":"Date To"},"tickers":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated tickers.","title":"Tickers"},"page":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Page number.","title":"Page"},"page_size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Records per page.","title":"Page Size"}},"title":"get_ipo_calendarArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_mergers_acquisitions":{"post":{"operationId":"get_mergers_acquisitions","summary":"List mergers and acquisitions with acquirer, target, deal type and size, payment type, status and announced, expected an","description":"List mergers and acquisitions with acquirer, target, deal type and size, payment type, status and announced, expected and completed dates. Use for \"What acquisitions were announced this week\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"date":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Single date YYYY-MM-DD (shorthand for date_from and date_to being equal; the API defaults to the latest).","title":"Date"},"date_from":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Start date YYYY-MM-DD.","title":"Date From"},"date_to":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"End date YYYY-MM-DD.","title":"Date To"},"tickers":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated ticker symbols, at most 50, for example 'AAPL,MSFT'.","title":"Tickers"},"date_sort":{"anyOf":[{"enum":["expected","completed","announced"],"type":"string"},{"type":"null"}],"default":null,"description":"Date field to sort on: expected, completed or announced.","title":"Date Sort"},"importance":{"anyOf":[{"maximum":5,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Minimum importance level to include (greater than or equal; 0 to 5).","title":"Importance"},"page":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Page offset starting at 0 (the API allows 0 to 100000).","title":"Page"},"page_size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"Records per page (1 to 1000).","title":"Page Size"}},"title":"get_mergers_acquisitionsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_insider_transaction_filings":{"post":{"operationId":"list_insider_transaction_filings","summary":"List SEC Form 4 insider transaction filings with company, symbol, insider name and role, filing date and remaining share","description":"List SEC Form 4 insider transaction filings with company, symbol, insider name and role, filing date and remaining shares. Search by symbol, CIK or accession number. Use for \"Which insiders filed Form 4 trades for AAPL recently\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"view_type":{"description":"Grouping of the answer: filings (one row per Form 4) or transactions (one row per transaction).","enum":["filings","transactions"],"title":"View Type","type":"string"},"search_keys_type":{"anyOf":[{"enum":["symbol","accession_number","cik","id"],"type":"string"},{"type":"null"}],"default":null,"description":"What search_keys holds: symbol, accession_number, cik or id.","title":"Search Keys Type"},"search_keys":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Value(s) to search for, comma-separated, for example 'AAPL'.","title":"Search Keys"},"date_from":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Start date YYYY-MM-DD.","title":"Date From"},"date_to":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"End date YYYY-MM-DD.","title":"Date To"},"page":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Page offset starting at 0.","title":"Page"},"page_size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"Records per page (1 to 1000).","title":"Page Size"}},"required":["view_type"],"title":"list_insider_transaction_filingsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_congress_trades":{"post":{"operationId":"list_congress_trades","summary":"List stock trades disclosed by US House and Senate members with member, party, state, security, transaction type and dat","description":"List stock trades disclosed by US House and Senate members with member, party, state, security, transaction type and date, and amount range. Use for \"What stocks did members of Congress trade recently\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"chamber":{"anyOf":[{"enum":["House","Senate"],"type":"string"},{"type":"null"}],"default":null,"description":"House or Senate.","title":"Chamber"},"search_keys_type":{"anyOf":[{"enum":["report_id","ticker"],"type":"string"},{"type":"null"}],"default":null,"description":"What search_keys holds: report_id or ticker.","title":"Search Keys Type"},"search_keys":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Value(s) to search for, comma-separated, for example 'NVDA'.","title":"Search Keys"},"date_from":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Start date YYYY-MM-DD.","title":"Date From"},"date_to":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"End date YYYY-MM-DD.","title":"Date To"},"page":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Page offset starting at 0.","title":"Page"},"page_size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"Records per page (1 to 1000).","title":"Page Size"}},"title":"list_congress_tradesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}