{"x-answerpool":{"service":"AnswerPool","base_url":"https://answerpool.io","how_to_call":"GET {base_url}{path}?<arguments as a query string>; the path for each tool is in `endpoints`. Responses are strict JSON with provenance and a refresh_after time.","auth_header":"Authorization: Bearer <credit key>","get_a_key":"https://answerpool.io/v1/credits/checkout?pack=micro","x402":"Or pay per request: call without a key, receive 402 with the price, retry signed.","docs":"https://answerpool.io/llms.txt","catalog":"https://answerpool.io/v1/catalog","note":"Generated from the AnswerPool catalog. Every tool is one GET request: send the arguments as the query string on the endpoint listed in x-answerpool.endpoints. Free tools need no key; paid ones take a prepaid credit key as a bearer token, or x402 (USDC on Base) if you pay per request.","endpoints":{"sec_company":{"method":"GET","path":"/v1/sec/company","price_usd":0.02,"sample_url":"https://answerpool.io/v1/samples/sec_company","page":"https://answerpool.io/p/sec_company"},"funding_signals":{"method":"GET","path":"/v1/funding/signals","price_usd":0.02,"sample_url":"https://answerpool.io/v1/samples/funding_signals","page":"https://answerpool.io/p/funding_signals"},"technology_momentum":{"method":"GET","path":"/v1/technology/momentum","price_usd":0.05,"sample_url":"https://answerpool.io/v1/samples/technology_momentum","page":"https://answerpool.io/p/technology_momentum"},"technology_emerging":{"method":"GET","path":"/v1/technology/emerging","price_usd":0.05,"sample_url":"https://answerpool.io/v1/samples/technology_emerging","page":"https://answerpool.io/p/technology_emerging"},"technology_lookup":{"method":"GET","path":"/v1/technology/lookup","price_usd":0.0,"sample_url":"https://answerpool.io/v1/samples/technology_lookup","page":"https://answerpool.io/p/technology_lookup"},"entity_resolve":{"method":"GET","path":"/v1/entity/resolve","price_usd":0.0,"sample_url":"https://answerpool.io/v1/samples/entity_resolve","page":"https://answerpool.io/p/entity_resolve"},"funding_naics_lookup":{"method":"GET","path":"/v1/funding/naics","price_usd":0.0,"sample_url":"https://answerpool.io/v1/samples/funding_naics_lookup","page":"https://answerpool.io/p/funding_naics_lookup"},"funding_program_lookup":{"method":"GET","path":"/v1/funding/programs","price_usd":0.0,"sample_url":"https://answerpool.io/v1/samples/funding_program_lookup","page":"https://answerpool.io/p/funding_program_lookup"},"funding_psc_lookup":{"method":"GET","path":"/v1/funding/psc","price_usd":0.0,"sample_url":"https://answerpool.io/v1/samples/funding_psc_lookup","page":"https://answerpool.io/p/funding_psc_lookup"},"funding_recipient_lookup":{"method":"GET","path":"/v1/funding/recipients","price_usd":0.0,"sample_url":"https://answerpool.io/v1/samples/funding_recipient_lookup","page":"https://answerpool.io/p/funding_recipient_lookup"},"funding_resolve":{"method":"GET","path":"/v1/funding/resolve","price_usd":0.0,"sample_url":"https://answerpool.io/v1/samples/funding_resolve","page":"https://answerpool.io/p/funding_resolve"},"graph_auditor_clients":{"method":"GET","path":"/v1/graph/auditor","price_usd":0.02,"sample_url":"https://answerpool.io/v1/samples/graph_auditor_clients","page":"https://answerpool.io/p/graph_auditor_clients"},"graph_interlocks":{"method":"GET","path":"/v1/graph/interlocks","price_usd":0.05,"sample_url":"https://answerpool.io/v1/samples/graph_interlocks","page":"https://answerpool.io/p/graph_interlocks"},"graph_person":{"method":"GET","path":"/v1/graph/person","price_usd":0.02,"sample_url":"https://answerpool.io/v1/samples/graph_person","page":"https://answerpool.io/p/graph_person"},"graph_subsidiaries":{"method":"GET","path":"/v1/graph/subsidiaries","price_usd":0.05,"sample_url":"https://answerpool.io/v1/samples/graph_subsidiaries","page":"https://answerpool.io/p/graph_subsidiaries"},"impact_cfr_citers":{"method":"GET","path":"/v1/impact/cfr","price_usd":0.02,"sample_url":"https://answerpool.io/v1/samples/impact_cfr_citers","page":"https://answerpool.io/p/impact_cfr_citers"},"impact_company_rules":{"method":"GET","path":"/v1/impact/company","price_usd":0.05,"sample_url":"https://answerpool.io/v1/samples/impact_company_rules","page":"https://answerpool.io/p/impact_company_rules"},"impact_docket_citers":{"method":"GET","path":"/v1/impact/docket","price_usd":0.02,"sample_url":"https://answerpool.io/v1/samples/impact_docket_citers","page":"https://answerpool.io/p/impact_docket_citers"},"impact_rule_companies":{"method":"GET","path":"/v1/impact/rule","price_usd":0.05,"sample_url":"https://answerpool.io/v1/samples/impact_rule_companies","page":"https://answerpool.io/p/impact_rule_companies"},"ipo_calendar":{"method":"GET","path":"/v1/ipo/calendar","price_usd":0.05,"sample_url":"https://answerpool.io/v1/samples/ipo_calendar","page":"https://answerpool.io/p/ipo_calendar"},"ipo_company":{"method":"GET","path":"/v1/ipo/company","price_usd":0.05,"sample_url":"https://answerpool.io/v1/samples/ipo_company","page":"https://answerpool.io/p/ipo_company"},"ipo_new_registrations":{"method":"GET","path":"/v1/ipo/registrations","price_usd":0.02,"sample_url":"https://answerpool.io/v1/samples/ipo_new_registrations","page":"https://answerpool.io/p/ipo_new_registrations"},"ipo_priced":{"method":"GET","path":"/v1/ipo/priced","price_usd":0.02,"sample_url":"https://answerpool.io/v1/samples/ipo_priced","page":"https://answerpool.io/p/ipo_priced"},"ipo_withdrawn":{"method":"GET","path":"/v1/ipo/withdrawn","price_usd":0.02,"sample_url":"https://answerpool.io/v1/samples/ipo_withdrawn","page":"https://answerpool.io/p/ipo_withdrawn"},"nih_institute_lookup":{"method":"GET","path":"/v1/nih/institutes","price_usd":0.0,"sample_url":"https://answerpool.io/v1/samples/nih_institute_lookup","page":"https://answerpool.io/p/nih_institute_lookup"},"peers_industry":{"method":"GET","path":"/v1/peers/industry","price_usd":0.02,"sample_url":"https://answerpool.io/v1/samples/peers_industry","page":"https://answerpool.io/p/peers_industry"},"peers_percentile":{"method":"GET","path":"/v1/peers/percentile","price_usd":0.05,"sample_url":"https://answerpool.io/v1/samples/peers_percentile","page":"https://answerpool.io/p/peers_percentile"},"peers_similar":{"method":"GET","path":"/v1/peers/similar","price_usd":0.05,"sample_url":"https://answerpool.io/v1/samples/peers_similar","page":"https://answerpool.io/p/peers_similar"},"reg_agency_lookup":{"method":"GET","path":"/v1/regs/agencies","price_usd":0.0,"sample_url":"https://answerpool.io/v1/samples/reg_agency_lookup","page":"https://answerpool.io/p/reg_agency_lookup"},"reg_cfr_watch":{"method":"GET","path":"/v1/regs/cfr","price_usd":0.02,"sample_url":"https://answerpool.io/v1/samples/reg_cfr_watch","page":"https://answerpool.io/p/reg_cfr_watch"},"reg_comment_deadlines":{"method":"GET","path":"/v1/regs/comment-deadlines","price_usd":0.02,"sample_url":"https://answerpool.io/v1/samples/reg_comment_deadlines","page":"https://answerpool.io/p/reg_comment_deadlines"},"reg_daily_digest":{"method":"GET","path":"/v1/regs/digest","price_usd":0.02,"sample_url":"https://answerpool.io/v1/samples/reg_daily_digest","page":"https://answerpool.io/p/reg_daily_digest"},"reg_effective_soon":{"method":"GET","path":"/v1/regs/effective","price_usd":0.02,"sample_url":"https://answerpool.io/v1/samples/reg_effective_soon","page":"https://answerpool.io/p/reg_effective_soon"},"reg_resolve":{"method":"GET","path":"/v1/regs/resolve","price_usd":0.0,"sample_url":"https://answerpool.io/v1/samples/reg_resolve","page":"https://answerpool.io/p/reg_resolve"},"reg_significant_rules":{"method":"GET","path":"/v1/regs/significant","price_usd":0.02,"sample_url":"https://answerpool.io/v1/samples/reg_significant_rules","page":"https://answerpool.io/p/reg_significant_rules"},"sec_13f_crowding":{"method":"GET","path":"/v1/sec/13f/crowding","price_usd":0.05,"sample_url":"https://answerpool.io/v1/samples/sec_13f_crowding","page":"https://answerpool.io/p/sec_13f_crowding"},"sec_13f_holders":{"method":"GET","path":"/v1/sec/13f/holders","price_usd":0.02,"sample_url":"https://answerpool.io/v1/samples/sec_13f_holders","page":"https://answerpool.io/p/sec_13f_holders"},"sec_13f_manager":{"method":"GET","path":"/v1/sec/13f/manager","price_usd":0.02,"sample_url":"https://answerpool.io/v1/samples/sec_13f_manager","page":"https://answerpool.io/p/sec_13f_manager"},"sec_13f_manager_changes":{"method":"GET","path":"/v1/sec/13f/changes","price_usd":0.05,"sample_url":"https://answerpool.io/v1/samples/sec_13f_manager_changes","page":"https://answerpool.io/p/sec_13f_manager_changes"},"sec_8k_auditor_change":{"method":"GET","path":"/v1/sec/8k/auditor-change","price_usd":0.02,"sample_url":"https://answerpool.io/v1/samples/sec_8k_auditor_change","page":"https://answerpool.io/p/sec_8k_auditor_change"},"sec_8k_bankruptcy":{"method":"GET","path":"/v1/sec/8k/bankruptcy","price_usd":0.02,"sample_url":"https://answerpool.io/v1/samples/sec_8k_bankruptcy","page":"https://answerpool.io/p/sec_8k_bankruptcy"},"sec_8k_changes":{"method":"GET","path":"/v1/sec/8k/changes","price_usd":0.005,"sample_url":"https://answerpool.io/v1/samples/sec_8k_changes","page":"https://answerpool.io/p/sec_8k_changes"},"sec_8k_cyber_incident":{"method":"GET","path":"/v1/sec/8k/cyber","price_usd":0.02,"sample_url":"https://answerpool.io/v1/samples/sec_8k_cyber_incident","page":"https://answerpool.io/p/sec_8k_cyber_incident"},"sec_8k_delisting":{"method":"GET","path":"/v1/sec/8k/delisting","price_usd":0.02,"sample_url":"https://answerpool.io/v1/samples/sec_8k_delisting","page":"https://answerpool.io/p/sec_8k_delisting"},"sec_8k_impairment":{"method":"GET","path":"/v1/sec/8k/impairment","price_usd":0.02,"sample_url":"https://answerpool.io/v1/samples/sec_8k_impairment","page":"https://answerpool.io/p/sec_8k_impairment"},"sec_8k_items_history":{"method":"GET","path":"/v1/sec/8k/history","price_usd":0.02,"sample_url":"https://answerpool.io/v1/samples/sec_8k_items_history","page":"https://answerpool.io/p/sec_8k_items_history"},"sec_8k_ma_events":{"method":"GET","path":"/v1/sec/8k/ma","price_usd":0.02,"sample_url":"https://answerpool.io/v1/samples/sec_8k_ma_events","page":"https://answerpool.io/p/sec_8k_ma_events"},"sec_8k_non_reliance":{"method":"GET","path":"/v1/sec/8k/restatement","price_usd":0.02,"sample_url":"https://answerpool.io/v1/samples/sec_8k_non_reliance","page":"https://answerpool.io/p/sec_8k_non_reliance"},"sec_8k_officer_change":{"method":"GET","path":"/v1/sec/8k/officer-change","price_usd":0.02,"sample_url":"https://answerpool.io/v1/samples/sec_8k_officer_change","page":"https://answerpool.io/p/sec_8k_officer_change"},"sec_busiest_filers":{"method":"GET","path":"/v1/sec/filings/top","price_usd":0.02,"sample_url":"https://answerpool.io/v1/samples/sec_busiest_filers","page":"https://answerpool.io/p/sec_busiest_filers"},"sec_cik_lookup":{"method":"GET","path":"/v1/sec/cik","price_usd":0.0,"sample_url":"https://answerpool.io/v1/samples/sec_cik_lookup","page":"https://answerpool.io/p/sec_cik_lookup"},"sec_companies_by_sic":{"method":"GET","path":"/v1/sec/companies-by-sic","price_usd":0.0,"sample_url":"https://answerpool.io/v1/samples/sec_companies_by_sic","page":"https://answerpool.io/p/sec_companies_by_sic"},"sec_company_search":{"method":"GET","path":"/v1/sec/search/company","price_usd":0.0,"sample_url":"https://answerpool.io/v1/samples/sec_company_search","page":"https://answerpool.io/p/sec_company_search"},"sec_crosswalk":{"method":"GET","path":"/v1/sec/crosswalk","price_usd":0.0,"sample_url":"https://answerpool.io/v1/samples/sec_crosswalk","page":"https://answerpool.io/p/sec_crosswalk"},"sec_distress_screen":{"method":"GET","path":"/v1/sec/screen/distress","price_usd":0.05,"sample_url":"https://answerpool.io/v1/samples/sec_distress_screen","page":"https://answerpool.io/p/sec_distress_screen"},"sec_earnings_changes":{"method":"GET","path":"/v1/sec/earnings/changes","price_usd":0.005,"sample_url":"https://answerpool.io/v1/samples/sec_earnings_changes","page":"https://answerpool.io/p/sec_earnings_changes"},"sec_earnings_latest":{"method":"GET","path":"/v1/sec/earnings/latest","price_usd":0.02,"sample_url":"https://answerpool.io/v1/samples/sec_earnings_latest","page":"https://answerpool.io/p/sec_earnings_latest"},"sec_earnings_recent":{"method":"GET","path":"/v1/sec/earnings/recent","price_usd":0.02,"sample_url":"https://answerpool.io/v1/samples/sec_earnings_recent","page":"https://answerpool.io/p/sec_earnings_recent"},"sec_entity_profile":{"method":"GET","path":"/v1/sec/entity","price_usd":0.0,"sample_url":"https://answerpool.io/v1/samples/sec_entity_profile","page":"https://answerpool.io/p/sec_entity_profile"},"sec_event_explain":{"method":"GET","path":"/v1/sec/event","price_usd":0.0,"sample_url":"https://answerpool.io/v1/samples/sec_event_explain","page":"https://answerpool.io/p/sec_event_explain"},"sec_filing_cadence":{"method":"GET","path":"/v1/sec/filings/cadence","price_usd":0.02,"sample_url":"https://answerpool.io/v1/samples/sec_filing_cadence","page":"https://answerpool.io/p/sec_filing_cadence"},"sec_filing_calendar":{"method":"GET","path":"/v1/sec/calendar","price_usd":0.02,"sample_url":"https://answerpool.io/v1/samples/sec_filing_calendar","page":"https://answerpool.io/p/sec_filing_calendar"},"sec_flag_glossary":{"method":"GET","path":"/v1/sec/flags","price_usd":0.0,"sample_url":"https://answerpool.io/v1/samples/sec_flag_glossary","page":"https://answerpool.io/p/sec_flag_glossary"},"sec_form_glossary":{"method":"GET","path":"/v1/sec/forms","price_usd":0.0,"sample_url":"https://answerpool.io/v1/samples/sec_form_glossary","page":"https://answerpool.io/p/sec_form_glossary"},"sec_form_trend":{"method":"GET","path":"/v1/sec/trends/form","price_usd":0.02,"sample_url":"https://answerpool.io/v1/samples/sec_form_trend","page":"https://answerpool.io/p/sec_form_trend"},"sec_formd_changes":{"method":"GET","path":"/v1/sec/formd/changes","price_usd":0.005,"sample_url":"https://answerpool.io/v1/samples/sec_formd_changes","page":"https://answerpool.io/p/sec_formd_changes"},"sec_full_text_search":{"method":"GET","path":"/v1/sec/search/fulltext","price_usd":0.02,"sample_url":"https://answerpool.io/v1/samples/sec_full_text_search","page":"https://answerpool.io/p/sec_full_text_search"},"sec_insider_changes":{"method":"GET","path":"/v1/sec/insider/changes","price_usd":0.005,"sample_url":"https://answerpool.io/v1/samples/sec_insider_changes","page":"https://answerpool.io/p/sec_insider_changes"},"sec_insider_clusters":{"method":"GET","path":"/v1/sec/insider/clusters","price_usd":0.05,"sample_url":"https://answerpool.io/v1/samples/sec_insider_clusters","page":"https://answerpool.io/p/sec_insider_clusters"},"sec_insider_screen":{"method":"GET","path":"/v1/sec/insider/screen","price_usd":0.02,"sample_url":"https://answerpool.io/v1/samples/sec_insider_screen","page":"https://answerpool.io/p/sec_insider_screen"},"sec_issuer_packet":{"method":"GET","path":"/v1/sec/issuer/packet","price_usd":0.2,"sample_url":"https://answerpool.io/v1/samples/sec_issuer_packet","page":"https://answerpool.io/p/sec_issuer_packet"},"sec_metrics_catalog":{"method":"GET","path":"/v1/sec/xbrl/metrics","price_usd":0.0,"sample_url":"https://answerpool.io/v1/samples/sec_metrics_catalog","page":"https://answerpool.io/p/sec_metrics_catalog"},"sec_new_registrants":{"method":"GET","path":"/v1/sec/registrants/new","price_usd":0.0,"sample_url":"https://answerpool.io/v1/samples/sec_new_registrants","page":"https://answerpool.io/p/sec_new_registrants"},"sec_resolve":{"method":"GET","path":"/v1/sec/resolve","price_usd":0.0,"sample_url":"https://answerpool.io/v1/samples/sec_resolve","page":"https://answerpool.io/p/sec_resolve"},"sec_shares_outstanding":{"method":"GET","path":"/v1/sec/xbrl/shares","price_usd":0.02,"sample_url":"https://answerpool.io/v1/samples/sec_shares_outstanding","page":"https://answerpool.io/p/sec_shares_outstanding"},"sec_sic_lookup":{"method":"GET","path":"/v1/sec/sic","price_usd":0.0,"sample_url":"https://answerpool.io/v1/samples/sec_sic_lookup","page":"https://answerpool.io/p/sec_sic_lookup"},"sec_ticker_lookup":{"method":"GET","path":"/v1/sec/ticker","price_usd":0.0,"sample_url":"https://answerpool.io/v1/samples/sec_ticker_lookup","page":"https://answerpool.io/p/sec_ticker_lookup"},"sec_transaction_codes":{"method":"GET","path":"/v1/sec/insider/codes","price_usd":0.0,"sample_url":"https://answerpool.io/v1/samples/sec_transaction_codes","page":"https://answerpool.io/p/sec_transaction_codes"},"sec_watchlist_events":{"method":"GET","path":"/v1/sec/watchlist","price_usd":0.02,"sample_url":"https://answerpool.io/v1/samples/sec_watchlist_events","page":"https://answerpool.io/p/sec_watchlist_events"},"sec_xbrl_compare":{"method":"GET","path":"/v1/sec/xbrl/compare","price_usd":0.05,"sample_url":"https://answerpool.io/v1/samples/sec_xbrl_compare","page":"https://answerpool.io/p/sec_xbrl_compare"},"sec_xbrl_financials":{"method":"GET","path":"/v1/sec/xbrl/financials","price_usd":0.02,"sample_url":"https://answerpool.io/v1/samples/sec_xbrl_financials","page":"https://answerpool.io/p/sec_xbrl_financials"},"sec_xbrl_frame":{"method":"GET","path":"/v1/sec/xbrl/frame","price_usd":0.05,"sample_url":"https://answerpool.io/v1/samples/sec_xbrl_frame","page":"https://answerpool.io/p/sec_xbrl_frame"},"sec_xbrl_growth":{"method":"GET","path":"/v1/sec/xbrl/growth","price_usd":0.05,"sample_url":"https://answerpool.io/v1/samples/sec_xbrl_growth","page":"https://answerpool.io/p/sec_xbrl_growth"},"sec_xbrl_ratios":{"method":"GET","path":"/v1/sec/xbrl/ratios","price_usd":0.05,"sample_url":"https://answerpool.io/v1/samples/sec_xbrl_ratios","page":"https://answerpool.io/p/sec_xbrl_ratios"}}},"tools":[{"type":"function","function":{"name":"sec_company","description":"Get a one-call SEC snapshot by ticker or CIK — returns identity, recent filings, indexed events, insider activity and key XBRL facts (revenue, income, cash, 8 periods). Use before deeper diligence. Costs $0.02 per call. Use when: You have a ticker or CIK and need cited fundamentals plus recent events in one call.","parameters":{"additionalProperties":false,"properties":{"ticker":{"anyOf":[{"maxLength":12,"type":"string"},{"type":"null"}],"default":null,"description":"US exchange ticker, case-insensitive (e.g. AAPL), resolved through the EDGAR ticker file; an unresolvable ticker returns 422. Provide exactly one of ticker or cik.","title":"Ticker"},"cik":{"anyOf":[{"maxLength":10,"pattern":"^\\d{1,10}$","type":"string"},{"type":"null"}],"default":null,"description":"SEC CIK, 1-10 digits, zero padding optional (e.g. 320193); skips ticker resolution. Provide exactly one of cik or ticker.","title":"Cik"}},"title":"CompanyInput","type":"object"}}},{"type":"function","function":{"name":"funding_signals","description":"Get the US federal money trail for a technology term — returns USAspending obligations by fiscal year with 3y growth, top recipients, NIH grant counts and recent projects, plus flags. Use instead of joining two federal APIs. Costs $0.02 per call. Use when: You need federal funding momentum, recipients, or NIH activity for a technology in one structured call.","parameters":{"additionalProperties":false,"properties":{"term":{"description":"Technology keyword, e.g. 'quantum computing'.","maxLength":200,"minLength":2,"title":"Term","type":"string"},"years":{"default":5,"description":"How many fiscal years back to aggregate.","maximum":8,"minimum":2,"title":"Years","type":"integer"}},"required":["term"],"title":"FundingInput","type":"object"}}},{"type":"function","function":{"name":"technology_momentum","description":"Score research momentum for any technology from OpenAlex (CC0) — returns momentum_score, acceleration_score, trend_label, growth series, leading institutions and researchers, key works, confidence and provenance. Use before betting a field is accelerating. Costs $0.05 per call. Use when: You need a quantified, source-cited answer to \"is this research or technology field accelerating, growing, stable, or declining?\" for one named topic, with growth ratios, leaders, and recent influential works, in one call.","parameters":{"additionalProperties":false,"properties":{"topic":{"description":"Technology or research topic, free text.","maxLength":200,"minLength":2,"title":"Topic","type":"string"}},"required":["topic"],"title":"Input","type":"object"}}},{"type":"function","function":{"name":"technology_emerging","description":"Rank the fastest-accelerating research topics across ~4,500 OpenAlex topics, weekly — returns rank, momentum z-score, growth, acceleration and citation-quality growth per topic, filterable by field. Use to find what is accelerating. Costs $0.05 per call. Use when: You need a ranked, evidence-backed list of accelerating fields (optionally within one discipline) to seed scouting, diligence, or content, and would otherwise scan topic by topic.","parameters":{"additionalProperties":false,"properties":{"limit":{"default":25,"description":"Number of ranked topics to return.","maximum":100,"minimum":1,"title":"Limit","type":"integer"},"field":{"anyOf":[{"maxLength":80,"type":"string"},{"type":"null"}],"default":null,"description":"Restrict to an OpenAlex field name, e.g. 'Engineering', 'Medicine'.","title":"Field"},"min_works":{"default":50,"description":"Minimum works in the last complete year (filters noise).","minimum":1,"title":"Min Works","type":"integer"},"emerging_only":{"default":false,"description":"Only topics flagged emerging (high momentum, below-median size).","title":"Emerging Only","type":"boolean"}},"title":"EmergingInput","type":"object"}}},{"type":"function","function":{"name":"technology_lookup","description":"Look up statistical research momentum for one OpenAlex topic (free) — returns rank among ~4,500 topics, momentum z-score, 1y/3y/5y growth, acceleration and per-year counts. Use to screen a field before paying for a full judgment. Free. Use when: You have a topic and want its numbers now, or you are screening many topics.","parameters":{"additionalProperties":false,"properties":{"topic":{"description":"OpenAlex topic id (e.g. T10299) or a topic name in free text (e.g. photonic computing), case-insensitive; names are resolved fuzzily and the response says which topic was matched.","maxLength":200,"minLength":2,"title":"Topic","type":"string"}},"required":["topic"],"title":"LookupInput","type":"object"}}},{"type":"function","function":{"name":"entity_resolve","description":"Any entity name in; Wikidata id, labels, aliases and the external identifiers other datasets key on (SEC CIK, LEI, ticker, NAICS) out, with endpoint URLs where they map. Turns name matching into a key join. Free, no key. Free. Use when: You have a name and need identifiers that work in other systems.","parameters":{"additionalProperties":false,"properties":{"q":{"description":"Name of any entity to resolve: company, person, place, product or organisation (e.g. Lockheed Martin). Matched against English Wikidata labels and aliases; a name that matches nothing is an error.","maxLength":100,"minLength":2,"title":"Q","type":"string"},"candidates":{"default":5,"description":"How many Wikidata search hits to request; the best hit is resolved in full and the rest are returned as other_candidates. Default 5.","maximum":10,"minimum":1,"title":"Candidates","type":"integer"}},"required":["q"],"title":"EntityResolveIn","type":"object"}}},{"type":"function","function":{"name":"funding_naics_lookup","description":"NAICS industry code resolution: text or code prefix in, code + description + retired flag out. The identifier layer for any US federal contracting analysis. Free, no key. Free. Use when: You need a NAICS code for a federal-spending query and have only an industry name or partial code.","parameters":{"additionalProperties":false,"properties":{"q":{"description":"Search text for this lookup, matched by USAspending autocomplete against the codes, names and descriptions it holds, e.g. semiconductor. No match returns an empty list.","maxLength":80,"minLength":2,"title":"Q","type":"string"},"limit":{"default":20,"description":"Maximum matches returned, in the relevance order USAspending autocomplete gives them. Default 20.","maximum":50,"minimum":1,"title":"Limit","type":"integer"}},"required":["q"],"title":"QueryIn","type":"object"}}},{"type":"function","function":{"name":"funding_program_lookup","description":"Federal assistance-listing (CFDA) resolution: topic or name in, program number + title + popular name out. The identifier for US federal grant analyses. Free. Free. Use when: You need the assistance-listing number behind a federal grant program name or topic.","parameters":{"additionalProperties":false,"properties":{"q":{"description":"Search text for this lookup, matched by USAspending autocomplete against the codes, names and descriptions it holds, e.g. semiconductor. No match returns an empty list.","maxLength":80,"minLength":2,"title":"Q","type":"string"},"limit":{"default":20,"description":"Maximum matches returned, in the relevance order USAspending autocomplete gives them. Default 20.","maximum":50,"minimum":1,"title":"Limit","type":"integer"}},"required":["q"],"title":"QueryIn","type":"object"}}},{"type":"function","function":{"name":"funding_psc_lookup","description":"Federal Product/Service Code resolution: text in, PSC code + description out. The what-was-bought identifier for US federal award filtering. Free, no key. Free. Use when: You need to filter federal awards by what was purchased and have only a description.","parameters":{"additionalProperties":false,"properties":{"q":{"description":"Search text for this lookup, matched by USAspending autocomplete against the codes, names and descriptions it holds, e.g. semiconductor. No match returns an empty list.","maxLength":80,"minLength":2,"title":"Q","type":"string"},"limit":{"default":20,"description":"Maximum matches returned, in the relevance order USAspending autocomplete gives them. Default 20.","maximum":50,"minimum":1,"title":"Limit","type":"integer"}},"required":["q"],"title":"QueryIn","type":"object"}}},{"type":"function","function":{"name":"funding_recipient_lookup","description":"Federal award recipient name resolution: fuzzy name in, deduplicated canonical recipient names (and UEI when available) out. The entity-resolution step before any who-got-federal-money question. Free, no key. Free. Use when: You are about to query federal awards by recipient and need the exact name variants the data uses.","parameters":{"additionalProperties":false,"properties":{"q":{"description":"Search text for this lookup, matched by USAspending autocomplete against the codes, names and descriptions it holds, e.g. semiconductor. No match returns an empty list.","maxLength":80,"minLength":2,"title":"Q","type":"string"},"limit":{"default":20,"description":"Maximum matches returned, in the relevance order USAspending autocomplete gives them. Default 20.","maximum":50,"minimum":1,"title":"Limit","type":"integer"}},"required":["q"],"title":"QueryIn","type":"object"}}},{"type":"function","function":{"name":"funding_resolve","description":"Any federal-spending string in — industry, product, program, recipient or agency — every code space searched at once, each match tagged with the filter parameter it belongs to. One call instead of five lookups. Free, no key. Free. Use when: You have one string and do not know which federal code space it belongs to.","parameters":{"additionalProperties":false,"properties":{"q":{"description":"Term to resolve at once across the NAICS, PSC, assistance listing, recipient and agency code spaces, e.g. semiconductors. Resolving nowhere returns a 400.","maxLength":80,"minLength":2,"title":"Q","type":"string"},"limit_per_kind":{"default":3,"description":"Maximum matches returned per code space (naics, psc, program, recipient, agency). Default 3.","maximum":10,"minimum":1,"title":"Limit Per Kind","type":"integer"}},"required":["q"],"title":"FundingResolveIn","type":"object"}}},{"type":"function","function":{"name":"graph_auditor_clients","description":"Which public companies name a given audit firm in their annual reports — exact- phrase 10-K full-text join per registrant with filing counts and dates. Map auditor concentration and shared-auditor networks in one call. Costs $0.02 per call. Use when: Auditor-concentration or shared-auditor analysis.","parameters":{"additionalProperties":false,"properties":{"name":{"description":"Audit firm, e.g. \"Ernst & Young LLP\".","maxLength":80,"minLength":3,"title":"Name","type":"string"},"lookback_days":{"default":400,"description":"Window in days over the 10-K filing date, counted back from today. Default 400, about one annual reporting cycle.","maximum":1825,"minimum":30,"title":"Lookback Days","type":"integer"},"limit":{"default":25,"description":"Maximum client companies returned, ordered by matching filing count descending then CIK. Default 25.","maximum":100,"minimum":1,"title":"Limit","type":"integer"}},"required":["name"],"title":"AuditorIn","type":"object"}}},{"type":"function","function":{"name":"graph_interlocks","description":"Board and officer interlock map for any public company — the insiders from its SEC ownership filings joined to every other issuer they file for, with roles on both sides. One call replaces entity resolution across Forms 3/4/5. Costs $0.05 per call. Use when: Governance or network analysis anchored on one company.","parameters":{"additionalProperties":false,"properties":{"ticker":{"anyOf":[{"maxLength":12,"type":"string"},{"type":"null"}],"default":null,"description":"US exchange ticker, case-insensitive (e.g. AAPL); resolved through the EDGAR ticker map, and an unknown ticker is an error. Provide exactly one of ticker or cik.","title":"Ticker"},"cik":{"anyOf":[{"maxLength":10,"pattern":"^\\d{1,10}$","type":"string"},{"type":"null"}],"default":null,"description":"SEC CIK of the target company, 1-10 digits, zero padding optional (e.g. 320193). Provide exactly one of cik or ticker.","title":"Cik"},"days":{"default":365,"description":"Length in days of the Form 3/4/5 filing-date window ending today; an insider counts as shared only if both companies filed inside it. Default 365.","maximum":3650,"minimum":7,"title":"Days","type":"integer"},"limit":{"default":25,"description":"Maximum linked companies returned, ordered by count of shared insiders descending then CIK. Default 25.","maximum":100,"minimum":1,"title":"Limit","type":"integer"}},"title":"InterlocksIn","type":"object"}}},{"type":"function","function":{"name":"graph_person","description":"Look up an insider by name or owner CIK and get every issuer they file SEC ownership forms for — roles, filing counts, first/last seen. The person node of the entity graph in one call. Costs $0.02 per call. Use when: You have an insider's name or CIK and want their issuer footprint.","parameters":{"additionalProperties":false,"properties":{"q":{"anyOf":[{"maxLength":80,"minLength":2,"type":"string"},{"type":"null"}],"default":null,"description":"Case-insensitive substring of the insider name as filed on Forms 3/4/5 (e.g. buffett). Ignored when owner_cik is given; provide one of the two.","title":"Q"},"owner_cik":{"anyOf":[{"maxLength":10,"pattern":"^\\d{1,10}$","type":"string"},{"type":"null"}],"default":null,"description":"CIK of the reporting owner (the insider, not the issuer), 1-10 digits, zero padding optional. Provide q or owner_cik; owner_cik takes precedence over q.","title":"Owner Cik"},"days":{"default":365,"description":"Window in days over the ownership filing date, counted back from now. Default 365.","maximum":3650,"minimum":7,"title":"Days","type":"integer"},"limit":{"default":25,"description":"Maximum persons returned, ordered by owner CIK ascending. Default 25.","maximum":100,"minimum":1,"title":"Limit","type":"integer"}},"title":"PersonIn","type":"object"}}},{"type":"function","function":{"name":"graph_subsidiaries","description":"Subsidiary names and jurisdictions extracted from any public company's latest annual-report Exhibit 21, with the source exhibit URL for verification. One call replaces locating and parsing EX-21 filings. Costs $0.05 per call. Use when: You need the registrant's disclosed subsidiary list and jurisdictions.","parameters":{"additionalProperties":false,"properties":{"ticker":{"anyOf":[{"maxLength":12,"type":"string"},{"type":"null"}],"default":null,"description":"US exchange ticker, case-insensitive (e.g. AAPL); resolved through the EDGAR ticker map, and an unknown ticker is an error. Provide exactly one of ticker or cik.","title":"Ticker"},"cik":{"anyOf":[{"maxLength":10,"pattern":"^\\d{1,10}$","type":"string"},{"type":"null"}],"default":null,"description":"SEC CIK of the parent registrant, 1-10 digits, zero padding optional (e.g. 320193). Provide exactly one of cik or ticker.","title":"Cik"},"limit":{"default":200,"description":"Maximum subsidiary rows returned, in the order they appear in the Exhibit 21 table. Default 200.","maximum":500,"minimum":1,"title":"Limit","type":"integer"}},"title":"SubsIn","type":"object"}}},{"type":"function","function":{"name":"impact_cfr_citers","description":"Which public companies cite a given CFR title and part in their SEC filings — exact-phrase full-text join aggregated per registrant with filing counts, forms and dates. Screen exposure to specific provisions in one call. Costs $0.02 per call. Use when: Your obligations map to known CFR parts and you want the citing issuers.","parameters":{"additionalProperties":false,"properties":{"cfr_title":{"description":"CFR title number, 1 to 50 (e.g. 17 for Commodity and Securities Exchanges). Searched together with cfr_part as the exact phrase '17 CFR 240'.","maximum":50,"minimum":1,"title":"Cfr Title","type":"integer"},"cfr_part":{"description":"CFR part number within cfr_title (e.g. 240). Both are required; a part nobody cites in the window returns an empty company list.","maximum":9999,"minimum":1,"title":"Cfr Part","type":"integer"},"lookback_days":{"default":365,"description":"Length in days of the SEC filing-date window ending today.","maximum":1825,"minimum":30,"title":"Lookback Days","type":"integer"},"limit":{"default":25,"description":"Maximum companies returned, most matching filings first.","maximum":100,"minimum":1,"title":"Limit","type":"integer"}},"required":["cfr_title","cfr_part"],"title":"CfrCitersIn","type":"object"}}},{"type":"function","function":{"name":"impact_company_rules","description":"Recent federal rules and proposed rules mapped to one public company via its SEC industry code — curated SIC-to-regulator table plus the agencies' rulemaking with comment and effective-date flags. Industry-level heuristic, one call. Costs $0.05 per call. Use when: You monitor one issuer and want its regulators' recent rulemaking.","parameters":{"additionalProperties":false,"properties":{"ticker":{"anyOf":[{"maxLength":12,"type":"string"},{"type":"null"}],"default":null,"description":"Exchange ticker, e.g. AAPL. Give ticker or cik; cik wins if both are set, and an unknown ticker is rejected.","title":"Ticker"},"cik":{"anyOf":[{"maxLength":10,"pattern":"^\\d{1,10}$","type":"string"},{"type":"null"}],"default":null,"description":"SEC CIK, digits only, zero-padding optional, e.g. 320193 or 0000320193. Give cik or ticker; cik wins if both are set.","title":"Cik"},"days":{"default":90,"description":"Length in days of the Federal Register publication-date window ending today. Default 90.","maximum":365,"minimum":7,"title":"Days","type":"integer"},"types":{"default":"rule,proposed_rule","description":"Comma-separated Federal Register document types: rule, proposed_rule, notice, presidential. Default rule,proposed_rule.","title":"Types","type":"string"},"significant_only":{"default":false,"description":"True keeps only E.O. 12866 significant documents; false (default) keeps all.","title":"Significant Only","type":"boolean"},"limit":{"default":25,"description":"Maximum Federal Register documents returned, newest publication first.","maximum":100,"minimum":1,"title":"Limit","type":"integer"}},"title":"CompanyRulesIn","type":"object"}}},{"type":"function","function":{"name":"impact_docket_citers","description":"Which public companies cite a specific agency docket id or RIN in their SEC filings — exact-phrase full-text join per registrant with filing counts and dates. Track who publicly engages with one rulemaking. Costs $0.02 per call. Use when: You track one docket/RIN and want the issuers referencing it.","parameters":{"additionalProperties":false,"properties":{"docket_id":{"anyOf":[{"maxLength":60,"minLength":2,"pattern":"^[A-Za-z0-9._/-]+$","type":"string"},{"type":"null"}],"default":null,"description":"Agency docket id searched as an exact phrase in filings, e.g. EPA-HQ-OAR-2021-0317. Give docket_id or rin; docket_id wins if both are set.","title":"Docket Id"},"rin":{"anyOf":[{"maxLength":12,"pattern":"^[0-9]{4}-[A-Z0-9]{2,6}$","type":"string"},{"type":"null"}],"default":null,"description":"Regulation Identifier Number, formatted NNNN-XXNN (e.g. 3235-AN00), searched as an exact phrase in filings. Give rin or docket_id; docket_id wins.","title":"Rin"},"lookback_days":{"default":365,"description":"Length in days of the SEC filing-date window ending today.","maximum":1825,"minimum":30,"title":"Lookback Days","type":"integer"},"limit":{"default":25,"description":"Maximum companies returned, most matching filings first.","maximum":100,"minimum":1,"title":"Limit","type":"integer"}},"title":"DocketCitersIn","type":"object"}}},{"type":"function","function":{"name":"impact_rule_companies","description":"Map a Federal Register rule to the public companies whose SEC filings cite its docket, RIN or CFR part — cross-corpus full-text join, ranked by citation strength with filing counts and dates. One call replaces holding and joining both corpora. Costs $0.05 per call. Use when: You hold a Federal Register document number and need the likely-affected issuer list.","parameters":{"additionalProperties":false,"properties":{"document_number":{"description":"Federal Register document number, e.g. 2026-12341.","maxLength":40,"minLength":3,"pattern":"^[A-Za-z0-9._-]+$","title":"Document Number","type":"string"},"lookback_days":{"default":365,"description":"How far back to scan SEC filings.","maximum":1825,"minimum":30,"title":"Lookback Days","type":"integer"},"limit":{"default":25,"description":"Maximum companies returned, most rule identifiers matched first.","maximum":100,"minimum":1,"title":"Limit","type":"integer"}},"required":["document_number"],"title":"RuleImpactIn","type":"object"}}},{"type":"function","function":{"name":"ipo_calendar","description":"The IPO pipeline staged in one call — just-filed S-1/F-1 issuers, amendments in progress, priced 424(b)(4) offerings and withdrawals for your window, each bucket newest first. Replaces composing four EDGAR form feeds. Costs $0.05 per call. Use when: You brief or monitor the pipeline as a whole, on a schedule.","parameters":{"additionalProperties":false,"properties":{"days":{"default":30,"description":"Length in days of the filing-date window ending today, used for every stage.","maximum":180,"minimum":1,"title":"Days","type":"integer"},"limit":{"default":25,"description":"Maximum issuers returned per pipeline stage (filed, amending, priced, withdrawn), most recently filed first. Applied to each stage separately. Default 25.","maximum":100,"minimum":1,"title":"Limit","type":"integer"}},"title":"CalendarIn","type":"object"}}},{"type":"function","function":{"name":"ipo_company","description":"One issuer's complete path to going public — registrations, amendments, prospectuses, effectiveness and withdrawals in order with a current stage label, merged live from EDGAR plus our 2021+ index. Look up by CIK or name substring. Costs $0.05 per call. Use when: You follow one candidate and want its full registration history + stage.","parameters":{"additionalProperties":false,"properties":{"cik":{"anyOf":[{"maxLength":10,"pattern":"^\\d{1,10}$","type":"string"},{"type":"null"}],"default":null,"description":"SEC CIK, digits only, zero-padding optional, e.g. 320193 or 0000320193. Give cik or company; cik is used if both are set.","title":"Cik"},"company":{"anyOf":[{"maxLength":80,"minLength":3,"type":"string"},{"type":"null"}],"default":null,"description":"Case-insensitive substring of the registrant name as filed (e.g. rivian); the most recent registration-stage filer matching it wins. Provide cik or company; a substring matching no registrant is an error.","title":"Company"},"limit":{"default":100,"description":"Maximum registration events returned, oldest filing date first.","maximum":500,"minimum":1,"title":"Limit","type":"integer"}},"title":"CompanyIn","type":"object"}}},{"type":"function","function":{"name":"ipo_new_registrations","description":"New S-1 and F-1 registration statements filed in the last N days — companies that just started going public, newest first with CIKs and filing links; amendments excluded by default. One call replaces EDGAR form-feed polling. Costs $0.02 per call. Use when: You track newly surfacing IPO candidates.","parameters":{"additionalProperties":false,"properties":{"days":{"default":30,"description":"Length in days of the filing-date window ending today.","maximum":365,"minimum":1,"title":"Days","type":"integer"},"include_amendments":{"default":false,"description":"True keeps S-1/A and F-1/A; false (default) returns initial filings only.","title":"Include Amendments","type":"boolean"},"foreign":{"default":true,"description":"Include F-1 (foreign private issuers).","title":"Foreign","type":"boolean"},"limit":{"default":50,"description":"Maximum filings returned, most recently filed first.","maximum":100,"minimum":1,"title":"Limit","type":"integer"}},"title":"NewRegsIn","type":"object"}}},{"type":"function","function":{"name":"ipo_priced","description":"Offerings that just priced — final 424(b)(4) prospectuses in your window, each flagged likely-IPO when the issuer has no earlier 424(b) in our 2021+ index, separating debuts from follow-ons. One call, minutes-fresh. Costs $0.02 per call. Use when: You act on completed pricings and want debuts distinguished.","parameters":{"additionalProperties":false,"properties":{"days":{"default":30,"description":"Length in days of the 424(b)(4) filing-date window ending today.","maximum":365,"minimum":1,"title":"Days","type":"integer"},"limit":{"default":50,"description":"Maximum offerings returned, most recently filed first.","maximum":100,"minimum":1,"title":"Limit","type":"integer"}},"title":"PricedIn","type":"object"}}},{"type":"function","function":{"name":"ipo_withdrawn","description":"Registration statements withdrawn in the last N days (RW and AW filings), newest first with issuer and filing links — the dead-deal list as one call. Covers all registration types, stated in the response. Costs $0.02 per call. Use when: You track failed or pulled offerings as a market signal.","parameters":{"additionalProperties":false,"properties":{"days":{"default":60,"description":"Length in days of the RW/AW filing-date window ending today.","maximum":365,"minimum":1,"title":"Days","type":"integer"},"limit":{"default":50,"description":"Maximum withdrawal filings returned, most recently filed first.","maximum":100,"minimum":1,"title":"Limit","type":"integer"}},"title":"WithdrawnIn","type":"object"}}},{"type":"function","function":{"name":"nih_institute_lookup","description":"All 27 NIH institutes/centers with code, full name and research focus, searchable. One call replaces the NIH org-chart crawl. Free, no key. Free. Use when: You have an NIH institute code to decode, or a research area to map to its funding institute.","parameters":{"additionalProperties":false,"properties":{"q":{"anyOf":[{"maxLength":60,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"description":"Case-insensitive substring matched against each entry's code, name and description, e.g. R01 or cancer. Omit for the full list.","title":"Q"}},"title":"RefIn","type":"object"}}},{"type":"function","function":{"name":"peers_industry","description":"Every SEC registrant in one SIC industry with total assets and revenue joined from corpus-wide XBRL frames, sorted largest first — the industry map in one call, by SIC code or resolved from any ticker. Costs $0.02 per call. Use when: You want the industry's public players and their scale, fast.","parameters":{"additionalProperties":false,"properties":{"sic":{"anyOf":[{"maximum":9999,"minimum":100,"type":"integer"},{"type":"null"}],"default":null,"description":"SEC SIC industry code, 3 or 4 digits, e.g. 3571 (see /v1/sec/sic). Takes precedence over ticker and cik, which are only used to look one up.","title":"Sic"},"ticker":{"anyOf":[{"maxLength":12,"type":"string"},{"type":"null"}],"default":null,"description":"US exchange ticker, case-insensitive (e.g. AAPL), used to look up the registrant's SIC. Ignored when sic is given; otherwise send ticker or cik.","title":"Ticker"},"cik":{"anyOf":[{"maxLength":10,"pattern":"^\\d{1,10}$","type":"string"},{"type":"null"}],"default":null,"description":"SEC CIK, 1-10 digits, zero padding optional (e.g. 320193), used to look up the registrant's SIC. Ignored when sic is given; otherwise send cik or ticker.","title":"Cik"},"limit":{"default":50,"description":"Maximum registrants returned from the industry, ordered by reported total assets descending. Default 50.","maximum":100,"minimum":1,"title":"Limit","type":"integer"}},"title":"IndustryIn","type":"object"}}},{"type":"function","function":{"name":"peers_percentile","description":"A company's percentile and rank versus its same-industry XBRL peer group on revenue, assets, net income and margin, with peer median/min/max. One call replaces a peer lookup plus a fundamentals fetch per peer. Costs $0.05 per call. Use when: You need a company's standing relative to comparables, quantitatively.","parameters":{"additionalProperties":false,"properties":{"ticker":{"anyOf":[{"maxLength":12,"type":"string"},{"type":"null"}],"default":null,"description":"US exchange ticker of the company being ranked, case-insensitive (e.g. AAPL). Provide exactly one of ticker or cik.","title":"Ticker"},"cik":{"anyOf":[{"maxLength":10,"pattern":"^\\d{1,10}$","type":"string"},{"type":"null"}],"default":null,"description":"SEC CIK of the company being ranked, 1-10 digits, zero padding optional (e.g. 320193). Provide exactly one of cik or ticker.","title":"Cik"},"peers":{"default":20,"description":"How many same-industry peers form the comparison set the percentiles are computed against. Default 20.","maximum":50,"minimum":3,"title":"Peers","type":"integer"}},"title":"PercentileIn","type":"object"}}},{"type":"function","function":{"name":"peers_similar","description":"The most similar public companies to any ticker or CIK — same-industry candidates ranked by log-scale asset/revenue distance and margin from the full SEC XBRL corpus, each peer row carrying the numbers behind the ranking. One call replaces corpus loading and similarity modeling. Costs $0.05 per call. Use when: You need a comparable set — valuation context, benchmarking, screening.","parameters":{"additionalProperties":false,"properties":{"ticker":{"anyOf":[{"maxLength":12,"type":"string"},{"type":"null"}],"default":null,"description":"US exchange ticker, case-insensitive (e.g. AAPL); resolved through the EDGAR ticker map, and an unknown ticker is an error. Provide exactly one of ticker or cik.","title":"Ticker"},"cik":{"anyOf":[{"maxLength":10,"pattern":"^\\d{1,10}$","type":"string"},{"type":"null"}],"default":null,"description":"SEC CIK of the target company, 1-10 digits, zero padding optional (e.g. 320193). Provide exactly one of cik or ticker.","title":"Cik"},"limit":{"default":20,"description":"Maximum peer companies returned, ordered by similarity distance ascending (closest first). Default 20.","maximum":50,"minimum":1,"title":"Limit","type":"integer"}},"title":"PeersIn","type":"object"}}},{"type":"function","function":{"name":"reg_agency_lookup","description":"Resolve a US federal agency name to its Federal Register slug — searches all ~470 agencies, returns slug, display name, short name and parent. Free. The slug is the agency parameter every other AnswerPool regulation endpoint takes. Free. Use when: You have an agency name or acronym and need the canonical slug for filtered rule-tracking calls.","parameters":{"additionalProperties":false,"properties":{"q":{"anyOf":[{"maxLength":120,"type":"string"},{"type":"null"}],"default":null,"description":"Substring of the agency name or slug.","title":"Q"},"limit":{"default":50,"description":"Maximum agencies returned; matches are listed alphabetically by name.","maximum":500,"minimum":1,"title":"Limit","type":"integer"}},"title":"AgencyLookupIn","type":"object"}}},{"type":"function","function":{"name":"reg_cfr_watch","description":"Federal rules and proposed rules amending a specific CFR title and part (e.g. 17 CFR 240), newest first with deadline flags. Watch the exact provisions you are subject to instead of whole agencies or topics. Costs $0.02 per call. Use when: Your obligations map to known CFR parts and you react only to those.","parameters":{"additionalProperties":false,"properties":{"cfr_title":{"description":"CFR title number, 1 to 50, e.g. 17 for Commodity and Securities Exchanges. Required; pair with cfr_part to narrow to one part.","maximum":50,"minimum":1,"title":"Cfr Title","type":"integer"},"cfr_part":{"anyOf":[{"maximum":9999,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"CFR part number within cfr_title, e.g. 240. Omit to watch the whole title.","title":"Cfr Part"},"types":{"default":"rule,proposed_rule","description":"Comma-separated Federal Register document types: rule, proposed_rule, notice, presidential. An unlisted type is rejected. Default rule,proposed_rule.","title":"Types","type":"string"},"since":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"publication_date >= this ISO date, e.g. 2026-06-01. Default: the last 90 days.","title":"Since"},"limit":{"default":25,"description":"Maximum documents touching this CFR title/part, newest publication first.","maximum":100,"minimum":1,"title":"Limit","type":"integer"}},"required":["cfr_title"],"title":"CfrWatchIn","type":"object"}}},{"type":"function","function":{"name":"reg_comment_deadlines","description":"Proposed federal rules whose comment window closes within N days, sorted soonest first with exact day-counts — the actionable comment queue, optionally filtered to one agency or topic. Replaces scanning months of proposed rules and computing dates. Costs $0.02 per call. Use when: You act on comment windows — drafting, alerting, or prioritizing by urgency.","parameters":{"additionalProperties":false,"properties":{"within_days":{"default":14,"description":"Comment periods closing within this many days.","maximum":90,"minimum":1,"title":"Within Days","type":"integer"},"agency":{"anyOf":[{"maxLength":120,"pattern":"^[a-z0-9-]+$","type":"string"},{"type":"null"}],"default":null,"description":"Federal Register agency slug from /v1/regs/agencies, e.g. securities-and-exchange-commission; an unknown slug fails the call. Omit for all.","title":"Agency"},"term":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Full-text term the proposed rules must match, e.g. 'cybersecurity'. Omit for every open comment period.","title":"Term"},"limit":{"default":25,"description":"Maximum documents returned, soonest comment deadline first.","maximum":100,"minimum":1,"title":"Limit","type":"integer"}},"title":"CommentDeadlinesIn","type":"object"}}},{"type":"function","function":{"name":"reg_daily_digest","description":"Every federal rule and proposed rule published on one date, significant documents sorted first, with deadline flags and day-counts — optionally one agency. One call gives a briefing agent the whole day's rulemaking, pre-triaged. Costs $0.02 per call. Use when: You brief or triage by publication day and want importance-first ordering.","parameters":{"additionalProperties":false,"properties":{"date":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"ISO publication date; default today (UTC).","title":"Date"},"agency":{"anyOf":[{"maxLength":120,"pattern":"^[a-z0-9-]+$","type":"string"},{"type":"null"}],"default":null,"description":"Federal Register agency slug from /v1/regs/agencies, e.g. securities-and-exchange-commission; an unknown slug fails the call. Omit for all.","title":"Agency"},"limit":{"default":50,"description":"Maximum documents from that day, significant ones listed first.","maximum":100,"minimum":1,"title":"Limit","type":"integer"}},"title":"DigestIn","type":"object"}}},{"type":"function","function":{"name":"reg_effective_soon","description":"Final federal rules taking effect within the next N days, sorted by effective date with exact day-counts, optionally one agency — the compliance-readiness queue. Replaces effective-date range queries and date math against the Federal Register. Costs $0.02 per call. Use when: You prepare for rules becoming binding — readiness, alerting, scheduling.","parameters":{"additionalProperties":false,"properties":{"within_days":{"default":30,"description":"Rules taking effect within this many days.","maximum":180,"minimum":1,"title":"Within Days","type":"integer"},"agency":{"anyOf":[{"maxLength":120,"pattern":"^[a-z0-9-]+$","type":"string"},{"type":"null"}],"default":null,"description":"Federal Register agency slug from /v1/regs/agencies, e.g. securities-and-exchange-commission; an unknown slug fails the call. Omit for all.","title":"Agency"},"limit":{"default":25,"description":"Maximum rules returned, soonest effective date first.","maximum":100,"minimum":1,"title":"Limit","type":"integer"}},"title":"EffectiveSoonIn","type":"object"}}},{"type":"function","function":{"name":"reg_resolve","description":"Any regulatory string in — agency name or acronym, \"40 CFR 60\", a document number — canonical identifier and the ready-to-call endpoint out. One call instead of picking a lookup. Free, no key. Free. Use when: You have a citation, acronym or document number and need the identifier plus where to send it.","parameters":{"additionalProperties":false,"properties":{"q":{"description":"An agency name, acronym or slug, a CFR citation like '40 CFR 60', a document number like 2026-12341, or a docket id; resolving nothing is an error.","maxLength":80,"minLength":2,"title":"Q","type":"string"},"limit":{"default":10,"description":"Maximum matches returned, exact acronym and slug hits before prefix hits.","maximum":25,"minimum":1,"title":"Limit","type":"integer"}},"required":["q"],"title":"RegResolveIn","type":"object"}}},{"type":"function","function":{"name":"reg_significant_rules","description":"Only E.O. 12866 significant federal rules and proposed rules — the OIRA-reviewed, economically major subset — newest first with deadline flags, optionally one agency. The high-signal fraction of rulemaking without scanning everything. Costs $0.02 per call. Use when: You want signal over volume — only rulemaking with major economic impact.","parameters":{"additionalProperties":false,"properties":{"agency":{"anyOf":[{"maxLength":120,"pattern":"^[a-z0-9-]+$","type":"string"},{"type":"null"}],"default":null,"description":"Federal Register agency slug from /v1/regs/agencies, e.g. securities-and-exchange-commission; an unknown slug fails the call. Omit for all.","title":"Agency"},"types":{"default":"rule,proposed_rule","description":"Comma-separated Federal Register document types: rule, proposed_rule, notice, presidential. An unlisted type is rejected. Default rule,proposed_rule.","title":"Types","type":"string"},"since":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"publication_date >= this ISO date, e.g. 2026-06-01. Default: the last 90 days.","title":"Since"},"limit":{"default":25,"description":"Maximum significant documents returned, newest publication date first.","maximum":100,"minimum":1,"title":"Limit","type":"integer"}},"title":"SignificantIn","type":"object"}}},{"type":"function","function":{"name":"sec_13f_crowding","description":"Institutional breadth in an issuer over the quarters we hold: holders, value and shares per quarter with changes, plus the managers that entered or exited last quarter. Built from accumulated 13F history, not a single snapshot. Costs $0.05 per call. Use when: You need the direction of institutional interest in an issuer over time.","parameters":{"additionalProperties":false,"properties":{"issuer":{"description":"Issuer name prefix exactly as managers file it, case-insensitive (e.g. NVIDIA). A prefix with no recorded 13F holdings is an error.","maxLength":80,"minLength":2,"title":"Issuer","type":"string"},"quarters":{"default":6,"description":"How many of the most recent 13F report periods (calendar quarter ends) to trend over. Default 6; silently capped by the quarters currently indexed.","maximum":12,"minimum":2,"title":"Quarters","type":"integer"}},"required":["issuer"],"title":"CrowdingIn","type":"object"}}},{"type":"function","function":{"name":"sec_13f_holders","description":"List institutional holders of one issuer from the latest 13F period — manager, value, shares and put/call, ranked by position size. Query by as-filed issuer name or CUSIP; joins by name/CIK only (no identifier mapping). Costs $0.02 per call. Use when: Ownership questions per issuer.","parameters":{"additionalProperties":false,"properties":{"issuer":{"anyOf":[{"maxLength":80,"minLength":2,"type":"string"},{"type":"null"}],"default":null,"description":"Issuer name prefix as filed, case-insensitive (e.g. NVIDIA). Provide exactly one of issuer or cusip.","title":"Issuer"},"cusip":{"anyOf":[{"maxLength":9,"minLength":9,"type":"string"},{"type":"null"}],"default":null,"description":"9-character CUSIP exactly as filed, case-insensitive (e.g. 67066G104); take one from any holdings row this API returns. Provide exactly one of cusip or issuer.","title":"Cusip"},"limit":{"default":25,"description":"Maximum holding managers returned, one row each, ordered by reported position value descending. Default 25.","maximum":100,"minimum":1,"title":"Limit","type":"integer"}},"title":"HoldersIn","type":"object"}}},{"type":"function","function":{"name":"sec_13f_manager","description":"Get an institutional manager's reported holdings from its latest 13F-HR — issuer, as-filed CUSIP/FIGI, value and shares, largest first, accession-cited. The dataset gated at competitors' top tiers, priced per call. Costs $0.02 per call. Use when: Per-manager portfolio questions; search view resolves the CIK first.","parameters":{"additionalProperties":false,"properties":{"cik":{"description":"CIK of the 13F filer (institutional manager), 1-10 digits, zero padding optional (e.g. 1067983 for Berkshire Hathaway). A CIK with no 13F-HR in the held periods is an error; find one with /v1/sec/13f/managers.","maxLength":10,"pattern":"^\\d{1,10}$","title":"Cik","type":"string"},"period":{"anyOf":[{"maxLength":10,"pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"},{"type":"null"}],"default":null,"description":"13F report period, the calendar quarter end as YYYY-MM-DD (e.g. 2026-06-30). Omit for the newest quarter held, falling back to earlier held quarters.","title":"Period"},"limit":{"default":50,"description":"Maximum holdings returned from the selected filing, ordered by reported position value descending. Default 50.","maximum":500,"minimum":1,"title":"Limit","type":"integer"}},"required":["cik"],"title":"ManagerIn","type":"object"}}},{"type":"function","function":{"name":"sec_13f_manager_changes","description":"Get a manager's quarter-over-quarter 13F changes — new, exited, increased and decreased positions with values and shares for both quarters. The premium derived layer at competitors, computed from primary filings in one call. Costs $0.05 per call. Use when: Flow questions per manager; needs the manager CIK.","parameters":{"additionalProperties":false,"properties":{"cik":{"description":"CIK of the 13F filer (institutional manager), 1-10 digits, zero padding optional (e.g. 1067983 for Berkshire Hathaway). Needs a 13F-HR in both of the two most recently indexed quarters; find a manager with /v1/sec/13f/managers.","maxLength":10,"pattern":"^\\d{1,10}$","title":"Cik","type":"string"},"limit":{"default":50,"description":"Maximum position changes returned, ordered by the larger of the current and prior reported position value, descending. Default 50.","maximum":200,"minimum":1,"title":"Limit","type":"integer"}},"required":["cik"],"title":"ChangesIn","type":"object"}}},{"type":"function","function":{"name":"sec_8k_auditor_change","description":"List 8-Ks reporting an auditor change (Item 4.01) market-wide — a standing accounting red flag with company, time and links. Use for accounting-risk monitoring instead of filtering the tape. Costs $0.02 per call. Use when: Accounting-quality screens.","parameters":{"additionalProperties":false,"properties":{"since":{"anyOf":[{"maxLength":32,"type":"string"},{"type":"null"}],"default":null,"description":"Earliest event time, ISO 8601 date or timestamp (e.g. 2026-08-01 or 2026-08-01T00:00:00Z); UTC if no offset, capped at 90 days back. Omit for this view's own default window of 7 to 30 recent days.","title":"Since"},"limit":{"default":50,"description":"Maximum 8-K events of this view's event type returned, newest first; 1 to 200, default 50.","maximum":200,"minimum":1,"title":"Limit","type":"integer"}},"title":"WindowIn","type":"object"}}},{"type":"function","function":{"name":"sec_8k_bankruptcy","description":"List 8-Ks reporting bankruptcy or receivership (Item 1.03) market-wide with company, time, flags and links. Use for distress monitoring without filtering the whole 8-K tape yourself. Costs $0.02 per call. Use when: Distress and credit monitoring.","parameters":{"additionalProperties":false,"properties":{"since":{"anyOf":[{"maxLength":32,"type":"string"},{"type":"null"}],"default":null,"description":"Earliest event time, ISO 8601 date or timestamp (e.g. 2026-08-01 or 2026-08-01T00:00:00Z); UTC if no offset, capped at 90 days back. Omit for this view's own default window of 7 to 30 recent days.","title":"Since"},"limit":{"default":50,"description":"Maximum 8-K events of this view's event type returned, newest first; 1 to 200, default 50.","maximum":200,"minimum":1,"title":"Limit","type":"integer"}},"title":"WindowIn","type":"object"}}},{"type":"function","function":{"name":"sec_8k_changes","description":"Half-cent poll: ids of flagged 8-K events added or updated since your cursor, with the next cursor and the URL of the full feed. Call it in a loop; fetch the feed only when changed > 0. Costs $0.005 per call. Use when: A polling loop that needs to know whether anything happened, cheaply, before deciding to fetch and parse rows.","parameters":{"additionalProperties":false,"properties":{"cursor":{"anyOf":[{"maxLength":64,"type":"string"},{"type":"null"}],"default":null,"description":"The `next_cursor` from your previous call to this endpoint. Omit it on the first call: you get changed=0 and a cursor set to now, which starts a poll loop for the price of one call. Cursors older than 7 days are clamped to 7 days back — this is a re-check, not a backfill; fetch the full feed instead.","title":"Cursor"}},"title":"ChangesIn","type":"object"}}},{"type":"function","function":{"name":"sec_8k_cyber_incident","description":"List 8-Ks disclosing material cybersecurity incidents (Item 1.05) market-wide with company, time and links. Use for breach monitoring — security and insurance agents get the mandatory disclosures without reading the tape. Costs $0.02 per call. Use when: Security, insurance and vendor-risk monitoring.","parameters":{"additionalProperties":false,"properties":{"since":{"anyOf":[{"maxLength":32,"type":"string"},{"type":"null"}],"default":null,"description":"Earliest event time, ISO 8601 date or timestamp (e.g. 2026-08-01 or 2026-08-01T00:00:00Z); UTC if no offset, capped at 90 days back. Omit for this view's own default window of 7 to 30 recent days.","title":"Since"},"limit":{"default":50,"description":"Maximum 8-K events of this view's event type returned, newest first; 1 to 200, default 50.","maximum":200,"minimum":1,"title":"Limit","type":"integer"}},"title":"WindowIn","type":"object"}}},{"type":"function","function":{"name":"sec_8k_delisting","description":"List 8-Ks reporting delisting notices or listing-rule deficiencies (Item 3.01) market-wide with company, time and links. Use for listing-status and distress monitoring without reading the tape. Costs $0.02 per call. Use when: Distress and small-cap risk screens.","parameters":{"additionalProperties":false,"properties":{"since":{"anyOf":[{"maxLength":32,"type":"string"},{"type":"null"}],"default":null,"description":"Earliest event time, ISO 8601 date or timestamp (e.g. 2026-08-01 or 2026-08-01T00:00:00Z); UTC if no offset, capped at 90 days back. Omit for this view's own default window of 7 to 30 recent days.","title":"Since"},"limit":{"default":50,"description":"Maximum 8-K events of this view's event type returned, newest first; 1 to 200, default 50.","maximum":200,"minimum":1,"title":"Limit","type":"integer"}},"title":"WindowIn","type":"object"}}},{"type":"function","function":{"name":"sec_8k_impairment","description":"List 8-Ks disclosing material impairments (Item 2.06) market-wide with company, time and links — write-down events pre-filtered from the tape. Use for credit and asset-quality monitoring. Costs $0.02 per call. Use when: Credit and asset-quality screens.","parameters":{"additionalProperties":false,"properties":{"since":{"anyOf":[{"maxLength":32,"type":"string"},{"type":"null"}],"default":null,"description":"Earliest event time, ISO 8601 date or timestamp (e.g. 2026-08-01 or 2026-08-01T00:00:00Z); UTC if no offset, capped at 90 days back. Omit for this view's own default window of 7 to 30 recent days.","title":"Since"},"limit":{"default":50,"description":"Maximum 8-K events of this view's event type returned, newest first; 1 to 200, default 50.","maximum":200,"minimum":1,"title":"Limit","type":"integer"}},"title":"WindowIn","type":"object"}}},{"type":"function","function":{"name":"sec_8k_items_history","description":"Get a filer's 8-K history with item codes — filter by item (e.g. 5.02 officer changes, 2.02 earnings) and date; includes coverage note. Use instead of paginating submissions and mapping item codes yourself. Costs $0.02 per call. Use when: Per-company 8-K event history questions.","parameters":{"additionalProperties":false,"properties":{"ticker":{"anyOf":[{"maxLength":12,"type":"string"},{"type":"null"}],"default":null,"description":"US exchange ticker, case-insensitive (e.g. AAPL); resolved through the EDGAR ticker map, and an unknown ticker returns 422. Provide exactly one of ticker or cik.","title":"Ticker"},"cik":{"anyOf":[{"maxLength":10,"pattern":"^\\d{1,10}$","type":"string"},{"type":"null"}],"default":null,"description":"SEC CIK, 1-10 digits, zero padding optional (e.g. 320193 or 0000320193). Provide exactly one of cik or ticker.","title":"Cik"},"since":{"anyOf":[{"maxLength":10,"pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"},{"type":"null"}],"default":null,"description":"ISO date, YYYY-MM-DD (e.g. 2025-01-01); keeps 8-K filings filed on or after it. Omitted means the whole EDGAR recent-submissions window.","title":"Since"},"items":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated item codes, e.g. 5.02,2.02","title":"Items"},"limit":{"default":100,"description":"Maximum 8-K filings to return after the since and items filters, newest filing date first. Default 100.","maximum":500,"minimum":1,"title":"Limit","type":"integer"}},"title":"EightKHistoryIn","type":"object"}}},{"type":"function","function":{"name":"sec_8k_ma_events","description":"List 8-Ks reporting completed acquisitions, dispositions or changes of control (Items 2.01 and 5.01) market-wide with company, time and links. Use for deal monitoring without filtering the tape. Costs $0.02 per call. Use when: Deal-flow and event-driven monitoring.","parameters":{"additionalProperties":false,"properties":{"since":{"anyOf":[{"maxLength":32,"type":"string"},{"type":"null"}],"default":null,"description":"Earliest event time, ISO 8601 date or timestamp (e.g. 2026-08-01 or 2026-08-01T00:00:00Z); UTC if no offset, capped at 90 days back. Omit for this view's own default window of 7 to 30 recent days.","title":"Since"},"limit":{"default":50,"description":"Maximum 8-K events of this view's event type returned, newest first; 1 to 200, default 50.","maximum":200,"minimum":1,"title":"Limit","type":"integer"}},"title":"WindowIn","type":"object"}}},{"type":"function","function":{"name":"sec_8k_non_reliance","description":"List 8-Ks declaring non-reliance on previously issued financials (Item 4.02) — the restatement red flag, market-wide with company, time and links. Use instead of filtering the 8-K tape for the rarest, highest-salience accounting event. Costs $0.02 per call. Use when: Accounting-risk and short-research screens.","parameters":{"additionalProperties":false,"properties":{"since":{"anyOf":[{"maxLength":32,"type":"string"},{"type":"null"}],"default":null,"description":"Earliest event time, ISO 8601 date or timestamp (e.g. 2026-08-01 or 2026-08-01T00:00:00Z); UTC if no offset, capped at 90 days back. Omit for this view's own default window of 7 to 30 recent days.","title":"Since"},"limit":{"default":50,"description":"Maximum 8-K events of this view's event type returned, newest first; 1 to 200, default 50.","maximum":200,"minimum":1,"title":"Limit","type":"integer"}},"title":"WindowIn","type":"object"}}},{"type":"function","function":{"name":"sec_8k_officer_change","description":"List 8-Ks reporting officer or director changes (Item 5.02) market-wide — the most filed 8-K item, with company, time and links. Use for leadership-change monitoring without polling and mapping the tape. Costs $0.02 per call. Use when: Leadership and governance monitoring.","parameters":{"additionalProperties":false,"properties":{"since":{"anyOf":[{"maxLength":32,"type":"string"},{"type":"null"}],"default":null,"description":"Earliest event time, ISO 8601 date or timestamp (e.g. 2026-08-01 or 2026-08-01T00:00:00Z); UTC if no offset, capped at 90 days back. Omit for this view's own default window of 7 to 30 recent days.","title":"Since"},"limit":{"default":50,"description":"Maximum 8-K events of this view's event type returned, newest first; 1 to 200, default 50.","maximum":200,"minimum":1,"title":"Limit","type":"integer"}},"title":"WindowIn","type":"object"}}},{"type":"function","function":{"name":"sec_busiest_filers","description":"Rank filers by filing volume over any window up to five years, optionally per form — serial Form D issuers, heaviest 8-K disclosers, most active registrants — from our historical index in one call. Costs $0.02 per call. Use when: Ranked market questions by activity.","parameters":{"additionalProperties":false,"properties":{"form":{"anyOf":[{"maxLength":12,"type":"string"},{"type":"null"}],"default":null,"description":"Single EDGAR form type, matched exactly and case-insensitively (e.g. 8-K). Omit to count every form.","title":"Form"},"days":{"default":90,"description":"Length in days of the lookback window ending today, 1 to 1830, clamped at the start of index coverage. Default 90.","maximum":1830,"minimum":1,"title":"Days","type":"integer"},"limit":{"default":25,"description":"Maximum filers to return, ranked by filing count in the window, highest first. Default 25.","maximum":100,"minimum":1,"title":"Limit","type":"integer"}},"title":"TopFilersIn","type":"object"}}},{"type":"function","function":{"name":"sec_cik_lookup","description":"Resolve a ticker or company name to its SEC CIK — returns zero-padded CIK, ticker and registered name from the SEC's official mapping. Free. Use before any EDGAR call instead of downloading and parsing company_tickers.json yourself. Free. Use when: You have a ticker or name and need the CIK that filings, facts and insider endpoints take.","parameters":{"additionalProperties":false,"properties":{"ticker":{"anyOf":[{"maxLength":12,"type":"string"},{"type":"null"}],"default":null,"description":"Exact US exchange ticker, case-insensitive (e.g. AAPL). Provide ticker or name (both is allowed); no match returns an empty list, not an error.","title":"Ticker"},"name":{"anyOf":[{"maxLength":80,"minLength":2,"type":"string"},{"type":"null"}],"default":null,"description":"Case-insensitive substring of the registrant name (e.g. apple), matched against the SEC ticker file. Provide name or ticker; at most 25 matches are returned.","title":"Name"}},"title":"CikLookupIn","type":"object"}}},{"type":"function","function":{"name":"sec_companies_by_sic","description":"SIC industry code in, the registrants filing under it out (CIK + name + ticker). Turns an industry into a company list in one call instead of paging EDGAR's company search. Free, no key. Free. Use when: You have a SIC code (or got one from /v1/sec/sic) and need its companies.","parameters":{"additionalProperties":false,"properties":{"sic":{"description":"SEC SIC code, e.g. 7372 (see /v1/sec/sic)","maximum":9999,"minimum":100,"title":"Sic","type":"integer"},"limit":{"default":50,"description":"Maximum registrants to return, in EDGAR company-search order. Capped at 100. Default 50.","maximum":100,"minimum":1,"title":"Limit","type":"integer"}},"required":["sic"],"title":"SicCompaniesIn","type":"object"}}},{"type":"function","function":{"name":"sec_company_search","description":"Search SEC registrants by name substring or ticker — returns candidate filers with CIK, ticker and registered name. Free. Use to disambiguate an informal company name before calling filings or facts endpoints. Free. Use when: The exact registered name or ticker is unknown.","parameters":{"additionalProperties":false,"properties":{"q":{"description":"Search text, 2 to 80 characters: a case-insensitive substring of the registrant name or an exact ticker (e.g. tesla or TSLA). No match returns an empty list.","maxLength":80,"minLength":2,"title":"Q","type":"string"},"limit":{"default":10,"description":"Maximum matches returned, in SEC ticker-file order (roughly largest first); 1 to 50, default 10.","maximum":50,"minimum":1,"title":"Limit","type":"integer"}},"required":["q"],"title":"CompanySearchIn","type":"object"}}},{"type":"function","function":{"name":"sec_crosswalk","description":"A company resolved across SEC EDGAR and federal spending in one call: exact CIK plus candidate USAspending recipient names, each graded exact/strong/weak because the join is by name, not by key. Free, no key. Free. Use when: You have a company and need its identity in both the SEC and federal-spending worlds.","parameters":{"additionalProperties":false,"properties":{"q":{"anyOf":[{"maxLength":80,"minLength":2,"type":"string"},{"type":"null"}],"default":null,"description":"Any issuer string: company name, ticker or CIK (e.g. Nvidia). Provide exactly one of q, ticker or cik; ticker and cik take precedence over q.","title":"Q"},"ticker":{"anyOf":[{"maxLength":12,"type":"string"},{"type":"null"}],"default":null,"description":"US exchange ticker, case-insensitive (e.g. AAPL). Provide exactly one of ticker, cik or q.","title":"Ticker"},"cik":{"anyOf":[{"maxLength":10,"pattern":"^\\d{1,10}$","type":"string"},{"type":"null"}],"default":null,"description":"SEC CIK, 1-10 digits, zero padding optional (e.g. 320193). Provide exactly one of cik, ticker or q.","title":"Cik"}},"title":"CrosswalkIn","type":"object"}}},{"type":"function","function":{"name":"sec_distress_screen","description":"Rank companies by distress signals in one call — bankruptcy, delisting notices, restatements and impairments joined and sorted by salience score. A derived screen no other API sells as one endpoint; use for credit and short research. Costs $0.05 per call. Use when: Cross-signal distress screening.","parameters":{"additionalProperties":false,"properties":{"since":{"anyOf":[{"maxLength":32,"type":"string"},{"type":"null"}],"default":null,"description":"Earliest event time, ISO 8601 date or timestamp (e.g. 2026-08-01 or 2026-08-01T00:00:00Z); UTC if no offset, capped at 90 days back. Default: 30 days.","title":"Since"},"min_score":{"default":0.0,"description":"Keep only events whose score is at or above this value, 0 to 1. Default 0 keeps every distress event, including those with no score.","maximum":1,"minimum":0,"title":"Min Score","type":"number"},"limit":{"default":50,"description":"Maximum distress events returned, highest score first; 1 to 200, default 50.","maximum":200,"minimum":1,"title":"Limit","type":"integer"}},"title":"DistressIn","type":"object"}}},{"type":"function","function":{"name":"sec_earnings_changes","description":"Half-cent poll: accession numbers of earnings releases added or updated since your cursor, with the next cursor and the URL of the full feed. Call it in a loop; fetch the feed only when changed > 0. Costs $0.005 per call. Use when: A polling loop that needs to know whether any issuer has reported, cheaply, before deciding to buy the feed.","parameters":{"additionalProperties":false,"properties":{"cursor":{"anyOf":[{"maxLength":64,"type":"string"},{"type":"null"}],"default":null,"description":"The `next_cursor` from your previous call to this endpoint. Omit it on the first call: you get changed=0 and a cursor set to now, which starts a poll loop for the price of one call. Cursors older than 7 days are clamped to 7 days back — this is a re-check, not a backfill; fetch the full feed instead.","title":"Cursor"}},"title":"ChangesIn","type":"object"}}},{"type":"function","function":{"name":"sec_earnings_latest","description":"The issuer's most recent 8-K Item 2.02 earnings release: revenue, net income and diluted EPS with prior-year comparatives and YoY change, each with source, confidence and the exact row it was read from, plus links to the 8-K and the press release. Costs $0.02 per call. Use when: You have a ticker or CIK and need the most recent reported quarter's headline figures with links to the filing that stated them.","parameters":{"additionalProperties":false,"properties":{"ticker":{"anyOf":[{"maxLength":12,"type":"string"},{"type":"null"}],"default":null,"description":"US exchange ticker of the issuer, case-insensitive (e.g. ADBE). Provide ticker or cik; cik wins if both are sent. An issuer with no indexed release returns found=false, not an error.","title":"Ticker"},"cik":{"anyOf":[{"maxLength":10,"pattern":"^\\d{1,10}$","type":"string"},{"type":"null"}],"default":null,"description":"SEC CIK of the issuer, with or without leading zeros (e.g. 796343 or 0000796343). Provide cik or ticker; resolve a name first with /v1/sec/cik.","title":"Cik"}},"title":"LatestIn","type":"object"}}},{"type":"function","function":{"name":"sec_earnings_recent","description":"Market-wide feed of 8-K Item 2.02 earnings releases, newest indexed first, each with revenue, net income and diluted EPS, prior-year comparatives, document links and a per-figure source and confidence. Costs $0.02 per call. Use when: You want everything that reported in a window, not one named issuer.","parameters":{"additionalProperties":false,"properties":{"since":{"anyOf":[{"maxLength":32,"type":"string"},{"type":"null"}],"default":null,"description":"Earliest index time, ISO 8601 date or timestamp (e.g. 2026-09-17 or 2026-09-17T12:00:00Z); UTC if no offset, capped at 90 days back. Default: 2 days.","title":"Since"},"limit":{"default":25,"description":"Maximum releases to return, newest indexed first; 1 to 100, default 25.","maximum":100,"minimum":1,"title":"Limit","type":"integer"}},"title":"RecentIn","type":"object"}}},{"type":"function","function":{"name":"sec_entity_profile","description":"Get a registrant's full SEC identity — tickers, exchanges, SIC and description, entity type, state of incorporation, fiscal year end and former names — free, from the submissions API without downloading the megabyte JSON. Free. Use when: Identity and classification questions about any SEC filer.","parameters":{"additionalProperties":false,"properties":{"ticker":{"anyOf":[{"maxLength":12,"type":"string"},{"type":"null"}],"default":null,"description":"US exchange ticker, case-insensitive (e.g. AAPL); resolved through the EDGAR ticker map, and an unknown ticker returns 422. Provide exactly one of ticker or cik.","title":"Ticker"},"cik":{"anyOf":[{"maxLength":10,"pattern":"^\\d{1,10}$","type":"string"},{"type":"null"}],"default":null,"description":"SEC CIK, 1-10 digits, zero padding optional (e.g. 320193 or 0000320193). Provide exactly one of cik or ticker.","title":"Cik"}},"title":"TickerCikIn","type":"object"}}},{"type":"function","function":{"name":"sec_event_explain","description":"Explain one indexed filing — returns its form, 8-K items and labels, and every derived event with flags and salience score, free. Use to audit any signal from our paid SEC endpoints against the underlying filing. Free. Use when: Verifying or debugging a flag from any events endpoint.","parameters":{"additionalProperties":false,"properties":{"accession":{"description":"EDGAR accession number with dashes, 10-2-6 digits (e.g. 0001193125-26-000123). An accession outside our recent-filings index returns 422.","maxLength":25,"pattern":"^\\d{10}-\\d{2}-\\d{6}$","title":"Accession","type":"string"}},"required":["accession"],"title":"ExplainIn","type":"object"}}},{"type":"function","function":{"name":"sec_filing_cadence","description":"Get a filer's year-by-year filing counts per form since 2021 — reporting rhythm, disclosure volume and gaps in one call from our historical index. Use to spot stopped reports or disclosure spikes without listing filings. Costs $0.02 per call. Use when: Rhythm/volume questions per filer.","parameters":{"additionalProperties":false,"properties":{"ticker":{"anyOf":[{"maxLength":12,"type":"string"},{"type":"null"}],"default":null,"description":"US exchange ticker, case-insensitive (e.g. AAPL); resolved through the EDGAR ticker map, and an unknown ticker returns 422. Provide exactly one of ticker or cik.","title":"Ticker"},"cik":{"anyOf":[{"maxLength":10,"pattern":"^\\d{1,10}$","type":"string"},{"type":"null"}],"default":null,"description":"SEC CIK, 1-10 digits, zero padding optional (e.g. 320193 or 0000320193). Provide exactly one of cik or ticker.","title":"Cik"}},"title":"CadenceIn","type":"object"}}},{"type":"function","function":{"name":"sec_filing_calendar","description":"Get a filer's reporting cadence — fiscal year end, last 10-K/10-Q dates and naive next-report estimates from historical spacing. Use to time monitoring windows without deriving cadence from raw filings. Costs $0.02 per call. Use when: Timing questions around periodic reports.","parameters":{"additionalProperties":false,"properties":{"ticker":{"anyOf":[{"maxLength":12,"type":"string"},{"type":"null"}],"default":null,"description":"US exchange ticker, case-insensitive (e.g. AAPL); resolved through the EDGAR ticker map, and an unknown ticker returns 422. Provide exactly one of ticker or cik.","title":"Ticker"},"cik":{"anyOf":[{"maxLength":10,"pattern":"^\\d{1,10}$","type":"string"},{"type":"null"}],"default":null,"description":"SEC CIK, 1-10 digits, zero padding optional (e.g. 320193 or 0000320193). Provide exactly one of cik or ticker.","title":"Cik"}},"title":"TickerCikIn","type":"object"}}},{"type":"function","function":{"name":"sec_flag_glossary","description":"List every event flag our SEC pipeline emits — insider_buy_cluster, distress, accounting_red_flag, large_raise and more — with meanings. Free. Use once to filter the events and watch endpoints precisely. Free. Use when: Before filtering any flagged feed.","parameters":{"additionalProperties":false,"properties":{},"title":"EmptyIn","type":"object"}}},{"type":"function","function":{"name":"sec_form_glossary","description":"List SEC form types with plain-English meaning and a covered flag for our 15-minute index — returns code, name, description per form. Free. Use to orient an agent before choosing which SEC endpoint to call. Free. Use when: First call when deciding which SEC product fits a task.","parameters":{"additionalProperties":false,"properties":{},"title":"EmptyIn","type":"object"}}},{"type":"function","function":{"name":"sec_form_trend","description":"Get monthly EDGAR-wide volume for any form since 2021 — S-1 as an IPO-pipeline proxy, Form D as private-capital activity, 10-K seasonality — one series, coverage stated. Use instead of counting filings yourself month by month. Costs $0.02 per call. Use when: Market-level cycle and seasonality questions by form.","parameters":{"additionalProperties":false,"properties":{"form":{"description":"e.g. S-1, 8-K, D, 13F-HR, 10-K","maxLength":12,"title":"Form","type":"string"},"since":{"anyOf":[{"maxLength":10,"pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"},{"type":"null"}],"default":null,"description":"ISO date, YYYY-MM-DD (e.g. 2023-01-01); first filing date counted. Defaults to, and is clamped at, the start of index coverage reported as index_from.","title":"Since"}},"required":["form"],"title":"TrendIn","type":"object"}}},{"type":"function","function":{"name":"sec_formd_changes","description":"Half-cent poll: ids of Form D filings added or updated since your cursor, with the next cursor and the URL of the full feed. Call it in a loop; fetch the feed only when changed > 0. Costs $0.005 per call. Use when: A polling loop that needs to know whether anything happened, cheaply, before deciding to fetch and parse rows.","parameters":{"additionalProperties":false,"properties":{"cursor":{"anyOf":[{"maxLength":64,"type":"string"},{"type":"null"}],"default":null,"description":"The `next_cursor` from your previous call to this endpoint. Omit it on the first call: you get changed=0 and a cursor set to now, which starts a poll loop for the price of one call. Cursors older than 7 days are clamped to 7 days back — this is a re-check, not a backfill; fetch the full feed instead.","title":"Cursor"}},"title":"ChangesIn","type":"object"}}},{"type":"function","function":{"name":"sec_full_text_search","description":"Search EDGAR filing text for any phrase with form and date filters — returns matching filings with filer, date, items and URL. The search competitors gate at their top tier or lack entirely; one call, no crawling. Costs $0.02 per call. Use when: Content questions across filings.","parameters":{"additionalProperties":false,"properties":{"q":{"description":"Full-text query, e.g. \"supply chain disruption\"","maxLength":200,"minLength":2,"title":"Q","type":"string"},"forms":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated EDGAR form types to restrict the search, e.g. 8-K,10-K. Defaults to 8-K when omitted.","title":"Forms"},"start":{"description":"Required ISO date, YYYY-MM-DD (e.g. 2026-01-01); inclusive start of the filing-date window searched.","maxLength":10,"pattern":"^\\d{4}-\\d{2}-\\d{2}$","title":"Start","type":"string"},"end":{"description":"Required ISO date, YYYY-MM-DD (e.g. 2026-06-30); inclusive end of the filing-date window searched.","maxLength":10,"pattern":"^\\d{4}-\\d{2}-\\d{2}$","title":"End","type":"string"},"limit":{"default":25,"description":"Maximum matching filings to return, in the relevance order EDGAR full-text search returns. No match yields an empty list. Default 25.","maximum":100,"minimum":1,"title":"Limit","type":"integer"}},"required":["q","start","end"],"title":"FullTextIn","type":"object"}}},{"type":"function","function":{"name":"sec_insider_changes","description":"Half-cent poll: ids of insider events added or updated since your cursor, with the next cursor and the URL of the full feed. Call it in a loop; fetch the feed only when changed > 0. Costs $0.005 per call. Use when: A polling loop that needs to know whether anything happened, cheaply, before deciding to fetch and parse rows.","parameters":{"additionalProperties":false,"properties":{"cursor":{"anyOf":[{"maxLength":64,"type":"string"},{"type":"null"}],"default":null,"description":"The `next_cursor` from your previous call to this endpoint. Omit it on the first call: you get changed=0 and a cursor set to now, which starts a poll loop for the price of one call. Cursors older than 7 days are clamped to 7 days back — this is a re-check, not a backfill; fetch the full feed instead.","title":"Cursor"}},"title":"ChangesIn","type":"object"}}},{"type":"function","function":{"name":"sec_insider_clusters","description":"List issuers where 3+ distinct officers or directors bought within a week — returns combined buy USD, insider count and names per issuer. A derived cluster signal no other API sells as one call; use as a high-conviction insider screen. Costs $0.05 per call. Use when: Screening for the strongest insider-buying setups.","parameters":{"additionalProperties":false,"properties":{"days":{"default":7,"description":"Length of the lookback window in days, counted back from now; 1 to 30, default 7.","maximum":30,"minimum":1,"title":"Days","type":"integer"},"min_insiders":{"default":3,"description":"Minimum number of distinct insiders buying the same issuer inside the window for it to be reported as a cluster; 2 to 10, default 3.","maximum":10,"minimum":2,"title":"Min Insiders","type":"integer"}},"title":"ClustersIn","type":"object"}}},{"type":"function","function":{"name":"sec_insider_screen","description":"Screen insider transactions market-wide — filter by code, buy/sell direction, minimum USD, owner role and window; returns parsed lines ranked by value. Use instead of polling EDGAR and joining Form 4 XML across every filer. Costs $0.02 per call. Use when: Market-wide questions about insider activity with filters; the per-issuer view is cheaper when you know the company.","parameters":{"additionalProperties":false,"properties":{"codes":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated: P,S,A,F,M,G,C,J,W","title":"Codes"},"direction":{"anyOf":[{"pattern":"^(buy|sell)$","type":"string"},{"type":"null"}],"default":null,"description":"Either buy (code P acquisitions) or sell (code S dispositions). Omit to keep both directions and every other transaction code.","title":"Direction"},"min_value_usd":{"default":0,"description":"Keep only transaction lines worth at least this many US dollars (e.g. 250000). Default 0 applies no value floor.","minimum":0,"title":"Min Value Usd","type":"number"},"role":{"anyOf":[{"pattern":"^(officer|director|ten_percent)$","type":"string"},{"type":"null"}],"default":null,"description":"Keep only lines whose reporting owner has this role: officer, director or ten_percent. Omit for all roles; an owner may hold several.","title":"Role"},"since":{"anyOf":[{"maxLength":32,"type":"string"},{"type":"null"}],"default":null,"description":"Earliest filing time, ISO 8601 date or timestamp (e.g. 2026-08-01 or 2026-08-01T00:00:00Z); UTC if no offset, capped at 90 days back. Default: 7 days.","title":"Since"},"limit":{"default":50,"description":"Maximum transaction lines returned, largest US dollar value first; 1 to 200, default 50.","maximum":200,"minimum":1,"title":"Limit","type":"integer"}},"title":"ScreenIn","type":"object"}}},{"type":"function","function":{"name":"sec_issuer_packet","description":"One document per public company joining SEC identity, flagged 8-K events, insider activity and clusters, Reg D history, XBRL facts, a computed peer group and the Federal Register rules that touch it. Replaces 6-8 calls and the joins between them; every section reports present/absent with a reason. Costs $0.2 per call. Use when: A broad question about one issuer, where the next step depends on what is there.","parameters":{"additionalProperties":false,"properties":{"ticker":{"anyOf":[{"maxLength":12,"type":"string"},{"type":"null"}],"default":null,"description":"Exchange ticker, e.g. AAPL. Give ticker or cik; cik wins if both are set.","title":"Ticker"},"cik":{"anyOf":[{"maxLength":10,"pattern":"^\\d{1,10}$","type":"string"},{"type":"null"}],"default":null,"description":"SEC CIK, digits only, zero-padding optional, e.g. 320193. Give cik or ticker.","title":"Cik"}},"title":"PacketIn","type":"object"}}},{"type":"function","function":{"name":"sec_metrics_catalog","description":"List the metric keys the XBRL views accept — revenue, net income, cash, capex and more, each mapped to its us-gaap tags — free. Use once before calling concept, compare, frame or financials. Free. Use when: First call before any XBRL view.","parameters":{"additionalProperties":false,"properties":{},"title":"EmptyLiveIn","type":"object"}}},{"type":"function","function":{"name":"sec_new_registrants","description":"First-time-ever EDGAR filers in your window, derived from our multi-year filing index — new companies and funds entering the SEC system, with first forms. A question EDGAR's own API cannot answer. Free, no key. Free. Use when: You want net-new registrants, not just recent filings.","parameters":{"additionalProperties":false,"properties":{"days":{"default":7,"description":"Window in days over the EDGAR filing date; a registrant counts as new when the index holds no filing for it before that cutoff. Default 7.","maximum":31,"minimum":1,"title":"Days","type":"integer"},"limit":{"default":50,"description":"Maximum registrants returned, ordered by first filing date descending then CIK. Default 50.","maximum":200,"minimum":1,"title":"Limit","type":"integer"}},"title":"NewRegistrantsIn","type":"object"}}},{"type":"function","function":{"name":"sec_resolve","description":"Any issuer string in — ticker, CIK or company name — canonical CIK, ticker, name, the match kind, and ready-to-call URLs for the next step out. One call instead of guessing which resolver to use. Free, no key. Free. Use when: You have any string identifying an issuer and want identifiers plus where to go next.","parameters":{"additionalProperties":false,"properties":{"q":{"description":"Ticker, CIK or company name","maxLength":80,"minLength":1,"title":"Q","type":"string"},"limit":{"default":10,"description":"Maximum matches to return, ranked ticker hit, then exact, prefix and substring name hits. best is always the top-ranked one. Default 10.","maximum":50,"minimum":1,"title":"Limit","type":"integer"}},"required":["q"],"title":"ResolveIn","type":"object"}}},{"type":"function","function":{"name":"sec_shares_outstanding","description":"Get reported common shares outstanding by period for one filer from XBRL — the series behind dilution and per-share math, deduplicated. Use instead of digging share counts out of companyfacts or cover pages. Costs $0.02 per call. Use when: Share-count questions.","parameters":{"additionalProperties":false,"properties":{"ticker":{"anyOf":[{"maxLength":12,"type":"string"},{"type":"null"}],"default":null,"description":"US exchange ticker, case-insensitive (e.g. AAPL); resolved through the EDGAR ticker map, and an unknown ticker returns 422. Provide exactly one of ticker or cik.","title":"Ticker"},"cik":{"anyOf":[{"maxLength":10,"pattern":"^\\d{1,10}$","type":"string"},{"type":"null"}],"default":null,"description":"SEC CIK, 1-10 digits, zero padding optional (e.g. 320193 or 0000320193). Provide exactly one of cik or ticker.","title":"Cik"}},"title":"TickerCikIn","type":"object"}}},{"type":"function","function":{"name":"sec_sic_lookup","description":"SEC SIC industry code resolution: code prefix or text in, code + industry title + reviewing Corp-Fin office out, over all 444 codes. Free, no key. Free. Use when: You need a SIC code for EDGAR industry filtering or to decode one from a filing header.","parameters":{"additionalProperties":false,"properties":{"q":{"description":"SIC code (or prefix) or industry text","maxLength":60,"minLength":1,"title":"Q","type":"string"},"limit":{"default":20,"description":"Maximum SIC entries returned, in ascending SIC code order. Default 20; no match returns an empty list.","maximum":100,"minimum":1,"title":"Limit","type":"integer"}},"required":["q"],"title":"SicLookupIn","type":"object"}}},{"type":"function","function":{"name":"sec_ticker_lookup","description":"Resolve an SEC CIK to its ticker and registered company name from the SEC's official mapping — the reverse of CIK lookup. Free. Use when a filing gives you a CIK and you need the tradable symbol. Free. Use when: You hold a CIK (from any filing) and need ticker and name.","parameters":{"additionalProperties":false,"properties":{"cik":{"description":"SEC CIK, 1-10 digits, zero padding optional (e.g. 320193 or 0000320193). A CIK with no ticker in the SEC ticker file returns an empty list, not an error.","maxLength":10,"pattern":"^\\d{1,10}$","title":"Cik","type":"string"}},"required":["cik"],"title":"TickerLookupIn","type":"object"}}},{"type":"function","function":{"name":"sec_transaction_codes","description":"Explain Form 4 transaction codes — P purchase, S sale, A award, F tax withholding, M exercise and the rest. Free. Use once so an insider screen filters on the right codes instead of guessing. Free. Use when: Before filtering insider transactions by code or direction.","parameters":{"additionalProperties":false,"properties":{},"title":"EmptyIn","type":"object"}}},{"type":"function","function":{"name":"sec_watchlist_events","description":"Get flagged SEC events for up to 25 tickers in one call — 8-K items, insider trades and raises since your cursor, with a next cursor to store. Use instead of running one EDGAR poll per portfolio name. Costs $0.02 per call. Use when: Recurring portfolio monitoring; store next_cursor between calls.","parameters":{"additionalProperties":false,"properties":{"tickers":{"description":"Comma-separated tickers, max 25","maxLength":300,"title":"Tickers","type":"string"},"since":{"anyOf":[{"maxLength":32,"type":"string"},{"type":"null"}],"default":null,"description":"Earliest event time, ISO 8601 date or timestamp (e.g. 2026-08-01 or 2026-08-01T00:00:00Z); UTC if no offset, capped at 90 days back. Default: 7 days.","title":"Since"},"limit":{"default":100,"description":"Maximum events returned across all watched tickers, newest first; 1 to 200, default 100. Poll again with next_cursor.","maximum":200,"minimum":1,"title":"Limit","type":"integer"}},"required":["tickers"],"title":"WatchlistIn","type":"object"}}},{"type":"function","function":{"name":"sec_xbrl_compare","description":"Compare one XBRL metric across up to 10 tickers — latest reported value per company, ranked, with period ends and tags. Use instead of N companyfacts downloads and a fiscal-alignment headache. Costs $0.05 per call. Use when: Peer comparisons on one metric.","parameters":{"additionalProperties":false,"properties":{"tickers":{"description":"Comma-separated tickers, max 10","maxLength":120,"title":"Tickers","type":"string"},"metric":{"description":"Required metric key from /v1/sec/xbrl/metrics (e.g. revenue) or a raw US-GAAP XBRL concept as us-gaap:<Tag>; tickers not reporting it are dropped from the result.","maxLength":120,"title":"Metric","type":"string"}},"required":["tickers","metric"],"title":"CompareIn","type":"object"}}},{"type":"function","function":{"name":"sec_xbrl_financials","description":"Get normalized key financials for one filer — revenue, net income, operating cash flow, assets, liabilities, capex, R&D and shares across eight reported periods. Use instead of downloading and normalizing the companyfacts JSON. Costs $0.02 per call. Use when: Multi-metric fundamentals for one company.","parameters":{"additionalProperties":false,"properties":{"ticker":{"anyOf":[{"maxLength":12,"type":"string"},{"type":"null"}],"default":null,"description":"US exchange ticker, case-insensitive (e.g. AAPL); resolved through the EDGAR ticker map, and an unknown ticker returns 422. Provide exactly one of ticker or cik.","title":"Ticker"},"cik":{"anyOf":[{"maxLength":10,"pattern":"^\\d{1,10}$","type":"string"},{"type":"null"}],"default":null,"description":"SEC CIK, 1-10 digits, zero padding optional (e.g. 320193 or 0000320193). Provide exactly one of cik or ticker.","title":"Cik"}},"title":"TickerCikIn","type":"object"}}},{"type":"function","function":{"name":"sec_xbrl_frame","description":"Rank every SEC filer on one XBRL metric for one period — top-N values with entity names and the total filer count, from the frames API. Use for whole-market screens without a bulk XBRL pipeline; one MCP incumbent exists for xbrl. Costs $0.05 per call. Use when: Whole-market, single-period metric questions.","parameters":{"additionalProperties":false,"properties":{"metric":{"description":"Required metric key from /v1/sec/xbrl/metrics (e.g. revenue) or a raw US-GAAP XBRL concept as us-gaap:<Tag>; one tag is queried across all filers.","maxLength":120,"title":"Metric","type":"string"},"period":{"description":"e.g. CY2025, CY2025Q1, CY2025Q1I","maxLength":12,"pattern":"^CY\\d{4}(Q[1-4])?I?$","title":"Period","type":"string"},"limit":{"default":50,"description":"Number of filers to return, ranked by reported value descending; total_filers reports the full population. Default 50.","maximum":200,"minimum":1,"title":"Limit","type":"integer"}},"required":["metric","period"],"title":"FrameIn","type":"object"}}},{"type":"function","function":{"name":"sec_xbrl_growth","description":"Annual XBRL metrics with YoY change and 3y/5y CAGR precomputed per company — revenue, earnings, assets and more. Skips period alignment, restatement duplicates and the growth math. Costs $0.05 per call. Use when: You need multi-year growth rates for one company from filed figures.","parameters":{"additionalProperties":false,"properties":{"ticker":{"anyOf":[{"maxLength":12,"type":"string"},{"type":"null"}],"default":null,"description":"US exchange ticker, case-insensitive (e.g. AAPL); resolved through the EDGAR ticker map, and an unknown ticker returns 422. Provide exactly one of ticker or cik.","title":"Ticker"},"cik":{"anyOf":[{"maxLength":10,"pattern":"^\\d{1,10}$","type":"string"},{"type":"null"}],"default":null,"description":"SEC CIK, 1-10 digits, zero padding optional (e.g. 320193 or 0000320193). Provide exactly one of cik or ticker.","title":"Cik"},"metrics":{"default":"revenue,net_income,total_assets","description":"Comma-separated metric names from /v1/sec/xbrl/metrics","maxLength":200,"title":"Metrics","type":"string"}},"title":"GrowthIn","type":"object"}}},{"type":"function","function":{"name":"sec_xbrl_ratios","description":"Margins, returns, leverage and R&D/capex intensity for a company from filed XBRL, every ratio period-aligned with its inputs shown and nulled rather than mixed across fiscal years. Costs $0.05 per call. Use when: You need ratios for one company from filed figures, with the inputs auditable.","parameters":{"additionalProperties":false,"properties":{"ticker":{"anyOf":[{"maxLength":12,"type":"string"},{"type":"null"}],"default":null,"description":"US exchange ticker, case-insensitive (e.g. AAPL); resolved through the EDGAR ticker map, and an unknown ticker returns 422. Provide exactly one of ticker or cik.","title":"Ticker"},"cik":{"anyOf":[{"maxLength":10,"pattern":"^\\d{1,10}$","type":"string"},{"type":"null"}],"default":null,"description":"SEC CIK, 1-10 digits, zero padding optional (e.g. 320193 or 0000320193). Provide exactly one of cik or ticker.","title":"Cik"}},"title":"RatiosIn","type":"object"}}}]}