{"openapi":"3.1.0","info":{"title":"slacking.biz API","description":"SEC EDGAR Financial Data API — Health scores, sentiment, financial statements, insider trades, and more.","version":"1.0.0"},"paths":{"/":{"get":{"summary":"Root","description":"Landing page.","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/.well-known/mcp.json":{"get":{"summary":"Mcp Discovery","description":"MCP discovery manifest — makes slacking.biz findable by AI agents.","operationId":"mcp_discovery__well_known_mcp_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/mcp":{"get":{"summary":"Mcp Setup","description":"MCP setup guide page — no auth required.","operationId":"mcp_setup_mcp_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/login":{"get":{"summary":"Login Page","description":"Login page.","operationId":"login_page_login_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}},"post":{"summary":"Login","description":"Login endpoint.","operationId":"login_login_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/signup":{"get":{"summary":"Signup Page","description":"Signup page.","operationId":"signup_page_signup_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}},"post":{"summary":"Signup","description":"Signup endpoint.","operationId":"signup_signup_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/me":{"get":{"summary":"Get Me","description":"Get current user info.","operationId":"get_me_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/logout":{"get":{"summary":"Logout","description":"Logout — clear session.","operationId":"logout_logout_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/dashboard":{"get":{"summary":"Dashboard","description":"Dashboard page.","operationId":"dashboard_dashboard_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/playground":{"get":{"summary":"Playground","description":"API Playground page. PUBLIC — developers can preview the API without signing up.\nIf logged in, their API key is pre-filled; anonymous visitors are prompted to sign up.","operationId":"playground_playground_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/upgrade":{"get":{"summary":"Upgrade","description":"Upgrade/pricing page. PUBLIC — anyone can view pricing (revenue conversion).\nAuth is optional: logged-in users see their current plan marked; anonymous\nvisitors see the full pricing grid with upgrade buttons that route to signup.","operationId":"upgrade_upgrade_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/alerts":{"get":{"summary":"Alerts Page","description":"Insider Alerts product page — pitch + pricing + watchlist management.","operationId":"alerts_page_alerts_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/status":{"get":{"summary":"Status Page","description":"Status page with feedback form.","operationId":"status_page_status_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/feedback":{"post":{"summary":"Submit Feedback","description":"Submit feedback report.","operationId":"submit_feedback_feedback_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/feedback/status":{"get":{"summary":"Feedback Status","description":"Check feedback status for an endpoint.","operationId":"feedback_status_feedback_status_get","parameters":[{"name":"endpoint","in":"query","required":false,"schema":{"type":"string","default":"","title":"Endpoint"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin":{"get":{"summary":"Admin Page","description":"Admin panel — manage users and plans.","operationId":"admin_page_admin_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/admin/update-plan":{"post":{"summary":"Admin Update Plan","description":"Update a user's plan.","operationId":"admin_update_plan_admin_update_plan_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/financial/{ticker}":{"get":{"summary":"Get Financial Data","description":"Get financial health score for a ticker.","operationId":"get_financial_data_v1_financial__ticker__get","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","title":"Ticker"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/financial/{ticker}/sentiment":{"get":{"summary":"Get Sentiment","description":"Get sentiment analysis for a ticker's SEC filing.","operationId":"get_sentiment_v1_financial__ticker__sentiment_get","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","title":"Ticker"}},{"name":"form_type","in":"query","required":false,"schema":{"type":"string","default":"10-K","title":"Form Type"}},{"name":"year","in":"query","required":false,"schema":{"type":"string","title":"Year"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/financial/compare":{"post":{"summary":"Compare Companies","description":"Compare financial health across companies.","operationId":"compare_companies_v1_financial_compare_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Data"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/financial/{ticker}/insider":{"get":{"summary":"Get Insider Trades Endpoint","description":"Get insider trading data for a ticker.","operationId":"get_insider_trades_endpoint_v1_financial__ticker__insider_get","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","title":"Ticker"}},{"name":"count","in":"query","required":false,"schema":{"type":"integer","default":10,"title":"Count"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/financial/{ticker}/filings":{"get":{"summary":"Get Filings Endpoint","description":"Get recent SEC filings for a ticker.","operationId":"get_filings_endpoint_v1_financial__ticker__filings_get","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","title":"Ticker"}},{"name":"count","in":"query","required":false,"schema":{"type":"integer","default":10,"title":"Count"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/financial/{ticker}/filings/search":{"get":{"summary":"Get Filing Search","description":"Search SEC filings by form type for a ticker.","operationId":"get_filing_search_v1_financial__ticker__filings_search_get","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","title":"Ticker"}},{"name":"form_types","in":"query","required":false,"schema":{"type":"string","default":"10-K,10-Q,8-K","title":"Form Types"}},{"name":"count","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Count"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/financial/{ticker}/vs-industry":{"get":{"summary":"Vs Industry","description":"Compare a company's financial metrics against its industry peers (same SIC code).\nUses only cached peer data — slow on first call for a SIC, fast after cache warms up.","operationId":"vs_industry_v1_financial__ticker__vs_industry_get","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","title":"Ticker"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/financial/{ticker}/trends":{"get":{"summary":"Get Historical Trends","description":"Get 6+ quarters of key financial metrics showing trajectory.","operationId":"get_historical_trends_v1_financial__ticker__trends_get","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","title":"Ticker"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/financial/{ticker}/profile":{"get":{"summary":"Get Profile","description":"Get company profile.","operationId":"get_profile_v1_financial__ticker__profile_get","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","title":"Ticker"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/financial/{ticker}/full":{"get":{"summary":"Get Full","description":"Get all financial data (500+ GAAP metrics).","operationId":"get_full_v1_financial__ticker__full_get","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","title":"Ticker"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/financial/screener":{"post":{"summary":"Stock Screener","description":"Screen stocks by financial criteria using cached fact data.","operationId":"stock_screener_v1_financial_screener_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Data"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/financial/batch":{"post":{"summary":"Multi Ticker Batch","description":"Fetch financial data for multiple tickers in one call.","operationId":"multi_ticker_batch_v1_financial_batch_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Data"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/financial/{ticker}/segments":{"get":{"summary":"Get Revenue Segments","description":"Get revenue breakdown by segment/product/geography for a company.","operationId":"get_revenue_segments_v1_financial__ticker__segments_get","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","title":"Ticker"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/financial/{ticker}/filing-types":{"get":{"summary":"Get Filing Types Summary","description":"Get a categorized summary of all filing types for a company.","operationId":"get_filing_types_summary_v1_financial__ticker__filing_types_get","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","title":"Ticker"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/financial/{ticker}/{statement}":{"get":{"summary":"Get Statement","description":"Get a specific financial statement (income-statement, balance-sheet, cash-flow).","operationId":"get_statement_v1_financial__ticker___statement__get","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","title":"Ticker"}},{"name":"statement","in":"path","required":true,"schema":{"type":"string","title":"Statement"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/econ/gdp":{"get":{"summary":"Get Gdp","description":"Get latest US GDP data.","operationId":"get_gdp_v1_econ_gdp_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/data/air-quality":{"get":{"summary":"Get Air Quality","description":"Get latest air quality data from OpenAQ (PM2.5, PM10, O3, NO2) for a location.\n\nFree source: OpenAQ v3 — key in /root/.openaq_api_key.\nFIX 2026-08-11 (WO 4b22e677): v3 free-tier `name` filter is IGNORED server-side\n(returned Ghana locations for 'Miami'); v2 API is retired. Robust path: geocode the\ncity via Nominatim (keyless, 1 req/s) -> coordinates+radius=25000 query -> real local\nstations. Falls back to the old name query if geocoding fails; never hard-fails on\nempty lookups.","operationId":"get_air_quality_v1_data_air_quality_get","parameters":[{"name":"location","in":"query","required":false,"schema":{"type":"string","description":"City name (e.g. Beijing, Los Angeles, London)","default":"Beijing","title":"Location"},"description":"City name (e.g. Beijing, Los Angeles, London)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/data/scholarly":{"get":{"summary":"Get Scholarly","description":"Search scholarly works via OpenAlex (keyless). Returns title, authors, year, citations.\n\nFree source: OpenAlex — 322M+ scholarly works. No key needed; mailto for polite pool.","operationId":"get_scholarly_v1_data_scholarly_get","parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string","description":"Search query for scholarly works","default":"artificial intelligence","title":"Query"},"description":"Search query for scholarly works"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/data/employment":{"get":{"summary":"Get Employment Bls","description":"Get BLS employment/labor series data (keyless v2 API).\n\nFree source: BLS Public API v2 — no key required (25 queries/day; registration only raises limits).\nDefault series LNS14000000 = civilian unemployment rate.","operationId":"get_employment_bls_v1_data_employment_get","parameters":[{"name":"series_id","in":"query","required":false,"schema":{"type":"string","description":"BLS series ID (default: unemployment rate)","default":"LNS14000000","title":"Series Id"},"description":"BLS series ID (default: unemployment rate)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/data/gdp-bea":{"get":{"summary":"Get Gdp Bea","description":"Get US GDP via BEA API.\n\nFree source: BEA (Bureau of Economic Analysis).\nNOTE: DEMO_KEY returned 'Invalid API UserId' (2026-08-10) — a real key\nrequires registration (CAPTCHA step, human). Endpoint reports the error\nhonestly instead of fabricating data.","operationId":"get_gdp_bea_v1_data_gdp_bea_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/data/sources":{"get":{"summary":"Get Data Sources","description":"Return the current status of all free data sources (deployable vs pending).","operationId":"get_data_sources_v1_data_sources_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/us-debt":{"get":{"summary":"Get Us Debt","description":"Get current U.S. national debt: total, public/intragov split, 30-day trend.\n\nSource: U.S. Treasury Fiscal Data (public domain, no key, updated daily).","operationId":"get_us_debt_v1_us_debt_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/us-debt/history":{"get":{"summary":"Get Us Debt History","description":"Get daily U.S. debt series (penny-level) over a date range.\n\nSource: U.S. Treasury Fiscal Data (public domain, no key).","operationId":"get_us_debt_history_v1_us_debt_history_get","parameters":[{"name":"from","in":"query","required":false,"schema":{"type":"string","description":"Start date YYYY-MM-DD","title":"From"},"description":"Start date YYYY-MM-DD"},{"name":"to","in":"query","required":false,"schema":{"type":"string","description":"End date YYYY-MM-DD","title":"To"},"description":"End date YYYY-MM-DD"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/treasury/interest-rates":{"get":{"summary":"Treasury Interest Rates","description":"US Treasury average interest rates by security type (T-bills, notes, bonds) and average yield curve rates.\nSource: US Treasury Fiscal Data API. Free, unrestricted, commercial use allowed.","operationId":"treasury_interest_rates_v1_treasury_interest_rates_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/treasury/statement":{"get":{"summary":"Get Treasury Statement","description":"Get the latest Monthly Treasury Statement: receipts, outlays, surplus/deficit.\n\nSource: U.S. Treasury Fiscal Data (public domain, no key).","operationId":"get_treasury_statement_v1_treasury_statement_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/treasury/auctions":{"get":{"summary":"Get Treasury Auctions","description":"Get recent completed Treasury auction results (yield, bid-to-cover, CUSIP).\n\nSource: U.S. Treasury Fiscal Data (public domain, no key).","operationId":"get_treasury_auctions_v1_treasury_auctions_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"description":"Number of recent auctions","default":10,"title":"Limit"},"description":"Number of recent auctions"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/fx/official":{"get":{"summary":"Get Fx Official","description":"Get official Treasury exchange rates (units of foreign currency per USD).\n\nComplements /v1/fx (Frankfurter). Source: Treasury Reporting Rates of Exchange.","operationId":"get_fx_official_v1_fx_official_get","parameters":[{"name":"currency","in":"query","required":false,"schema":{"type":"string","description":"ISO code (EUR, GBP, JPY) or currency name (Euro, Pound, Yen)","default":"EUR","title":"Currency"},"description":"ISO code (EUR, GBP, JPY) or currency name (Euro, Pound, Yen)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/treasury/gold":{"get":{"summary":"Get Treasury Gold","description":"Get U.S. gold reserve holdings (fine troy ounces + book value).\n\nSource: U.S. Treasury Fiscal Data (public domain, no key).","operationId":"get_treasury_gold_v1_treasury_gold_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/treasury/summary":{"get":{"summary":"Get Treasury Summary","description":"Get headline U.S. Treasury dashboard: debt, rates, statement, gold, EUR rate.\n\nSource: U.S. Treasury Fiscal Data (public domain, no key).","operationId":"get_treasury_summary_v1_treasury_summary_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/econ/inflation":{"get":{"summary":"Get Inflation","description":"Get latest CPI / inflation data.","operationId":"get_inflation_v1_econ_inflation_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/econ/rates":{"get":{"summary":"Get Rates","description":"Get latest Fed funds rate, mortgage rates, and treasury yields.","operationId":"get_rates_v1_econ_rates_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/econ/employment":{"get":{"summary":"Get Employment","description":"Get latest unemployment rate and jobless claims.","operationId":"get_employment_v1_econ_employment_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/econ/housing":{"get":{"summary":"Get Housing","description":"Get latest housing starts and existing home sales data.","operationId":"get_housing_v1_econ_housing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/econ/summary":{"get":{"summary":"Get Econ Summary","description":"Get all key economic indicators in one call.","operationId":"get_econ_summary_v1_econ_summary_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/demo/zip/{zip_code}":{"get":{"summary":"Get Zip Demographics","description":"Get demographics for a ZIP code (population, income, age, housing, education).","operationId":"get_zip_demographics_v1_demo_zip__zip_code__get","parameters":[{"name":"zip_code","in":"path","required":true,"schema":{"type":"string","title":"Zip Code"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/demo/county/{fips}":{"get":{"summary":"Get County Demographics","description":"Get county-level demographics data by FIPS code.","operationId":"get_county_demographics_v1_demo_county__fips__get","parameters":[{"name":"fips","in":"path","required":true,"schema":{"type":"string","title":"Fips"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/worldbank/countries":{"get":{"summary":"Wb List Countries","description":"Get list of all available World Bank country codes and names.","operationId":"wb_list_countries_v1_worldbank_countries_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/worldbank/summary":{"get":{"summary":"Wb Summary","description":"Get a summary of key economic indicators for multiple countries (up to 10).","operationId":"wb_summary_v1_worldbank_summary_get","parameters":[{"name":"countries","in":"query","required":false,"schema":{"type":"string","description":"Comma-separated ISO country codes","default":"USA,CAN,GBR,DEU,JPN,CHN,IND,BRA,AUS","title":"Countries"},"description":"Comma-separated ISO country codes"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/worldbank/{country_code}":{"get":{"summary":"Wb Country Economics","description":"Get key economic indicators for a specific country from the World Bank.\nReturns GDP, GDP growth, GDP per capita, population, inflation, unemployment, and more.","operationId":"wb_country_economics_v1_worldbank__country_code__get","parameters":[{"name":"country_code","in":"path","required":true,"schema":{"type":"string","title":"Country Code"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/worldbank/{country_code}/{indicator_key}":{"get":{"summary":"Wb Specific Indicator","description":"Get a specific World Bank indicator for a country.\nArgs:\n    country_code: ISO 3166-1 alpha-3 country code (e.g., USA, CHN, GBR)\n    indicator_key: One of: gdp, gdp_growth, gdp_per_capita, gdp_per_capita_growth, population, population_growth, inflation_cpi, unemployment, exports, imports, fdi, poverty, life_expectancy, education_expenditure\n    years: Number of years of historical data (default: 10, max: 50)","operationId":"wb_specific_indicator_v1_worldbank__country_code___indicator_key__get","parameters":[{"name":"country_code","in":"path","required":true,"schema":{"type":"string","title":"Country Code"}},{"name":"indicator_key","in":"path","required":true,"schema":{"type":"string","title":"Indicator Key"}},{"name":"years","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":10,"title":"Years"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/nonprofits/{ein}":{"get":{"summary":"Nonprofit 990 Lookup","description":"Get IRS Form 990 financial data for a nonprofit by EIN.\nReturns org profile plus revenue, expenses, assets, liabilities, and\nofficer compensation from the latest available 990/990-EZ/990-PF filing.","operationId":"nonprofit_990_lookup_v1_nonprofits__ein__get","parameters":[{"name":"ein","in":"path","required":true,"schema":{"type":"string","title":"Ein"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/fx/rates":{"get":{"summary":"Fx Rates","description":"Get current or historical exchange rates. Source: Frankfurter (84 central banks, 201 currencies).\nNo API key required. Free for commercial use.\nArgs:\n    base: Base currency code (default: EUR)\n    quotes: Optional comma-separated list of target currencies\n    date: Optional date in YYYY-MM-DD format for historical rates","operationId":"fx_rates_v1_fx_rates_get","parameters":[{"name":"base","in":"query","required":false,"schema":{"type":"string","description":"Base currency code (e.g., USD, EUR, GBP)","default":"EUR","title":"Base"},"description":"Base currency code (e.g., USD, EUR, GBP)"},{"name":"quotes","in":"query","required":false,"schema":{"type":"string","description":"Comma-separated target currencies to filter (e.g., USD,EUR,GBP)","title":"Quotes"},"description":"Comma-separated target currencies to filter (e.g., USD,EUR,GBP)"},{"name":"date","in":"query","required":false,"schema":{"type":"string","description":"Date for historical rates in YYYY-MM-DD format (default: latest)","title":"Date"},"description":"Date for historical rates in YYYY-MM-DD format (default: latest)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/fx/rate/{from_currency}/{to_currency}":{"get":{"summary":"Fx Pair Rate","description":"Get the exchange rate between two currencies. Source: Frankfurter.\nNo API key required. Free for commercial use.\nArgs:\n    from_currency: Source currency code (e.g., USD)\n    to_currency: Target currency code (e.g., EUR)\n    date: Optional date for historical rate","operationId":"fx_pair_rate_v1_fx_rate__from_currency___to_currency__get","parameters":[{"name":"from_currency","in":"path","required":true,"schema":{"type":"string","title":"From Currency"}},{"name":"to_currency","in":"path","required":true,"schema":{"type":"string","title":"To Currency"}},{"name":"date","in":"query","required":false,"schema":{"type":"string","description":"Date in YYYY-MM-DD format (default: latest)","title":"Date"},"description":"Date in YYYY-MM-DD format (default: latest)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/fx/convert":{"get":{"summary":"Fx Convert","description":"Convert an amount from one currency to another. Source: Frankfurter.\nNo API key required. Free for commercial use.\nArgs:\n    from_currency: Source currency code (e.g., USD)\n    to_currency: Target currency code (e.g., EUR)\n    amount: Amount to convert (default: 1.0)\n    date: Optional date for historical conversion","operationId":"fx_convert_v1_fx_convert_get","parameters":[{"name":"from_currency","in":"query","required":false,"schema":{"type":"string","description":"Source currency code","default":"USD","title":"From Currency"},"description":"Source currency code"},{"name":"to_currency","in":"query","required":false,"schema":{"type":"string","description":"Target currency code","default":"EUR","title":"To Currency"},"description":"Target currency code"},{"name":"amount","in":"query","required":false,"schema":{"type":"number","description":"Amount to convert","default":1.0,"title":"Amount"},"description":"Amount to convert"},{"name":"date","in":"query","required":false,"schema":{"type":"string","description":"Date for historical rate in YYYY-MM-DD format","title":"Date"},"description":"Date for historical rate in YYYY-MM-DD format"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/fx/currencies":{"get":{"summary":"Fx Currencies","description":"Get list of all available currencies with names.\nSource: Frankfurter (European Central Bank + 84 central banks, 201 currencies).\nNo API key required. Free for commercial use.","operationId":"fx_currencies_v1_fx_currencies_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/treasury/debt":{"get":{"summary":"Treasury Debt","description":"US federal debt to the penny — total public debt outstanding, debt held by the public, intragovernmental holdings.\nSource: US Treasury Fiscal Data API. Free, unrestricted, commercial use allowed.","operationId":"treasury_debt_v1_treasury_debt_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/treasury/fx-rates":{"get":{"summary":"Treasury Fx Rates","description":"Official US Treasury reporting rates of exchange — daily official FX rates for 100+ currencies.\nSource: US Treasury Fiscal Data API. Free, unrestricted, commercial use allowed.","operationId":"treasury_fx_rates_v1_treasury_fx_rates_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/eurostat/gdp":{"get":{"summary":"Eurostat Gdp","description":"Eurostat GDP and main components (annual, current prices, million EUR) for EU countries.\nSource: Eurostat dissemination API. Free of charge, commercial use with attribution.","operationId":"eurostat_gdp_v1_eurostat_gdp_get","parameters":[{"name":"geo","in":"query","required":false,"schema":{"type":"string","description":"EU geo code (e.g. DE, FR, IT, EU27_2020, EA20)","default":"DE","title":"Geo"},"description":"EU geo code (e.g. DE, FR, IT, EU27_2020, EA20)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/eurostat/inflation":{"get":{"summary":"Eurostat Inflation","description":"Eurostat HICP inflation — annual rate of change (%) for EU countries.\nSource: Eurostat dissemination API (prc_hicp_manr). Free of charge, commercial use with attribution.","operationId":"eurostat_inflation_v1_eurostat_inflation_get","parameters":[{"name":"geo","in":"query","required":false,"schema":{"type":"string","description":"EU geo code (e.g. DE, FR, IT, EU27_2020, EA20)","default":"DE","title":"Geo"},"description":"EU geo code (e.g. DE, FR, IT, EU27_2020, EA20)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/eurostat/unemployment":{"get":{"summary":"Eurostat Unemployment","description":"Eurostat unemployment rate (%) — monthly, total age 15-74, both sexes.\nSource: Eurostat dissemination API (une_rt_m). Free of charge, commercial use with attribution.","operationId":"eurostat_unemployment_v1_eurostat_unemployment_get","parameters":[{"name":"geo","in":"query","required":false,"schema":{"type":"string","description":"EU geo code (e.g. DE, FR, IT, EU27_2020, EA20)","default":"DE","title":"Geo"},"description":"EU geo code (e.g. DE, FR, IT, EU27_2020, EA20)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/oecd/leading-indicators":{"get":{"summary":"Oecd Leading Indicators","description":"OECD Composite Leading Indicators (CLI) — amplitude-adjusted, for G20/OECD countries.\nSource: OECD Data Explorer (SDMX). Openly reusable with attribution. No key required.","operationId":"oecd_leading_indicators_v1_oecd_leading_indicators_get","parameters":[{"name":"country","in":"query","required":false,"schema":{"type":"string","description":"OECD country code (e.g. USA, DEU, JPN, GBR). See /v1/oecd/countries","default":"USA","title":"Country"},"description":"OECD country code (e.g. USA, DEU, JPN, GBR). See /v1/oecd/countries"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/oecd/countries":{"get":{"summary":"Oecd Countries","description":"List OECD country codes available for leading-indicator queries.","operationId":"oecd_countries_v1_oecd_countries_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/nws/forecast":{"get":{"summary":"Nws Forecast","description":"Official NWS weather forecast for a latitude/longitude — period forecasts for next 7 days.\nSource: NOAA National Weather Service API. Free for any purpose. Requires descriptive User-Agent.","operationId":"nws_forecast_v1_nws_forecast_get","parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number","description":"Latitude (e.g. 39.7456)","title":"Lat"},"description":"Latitude (e.g. 39.7456)"},{"name":"lon","in":"query","required":true,"schema":{"type":"number","description":"Longitude (e.g. -97.0892)","title":"Lon"},"description":"Longitude (e.g. -97.0892)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/nws/alerts":{"get":{"summary":"Nws Alerts","description":"Active NWS weather alerts for a US state (CAP format) — watches, warnings, advisories.\nSource: NOAA National Weather Service API. Free for any purpose.","operationId":"nws_alerts_v1_nws_alerts_get","parameters":[{"name":"state","in":"query","required":true,"schema":{"type":"string","description":"Two-letter US state code (e.g. FL, CA, TX)","title":"State"},"description":"Two-letter US state code (e.g. FL, CA, TX)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/fda/drug-labels":{"get":{"summary":"Fda Drug Labels","description":"Search FDA drug labels by brand/generic name or ingredient.\nSource: openFDA (public-domain US FDA data). Keyless up to 1000 req/day.\nDisclaimer: openFDA data is not validated for clinical or production use.","operationId":"fda_drug_labels_v1_fda_drug_labels_get","parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string","description":"Search query (e.g. aspirin, brand name, ingredient)","title":"Query"},"description":"Search query (e.g. aspirin, brand name, ingredient)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":5,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/fda/recalls":{"get":{"summary":"Fda Recalls","description":"Recent FDA drug/food enforcement recalls.\nSource: openFDA (public-domain US FDA data). Keyless up to 1000 req/day.","operationId":"fda_recalls_v1_fda_recalls_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":5,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/health/drug/search":{"get":{"summary":"Health Drug Search","description":"Search FDA drug labels by brand/generic name or ingredient. Returns a compact list.\nSource: openFDA drug/label (U.S. FDA).","operationId":"health_drug_search_v1_health_drug_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","description":"Search query — brand name, generic name, or ingredient","title":"Q"},"description":"Search query — brand name, generic name, or ingredient"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":5,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/health/drug/{identifier}":{"get":{"summary":"Health Drug Lookup","description":"Look up an FDA drug label by NDC or brand/generic name.\nReturns active ingredients, purpose, indications, warnings, dosage, and manufacturer.\nSource: openFDA drug/label (U.S. FDA).","operationId":"health_drug_lookup_v1_health_drug__identifier__get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"type","in":"query","required":false,"schema":{"type":"string","description":"Interpretation: auto (NDC if numeric, else name), ndc, name","default":"auto","title":"Type"},"description":"Interpretation: auto (NDC if numeric, else name), ndc, name"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/health/adverse-events":{"get":{"summary":"Health Adverse Events","description":"FAERS adverse event reports for a drug (by brand/generic name or NDC).\nSource: openFDA FAERS (U.S. FDA).","operationId":"health_adverse_events_v1_health_adverse_events_get","parameters":[{"name":"drug","in":"query","required":false,"schema":{"type":"string","description":"Drug brand or generic name","title":"Drug"},"description":"Drug brand or generic name"},{"name":"ndc","in":"query","required":false,"schema":{"type":"string","description":"NDC code","title":"Ndc"},"description":"NDC code"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":5,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/health/recalls":{"get":{"summary":"Health Recalls","description":"FDA enforcement recalls (drugs, devices, food) — by product keyword, company, or most recent.\nSource: openFDA drug/enforcement (U.S. FDA).","operationId":"health_recalls_v1_health_recalls_get","parameters":[{"name":"product","in":"query","required":false,"schema":{"type":"string","description":"Product description or keyword","title":"Product"},"description":"Product description or keyword"},{"name":"company","in":"query","required":false,"schema":{"type":"string","description":"Recalling firm name","title":"Company"},"description":"Recalling firm name"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":5,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/health/device/{k_number}":{"get":{"summary":"Health Device 510K","description":"Look up an FDA 510(k) premarket device clearance by K number (e.g. K123456).\nSource: openFDA device/510k (U.S. FDA).","operationId":"health_device_510k_v1_health_device__k_number__get","parameters":[{"name":"k_number","in":"path","required":true,"schema":{"type":"string","title":"K Number"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/health/summary":{"get":{"summary":"Health Summary","description":"Health data API summary — endpoint list plus live sample data showing the API is working.\nSource: openFDA (U.S. FDA).","operationId":"health_summary_v1_health_summary_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/uk-company/search":{"get":{"summary":"Uk Company Search","description":"Search UK companies by name or number. Source: Companies House (UK), OGL v3.0.","operationId":"uk_company_search_v1_uk_company_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","description":"Company name or number search term","title":"Q"},"description":"Company name or number search term"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/uk-company/officers/search":{"get":{"summary":"Uk Officer Search","description":"Search UK company officers (directors) by name. Source: Companies House (UK), OGL v3.0.","operationId":"uk_officer_search_v1_uk_company_officers_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","description":"Officer name search term","title":"Q"},"description":"Officer name search term"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/uk-company/{number}":{"get":{"summary":"Uk Company Profile","description":"UK company profile: status, type, incorporation date, registered address, SIC codes.\nSource: Companies House (UK), OGL v3.0. Attribution required on downstream use.","operationId":"uk_company_profile_v1_uk_company__number__get","parameters":[{"name":"number","in":"path","required":true,"schema":{"type":"string","title":"Number"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/uk-company/{number}/officers":{"get":{"summary":"Uk Company Officers","description":"UK company directors and appointments (active first). Source: Companies House (UK).","operationId":"uk_company_officers_v1_uk_company__number__officers_get","parameters":[{"name":"number","in":"path","required":true,"schema":{"type":"string","title":"Number"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/uk-company/{number}/ownership":{"get":{"summary":"Uk Company Ownership","description":"Persons with Significant Control (beneficial owners, % control) for a UK company.\nKYB/due-diligence lane. Source: Companies House (UK).","operationId":"uk_company_ownership_v1_uk_company__number__ownership_get","parameters":[{"name":"number","in":"path","required":true,"schema":{"type":"string","title":"Number"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/uk-company/{number}/charges":{"get":{"summary":"Uk Company Charges","description":"Registered charges (mortgages/debentures) for a UK company. Source: Companies House (UK).","operationId":"uk_company_charges_v1_uk_company__number__charges_get","parameters":[{"name":"number","in":"path","required":true,"schema":{"type":"string","title":"Number"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/uk-company/{number}/filings":{"get":{"summary":"Uk Company Filings","description":"Filing history summary for a UK company (most recent first). Source: Companies House (UK).","operationId":"uk_company_filings_v1_uk_company__number__filings_get","parameters":[{"name":"number","in":"path","required":true,"schema":{"type":"string","title":"Number"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/uk-company/{number}/health":{"get":{"summary":"Uk Company Health","description":"Derived 'company health' grade (A-E) for a UK company from status, charges, and filing signals.\nDifferentiator vs raw register. Source: Companies House (UK) — heuristic, not financial advice.","operationId":"uk_company_health_v1_uk_company__number__health_get","parameters":[{"name":"number","in":"path","required":true,"schema":{"type":"string","title":"Number"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/datausa/population":{"get":{"summary":"Datausa Population","description":"US population by geography (Nation/State/County/Place) from the Data USA API.\nSource: Data USA (curated Census ACS data). No key, no published rate limits.","operationId":"datausa_population_v1_datausa_population_get","parameters":[{"name":"level","in":"query","required":false,"schema":{"type":"string","description":"Geography level: Nation, State, County, Place","default":"State","title":"Level"},"description":"Geography level: Nation, State, County, Place"},{"name":"year","in":"query","required":false,"schema":{"type":"integer","maximum":2026,"minimum":2010,"default":2023,"title":"Year"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/datausa/income":{"get":{"summary":"Datausa Income","description":"US median household income by geography from the Data USA API.\nSource: Data USA (curated Census ACS data). No key, no published rate limits.","operationId":"datausa_income_v1_datausa_income_get","parameters":[{"name":"level","in":"query","required":false,"schema":{"type":"string","description":"Geography level: Nation, State, County, Place","default":"State","title":"Level"},"description":"Geography level: Nation, State, County, Place"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/usgs/earthquakes":{"get":{"summary":"Usgs Earthquakes","description":"Recent earthquakes worldwide with magnitude, location, and depth.\nSource: USGS FDSN Event Web Service. Public-domain data, unlimited, no key.","operationId":"usgs_earthquakes_v1_usgs_earthquakes_get","parameters":[{"name":"minmagnitude","in":"query","required":false,"schema":{"type":"number","maximum":10,"minimum":-1,"default":0,"title":"Minmagnitude"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":30,"minimum":1,"default":7,"title":"Days"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/usaspending/budget":{"get":{"summary":"Usaspending Budget","description":"Total federal budgetary resources (US government spending authority) by fiscal period.\nSource: USAspending.gov API. US government open data, no key.","operationId":"usaspending_budget_v1_usaspending_budget_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/usaspending/awards":{"get":{"summary":"Usaspending Awards","description":"Search federal contract/grant awards by keyword — award ID, recipient, amount.\nSource: USAspending.gov API. US government open data, no key.","operationId":"usaspending_awards_v1_usaspending_awards_get","parameters":[{"name":"keyword","in":"query","required":true,"schema":{"type":"string","description":"Keyword to search federal awards (e.g. cybersecurity, road construction)","title":"Keyword"},"description":"Keyword to search federal awards (e.g. cybersecurity, road construction)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":25,"minimum":1,"default":5,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/imf/indicator/{indicator}":{"get":{"summary":"Imf Indicator","description":"IMF World Economic Outlook indicator for a country (GDP growth, inflation, unemployment, debt, etc.).\nSource: IMF DataMapper API (WEO). Free to use/redistribute with attribution. No key.","operationId":"imf_indicator_v1_imf_indicator__indicator__get","parameters":[{"name":"indicator","in":"path","required":true,"schema":{"type":"string","title":"Indicator"}},{"name":"country","in":"query","required":false,"schema":{"type":"string","description":"ISO country code (e.g. USA, GBR, CHN, JPN, DEU)","default":"USA","title":"Country"},"description":"ISO country code (e.g. USA, GBR, CHN, JPN, DEU)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/imf/indicators":{"get":{"summary":"Imf Indicators","description":"List available IMF WEO indicators.","operationId":"imf_indicators_v1_imf_indicators_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/edgar/search":{"get":{"summary":"Edgar Fulltext Search","description":"Full-text search across SEC EDGAR filings (EFTS) — find filings mentioning a keyword/phrase.\nSource: SEC EDGAR full-text search (efts.sec.gov). Public-domain data, no key (descriptive User-Agent required).\nThis EXTENDS the existing slacking.biz SEC integration with cross-company filing search.","operationId":"edgar_fulltext_search_v1_edgar_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","description":"Full-text search query (e.g. 'artificial intelligence', ticker + keyword)","title":"Q"},"description":"Full-text search query (e.g. 'artificial intelligence', ticker + keyword)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/stats":{"get":{"summary":"Get Api Stats","description":"Get API usage statistics — total calls, by endpoint, daily breakdown.","operationId":"get_api_stats_v1_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/stats/reset":{"post":{"summary":"Reset Stats","description":"Reset usage stats (admin only).","operationId":"reset_stats_v1_stats_reset_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/alerts/watchlist":{"get":{"summary":"Get Watchlist","description":"List the caller's watchlist tickers.","operationId":"get_watchlist_v1_alerts_watchlist_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"summary":"Add Watchlist Ticker","description":"Add a ticker to the caller's watchlist. Body: {\"ticker\": \"AAPL\", \"webhook_url\": \"https://...\"}","operationId":"add_watchlist_ticker_v1_alerts_watchlist_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Data"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"summary":"Remove Watchlist Ticker","description":"Remove a ticker from the caller's watchlist. Body: {\"ticker\": \"AAPL\"}","operationId":"remove_watchlist_ticker_v1_alerts_watchlist_delete","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Data"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/alerts/status":{"get":{"summary":"Alerts Status","description":"Return alert plan status: plan, watchlist usage, delivery config.","operationId":"alerts_status_v1_alerts_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/create-checkout-session":{"post":{"summary":"Create Checkout Session","description":"Create a Stripe checkout session for plan upgrade.","operationId":"create_checkout_session_create_checkout_session_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Data"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/stripe-webhook":{"post":{"summary":"Stripe Webhook","description":"Handle Stripe webhook events (checkout.completed, invoice.paid, etc.).","operationId":"stripe_webhook_stripe_webhook_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}