/** * Endpoint bindings. Each method wraps `TwoS.request` with the right * path/method/typing for one route on https://2s.io. */ import type { TwoS, CallResult } from './index.js'; import type { CryptoChain, AiScreenshotResponse, UrlUnfurlResponse, UrlCleanResponse, AccountBalanceResponse } from './types.js'; type R = Promise>; /** * Catalog-wide normalized response envelope (migration in progress — * endpoints advertising `responseShape: 'normalized'` in /api/directory * return this shape; legacy endpoints keep their per-endpoint shapes). */ export interface Normalized, M = Record> { ok: true; items: T[]; total: number | null; page?: { number: number; size: number; pages: number | null; }; source: { provider: string; url: string; license: string; }; meta?: M; } export interface Endpoints { tcg: { games(input?: Record): R; sets(input: { game: string; q?: string; limit?: number; }): R; setPrices(input: { game: string; set: string; limit?: number; }): R; card(input: { game: string; set: string; productId: string; }): R; }; class: { industryResolve(input: { system: string; code: string; }): R; }; schedule: { cancel(input: { scheduleId: string; }): R; create(input: { callbackUrl: string; at?: string; everySeconds?: number; payload?: unknown; maxFires?: number; expiresInSeconds?: number; label?: string; }): R; status(input: { scheduleId: string; }): R; }; queue: { ack(input: { queue: string; id: string; leaseToken: string; }): R; enqueue(input: { queue: string; body?: string; maxAttempts?: number; }): R; lease(input: { queue: string; count?: number; visibilitySeconds?: number; }): R; stats(input: { queue: string; }): R; }; pubsub: { createTopic(input: { name: string; }): R; publish(input: { topicId: string; message?: string; }): R; subscribe(input: { topicId: string; callbackUrl: string; label?: string; }): R; unsubscribe(input: { subscriptionId: string; }): R; }; lock: { acquire(input: { key: string; ttlSeconds: number; }): R; release(input: { key: string; token: string; }): R; renew(input: { key: string; token: string; ttlSeconds: number; }): R; }; store: { blobDelete(input: { ns: string; key: string; }): R; blobGet(input: { ns: string; key: string; }): R; blobList(input: { ns: string; prefix?: string; limit?: number; after?: string; }): R; blobPut(input: { ns: string; key: string; data: string; contentType?: string; }): R; docDelete(input: { ns: string; id: string; }): R; docGet(input: { ns: string; id: string; }): R; docPut(input: { ns: string; id: string; body: string; meta?: string; redact?: boolean; }): R; docSearch(input: { ns: string; query: string; limit?: number; }): R; kvDelete(input: { ns: string; key: string; }): R; kvGet(input: { ns: string; key: string; }): R; kvPut(input: { ns: string; key: string; value?: string; }): R; kvScan(input: { ns: string; prefix?: string; limit?: number; after?: string; values?: boolean; }): R; usage(): R; vectorDelete(input: { ns: string; id: string; }): R; vectorQuery(input: { ns: string; embedding: unknown; topK?: number; }): R; vectorUpsert(input: { ns: string; id: string; embedding: unknown; body?: string; meta?: string; }): R; }; markets: { status(input?: { exchange?: string; }): R; holiday(input?: { exchange?: string; }): R; }; watchers: { packageRelease(input: { registry: string; name: string; callbackUrl: string; payload?: unknown; expiresInSeconds?: number; maxFires?: number; label?: string; }): R; iocReputation(input: { ioc: string; callbackUrl: string; payload?: unknown; expiresInSeconds?: number; maxFires?: number; label?: string; }): R; httpHeaders(input: { url: string; callbackUrl: string; payload?: unknown; expiresInSeconds?: number; maxFires?: number; label?: string; }): R; dns(input: { host: string; callbackUrl: string; payload?: unknown; expiresInSeconds?: number; maxFires?: number; label?: string; }): R; whois(input: { domain: string; callbackUrl: string; payload?: unknown; expiresInSeconds?: number; maxFires?: number; label?: string; }): R; fearGreed(input: { conditionType: string; threshold: number; callbackUrl: string; payload?: unknown; expiresInSeconds?: number; maxFires?: number; label?: string; }): R; fredSeries(input: { seriesId: string; conditionType: string; threshold: number; callbackUrl: string; payload?: unknown; expiresInSeconds?: number; maxFires?: number; label?: string; }): R; patent(input: { query: string; callbackUrl: string; payload?: unknown; expiresInSeconds?: number; maxFires?: number; label?: string; }): R; paper(input: { query: string; callbackUrl: string; payload?: unknown; expiresInSeconds?: number; maxFires?: number; label?: string; }): R; productRecall(input: { keyword?: string; callbackUrl: string; payload?: unknown; expiresInSeconds?: number; maxFires?: number; label?: string; }): R; fxRate(input: { base: string; quote: string; conditionType: string; threshold: number; callbackUrl: string; payload?: unknown; expiresInSeconds?: number; maxFires?: number; label?: string; }): R; fundingRate(input: { coin: string; conditionType: string; threshold: number; callbackUrl: string; payload?: unknown; expiresInSeconds?: number; maxFires?: number; label?: string; }): R; predictionMarket(input: { conditionId: string; outcomeIndex?: number; conditionType: string; threshold: number; callbackUrl: string; payload?: unknown; expiresInSeconds?: number; maxFires?: number; label?: string; }): R; secFiling(input: { ticker: string; form?: string; callbackUrl: string; payload?: unknown; expiresInSeconds?: number; maxFires?: number; label?: string; }): R; companyNews(input: { ticker: string; keyword?: string; callbackUrl: string; payload?: unknown; expiresInSeconds?: number; maxFires?: number; label?: string; }): R; ipo(input: { keyword?: string; callbackUrl: string; payload?: unknown; expiresInSeconds?: number; maxFires?: number; label?: string; }): R; federalRegister(input: { type?: string; agency?: string; keyword?: string; callbackUrl: string; payload?: unknown; expiresInSeconds?: number; maxFires?: number; label?: string; }): R; weatherAlert(input: { area: string; severity?: string; callbackUrl: string; payload?: unknown; expiresInSeconds?: number; maxFires?: number; label?: string; }): R; earthquake(input: { lat: number; lon: number; radiusKm?: number; minMagnitude?: number; callbackUrl: string; payload?: unknown; expiresInSeconds?: number; maxFires?: number; label?: string; }): R; flightStatus(input: { ident: string; callbackUrl: string; payload?: unknown; expiresInSeconds?: number; maxFires?: number; label?: string; }): R; tokenPrice(input: { tokenId: string; conditionType: string; threshold: number; callbackUrl: string; payload?: unknown; expiresInSeconds?: number; maxFires?: number; label?: string; }): R; gasPrice(input: { chain: string; conditionType: string; threshold: number; tier?: string; callbackUrl: string; payload?: unknown; expiresInSeconds?: number; maxFires?: number; label?: string; }): R; businessEarnings(input: { ticker: string; trigger?: string; daysBefore?: number; callbackUrl: string; payload?: unknown; expiresInSeconds?: number; maxFires?: number; label?: string; }): R; stockPrice(input: { ticker: string; conditionType: string; threshold: number; callbackUrl: string; payload?: unknown; expiresInSeconds?: number; maxFires?: number; label?: string; }): R; cancel(input: { watcherId: string; }): R; cryptoAddressActivity(input: { chain: string; address: string; callbackUrl: string; direction?: string; assetTypes?: unknown; minValueUsd?: number; payload?: unknown; expiresInSeconds?: number; maxFires?: number; label?: string; }): R; status(input: { watcherId: string; }): R; }; /** Time & date utilities. */ time: { parse(input: { input: string; tz?: string; }): R; }; account: { balance(): R; }; /** USDA agricultural statistics, drought, and trade. */ agriculture: { /** US Drought Monitor severity for a county (5-digit FIPS) or state (2-letter), weekly. */ drought(input: { area: string; weeks?: number; }): R; /** USDA NASS QuickStats — crop/livestock yields, acreage, production, prices. Requires commodity_desc + a bound. */ stats(input: { commodity_desc: string; year?: string; year__GE?: string; year__LE?: string; state_alpha?: string; county_name?: string; statisticcat_desc?: string; agg_level_desc?: string; short_desc?: string; freq_desc?: string; }): R; }; /** USDA-NRCS soil + USDA plant hardiness. */ soil: { /** SSURGO soil profile (map unit + ranked components) for a lat/lng. */ profile(input: { lat: number; lon: number; }): R; /** USDA plant hardiness zone for a US ZIP code. */ hardinessZone(input: { zip: string; }): R; }; /** FCC public data — docket filings + spectrum market areas. */ telecom: { /** Search FCC ECFS filings for a proceeding/docket. */ fccFilings(input: { proceeding: string; filer?: string; limit?: number; }): R; /** Map a lat/lon to its FCC spectrum market areas (CMA/BTA/MTA/PEA…) + census block. */ marketArea(input: { lat: number; lon: number; }): R; }; /** O*NET occupations (US DOL) — profile, search, related. */ occupation: { /** Full occupation dossier (skills/knowledge/abilities/tasks/tech) by SOC/O*NET-SOC code. */ profile(input: { code: string; }): R; /** Find occupations by keyword (job title, skill, activity). */ search(input: { keyword: string; limit?: number; }): R; /** Related/career-adjacent occupations for a code. */ related(input: { code: string; limit?: number; }): R; }; /** US Bureau of Labor Statistics — wages, openings, unemployment. */ labor: { /** OEWS occupational wages by SOC code, nationally or by state. */ wages(input: { soc: string; state?: string; }): R; /** JOLTS labor-market turnover (openings/hires/quits/layoffs/separations), national monthly. */ openings(input?: { measure?: 'openings' | 'hires' | 'quits' | 'layoffs' | 'separations'; months?: number; }): R; /** Unemployment (rate/counts) for "US" or a 2-letter state, monthly. */ unemployment(input: { area: string; measure?: 'rate' | 'unemployed' | 'employed' | 'laborforce'; months?: number; }): R; }; /** USCG PSIX vessel registry + port-state-control. */ maritime: { /** Search the USCG PSIX vessel registry by name/callsign/official number/HIN/flag/etc. */ vessel(input: { name?: string; callSign?: string; officialNumber?: string; hullNumber?: string; flag?: string; service?: string; buildYear?: string; vesselId?: string; }): R; /** USCG activity / port-state-control case history for a vessel id. */ cases(input: { vesselId: string; }): R; /** NGA World Port Index lookup by port name and/or country: location, harbor type, depths, max vessel size, UN/LOCODE. */ port(input: { portName?: string; country?: string; limit?: number; }): R; }; /** MusicBrainz music metadata (CC0). */ music: { /** Resolve a recording/song by artist+title or free-text query. */ recording(input: { artist?: string; title?: string; query?: string; limit?: number; }): R; /** Resolve an artist by name or query. */ artist(input: { name?: string; query?: string; limit?: number; }): R; /** Resolve a release/album by barcode, artist+album, or query. */ release(input: { barcode?: string; artist?: string; album?: string; query?: string; limit?: number; }): R; }; /** Run many endpoint calls behind one x402 payment. */ batch: { /** * Execute up to 50 catalog calls in one request, settled once. Price = sum * of sub-call prices (no discount). Atomic: every sub-call must succeed or * nothing is charged. Excludes bearer-only, deprecated, variable-priced, * and metered-upstream endpoints. */ run(input: { calls: Array<{ endpoint: string; params?: Record; }>; }): R; }; ai: { chat(input: { model: string; messages: unknown; max_tokens?: number; temperature?: number; top_p?: number; stop?: string; }): R; image(input: { model: string; prompt: string; n?: number; size?: string; }): R; council(input: { prompt: string; mode?: string; models?: unknown; maxTokens?: number; }): R; ocr(input: { imageUrl: string; instruction?: string; }): R; research(input: { query: string; urls?: unknown; }): R; webAnswer(input: { query: string; topic?: string; maxResults?: number; }): R; summarize(input: { url: string; instruction?: string; }): R; /** POST — server param names: text, targetLanguage, sourceLanguage. */ translate(input: { text: string; targetLanguage: string; sourceLanguage?: string; }): R; extract(input: { url: string; schema: Record; instruction?: string; }): R>; /** POST — server param name: imageUrl (HTTPS URL of a JPEG/PNG/GIF/WebP image ≤1MB). */ describeImage(input: { imageUrl: string; instruction?: string; }): R; screenshot(input: { url: string; width?: number; height?: number; fullPage?: boolean; format?: 'png' | 'jpeg' | 'webp'; quality?: number; waitUntil?: 'load' | 'domcontentloaded' | 'networkidle0' | 'networkidle2'; timeoutMs?: number; deviceScaleFactor?: number; blockAds?: boolean; }): R; /** Zero-shot text classification — assign text to your labels (or several when multiLabel) with confidence + rationale. POST { text, labels[], multiLabel? }. */ classify(input: { text: string; labels: string[]; multiLabel?: boolean; }): R; /** Named-entity recognition — extract people/orgs/locations/dates/money/etc with type + mention count. POST { text }. */ entities(input: { text: string; }): R; /** Content moderation — per-category boolean + 0..1 severity score + overall flagged verdict. POST { text }. */ moderate(input: { text: string; }): R; /** PII detection — finds names/emails/phones/SSNs/cards/etc with type + exact substring for redaction. POST { text }. */ pii(input: { text: string; }): R; /** Sentiment analysis — polarity (positive/negative/neutral/mixed), -1..1 score, confidence + rationale. POST { text }. */ sentiment(input: { text: string; }): R; }; airport: { /** Look up by IATA (3-letter) or ICAO (4-letter) code. */ lookup(input: { code: string; }): R; near(input: { lat: number; lon: number; radius_km?: number; limit?: number; type?: 'large_airport' | 'medium_airport' | 'small_airport' | 'heliport' | 'seaplane_base' | 'balloonport' | 'closed'; country?: string; scheduled_service?: boolean; }): R; }; barcode: { /** Returns raw image bytes — `result.data` is a `Uint8Array`. */ generate(input: { data: { type: 'text' | 'url'; text?: string; url?: string; }; format?: 'qr' | 'code128' | 'ean13'; }): R; }; /** Official-holiday lookup + holiday-aware business-day math (200+ countries, computed locally). */ calendar: { earnings(input?: { from?: string; to?: string; ticker?: string; }): R; ipo(input?: { from?: string; to?: string; }): R; /** List official holidays for a country/region + year, exact observed dates incl. substitute days. */ holidays(input: { country: string; year: number | string; region?: string; types?: string; lang?: string; }): R; /** Holiday-aware business-day math: start+addDays (shift), start+end (count), or start alone (check). */ businessDays(input: { country: string; start: string; addDays?: number; end?: string; region?: string; weekend?: string; types?: string; }): R; }; census: { zipcode(input: { zip: string; }): R; /** US Census ACS 5-year demographics for a state or county (population, income, poverty, housing). */ demographics(input: { state: string; county?: string; year?: number; }): R; }; climate: { stationNear(input: { lat: number; lon: number; radius_km?: number; limit?: number; }): R; /** Daily observed weather (GHCN-Daily) for one station over a date range (≤366 days). */ stationHistory(input: { station: string; startDate: string; endDate: string; dataTypes?: string; }): R; }; countdown: { /** Returns animated GIF bytes — `result.data` is a `Uint8Array`. Server param: endDate (ISO-8601 UTC). */ gif(input: { endDate: string; template?: 'default' | 'minimal' | 'neon' | 'retro' | 'corporate'; seconds?: number; fps?: number; width?: number; height?: number; [k: string]: unknown; }): R; }; crypto: { kimchiPremium(input?: { symbol?: string; }): R; balances(input: { address: string; chain?: string; tokens?: string; }): R; btcAddress(input: { address: string; }): R; btcMempool(input?: { minBtc?: number; }): R; btcTx(input: { txid: string; }): R; btcUtxos(input: { address: string; limit?: number; }): R; cexKlines(input: { pair: string; interval?: string; limit?: number; }): R; cexTicker(input: { pair: string; }): R; decodeCalldata(input: { data: string; }): R; nft(input: { address: string; tokenId: string; chain?: string; metadata?: string; }): R; nftSecurity(input: { address: string; chainId?: number; }): R; tokenMetadata(input: { address: string; chain?: string; }): R; vrf(input: { seed: string; }): R; /** DeFi TVL via DefiLlama: protocol= or chain= for one, or omit for the top protocols + total TVL. */ defi(input?: { protocol?: string; chain?: string; limit?: number; }): R; /** EVM contract decode: Sourcify verified ABI + function/event signatures + proxy, with optional 4-byte selector decode. GET { chain, address, selector? }. */ contract(input: { chain: string; address: string; selector?: string; }): R; /** Crypto Fear & Greed Index (0–100 sentiment). Pass `limit` for history or omit for current. */ fearGreed(input?: { limit?: number; }): R; /** Top cryptocurrencies by market cap (price, mcap, 24h/7d change). Pass `limit` (1–100). */ markets(input?: { limit?: number; }): R; /** Whole-crypto-market overview: total mcap, volume, BTC/ETH dominance. */ global(input?: Record): R; /** Trending (most-searched) cryptocurrencies right now. */ trending(input?: Record): R; addressValidate(input: { chain: CryptoChain; address: string; }): R; gasOracle(input?: { chain?: string; }): R; /** Current Bitcoin fee rates (sat/vByte) + mempool backlog from mempool.space. */ btcFees(): R; /** ENS forward + reverse resolution on Ethereum mainnet (live RPC). */ ensResolve(input: { query: string; }): R; /** Spot price + market data by CoinGecko asset ids (comma-separated, lowercase). */ tokenPrice(input: { ids: string; vs?: string; }): R; /** Live EVM transaction status + receipt by hash. Chains: base, ethereum, polygon, arbitrum, optimism. */ tx(input: { chain: 'base' | 'ethereum' | 'polygon' | 'arbitrum' | 'optimism'; hash: string; }): R; /** EVM address transaction history (Etherscan-family). chainId defaults to 1 (Ethereum). */ addressHistory(input: { address: string; chainId?: number; page?: number; offset?: number; sort?: 'asc' | 'desc'; startBlock?: number; endBlock?: number; }): R; /** Address safety report — risk signals/labels for an EVM address by chainId. */ addressSafety(input: { chainId: string; address: string; }): R; /** OFAC sanctions screen for a wallet address (any chain, case-insensitive). */ addressScreen(input: { address: string; }): R; /** Daily TVL history for a chain (DefiLlama). Pass chain (+ limit for most-recent N points). */ chainTvlHistory(input: { chain: string; limit?: number; }): R; /** Full coin profile by CoinGecko id (price, market data, links, description). */ coin(input: { id: string; }): R; /** Historical price/marketcap/volume series for a coin by CoinGecko id. */ coinHistory(input: { id: string; days?: number; vs?: string; }): R; /** DeFi chains ranked by TVL (DefiLlama). */ defiChains(input?: { limit?: number; }): R; /** DeFi protocol fees/revenue ranked (DefiLlama). kind fees|dexs, sort by window. */ defiFees(input?: { kind?: 'fees' | 'dexs'; sort?: 'total24h' | 'total7d' | 'total30d'; limit?: number; }): R; /** Daily TVL history for a DefiLlama protocol slug (+ limit for most-recent N points). */ defiProtocolHistory(input: { slug: string; limit?: number; }): R; /** DeFi yield pools (DefiLlama) — filter by chain/project/symbol/minApy/minTvl, sort by apy|tvl. */ defiYields(input?: { chain?: string; project?: string; symbol?: string; minApy?: number; minTvlUsd?: number; sort?: 'apy' | 'tvl'; limit?: number; }): R; /** Supported DEX networks (GeckoTerminal). */ dexNetworks(input?: { limit?: number; }): R; /** OHLCV candles for a DEX pool (GeckoTerminal). network + pool address + timeframe. */ dexOhlcv(input: { network: string; address: string; timeframe?: 'day' | 'hour' | 'minute'; aggregate?: number; limit?: number; }): R; /** Trending/new DEX pools for a network (GeckoTerminal). */ dexPools(input: { network: string; kind?: 'trending' | 'new'; limit?: number; }): R; /** Search DEX pools by token name/symbol/contract (GeckoTerminal), optional network scope. */ dexSearch(input: { query: string; network?: string; limit?: number; }): R; /** Pools trading a given token on a network (GeckoTerminal). */ dexTokenPools(input: { network: string; address: string; limit?: number; }): R; /** Hyperliquid perps — open interest, volume, funding (sort by oi|volume|funding). */ hyperliquidFunding(input?: { coin?: string; sort?: 'oi' | 'volume' | 'funding'; limit?: number; }): R; /** Hyperliquid predicted next-hour funding rates per coin across venues. */ hyperliquidPredictedFunding(input?: { coin?: string; limit?: number; }): R; /** Stablecoins by circulating USD (DefiLlama). */ stablecoins(input?: { limit?: number; }): R; /** Token info by network + contract address (GeckoTerminal). */ tokenInfo(input: { network: string; address: string; }): R; /** Token safety report by EVM chainId + contract address. */ tokenSafety(input: { chainId: string; address: string; }): R; /** ERC-20 token transfers for an EVM address (Etherscan-family). chainId defaults to 1. */ tokenTransfers(input: { address: string; chainId?: number; contractAddress?: string; page?: number; offset?: number; sort?: 'asc' | 'desc'; }): R; }; /** Deterministic validation/normalization primitives (no upstream). */ validate: { /** IBAN structural + ISO 7064 mod-97 checksum validation + canonical form (~85 countries). */ iban(input: { iban: string; }): R; /** GTIN/UPC/EAN/ISBN check-digit validation; normalizes to canonical GTIN-14. */ gtin(input: { gtin: string; }): R; /** US ABA routing-number Federal Reserve weighted mod-10 checksum. */ aba(input: { routingNumber: string; }): R; /** Legal Entity Identifier (LEI, ISO 17442) mod-97-10 check-digit validation. */ lei(input: { lei: string; }): R; /** SWIFT/BIC (ISO 9362) structure validation incl. ISO country position. */ bic(input: { bic: string; }): R; /** GS1 Global Location Number (13-digit mod-10) validation. */ gln(input: { gln: string; }): R; /** GS1 Serial Shipping Container Code (18-digit mod-10) validation. */ sscc(input: { sscc: string; }): R; /** ISIN (ISO 6166) securities identifier — country + NSIN + Luhn check (+ embedded CUSIP for US/CA). */ isin(input: { isin: string; }): R; /** CUSIP (US/Canada securities identifier) mod-10 check-digit validation. */ cusip(input: { cusip: string; }): R; /** Batch-validate up to 100 mixed identifiers ({type,value}) in one deterministic call. */ batch(input: { items: Array<{ type: string; value: string; }>; }): R; }; /** Deterministic conversion primitives (no upstream). */ convert: { /** Unit-of-measure conversion: mass, length, volume, area, temperature. */ unit(input: { value: number; from: string; to: string; }): R; /** Currency conversion at a live or historical ECB rate. from + to (ISO 4217) + amount + optional date. */ currency(input: { from: string; to: string; amount?: number; date?: string; }): R; }; /** ISO standards lookup — currency (4217), language (639), subdivision (3166-2). */ iso: { /** ISO 4217 currency by code (alpha/numeric) or country: name, numeric, minor units. */ currency(input: { code?: string; country?: string; }): R; /** ISO 639 language by code (639-1/2B/2T) or name: canonical codes + English name. */ language(input: { code?: string; name?: string; }): R; /** ISO 3166-2 subdivision by code (US-CA) or country (US → list). */ subdivision(input: { code?: string; country?: string; }): R; }; /** Tax-identifier validation. */ tax: { /** Validate an EU VAT number against the live VIES register. Pass `vat` (full id) OR `country`+`number`. */ vat(input: { vat?: string; country?: string; number?: string; }): R; /** EU VAT rates by member state (standard + reduced/etc). Pass `country` (ISO 2-letter, Greece=EL) or omit for all 27. */ vatRates(input?: { country?: string; }): R; }; /** US inflation data (FRED-backed). */ inflation: { /** Adjust a $ amount for inflation between two dates via CPI-U. Pass amount + from (+ optional to). */ calculator(input: { amount: number; from: string; to?: string; }): R; /** Current inflation by measure (CPI, core CPI, PCE, core PCE, PPI, by category...) with YoY/MoM. Pass `measure` or omit for all. */ rates(input?: { measure?: string; }): R; /** Market + survey inflation expectations (TIPS breakevens, 5y5y forward, U-Mich). */ expectations(input?: Record): R; /** EU harmonized inflation (HICP annual rate) by country/aggregate. Pass `country` (Eurostat geo, e.g. DE, EA20) or omit for all. */ hicp(input?: { country?: string; }): R; }; /** US macroeconomic indicators (FRED-backed). */ econ: { cot(input: { market: string; limit?: number; }): R; /** Any FRED series by id (→ metadata + observations) or full-text catalog search. */ fred(input: { seriesId?: string; query?: string; limit?: number; start?: string; end?: string; }): R; /** FRED economic-data release calendar — upcoming report dates (filter by name/releaseId). */ fredReleases(input?: { from?: string; name?: string; releaseId?: number; limit?: number; }): R; /** FRED ALFRED point-in-time / vintage data — values as known on a past date + revision dates. */ fredVintage(input: { seriesId: string; asOf?: string; start?: string; end?: string; limit?: number; }): R; /** Browse the FRED category tree to discover series (category + children + popular series). */ fredCategories(input?: { categoryId?: number; seriesLimit?: number; }): R; /** FRED regional data — one series across all U.S. states/counties/metros for a period (income, unemployment, regional GDP). */ fredRegional(input: { seriesId: string; date?: string; }): R; /** Curated macro indicator latest reading + YoY (unemployment, fed funds, GDP, yields, payrolls...). Pass `indicator` or omit for all. */ indicator(input?: { indicator?: string; }): R; /** Current US Treasury yield curve across maturities + 2s10s/3m10y spreads + inversion flag. */ yieldCurve(input?: Record): R; /** Benchmark commodity prices (oil, gas, metals, ags). Pass `commodity` (wti, brent, copper, wheat...) or omit for all. */ commodity(input?: { commodity?: string; }): R; /** Composite US recession-signal dashboard (NY Fed probability + Sahm rule + 10y2y inversion). */ recession(input?: Record): R; }; /** EDI (electronic data interchange). */ edi: { /** Parse a raw ANSI X12 EDI document into structured, named JSON + a semantic summary. POST { edi }. */ parse(input: { edi: string; }): R; /** Parse a raw UN/EDIFACT document (international B2B EDI) into structured, named JSON + a semantic summary. POST { edi }. */ edifact(input: { edi: string; }): R; /** Generate an outbound UN/EDIFACT ORDERS or INVOIC from JSON → meta.edi. POST { type, senderId, recipientId, documentNumber, items, … }. */ edifactGenerate(input: { type: 'ORDERS' | 'INVOIC'; senderId: string; recipientId: string; senderQualifier?: string; recipientQualifier?: string; documentNumber: string; date?: string; parties?: Array<{ role: string; name: string; }>; items: Array<{ quantity: number | string; productId?: string; price?: number | string; idType?: string; }>; total?: number; controlRef?: string; }): R; /** Generate the X12 997 Functional Acknowledgment for a received interchange (meta.ack = ready-to-send 997). POST { edi, status?, controlNumber? }. */ ack(input: { edi: string; status?: 'A' | 'E' | 'P' | 'R' | 'M' | 'W' | 'X'; controlNumber?: string; }): R; /** Generate an outbound X12 850 (PO) or 810 (Invoice) from JSON → meta.edi. POST { type, senderId, receiverId, documentNumber, items, … }. */ generate(input: { type: '850' | '810' | '856'; senderId: string; receiverId: string; documentNumber: string; items: Array<{ quantity: number | string; uom?: string; price?: number | string; productId?: string; }>; poNumber?: string; date?: string; parties?: Array<{ role: string; name: string; }>; total?: number; }): R; }; /** Fact-check / claim verification (Google Fact Check Tools / ClaimReview). */ factcheck: { /** Search published fact-checks by claim text → claims with publishers, verdicts, and review URLs. GET { query, language?, maxAgeDays?, publisher?, limit? }. */ search(input: { query: string; language?: string; maxAgeDays?: number; publisher?: string; limit?: number; }): R; }; /** Aviation weather (NOAA). */ aviation: { /** Current METAR observation(s) for ICAO station id(s). Pass `ids` (comma-separated). */ metar(input: { ids: string; }): R; /** Terminal Aerodrome Forecast (TAF) for ICAO station id(s). Pass `ids`. */ taf(input: { ids: string; }): R; /** Active in-flight hazard advisories (SIGMETs/AIRMETs) from NOAA: convective/turbulence/icing/IFR, with valid times, altitudes, movement. */ sigmet(input?: { hazard?: string; hours?: number; limit?: number; }): R; /** NTSB civil aviation accident/incident history. Filter by registration/state/make/model/city/date range. */ accidents(input: { registration?: string; state?: string; make?: string; model?: string; city?: string; dateFrom?: string; dateTo?: string; limit?: number; }): R; }; /** Developer/standards reference. */ dev: { cratesSearch(input: { q: string; limit?: number; }): R; csvToJson(input: { csv: string; delimiter?: string; header?: boolean; }): R; diffJson(input?: { a?: string; b?: string; }): R; flattenJson(input?: { data?: string; delimiter?: string; }): R; gitlabSearch(input: { q: string; limit?: number; }): R; jsonToCsv(input: { data: unknown; delimiter?: string; }): R; jsonToTypescript(input?: { sample?: string; rootName?: string; }): R; jsonToZod(input?: { sample?: string; name?: string; }): R; jwtDecode(input: { token: string; }): R; npmSearch(input: { q: string; limit?: number; }): R; regexTest(input: { pattern: string; flags?: string; input: string; }): R; stackoverflowSearch(input: { q: string; sort?: string; limit?: number; }): R; uuid(input?: { version?: string; count?: number; }): R; /** IETF RFC lookup by number → status, title, authors, date, obsoletes/updates chain (bundled index). */ rfc(input: { number: string; }): R; /** Preflight gate: is a shell command runnable? Static verdict + optional live HEAD probe (probe=true). */ preflight(input: { command: string; probe?: boolean; }): R; }; /** US surface-water data (USGS). */ water: { /** Real-time streamflow + gage height at a USGS site. Pass `site` (site number). */ gauge(input: { site: string; }): R; }; /** Trade / customs reference data. */ trade: { commodityResolve(input: { system: string; code: string; }): R; /** US Harmonized Tariff Schedule: exact `code` lookup or free-text `query` → candidate HS codes + duty rates. */ tariff(input: { code?: string; query?: string; limit?: number; }): R; /** UN/LOCODE: exact `locode` lookup (e.g. USNYC) or name `query` with optional country / function filters. */ locode(input: { locode?: string; query?: string; country?: string; function?: 'port' | 'rail' | 'road' | 'airport' | 'postal' | 'multimodal' | 'fixed' | 'border'; limit?: number; }): R; /** Annual international merchandise-trade flows (UN Comtrade, HS). reporter ISO/M49, optional partner, year, flow, commodity (TOTAL/HS code/AG2|AG4|AG6). */ flows(input: { reporter: string; partner?: string; year: string; flow?: 'export' | 'import'; commodity?: string; limit?: number; }): R; }; dns: { /** Server params: host (FQDN), types (CSV like "A,MX,TXT"), resolver. */ lookup(input: { host: string; types?: string; resolver?: 'cloudflare' | 'google' | 'quad9' | 'opendns'; }): R; }; domain: { whois(input: { domain: string; }): R; /** Domain recon dossier — DNS + WHOIS/RDAP + TLS certificate in one call. */ intel(input: { domain: string; }): R; /** Email-auth / DNS-security posture grade (SPF/DKIM/DMARC/MTA-STS/DNSSEC/CAA/BIMI) from live DNS. */ emailSecurity(input: { domain: string; dkimSelector?: string; }): R; /** Certificate Transparency recon — subdomains + issued certs for a domain. */ ctLogs(input: { domain: string; limit?: number; }): R; }; email: { /** Email signals: RFC syntax, disposable/role/free flags, and MX-record presence (NOT deliverability). */ validate(input: { email: string; checkMx?: boolean; }): R; }; travel: { /** US State Dept travel advisories (live RSS). Omit country for all. */ advisory(input?: { country?: string; }): R; /** Visa requirement for a passport × destination (ISO alpha-3/alpha-2/name). */ visa(input: { passport: string; destination: string; }): R; }; earth: { now(input: { lat: number; lon: number; radius_km?: number; hours?: number; min_magnitude?: number; }): R; /** Global natural-events feed (wildfires, storms, volcanoes, floods) via NASA EONET v3. */ events(input?: { status?: 'open' | 'closed' | 'all'; limit?: number; days?: number; category?: string; bbox?: string; }): R; }; finance: { mortgagePulse(input?: Record): R; centralBankRates(input?: { bank?: string; }): R; securityResolve(input?: { ticker?: string; isin?: string; lei?: string; }): R; cikTicker(input?: { ticker?: string; cik?: string; }): R; bankIdResolve(input?: { bic?: string; lei?: string; fdic_cert?: string; }): R; form144(input?: { q?: string; startDate?: string; endDate?: string; limit?: number; }): R; /** Loan/mortgage amortization schedule (deterministic). */ amortize(input: { principal: number; annualRatePct: number; termMonths?: number; termYears?: number; extraMonthly?: number; }): R; /** Recent SEC filings for a US public company by ticker. */ secFilings(input: { ticker: string; formType?: string; limit?: number; }): R; /** Curated XBRL financial metrics (revenue, net income, EPS, etc.) by ticker. */ companyFacts(input: { ticker: string; metrics?: string; annualLimit?: number; quarterlyLimit?: number; }): R; /** SEC XBRL Frames — one concept (e.g. Revenues) across ALL filers for a period, for cross-company screening. */ xbrlFrames(input: { tag: string; period: string; unit?: string; taxonomy?: string; sort?: 'desc' | 'asc'; limit?: number; }): R; /** Indian bank branch by IFSC code: bank, branch, address, MICR, payment rails. */ ifscIndia(input: { ifsc: string; }): R; /** Card BIN/IIN lookup: brand, card type, issuing bank, country (longest-prefix match). */ bin(input: { bin: string; }): R; /** OpenFIGI mapping: identifier (ISIN/CUSIP/SEDOL/TICKER/FIGI…) → FIGI(s) + security metadata across listings. */ figi(input: { idType: string; idValue: string; exchCode?: string; currency?: string; limit?: number; }): R; /** OpenFIGI free-text security search (+ exchange/type/sector filters + cursor). */ figiSearch(input: { query: string; exchCode?: string; securityType?: string; marketSector?: string; start?: string; limit?: number; }): R; /** Recent SEC Form 4 insider transactions by ticker. */ insiderTrades(input: { ticker: string; limit?: number; }): R; /** Parsed institutional holdings (13F-HR) for an investment manager by CIK. */ thirteenF(input: { managerCik: string; formType?: string; limit?: number; }): R; /** Company 360 by ticker — SEC filings + XBRL fundamentals + insider trades merged in one call. */ companyProfile(input: { ticker: string; formType?: string; limit?: number; }): R; }; geo: { zipResolve(input: { zip: string; }): R; ip(input: { ip: string; }): R; /** Ground elevation (m + ft) for a coordinate, global. Pass lat + lon. */ elevation(input: { lat: number; lon: number; }): R; /** Airports + schools + climate stations + recent quakes around a coordinate. */ nearby(input: { lat: number; lon: number; radiusKm?: number; limit?: number; }): R; /** Postal/ZIP code → place + admin divisions + coordinates (international). */ postal(input: { postalCode: string; country?: string; }): R; /** FEMA flood zone for a coordinate: zone code, SFHA flag, risk level, base flood elevation (free, keyless). */ floodZone(input: { lat: number; lon: number; }): R; /** Static risk/context dossier for a point: Census place + FEMA flood + USGS seismic + nearest NOAA station (+ ACS when zip given). Pass lat+lon or address. */ locationDossier(input: { lat?: number; lon?: number; address?: string; zip?: string; riskCategory?: string; siteClass?: string; }): R; }; geocode: { /** Server params: q (query string), limit (1-10), country (ISO-3166 alpha-2). */ address(input: { q: string; limit?: number; country?: string; }): R; reverse(input: { lat: number; lon: number; }): R; }; hash: { compute(input: { input: string; inputEncoding?: 'utf8' | 'hex' | 'base64'; algorithms?: string[]; algorithm?: string; outputEncoding?: 'hex' | 'base64'; }): R; }; image: { /** Returns compressed image bytes — `result.data` is a `Uint8Array`. Provide exactly one of url | imageBase64. */ compress(input: { url?: string; imageBase64?: string; format?: 'auto' | 'png' | 'jpeg' | 'webp' | 'avif'; quality?: number; lossy?: boolean; effort?: number; }): R; }; ipinfo: { bulk(input: { ips: string[]; }): R; }; html: { /** Convert caller-supplied HTML to clean reading markdown (POST, no fetch). */ toMarkdown(input: { html: string; }): R; }; tls: { /** Live TLS handshake → server certificate detail (issuer, validity, SANs, fingerprint). */ certInfo(input: { host: string; port?: number; }): R; }; business: { idResolve(input?: { name?: string; lei?: string; cik?: string; ticker?: string; }): R; fiCompanies(input: { name: string; limit?: number; }): R; frCompanies(input: { q: string; limit?: number; }): R; leiHierarchy(input: { lei: string; childLimit?: number; }): R; leiIsins(input?: { lei?: string; isin?: string; limit?: number; }): R; noCompanies(input: { name: string; limit?: number; }): R; plKrs(input: { krs: string; register?: string; }): R; /** State Secretary-of-State business registry search, normalized (NY, CO). */ sosSearch(input: { state: 'NY' | 'CO' | 'CT'; name?: string; entityId?: string; limit?: number; offset?: number; }): R; /** Brazilian company registry by CNPJ: legal/trade name, status, activity, address, partners. */ brCnpj(input: { cnpj: string; }): R; /** UK Companies House: name search OR companyNumber → full profile + officers. */ ukCompanies(input: { query?: string; companyNumber?: string; limit?: number; }): R; /** Full entity dossier — master record + officers + registered agent + filings (v1: CT). By entityId, accountNumber, or name. */ entityProfile(input: { state: 'CT'; entityId?: string; accountNumber?: string; name?: string; filingsLimit?: number; }): R; /** Registry lookup + OFAC sanctions screen of the entity + its agent in one call. */ entityScreen(input: { state: 'NY' | 'CO' | 'CT'; name?: string; entityId?: string; threshold?: number; limit?: number; }): R; /** NAICS 2022 industry-code lookup (exact code + children) or free-text industry search (US Census). */ naics(input: { code?: string; query?: string; level?: number; limit?: number; }): R; /** GLEIF Legal Entity Identifier registry: exact `lei` lookup or `query` name search (ISO 17442, ~2.6M entities). */ lei(input: { lei?: string; query?: string; country?: string; status?: 'active' | 'all'; limit?: number; offset?: number; }): R; /** Fuzzy resolve a messy company name to its canonical GLEIF LEI with a similarity score + confidence (KYB / record linkage). */ entityMatch(input: { name: string; country?: string; limit?: number; }): R; /** Full company KYB dossier: SAM/exclusions/OFAC/GLEIF/USAspending/FARA/trademarks (+ SEC if ticker). */ kyb360(input: { name: string; state?: string; ticker?: string; threshold?: number; limit?: number; }): R; }; law: { /** Federal court dockets (civil + criminal) via RECAP — q full-text or exact docketNumber. */ docketSearch(input: { q?: string; court?: string; docketNumber?: string; filedAfter?: string; filedBefore?: string; page?: number; }): R; caseSearch(input: { q: string; court?: string; filedAfter?: string; filedBefore?: string; order?: 'relevance' | 'dateFiled-desc' | 'dateFiled-asc' | 'citeCount-desc'; limit?: number; }): R; /** POST { text } — finds + verifies citations inside a passage. */ caseVerify(input: { text: string; }): R; /** POST { text?, quotes? } — verify existence of cases/USC/CFR refs + (deterministically) whether attributed quotes appear in the cited opinion. */ citationCheck(input: { text?: string; quotes?: Array<{ citation: string; quote: string; }>; }): R; /** POST { query, threshold?, limit?, sourceList? } — OFAC SDN fuzzy match. */ sanctionsCheck(input: { query: string; threshold?: number; limit?: number; sourceList?: string; }): R; /** Server params: q, type (RULE|PRORULE|NOTICE|PRESDOCU), agency (slug), since/until (yyyy-mm-dd), limit. */ federalRegister(input: { q: string; type?: 'RULE' | 'PRORULE' | 'NOTICE' | 'PRESDOCU'; agency?: string; since?: string; until?: string; limit?: number; }): R; /** Full text of a CFR section by title (1-50) + section ("1026.43"); optional point-in-time date (yyyy-mm-dd, back to 2017). */ cfrSection(input: { title: number; section: string; date?: string; }): R; /** POST — supply exactly one of `opinionId` or `citation`. */ opinion(input: { opinionId: number; } | { citation: string; }): R; /** CourtListener attorney search by name and/or firm. */ attorneyLookup(input: { name?: string; firmName?: string; limit?: number; }): R; /** CourtListener federal judge lookup by name. */ judgeLookup(input: { name: string; limit?: number; }): R; /** Full current text of a US Code section by title (1-54) + section ("107", "1395w-4"). */ uscSection(input: { title: number; section: string; includeNotes?: boolean; }): R; /** US trademark status by 8-digit serial number OR registration number (exactly one). */ trademarkStatus(input: { serialNumber: string; } | { registrationNumber: string; }): R; }; /** USDA FoodData Central nutrition data. */ nutrition: { /** Search foods (query=…) or fetch one food's full nutrient profile (fdcId=…). */ food(input: { query?: string; fdcId?: number; dataType?: 'Foundation' | 'SR Legacy' | 'Survey (FNDDS)' | 'Branded'; limit?: number; page?: number; }): R; }; /** Person-name sweeps across public registries. */ person: { /** Name-matched candidates (NOT identity-resolved) across FINRA, attorneys, inmates, TX trades + real-estate. */ crossRegistry(input: { name: string; limit?: number; }): R; }; /** TLD registry + Public Suffix List intelligence. */ tld: { /** Pass tld=… for IANA metadata, or domain=… for PSL public-suffix/registrable-domain analysis. */ info(input: { tld?: string; domain?: string; }): R; }; papers: { search(input: { q: string; limit?: number; since?: string; sources?: string; }): R; /** Citation graph for a work (OpenAlex): works citing it, or works it references. `id` = DOI or OpenAlex work id. */ citations(input: { id: string; view?: 'citing' | 'referenced'; page?: number; limit?: number; sort?: 'recent' | 'citations'; }): R; }; paper: { /** Crossref DOI bibliographic metadata lookup. */ doiLookup(input: { doi: string; }): R; }; registry: { /** npm package metadata. */ npmLookup(input: { name: string; }): R; /** PyPI package metadata. */ pypiLookup(input: { name: string; }): R; }; fx: { /** ECB daily reference exchange rates via Frankfurter. */ rates(input?: { base?: string; symbols?: string; date?: string; amount?: number; }): R; /** ECB historical daily rate series + summary stats over a date range. */ timeseries(input: { start: string; base?: string; symbols?: string; end?: string; amount?: number; }): R; }; bls: { /** US Bureau of Labor Statistics time series. */ series(input: { seriesIds: string; startYear?: number; endYear?: number; }): R; }; country: { financials(input?: { code?: string; }): R; /** Country metadata lookup (REST Countries). */ lookup(input: { alpha2?: string; alpha3?: string; name?: string; fullText?: boolean; }): R; }; news: { /** Hacker News feed (top/new/best/ask/show/job). */ hnTop(input?: { kind?: 'top' | 'new' | 'best' | 'ask' | 'show' | 'job'; limit?: number; }): R; /** Hacker News item lookup by ID. */ hnItem(input: { id: number; }): R; /** Live news search: headlines with source, age, breaking flag. freshness: pd|pw|pm|py. */ search(input: { q: string; count?: number; offset?: number; country?: string; freshness?: 'pd' | 'pw' | 'pm' | 'py'; }): R; /** Full-text Hacker News search (Algolia) — stories/comments by keyword, tags, author, sort. */ hnSearch(input?: { query?: string; tags?: 'story' | 'comment' | 'ask_hn' | 'show_hn' | 'poll'; sort?: 'relevance' | 'date'; author?: string; limit?: number; }): R; /** Hacker News user profile by username — karma, about, created, submitted count. */ hnUser(input: { username: string; }): R; }; /** Chinese-language deterministic primitives (OpenCC + pinyin, keyless). */ chinese: { /** Convert Chinese between Simplified/Traditional variants. from/to: cn|tw|twp|hk|t|jp. */ convert(input: { text: string; from: string; to: string; }): R; /** Detect Chinese in text — Han presence, count, and script classification (simplified/traditional/mixed/han-common). */ detect(input: { text: string; }): R; /** Convert Hanzi to pinyin — tone marks, numbered tones, or none; auto-segments words. */ pinyin(input: { text: string; tone?: 'symbol' | 'num' | 'none'; segmented?: boolean; }): R; }; /** Contact the 2s team. */ feedback: { /** Send a message to the 2s team (feedback/bug/endpoint request). Flat $0.10. POST { message, subject?, name?, from? }. */ send(input: { message: string; subject?: string; name?: string; from?: string; }): R; }; /** GitHub read API (no caller key needed). */ github: { /** Repository metadata: stars, forks, language, topics, license, timestamps. */ repo(input: { owner: string; repo: string; }): R; /** List a user/org's repositories. Sort updated|created|pushed|full_name; type owner|member|all. */ repos(input: { owner: string; sort?: 'updated' | 'created' | 'pushed' | 'full_name'; type?: 'owner' | 'member' | 'all'; perPage?: number; page?: number; }): R; /** GitHub code search (code-search syntax) — total count + file name/path/repo/url per hit. */ searchCode(input: { q: string; perPage?: number; page?: number; }): R; /** GitHub repository search (full query syntax). Sort stars|forks|help-wanted-issues|updated. */ searchRepos(input: { q: string; sort?: 'stars' | 'forks' | 'help-wanted-issues' | 'updated'; order?: 'asc' | 'desc'; perPage?: number; page?: number; }): R; /** GitHub user/org profile: name, company, bio, followers, repo counts, created date. */ user(input: { username: string; }): R; /** Commit history for a repo. Filter by branch/tag (sha), file path, or author; paginate. */ commits(input: { owner: string; repo: string; sha?: string; path?: string; author?: string; perPage?: number; page?: number; }): R; /** Issues for a repo (PRs excluded). Filter state open|closed|all + labels; paginate. */ issues(input: { owner: string; repo: string; state?: 'open' | 'closed' | 'all'; labels?: string; perPage?: number; page?: number; }): R; /** Pull requests for a repo. Filter state open|closed|all; paginate. */ pulls(input: { owner: string; repo: string; state?: 'open' | 'closed' | 'all'; perPage?: number; page?: number; }): R; /** Branches of a repo: name, head sha, protection flag. */ branches(input: { owner: string; repo: string; perPage?: number; page?: number; }): R; /** Git tags of a repo (name + commit sha), most recent first. */ tags(input: { owner: string; repo: string; perPage?: number; page?: number; }): R; /** A repo's releases: tag, name, draft/prerelease, author, published time, notes. */ releases(input: { owner: string; repo: string; perPage?: number; page?: number; }): R; /** Top contributors to a repo, ranked by commit count. */ contributors(input: { owner: string; repo: string; perPage?: number; page?: number; }): R; /** Programming-language breakdown of a repo (bytes + percent), by size. */ languages(input: { owner: string; repo: string; }): R; /** A repo's README decoded to UTF-8 text. Optional ref (branch/tag/sha). */ readme(input: { owner: string; repo: string; ref?: string; }): R; }; /** Prediction markets — Kalshi + Polymarket (read-only). */ predict: { search(input: { q: string; limit?: number; status?: string; }): R; events(input?: { q?: string; limit?: number; offset?: number; closed?: boolean; order?: string; }): R; cryptoUpdown(input?: { limit?: number; }): R; leaderboard(input?: { rankBy?: string; window?: string; limit?: number; }): R; positions(input: { address: string; limit?: number; }): R; activity(input: { address: string; limit?: number; type?: string; }): R; matchedPairs(input?: { limit?: number; minScore?: number; }): R; sports(input?: { category?: string; limit?: number; }): R; holders(input: { market: string; limit?: number; }): R; limitlessMarkets(input?: { limit?: number; }): R; /** Browse Kalshi events. Filter status/seriesTicker; page with limit + cursor. */ kalshiEvents(input?: { limit?: number; cursor?: string; status?: 'unopened' | 'open' | 'closed' | 'settled'; seriesTicker?: string; }): R; /** A single Kalshi market by ticker — yes/no bid+ask, last price, volume, OI, result. */ kalshiMarket(input: { ticker: string; }): R; /** Browse Kalshi markets. Filter status/eventTicker/seriesTicker/tickers; page with limit + cursor. */ kalshiMarkets(input?: { limit?: number; cursor?: string; eventTicker?: string; seriesTicker?: string; status?: 'unopened' | 'open' | 'closed' | 'settled'; tickers?: string; }): R; /** Order book for a Kalshi market by ticker — resting yes/no bids (price + size). */ kalshiOrderbook(input: { ticker: string; depth?: number; }): R; /** Recent Kalshi trades, optionally filtered to one ticker. Page with limit + cursor. */ kalshiTrades(input?: { ticker?: string; limit?: number; cursor?: string; }): R; /** A single Polymarket market by conditionId, slug, or id — outcomes + live prices, CLOB token ids. */ market(input?: { conditionId?: string; slug?: string; id?: string; }): R; /** Browse Polymarket markets. Filter active/closed, order, page with limit/offset. */ markets(input?: { limit?: number; offset?: number; active?: boolean; closed?: boolean; order?: 'volume' | 'liquidity' | 'endDate' | 'startDate'; ascending?: boolean; tagId?: number; }): R; /** Full CLOB order book (bids + asks) for a Polymarket outcome token (clobTokenId). */ orderbook(input: { tokenId: string; }): R; /** Live best bid/ask/midpoint for a Polymarket outcome token (midpoint = implied probability). */ price(input: { tokenId: string; }): R; /** Time-series price (implied-probability) history for a Polymarket outcome token. */ priceHistory(input: { tokenId: string; interval?: '1h' | '6h' | '1d' | '1w' | '1m' | 'max'; fidelity?: number; }): R; /** Recent Polymarket trades. Filter by market (conditionId) and/or user (wallet); page with limit. */ trades(input?: { market?: string; user?: string; limit?: number; }): R; /** A Polymarket trader's portfolio by wallet address — value + open positions + unrealized PnL. */ wallet(input: { address: string; }): R; /** Polymarket whale radar — largest recent trades by USD notional, ranked. */ whales(input?: { limit?: number; minUsd?: number; }): R; }; /** Sports schedules, scores, standings (official league APIs, keyless). */ sports: { nbaTeams(input?: { id?: number; }): R; nbaPlayers(input?: { search?: string; cursor?: string; per_page?: number; }): R; nbaGames(input?: { season?: number; date?: string; team_id?: number; cursor?: string; per_page?: number; }): R; nflTeams(input?: { id?: number; }): R; nflPlayers(input?: { search?: string; cursor?: string; per_page?: number; }): R; nflGames(input?: { season?: number; week?: number; team_id?: number; cursor?: string; per_page?: number; }): R; /** MLB games for a date (+ optional team) — status, teams, score, venue. Defaults to today. */ mlbSchedule(input?: { date?: string; teamId?: number; }): R; /** MLB regular-season standings for a season (wins/losses/pct/GB/rank/streak). */ mlbStandings(input?: { season?: number; }): R; /** NHL game schedule for the week anchored on a date (+ optional 3-letter team). Defaults to this week. */ nhlSchedule(input?: { date?: string; team?: string; }): R; /** NHL scores/games for a date — state, start time, teams + score. Defaults to today. */ nhlScores(input?: { date?: string; }): R; /** Current NHL standings — conference/division, GP, W/L/OTL, points, diff, streak. */ nhlStandings(): R; }; /** Live web search + catalog discovery. */ search: { ai(input: { q: string; maxResults?: number; topic?: string; }): R; crawl(input: { url: string; limit?: number; maxDepth?: number; instructions?: string; }): R; extract(input: { urls: unknown; depth?: string; }): R; /** Find 2s endpoints matching a natural-language query (e.g. "screen a company for sanctions"). */ endpoints(input: { q: string; limit?: number; }): R; /** Ranked web results with title, url, snippet, site, age. freshness: pd|pw|pm|py or YYYY-MM-DDtoYYYY-MM-DD. */ web(input: { q: string; count?: number; offset?: number; country?: string; freshness?: string; safesearch?: 'off' | 'moderate' | 'strict'; }): R; }; /** Vulnerability intelligence. */ security: { icsAdvisories(input?: { q?: string; limit?: number; }): R; /** Resolve a CVE across NVD (record + CVSS + CWE), CISA KEV (actively-exploited + ransomware flag), and EPSS (exploit probability) in one call. */ cve(input: { cve: string; }): R; /** CVE change feed — CVEs modified within a window (NVD lastMod), each flagged if now CISA known-exploited. The pollable delta primitive. */ cveChanges(input: { since: string; until?: string; keyword?: string; cpe?: string; limit?: number; }): R; /** Grade a URL's HTTP security headers (CSP/HSTS/X-Frame/…) from the live response. */ httpHeaders(input: { url: string; }): R; /** Check a password against breach corpora via HIBP k-anonymity (only a 5-char SHA-1 prefix is sent). POST { password } or { sha1 }. */ passwordExposure(input: { password?: string; sha1?: string; }): R; /** Threat-intel reputation for an IP/domain/URL/hash (abuse.ch + Feodo + Tor + Spamhaus DROP). */ iocReputation(input: { ioc: string; }): R; /** Multi-source IP reputation + combined authority score (AbuseIPDB + abuse.ch + blocklist.de + StopForumSpam). */ ipReputation(input: { ip: string; }): R; /** AbuseIPDB single-IP abuse check — confidence score, reports, usage type, ISP (verbose adds report records). */ ipAbuse(input: { ip: string; maxAgeInDays?: number; verbose?: boolean; }): R; /** AbuseIPDB bulk blacklist — worst-offender IPs above a confidence threshold (the fail2ban firewall feed). */ ipBlacklist(input: { confidenceMinimum?: number; limit?: number; ipVersion?: 4 | 6; onlyCountries?: string; exceptCountries?: string; }): R; /** AbuseIPDB subnet (CIDR) check — which IPs inside a network block have been reported. */ ipBlock(input: { network: string; maxAgeInDays?: number; limit?: number; }): R; /** MITRE CWE weakness lookup by id (CWE-79) or keyword search (bundled, anti-hallucination). */ cwe(input: { id?: string; query?: string; limit?: number; }): R; /** MITRE ATT&CK Enterprise technique lookup by id (T1059) or keyword search (bundled). */ attack(input: { id?: string; query?: string; limit?: number; }): R; /** MITRE CAPEC attack-pattern lookup by id (CAPEC-66) or keyword search (bundled). */ capec(input: { id?: string; query?: string; limit?: number; }): R; /** Does public exploit code exist for a CVE (Exploit-DB)? The weaponized-triage signal beyond KEV/EPSS. */ exploitAvailability(input: { cve: string; }): R; /** Package security + provenance: OSV vulns + deps.dev license/deprecation + OpenSSF Scorecard health, in one call. GET { ecosystem, name, version? }. */ package(input: { ecosystem: string; name: string; version?: string; }): R; /** Find CVEs affecting a product (NVD search by keyword or CPE). GET { product? | cpe?, limit? }. */ cveSearch(input: { product?: string; cpe?: string; limit?: number; }): R; }; /** Stock market data (Massive / formerly Polygon.io). */ stocks: { screener(input: { concept: string; period: string; unit?: string; op?: string; value?: number; ratioConcept?: string; sort?: string; limit?: number; }): R; metrics(input: { ticker: string; }): R; peers(input: { ticker: string; grouping?: string; }): R; earningsSurprises(input: { ticker: string; limit?: number; }): R; recommendations(input: { ticker: string; }): R; companyNews(input: { ticker: string; from?: string; to?: string; limit?: number; }): R; insiderSentiment(input: { ticker: string; from?: string; to?: string; }): R; financialsReported(input: { ticker: string; freq?: string; limit?: number; }): R; symbols(input?: { q?: string; exchange?: string; limit?: number; }): R; lobbying(input: { ticker: string; from?: string; to?: string; limit?: number; }): R; govSpending(input: { ticker: string; from?: string; to?: string; limit?: number; }): R; h1bVisas(input: { ticker: string; from?: string; to?: string; limit?: number; }): R; patents(input: { ticker: string; from?: string; to?: string; limit?: number; }): R; /** Latest daily quote for a US ticker (EOD/delayed): OHLCV, VWAP, change vs prior session, company metadata. */ quote(input: { ticker: string; }): R; }; /** Live flight tracking. */ flight: { airportBoard(input: { airport: string; type?: string; limit?: number; }): R; routeSchedule(input: { origin: string; destination: string; startDate: string; endDate: string; limit?: number; }): R; /** Recent + upcoming instances of a flight with live times, delays, progress. */ status(input: { ident: string; identType?: 'designator' | 'registration' | 'fa_flight_id'; limit?: number; }): R; }; /** Speech-to-text. */ transcribe: { /** POST — transcribe an audio URL (≤15 MB, ≤15 min). diarize=true adds speaker turns. */ audio(input: { url: string; language?: string; diarize?: boolean; }): R; }; food: { /** Food product lookup by UPC/EAN barcode (Open Food Facts, CC0). */ barcodeLookup(input: { barcode: string; }): R; /** UK Food Standards Agency hygiene ratings by business name/postcode. */ hygieneUk(input?: { name?: string; postcode?: string; limit?: number; }): R; }; edu: { /** US college + university search (Department of Education College Scorecard). */ collegeScorecard(input?: Record): R; /** Every US public K-12 school (~102k, NCES CCD). */ schoolLookup(input: { name?: string; district?: string; state?: string; city?: string; zip?: string; ncessch?: string; limit?: number; offset?: number; }): R; }; energy: { solarForecast(input: { latitude: number; longitude: number; days?: number; }): R; /** Alternative-fuel station locator (NREL Alternative Fuels Data Center). */ fuelStations(input?: Record): R; /** Solar resource averages (NREL NSRDB) for a lat/lon. */ solarResource(input: { lat: number; lon: number; }): R; /** US energy benchmark prices (EIA): omit series for a snapshot of all, or pass one (wti_crude/brent_crude/henry_hub_gas/gasoline_regular/diesel/electricity_retail). */ prices(input?: { series?: string; limit?: number; }): R; /** Electricity generation mix by fuel type for a US state or "US" (EIA, latest month + shares). */ generationMix(input: { location: string; }): R; /** Retail electricity price + sales for a US state by sector, monthly (EIA). */ electricityRates(input: { state: string; sector?: 'residential' | 'commercial' | 'industrial' | 'transportation' | 'all'; months?: number; }): R; /** Great Britain grid carbon intensity (gCO2/kWh) + live generation mix. */ carbonIntensityUk(): R; /** Serving utility + rate-plan summaries for a lat/lon (OpenEI URDB, CC0). */ utilityRates(input: { lat: number; lon: number; limit?: number; }): R; }; park: { /** Unified US National Park Service read API (NPS). */ lookup(input: { resource: string; parkCode?: string; state?: string; q?: string; limit?: number; start?: number; }): R; }; recreation: { /** Recreation Information Database (RIDB / Recreation.gov) search. */ search(input: { resource: string; query?: string; state?: string; activity?: number; latitude?: number; longitude?: number; radius?: number; lastUpdated?: string; limit?: number; offset?: number; }): R; }; job: { /** Search current US federal job postings via USAJobs. */ federalSearch(input?: Record): R; /** USAJobs reference codelist contents. */ federalCodes(input: { name: string; }): R; }; property: { /** NYC tax-lot lookup via PLUTO — by BBL or address. */ nycParcelLookup(input?: { bbl?: string; address?: string; borough?: string; }): R; /** NYC ACRIS deed + mortgage history for a BBL. */ nycDeedHistory(input: { bbl: string; limit?: number; offset?: number; }): R; /** NYC DOB construction permits by BBL or address. */ nycPermits(input?: Record): R; /** NYC HPD violations by BBL or address. */ nycViolations(input?: Record): R; }; treasury: { /** US National Debt — daily Debt to the Penny. */ debt(input?: Record): R; /** Daily Treasury Statement (DTS) operating cash balance. */ cash(input?: Record): R; /** Official Treasury exchange rates (quarterly). */ exchangeRates(input?: Record): R; /** Monthly Treasury Statement (MTS) — Table 4 federal receipts by source. */ monthlyStatement(input?: Record): R; }; word: { /** English dictionary entry (dictionaryapi.dev / Wiktionary, CC BY-SA). */ define(input: { word: string; }): R; /** Related words: rhymes, synonyms, antonyms, semantic neighbours (Datamuse). */ related(input: { word: string; relation: string; limit?: number; }): R; }; patents: { epoBiblio(input: { number: string; format?: string; }): R; epoFamily(input: { number: string; format?: string; }): R; epoLegal(input: { number: string; format?: string; }): R; epoSearch(input: { q: string; limit?: number; }): R; search(input: { q: string; yearFrom?: number; yearTo?: number; applicationType?: 'Utility' | 'Design' | 'Plant' | 'Reissue'; limit?: number; offset?: number; }): R; detail(input: { applicationNumber: string; }): R; documents(input: { applicationNumber: string; }): R; }; quakes: { /** Server requires lat + lon. Optional: radius_km, hours, min_magnitude. */ recent(input: { lat: number; lon: number; radius_km?: number; hours?: number; min_magnitude?: number; }): R; }; sunrise: { /** Server requires lat + lon + date (yyyy-mm-dd). */ compute(input: { lat: number; lon: number; date: string; }): R; }; tides: { now(input: { lat: number; lon: number; radius_km?: number; hours?: number; }): R; }; medical: { taxonomySpecialty(input: { code: string; }): R; providerIdResolve(input: { npi: string; }): R; /** Verify an ICD-10-CM diagnosis code or keyword-search the official US code set. */ icd10(input: { code?: string; q?: string; billable_only?: boolean; limit?: number; }): R; /** Normalize/verify drug names against RxNorm: term=… for candidates, rxcui=… for canonical concept + ingredients/brands/dose forms. */ rxnorm(input: { term?: string; rxcui?: string; limit?: number; }): R; /** Drug situational awareness: FDA shortage + recall status + NDC metadata for a drug name / rxcui / ndc (composed on RxNorm). */ drugStatus(input: { drug?: string; rxcui?: string; ndc?: string; limit?: number; }): R; /** Authoritative FDA drug label (SPL): indications, dosage, warnings, interactions, boxed warning + identity metadata for a drug name / ndc / rxcui / setId. */ drugLabel(input: { drug?: string; ndc?: string; rxcui?: string; setId?: string; limit?: number; }): R; /** CMS NADAC drug acquisition cost by NDC or name (live; current-year dataset auto-resolved). */ drugPrice(input: { ndc?: string; name?: string; limit?: number; }): R; /** Drugs@FDA approval history: applications, products (ingredients/strength/form/marketing status) + submissions by drug/applicationNumber/sponsor. */ drugApproval(input: { drug?: string; applicationNumber?: string; sponsor?: string; limit?: number; }): R; /** FDA 510(k) premarket clearances by device name / applicant / product code: K-number, decision, clearance type. */ device510k(input: { device?: string; applicant?: string; productCode?: string; limit?: number; }): R; /** FDA device classification by device name / product code: class (I/II/III), regulation number, specialty, controls. */ deviceClassification(input: { device?: string; productCode?: string; limit?: number; }): R; /** FDA GUDID device lookup by UDI / brand / company: description, Rx/OTC, MRI safety, identifiers, product codes, GMDN. */ deviceUdi(input: { device?: string; company?: string; udi?: string; limit?: number; }): R; /** FDA medical-device recalls by device / firm / classification / status / state: reason, status, quantity, dates. */ deviceRecall(input?: { device?: string; firm?: string; classification?: 'I' | 'II' | 'III'; status?: 'Ongoing' | 'Completed' | 'Terminated' | 'Pending'; state?: string; limit?: number; }): R; /** CMS NPPES provider lookup by NPI, name, or organization (+state/taxonomy): identity, taxonomies, addresses. */ npi(input: { npi?: string; firstName?: string; lastName?: string; organization?: string; state?: string; taxonomy?: string; limit?: number; }): R; /** MedlinePlus Genetics reference for a condition or gene: summary, sections, inheritance, related genes, cross-refs. */ genetics(input: { term: string; }): R; }; net: { ipResolve(input: { ip: string; }): R; /** Autonomous System (BGP) intelligence by AS number: holder, allocation block, announced prefixes, routing visibility (RIPEstat). */ asn(input: { asn: string; }): R; /** Resolve a MAC address or OUI prefix to its IEEE-registered vendor + decoded address bits (multicast/local/randomized). Bundled IEEE registries. */ macVendor(input: { mac: string; }): R; /** RPKI route-origin validation for an (ASN, prefix) pair — valid/invalid/unknown BGP-hijack signal (RIPEstat). */ rpkiValidity(input: { asn: string; prefix: string; }): R; }; product: { /** Decode/validate a product barcode (UPC/EAN/GTIN/ISBN): check digit, symbology, GS1 prefix → issuing org/country, + fresh best-effort identity (open ODbL federation). */ gtin(input: { gtin: string; identity?: boolean; }): R; }; research: { /** Resolve a research organization via ROR (id or name): location, external ids, relationships. */ org(input: { id?: string; name?: string; limit?: number; }): R; /** ORCID researcher profile by iD: name, affiliations, works. */ author(input: { orcid: string; worksLimit?: number; }): R; /** NIH RePORTER federal grant search by term/org/pi/fiscalYear. */ funding(input: { term?: string; org?: string; pi?: string; fiscalYear?: number; limit?: number; offset?: number; }): R; }; timezone: { /** Resolve a coordinate to its IANA timezone + current local wall time. */ lookup(input: { lat: number; lon: number; at?: string; }): R; }; url: { unfurl(input: { url: string; }): R; /** * Clean a URL into article content. `format` markdown|text|both returns a * JSON envelope (`result.data` is {@link UrlCleanResponse}); `html` and * `pdf` return raw bytes (`result.data` is a `Uint8Array` — a * self-contained reader page / typeset PDF respectively). */ clean(input: { url: string; format?: 'markdown' | 'text' | 'both' | 'html' | 'pdf'; }): R; /** * Like {@link clean} but renders the page in a real headless browser (JS * executed) — for client-rendered / SPA pages where `clean`'s raw fetch * sees an empty shell. Tier 2 (~10× the price of clean). Same formats & * return shape (JSON envelope, or `Uint8Array` for html/pdf). */ render(input: { url: string; format?: 'markdown' | 'text' | 'both' | 'html' | 'pdf'; waitUntil?: 'load' | 'domcontentloaded' | 'networkidle0' | 'networkidle2'; timeoutMs?: number; }): R; /** * Discover the URLs a page or sitemap points at in a single fetch — * entries from an XML sitemap/sitemap-index, or links from an * HTML page (auto-detected). Resolved-absolute, deduped, http(s)-only. * Stateless, no JS, NOT a crawler — re-call on a child sitemap/page to go * deeper. `limit` 1-2000 (default 200); `sameHostOnly` keeps same-host links. */ map(input: { url: string; limit?: number; sameHostOnly?: boolean; }): R<{ url: string; finalUrl: string; source: 'sitemap' | 'links'; count: number; capped: boolean; urls: string[]; }>; }; weather: { zip(input: { zip: string; }): R; /** Live US National Weather Service active alerts by point ("lat,lon") or area (2-letter state/marine code). */ alerts(input: { point?: string; area?: string; severity?: 'Extreme' | 'Severe' | 'Moderate' | 'Minor' | 'Unknown'; urgency?: 'Immediate' | 'Expected' | 'Future' | 'Past' | 'Unknown'; limit?: number; }): R; /** NWS multi-day (or hourly) forecast for a US coordinate. Pass lat + lon (+ optional hourly, limit). */ forecast(input: { lat: number; lon: number; hourly?: boolean; limit?: number; }): R; /** Current air quality (US/EU AQI + pollutants) for a coordinate, global. */ airQuality(input: { lat: number; lon: number; }): R; /** Current marine/sea-state (waves + swell) for an ocean/coastal coordinate. */ marine(input: { lat: number; lon: number; }): R; /** Historical daily weather (ERA5) for a coordinate + date range. */ history(input: { lat: number; lon: number; start: string; end: string; }): R; /** Current conditions for any coordinate worldwide (Open-Meteo; global, not just US). */ current(input: { lat: number; lon: number; units?: 'metric' | 'imperial'; }): R; /** Global forecast up to 16 days (daily, or hourly=true) for any coordinate (Open-Meteo). */ forecastGlobal(input: { lat: number; lon: number; days?: number; hourly?: boolean; units?: 'metric' | 'imperial'; }): R; }; wikipedia: { summary(input: { title: string; lang?: string; }): R; }; poi: { /** Find POIs near a coord — OpenStreetMap-backed via Overpass. */ near(input: { lat: number; lon: number; category: string; radius_m?: number; limit?: number; }): R; }; phone: { /** E.164-normalize + classify (mobile/fixed/voip/etc.) using libphonenumber. */ normalize(input: { phone: string; defaultRegion?: string; }): R; }; text: { /** Deterministically redact secrets (keys, tokens, JWTs, private keys) from text → [redacted:] + per-kind counts. Pure compute, nothing stored. */ redact(input: { text: string; }): R; }; space: { /** Current NOAA space-weather Kp/solar-flux/aurora snapshot. */ weather(input?: Record): R; /** Asteroid/comet physical + orbital params from JPL Small-Body Database. */ body(input: { q: string; }): R; /** Near-Earth-object close approaches in a date + distance window (JPL CAD). */ closeApproaches(input?: { dateMin?: string; dateMax?: string; distMaxAu?: number; limit?: number; }): R; /** Current position of any cataloged satellite (Celestrak + SGP4). */ satellite(input: { noradId: number; lat?: number; lon?: number; altKm?: number; at?: string; }): R; /** Search the satellite catalog (SATCAT, ~69k objects) by name/owner/type/launch-year/on-orbit; total = full count matching. */ satellites(input?: { q?: string; owner?: string; type?: string; noradId?: number; intlDesignator?: string; launchYearFrom?: number; launchYearTo?: number; onOrbit?: 'true' | 'false'; limit?: number; offset?: number; }): R; /** Upcoming/recent orbital rocket launches (Launch Library 2). */ launches(input?: { when?: 'upcoming' | 'previous'; search?: string; limit?: number; offset?: number; }): R; /** Observer-local sky almanac — sun/moon rise-set, moon phase, planet positions (computed). */ skyTonight(input: { lat: number; lon: number; altitudeM?: number; at?: string; }): R; /** Confirmed exoplanets from the NASA Exoplanet Archive. */ exoplanet(input?: { name?: string; hostStar?: string; discoveryYear?: number; method?: string; limit?: number; }): R; /** Synthesis: what's notable in your sky now — almanac + close approaches + ISS. */ skywatch(input: { lat: number; lon: number; altitudeM?: number; }): R; /** Synthesis: a host star's planetary system + computed habitable zone. */ system(input: { hostStar: string; }): R; /** Where is an asteroid/comet in the sky + can you see it tonight (computed ephemeris). */ observe(input: { body: string; lat?: number; lon?: number; altKm?: number; at?: string; }): R; }; bio: { /** Resolve a species to the GBIF taxonomic backbone (lineage, vernacular, occurrences). */ species(input: { name: string; }): R; /** Gene identity (NCBI) joined with its reviewed protein (UniProt). */ gene(input: { symbol: string; taxid?: number; }): R; /** Full UniProtKB protein entry by accession (function, GO, PDB, subcellular). */ protein(input: { accession: string; }): R; }; vehicle: { /** Vehicle 360 by VIN — decode + this vehicle's recalls + complaints merged in one call. */ profile(input: { vin: string; modelYear?: number; }): R; /** EPA/DOE fuel economy, fuel cost, and emissions by year/make/model (one entry per powertrain config). */ fuelEconomy(input: { year: number; make: string; model: string; }): R; /** NHTSA vPIC Canadian Vehicle Specifications — dimensions/weights by year/make(/model). */ canadianSpecs(input: { year: number; make: string; model?: string; }): R; /** Decode a VIN via NHTSA vPIC. */ vinDecode(input: { vin: string; modelYear?: number; }): R; /** NHTSA recall lookup by VIN, by make/model/year, or by campaign ID. */ recalls(input: { vin?: string; make?: string; model?: string; modelYear?: number; nhtsaId?: string; }): R; /** NHTSA consumer complaints by make/model/year. */ complaints(input: { make?: string; model?: string; modelYear?: number; limit?: number; offset?: number; }): R; /** NHTSA open investigations (newest-first, chronological). */ investigations(input: { limit?: number; offset?: number; }): R; /** NHTSA NCAP 5-Star crash-test ratings by make/model/year. */ safetyRatings(input: { make: string; model: string; modelYear: number; }): R; /** Models for a given make + year (vPIC). */ models(input: { make: string; modelYear: number; }): R; /** Decode a 3-character World Manufacturer Identifier (WMI). */ decodeWmi(input: { wmi: string; }): R; /** Paginated NHTSA manufacturer list (vPIC). */ manufacturers(input: { page?: number; }): R; }; agent: { /** Multi-source delta of recent events on a topic. Tier 2. */ knowledgeDelta(input: { topic: string; since: string; until?: string; maxEvents?: number; }): R; }; chem: { /** Look up a chemical compound by cid, name, smiles, or inchikey. NIH PubChem. */ compound(input: { cid?: number; name?: string; smiles?: string; inchikey?: string; }): R; }; bank: { /** FDIC-insured US bank directory. Lookup by name, cert, RSSD, or state. */ lookup(input: { name?: string; cert?: string; rssdId?: string; state?: string; status?: 'active' | 'inactive' | 'any'; limit?: number; offset?: number; }): R; }; license: { /** US healthcare provider lookup (NPPES NPI Registry). */ medical(input: { npi?: string; firstName?: string; lastName?: string; name?: string; state?: string; enumerationType?: '1' | '2'; limit?: number; skip?: number; }): R; /** FINRA BrokerCheck — registered US brokers / investment advisors. */ broker(input: { query?: string; crd?: string; limit?: number; offset?: number; }): R; /** US trade / occupational license verification (TX TDLR). */ trades(input: { state: 'TX'; name?: string; licenseNumber?: string; licenseType?: string; county?: string; limit?: number; offset?: number; }): R; /** US real-estate license verification (TX TREC). */ realEstate(input: { state: 'TX'; name?: string; licenseNumber?: string; licenseType?: string; status?: string; limit?: number; offset?: number; }): R; }; health: { /** Current US disease surveillance (CDC NNDSS weekly notifiable-disease counts). Filter by condition/location/year. */ diseaseSurveillance(input: { condition?: string; location?: string; year?: number; weeks?: number; limit?: number; }): R; /** CMS Open Payments — pharma/device → US physician payment disclosures. */ openPayments(input: { npi?: string; firstName?: string; lastName?: string; payerName?: string; state?: string; minAmount?: number; limit?: number; offset?: number; }): R; /** CMS Care Compare hospital lookup. */ hospitalLookup(input: { facilityId?: string; name?: string; city?: string; state?: string; hospitalType?: string; minRating?: number; limit?: number; offset?: number; }): R; /** CMS Care Compare hospital quality (overall star rating + measure domains). */ hospitalQuality(input: { facilityId?: string; state?: string; city?: string; name?: string; limit?: number; offset?: number; }): R; /** Medicare utilization + payments by provider NPI (CMS annual dataset). */ medicareProvider(input: { npi?: string; lastName?: string; state?: string; limit?: number; offset?: number; }): R; /** US mortality statistics (CDC NCHS: leading causes 1999-2017, weekly counts 2020-2023). */ mortalityStats(input?: { dataset?: 'leading-causes' | 'weekly-counts'; state?: string; year?: number; cause?: string; limit?: number; offset?: number; }): R; /** Provider 360 by NPI — NPPES identity + Open Payments + Medicare billing merged in one call. */ providerProfile(input: { npi: string; }): R; }; worldbank: { /** World Bank Open Data indicator time series. */ indicator(input: { country: string; indicator: string; yearFrom?: number; yearTo?: number; limit?: number; page?: number; }): R; }; book: { /** Open Library book metadata search. */ search(input: { q?: string; title?: string; author?: string; isbn?: string; limit?: number; page?: number; }): R; }; clinical: { /** ClinicalTrials.gov study search. */ trialSearch(input: { query?: string; nctId?: string; status?: 'RECRUITING' | 'ACTIVE_NOT_RECRUITING' | 'COMPLETED' | 'TERMINATED' | 'WITHDRAWN' | 'NOT_YET_RECRUITING' | 'SUSPENDED'; sponsor?: string; phase?: string; country?: string; pageSize?: number; pageToken?: string; }): R; /** Full ClinicalTrials.gov study record by NCT id: eligibility, locations, outcomes, design, sponsors, results flag. */ studyDetail(input: { nctId: string; }): R; }; code: { /** GitHub repository lookup by "owner/name". */ repoLookup(input: { repo: string; }): R; }; wikidata: { /** Wikidata entity (Q/P/L/M/S id) lookup. */ entity(input: { id: string; languages?: string; includeClaims?: boolean; maxClaimsPerProperty?: number; }): R; }; nonprofit: { /** US 501(c) nonprofit search via ProPublica Nonprofit Explorer. */ search(input: { q?: string; ein?: string; state?: string; nteeCode?: string; subsectionCode?: number; page?: number; }): R; /** Nonprofit lookup + OFAC sanctions screen per organization in one call. */ screen(input: { q?: string; ein?: string; limit?: number; }): R; }; gov: { fairMarketRent(input?: { fips?: string; state?: string; year?: string; }): R; incomeLimits(input?: { fips?: string; state?: string; year?: string; }): R; /** Active US federal contract opportunities (SAM.gov). Requires postedFrom + postedTo (MM/DD/YYYY); filter by title/naics/state/setAside/ptype. */ contractOpportunities(input: { postedFrom: string; postedTo: string; title?: string; naics?: string; state?: string; setAside?: string; ptype?: string; limit?: number; offset?: number; }): R; /** SAM.gov registered-entity lookup by UEI / CAGE / legal business name. */ entity(input: { legalBusinessName?: string; ueiSAM?: string; cageCode?: string; limit?: number; }): R; /** SAM.gov federal exclusions (debarment/suspension) check by name / UEI / CAGE. */ exclusions(input: { name?: string; ueiSAM?: string; cageCode?: string; classificationType?: string; limit?: number; }): R; /** Federal counterparty due-diligence dossier on a name: SAM registration + exclusions + OFAC + GLEIF LEI + USAspending awards + FARA foreign-agent in one call. */ counterparty(input: { name: string; state?: string; threshold?: number; limit?: number; }): R; /** FARA foreign-agent registration search by name: is this entity a registered foreign agent, with a KYB-safe bestMatch. */ foreignAgents(input: { name: string; limit?: number; }): R; /** FEMA National Risk Index for a US county (by FIPS, state+county, or lat/lon): composite risk + per-hazard ratings. */ riskIndex(input: { countyFips?: string; state?: string; county?: string; lat?: number; lon?: number; }): R; /** Resolve an FCC ID to its grantee/manufacturer (company, location, registration date) via the FCC EAS open dataset. */ fccId(input: { fccId: string; }): R; /** FEMA NFIP flood-insurance claims history for an area (by state + optional county FIPS/zip/year): net payouts + flood zone + cause + water depth. */ nfipClaims(input: { state: string; county?: string; zip?: string; yearFrom?: number; yearTo?: number; limit?: number; }): R; /** FEMA federal disaster & emergency declarations (every declaration since 1953): filter by state/disasterNumber/declarationType/incidentType/county/year/date range. */ disasterDeclarations(input?: { state?: string; disasterNumber?: number; declarationType?: string; incidentType?: string; county?: string; fyDeclared?: number; fromDate?: string; toDate?: string; limit?: number; }): R; /** FEMA disaster assistance dollars by disaster/place: program=individuals (IHP approved $ per ZIP) or public (Public Assistance obligated $ per applicant). */ disasterAssistance(input?: { program?: 'individuals' | 'public'; tenancy?: 'owner' | 'renter'; disasterNumber?: number; state?: string; zipCode?: string; limit?: number; }): R; /** FEMA Hazard Mitigation Assistance (HMA) funded projects (HMGP/BRIC/FMA): filter by state/disasterNumber/programFy/programArea → federal share, benefit-cost ratio, project type. */ hazardMitigation(input?: { state?: string; disasterNumber?: number; programFy?: number; programArea?: string; limit?: number; }): R; /** FEMA Public Assistance (PA) funded project details — post-disaster infrastructure-recovery grants: filter by state and/or disasterNumber → federal share, damage category, applicant. */ publicAssistance(input?: { state?: string; disasterNumber?: number; incidentType?: string; limit?: number; }): R; /** FEC campaign finance: name → candidate search; candidateId → financial totals (receipts/disbursements/cash-on-hand/contributions). */ fec(input?: { name?: string; candidateId?: string; limit?: number; }): R; /** Open US federal job postings (USAJOBS): filter by keyword/location/organization → title, agency, salary, grade, close date, apply link. */ usajobs(input?: { keyword?: string; location?: string; organization?: string; limit?: number; }): R; /** UK street-level crime by lat/lng (+month): total, by-category breakdown, recent records. */ ukCrime(input: { lat: number; lng: number; month?: string; limit?: number; }): R; /** Quarterly real GDP by US state (BEA Regional): state (2-letter) + optional year → real GDP (millions chained USD) per quarter. */ beaGdp(input: { state: string; year?: number; limit?: number; }): R; /** Search EU public-procurement notices (TED) by country/cpv/keyword or a raw expert query. */ euTenders(input: { country?: string; cpv?: string; keyword?: string; query?: string; limit?: number; page?: number; }): R; /** FMCSA motor-carrier safety profile by USDOT number (or name search): authority/status, safety rating, crash + inspection history, CSA BASICs. */ carrierSafety(input: { dot?: number; name?: string; limit?: number; }): R; /** US Congress members for a location: address (or state[+district]) → House rep + 2 senators with party, IDs, phone, office, contact form. */ representatives(input: { address?: string; state?: string; district?: string | number; }): R; /** US address → congressional district (119th), state, and county via the Census geocoder. GET { address }. */ district(input: { address: string; }): R; /** Federal Bureau of Prisons inmate locator (1982-present, current + released). */ inmateLocator(input: { lastName?: string; firstName?: string; middleName?: string; inmateNumber?: string; age?: number; sex?: 'Male' | 'Female'; race?: string; }): R; /** US Senate lobbying disclosures (LDA filings) — registrant/client/lobbyist/year. */ lobbyingFilings(input: { registrant?: string; client?: string; lobbyist?: string; year?: number; period?: string; type?: string; page?: number; pageSize?: number; }): R; /** US House financial-disclosure filings incl. PTR stock-trade reports (STOCK Act). Filter by member/state/type/year/date; total = count. */ congressFilings(input?: { q?: string; state?: string; type?: string; chamber?: 'house' | 'senate'; year?: number; dateFrom?: string; dateTo?: string; limit?: number; offset?: number; }): R; /** US Congress member stock trades parsed from STOCK Act PTRs. Filter by member/ticker/type/state/date; amounts are disclosed ranges; total = count. */ congressTrades(input?: { q?: string; ticker?: string; type?: 'purchase' | 'sale' | 'exchange'; chamber?: 'house' | 'senate'; state?: string; dateFrom?: string; dateTo?: string; limit?: number; offset?: number; }): R; /** US Congress bills — lookup by congress+type+number, or list/filter. */ congressBill(input?: Record): R; /** Members of US Congress — lookup by bioguide ID or filter. */ congressMember(input?: Record): R; /** Federal political candidates (OpenFEC). */ fecCandidate(input?: Record): R; /** Federal political committees (OpenFEC). */ fecCommittee(input?: Record): R; /** FEC Schedule A — itemized contributions to political committees. */ fecContributions(input?: Record): R; /** FEC Schedule B — itemized political committee disbursements. */ fecExpenditures(input?: Record): R; /** FEC aggregate financial totals (candidates or committees). */ fecTotals(input: { scope: 'candidates' | 'committees'; [k: string]: unknown; }): R; /** US Congressional committees — list or look up by systemCode. */ congressCommittee(input?: Record): R; /** US Congressional amendments — list or look up by congress+type+number. */ congressAmendment(input?: Record): R; /** US presidential nominations sent to the Senate. */ congressNomination(input?: Record): R; /** US Congressional hearings (Congress.gov). */ congressHearing(input?: Record): R; /** International treaties transmitted to the US Senate (Congress.gov). */ congressTreaty(input?: Record): R; /** Daily Congressional Record issues (Congress.gov). */ congressRecord(input?: Record): R; /** Latest US Congressional bill summaries (Congress.gov). */ billSummaries(input?: Record): R; /** OSHA inspection records via DOL Open Data Portal. */ oshaInspections(input?: Record): R; /** OSHA citation / violation records via DOL Open Data Portal. */ oshaViolations(input?: Record): R; /** OSHA-investigated workplace accident reports via DOL Open Data Portal. */ oshaAccidents(input?: Record): R; /** MSHA mine safety accident records via DOL Open Data Portal. */ mshaAccidents(input?: Record): R; /** OpenFDA drug adverse event reports (FAERS). */ fdaDrugEvents(input: { drug: string; reaction?: string; limit?: number; }): R; /** OpenFDA drug recall enforcement reports. */ fdaRecalls(input: { drug?: string; classification?: 'I' | 'II' | 'III'; status?: 'Ongoing' | 'Completed' | 'Terminated' | 'Pending'; limit?: number; }): R; /** CPSC consumer-product recalls (SaferProducts.gov), newest first. All filters optional. */ productRecalls(input?: { title?: string; productName?: string; recallNumber?: string; dateStart?: string; dateEnd?: string; limit?: number; }): R; /** OpenFDA food recall enforcement reports. */ fdaFoodRecalls(input: { product?: string; classification?: 'I' | 'II' | 'III'; status?: 'Ongoing' | 'Completed' | 'Terminated' | 'Pending'; state?: string; limit?: number; }): R; /** OpenFDA medical device adverse event reports (MAUDE). */ fdaDeviceEvents(input: { device?: string; manufacturer?: string; problem?: string; limit?: number; }): R; /** OpenFDA animal/veterinary adverse event reports. */ fdaAnimalvetEvents(input: { drug?: string; species?: string; reaction?: string; limit?: number; }): R; /** US House of Representatives roll-call votes (locally aggregated, daily). */ houseVotes(input?: { year?: number; congress?: number; result?: string; bill?: string; since?: string; until?: string; limit?: number; offset?: number; }): R; /** US Senate roll-call votes (locally aggregated, daily). */ senateVotes(input?: { congress?: number; session?: 1 | 2; result?: string; document?: string; since?: string; until?: string; limit?: number; offset?: number; }): R; /** Federal-award (contracts/grants/loans/payments) search via USAspending.gov. */ usaspendingAwards(input?: { recipient?: string; agency?: string; recipientState?: string; awardType?: 'contracts' | 'grants' | 'loans' | 'direct_payments' | 'other'; since?: string; until?: string; limit?: number; page?: number; }): R; /** Real-time USGS NWIS water gauge readings within a bbox around lat/lon. */ usgsWater(input: { lat: number; lon: number; radius?: number; variables?: string; limit?: number; }): R; /** EPA Facility Registry Service (FRS) by state + name + program. */ epaFacilities(input: { state: string; name?: string; program?: string; limit?: number; offset?: number; }): R; /** Newest Federal Register documents by publication date (chronological feed). */ federalRegisterRecent(input?: { type?: 'RULE' | 'PRORULE' | 'NOTICE' | 'PRESDOCU'; agency?: string; since?: string; until?: string; limit?: number; page?: number; }): R; }; } export declare function createEndpoints(client: TwoS): Endpoints; export {}; //# sourceMappingURL=endpoints.d.ts.map