fmp-node-api 0.0.6 → 0.0.8

package/dist/index.d.ts

@@ -1,17 +1,7 @@
 interface APIResponse<T = unknown> {
     success: boolean;
-    data?: T;
-    error?: string;
-    status?: number;
-}
-interface SuccessResponse<T> extends APIResponse<T> {
-    success: true;
-    data: T;
-    status: number;
-}
-interface ErrorResponse extends APIResponse<never> {
-    success: false;
-    error: string;
+    data: T | null;
+    error: string | null;
     status: number;
 }
 interface FMPConfig {
@@ -161,6 +151,29 @@ interface MarketCap {
     date: string;
     marketCap: number;
 }
+interface StockRealTimePrice {
+    symbol: string;
+    price: number;
+}
+interface StockRealTimePriceFull {
+    bidSize: number;
+    askPrice: number;
+    volume: number;
+    askSize: number;
+    bidPrice: number;
+    lastSalePrice: number;
+    lastSaleSize: number;
+    lastSaleTime: number;
+    fmpLast: number;
+    lastUpdated: number;
+    symbol: string;
+}
+interface StockListResponse<T> {
+    stockList: T[];
+}
+interface CompaniesPriceListResponse<T> {
+    companiesPriceList: T[];
+}
 
 interface FinancialStatementsParams extends SymbolParams, PeriodParams {
     limit?: number;
@@ -830,7 +843,7 @@ interface MarketIndex {
 interface EarningsCalendar {
     date: string;
     symbol: string;
-    eps: number;
+    eps: number | null;
     epsEstimated: number | null;
     time: string;
     revenue: number | null;
@@ -838,6 +851,16 @@ interface EarningsCalendar {
     fiscalDateEnding: string;
     updatedFromDate: string;
 }
+interface EarningsConfirmed {
+    symbol: string;
+    exchange: string;
+    time: string;
+    when: string;
+    date: string;
+    publicationDate: string;
+    title: string;
+    url: string;
+}
 interface DividendsCalendar {
     date: string;
     label: string;
@@ -1011,6 +1034,7 @@ interface EarningsCallTranscript {
     date: string;
     content: string;
 }
+type CompanyTranscriptData = [number, number, string];
 
 interface SenateHouseTradingParams {
     symbol: string;
@@ -1018,6 +1042,9 @@ interface SenateHouseTradingParams {
 interface SenateHouseTradingRSSFeedParams {
     page: number;
 }
+interface SenateHouseTradingByNameParams {
+    name: string;
+}
 interface SenateTradingResponse {
     firstName: string;
     lastName: string;
@@ -1047,6 +1074,279 @@ interface HouseTradingResponse {
     link: string;
     capitalGainsOver200USD: string;
 }
+interface SenateHouseTradingByNameResponse {
+    symbol: string;
+    disclosureDate: string;
+    transactionDate: string;
+    firstName: string;
+    lastName: string;
+    office: string;
+    district: string;
+    owner: string;
+    assetDescription: string;
+    assetType: string;
+    type: string;
+    amount: string;
+    capitalGainsOver200USD: string;
+    comment: string;
+    link: string;
+}
+
+interface Form13FParams {
+    cik: string;
+    date: string;
+}
+interface Form13FDatesParams {
+    cik: string;
+}
+interface InstitutionalHolderParams {
+    symbol: string;
+}
+interface Form13FResponse {
+    date: string;
+    fillingDate: string;
+    acceptedDate: string;
+    cik: string;
+    cusip: string;
+    tickerCusip: string;
+    nameOfIssuer: string;
+    shares: number;
+    titleOfClass: string;
+    value: number;
+    link: string;
+    finalLink: string;
+}
+interface InstitutionalHolderResponse {
+    holder: string;
+    shares: number;
+    dateReported: string;
+    change: number;
+}
+
+interface InsiderTradingRSSResponse {
+    title: string;
+    fillingDate: string;
+    symbol: string;
+    link: string;
+    reportingCik: string;
+    issuerCik: string;
+}
+interface InsiderTradingSearchResponse {
+    symbol: string;
+    filingDate: string;
+    transactionDate: string;
+    reportingCik: string;
+    transactionType: string;
+    securitiesOwned: number;
+    securitiesTransacted: number;
+    companyCik: string;
+    reportingName: string;
+    typeOfOwner: string;
+    link: string;
+    securityName: string;
+    price: number;
+    formType: string;
+    acquistionOrDisposition: string;
+}
+type TransactionTypesResponse = string[];
+interface InsidersBySymbolResponse {
+    typeOfOwner: string;
+    transactionDate: string;
+    owner: string;
+}
+interface InsiderTradeStatisticsResponse {
+    symbol: string;
+    cik: string;
+    year: number;
+    quarter: number;
+    purchases: number;
+    sales: number;
+    buySellRatio: number;
+    totalBought: number;
+    totalSold: number;
+    averageBought: number;
+    averageSold: number;
+    pPurchases: number;
+    sSales: number;
+}
+interface CikMapperResponse {
+    reportingCik: string;
+    reportingName: string;
+}
+interface CikMapperBySymbolResponse {
+    symbol: string;
+    companyCik: string;
+}
+interface BeneficialOwnershipResponse {
+    cik: string;
+    symbol: string;
+    filingDate: string;
+    acceptedDate: string;
+    cusip: string;
+    nameOfReportingPerson: string;
+    citizenshipOrPlaceOfOrganization: string;
+    soleVotingPower: string;
+    sharedVotingPower: string;
+    soleDispositivePower: string;
+    sharedDispositivePower: string;
+    amountBeneficiallyOwned: string;
+    percentOfClass: string;
+    typeOfReportingPerson: string;
+    url: string;
+}
+interface FailToDeliverResponse {
+    symbol: string;
+    date: string;
+    price: number;
+    quantity: number;
+    cusip: string;
+    name: string;
+}
+interface InsiderTradingRSSParams {
+    page: number;
+}
+interface InsiderTradingSearchParams {
+    symbol?: string;
+    reportingCik?: string;
+    companyCik?: string;
+    transactionType?: string;
+    page: number;
+}
+interface InsidersBySymbolParams {
+    symbol: string;
+}
+interface InsiderTradeStatisticsParams {
+    symbol: string;
+}
+interface CikMapperParams {
+    page: number;
+}
+interface CikMapperByNameParams {
+    name: string;
+    page?: number;
+}
+interface CikMapperBySymbolParams {
+    symbol: string;
+}
+interface BeneficialOwnershipParams {
+    symbol: string;
+}
+interface FailToDeliverParams {
+    symbol: string;
+    page?: number;
+}
+declare enum TransactionType {
+    AWARD = "A-Award",
+    CONVERSION = "C-Conversion",
+    RETURN = "D-Return",
+    EXPIRE_SHORT = "E-ExpireShort",
+    IN_KIND = "F-InKind",
+    GIFT = "G-Gift",
+    EXPIRE_LONG = "H-ExpireLong",
+    DISCRETIONARY = "I-Discretionary",
+    OTHER = "J-Other",
+    SMALL = "L-Small",
+    EXEMPT = "M-Exempt",
+    OUT_OF_THE_MONEY = "O-OutOfTheMoney",
+    PURCHASE = "P-Purchase",
+    SALE = "S-Sale",
+    TENDER = "U-Tender",
+    WILL = "W-Will",
+    IN_THE_MONEY = "X-InTheMoney",
+    TRUST = "Z-Trust"
+}
+
+interface RSSFeedItem {
+    title: string;
+    date: string;
+    link: string;
+    cik: string;
+    form_type: string;
+    ticker: string;
+    done: boolean;
+}
+interface RSSFeedV3Item {
+    title: string;
+    date: string;
+    link: string;
+    cik: string;
+    form_type: string;
+    ticker: string;
+    done: boolean;
+}
+interface RSSFeed8KItem {
+    title: string;
+    symbol: string;
+    cik: string;
+    link: string;
+    finalLink: string;
+    date: string;
+    process: string;
+    hasFinancials: string;
+}
+interface SECFiling {
+    symbol: string;
+    cik: string;
+    type: string;
+    link: string;
+    finalLink: string;
+    acceptedDate: string;
+    fillingDate: string;
+}
+interface IndustryClassification {
+    symbol: string;
+    name: string;
+    cik: string;
+    sicCode: string;
+    industryTitle: string;
+    businessAdress: string;
+    phoneNumber: string;
+}
+interface IndustryClassificationCode {
+    office: string;
+    sicCode: string;
+    industryTitle: string;
+}
+interface RSSFeedParams {
+    limit?: number;
+    type?: string;
+    from?: string;
+    to?: string;
+    isDone?: boolean;
+}
+interface RSSFeedV3Params {
+    page?: number;
+    datatype?: string;
+}
+interface RSSFeedAllItem {
+    symbol: string;
+    fillingDate: string;
+    acceptedDate: string;
+    cik: string;
+    type: string;
+    link: string;
+    finalLink: string;
+}
+interface RSSFeed8KParams {
+    page?: number;
+    from?: string;
+    to?: string;
+    hasFinancial?: boolean;
+    limit?: number;
+}
+interface SECFilingsParams {
+    page?: number;
+    type?: string;
+}
+interface IndividualIndustryClassificationParams {
+    symbol?: string;
+    cik?: number;
+    sicCode?: number;
+}
+interface IndustryClassificationCodesParams {
+    industryTitle?: string;
+    sicCode?: number;
+}
 
 declare class FMPClient {
     private v3Client;
@@ -1055,7 +1355,18 @@ declare class FMPClient {
     private apiKey;
     constructor(config: FMPConfig);
     private createClient;
+    /**
+     * Standard get method - returns raw API response
+     *
+     * For endpoints that return arrays, this will always return an array (possibly empty) for `data` when success is true.
+     * For endpoints that return objects, data is returned as-is.
+     */
     get<T>(endpoint: string, version?: 'v3' | 'v4' | 'stable', params?: Record<string, any>): Promise<APIResponse<T>>;
+    /**
+     * Get method for single-object endpoints - unwraps single-item arrays
+     *
+     * For endpoints that return single objects, this will always return an object (possibly empty) for `data` when success is true.
+     */
     getSingle<T>(endpoint: string, version?: 'v3' | 'v4' | 'stable', params?: Record<string, any>): Promise<APIResponse<T>>;
     private getClientForVersion;
 }
@@ -1071,7 +1382,7 @@ declare class StockEndpoints {
      */
     getQuote({ symbol }: {
         symbol: string;
-    }): Promise<APIResponse<StockQuote | null>>;
+    }): Promise<APIResponse<StockQuote>>;
     /**
      * Get historical stock prices
      * @deprecated Use `fmp.quote.getHistoricalPrice()` instead. This method will be removed in version 0.1.0.
@@ -1093,7 +1404,7 @@ declare class StockEndpoints {
      */
     getMarketCap({ symbol }: {
         symbol: string;
-    }): Promise<APIResponse<MarketCap | null>>;
+    }): Promise<APIResponse<MarketCap>>;
     /**
      * Get stock splits
      * https://site.financialmodelingprep.com/developer/docs#splits-historical-splits
@@ -1112,6 +1423,23 @@ declare class StockEndpoints {
     getDividendHistory({ symbol, }: {
         symbol: string;
     }): Promise<APIResponse<StockDividendResponse>>;
+    /**
+     * Get stock real time price
+     * @param symbol - The stock symbol to get the real time price for
+     * @returns The real time price for the stock
+     */
+    getRealTimePrice({ symbols, }: {
+        symbols: string[];
+    }): Promise<APIResponse<StockRealTimePrice[]>>;
+    /**
+     * Get stock real time price full
+     * https://site.financialmodelingprep.com/developer/docs#real-time-full-price-quote
+     * @param symbols - The stock symbols to get the real time price for
+     * @returns The real time price for the stocks
+     */
+    getRealTimePriceForMultipleStocks({ symbols, }: {
+        symbols: string[];
+    }): Promise<APIResponse<StockRealTimePriceFull[]>>;
 }
 
 declare class FinancialEndpoints {
@@ -1311,7 +1639,7 @@ declare class ETFEndpoints {
      * @param symbol - The symbol of the ETF to get the profile for
      * @returns The FMP ETF Information endpoint provides basic information about an ETF, such as its ticker symbol, name, expense ratio, and asset under management. For example, an investor may want to compare the expense ratios of different ETFs to find the one that is most cost-effective.
      */
-    getProfile({ symbol }: SymbolParams): Promise<APIResponse<ETFProfile | null>>;
+    getProfile({ symbol }: SymbolParams): Promise<APIResponse<ETFProfile>>;
     /**
      * Get ETF sector weighting
      * https://site.financialmodelingprep.com/developer/docs#etf-sector-weighting-etf-holdings
@@ -1463,6 +1791,14 @@ declare class CalendarEndpoints {
      * @returns The earnings calendar
      */
     getEarningsCalendar({ from, to }?: DateRangeParams): Promise<APIResponse<EarningsCalendar[]>>;
+    /**
+     * Get earnings confirmed
+     * https://site.financialmodelingprep.com/developer/docs#earnings-confirmed-earnings
+     * @param from - The start date to get the earnings confirmed for
+     * @param to - The end date to get the earnings confirmed for
+     * @returns The earnings confirmed
+     */
+    getEarningsConfirmed({ from, to }?: DateRangeParams): Promise<APIResponse<EarningsConfirmed[]>>;
     /**
      * Get dividends calendar
      * https://site.financialmodelingprep.com/developer/docs#dividends-calendar-dividends
@@ -1506,9 +1842,9 @@ declare class CompanyEndpoints {
      * @param symbol - The stock symbol to get the profile for
      * @returns Get a comprehensive overview of a company with our Company Profile endpoint. This endpoint provides key information such as price, beta, market capitalization, description, headquarters, and more.
      */
-    getCompanyProfile({ symbol, }: {
+    getCompanyProfile({ symbol }: {
         symbol: string;
-    }): Promise<APIResponse<CompanyProfile | null>>;
+    }): Promise<APIResponse<CompanyProfile>>;
     /**
      * Get executive compensation
      * https://site.financialmodelingprep.com/developer/docs#executive-compensation-company-information
@@ -1517,16 +1853,16 @@ declare class CompanyEndpoints {
      */
     getExecutiveCompensation({ symbol, }: {
         symbol: string;
-    }): Promise<APIResponse<ExecutiveCompensation[] | null>>;
+    }): Promise<APIResponse<ExecutiveCompensation[]>>;
     /**
      * Get company notes
      * https://site.financialmodelingprep.com/developer/docs#company-notes-company-information
      * @param symbol - The stock symbol to get the notes for
      * @returns Stay up-to-date on a company's financial condition, operations, and risks with our Company Notes endpoint. This endpoint provides information about notes reported by a company in their financial statements.
      */
-    getCompanyNotes({ symbol, }: {
+    getCompanyNotes({ symbol }: {
         symbol: string;
-    }): Promise<APIResponse<CompanyNotes[] | null>>;
+    }): Promise<APIResponse<CompanyNotes[]>>;
     /**
      * Get historical employee count
      * https://site.financialmodelingprep.com/developer/docs#historical-employee-company-information
@@ -1535,7 +1871,7 @@ declare class CompanyEndpoints {
      */
     getHistoricalEmployeeCount({ symbol, }: {
         symbol: string;
-    }): Promise<APIResponse<HistoricalEmployeeCount[] | null>>;
+    }): Promise<APIResponse<HistoricalEmployeeCount[]>>;
     /**
      * Get shares float
      * https://site.financialmodelingprep.com/developer/docs#company-share-float-share-float
@@ -1544,7 +1880,7 @@ declare class CompanyEndpoints {
      */
     getSharesFloat({ symbol }: {
         symbol: string;
-    }): Promise<APIResponse<SharesFloat | null>>;
+    }): Promise<APIResponse<SharesFloat>>;
     /**
      * Get historical shares float
      * https://site.financialmodelingprep.com/developer/docs#company-historical-share-float
@@ -1553,7 +1889,7 @@ declare class CompanyEndpoints {
      */
     getHistoricalSharesFloat({ symbol, }: {
         symbol: string;
-    }): Promise<APIResponse<HistoricalSharesFloat[] | null>>;
+    }): Promise<APIResponse<HistoricalSharesFloat[]>>;
     /**
      * Get earnings call transcript
      * https://site.financialmodelingprep.com/developer/docs#earnings-transcript-earnings-transcripts
@@ -1566,7 +1902,16 @@ declare class CompanyEndpoints {
         symbol: string;
         year: number;
         quarter: number;
-    }): Promise<APIResponse<EarningsCallTranscript[] | null>>;
+    }): Promise<APIResponse<EarningsCallTranscript[]>>;
+    /**
+     * Get company transcript dates
+     * https://site.financialmodelingprep.com/developer/docs#transcript-dates-earnings-transcripts
+     * @param symbol - The stock symbol to get the transcript data for
+     * @returns The FMP Company Transcript Data endpoint provides the transcript data for a company's earnings call.
+     */
+    getCompanyTranscriptData({ symbol, }: {
+        symbol: string;
+    }): Promise<APIResponse<CompanyTranscriptData[]>>;
 }
 
 declare class QuoteEndpoints {
@@ -1577,7 +1922,7 @@ declare class QuoteEndpoints {
      * @param params - Parameters for the quote request
      * @returns Quote data for the specified asset
      */
-    getQuote(params: QuoteParams): Promise<APIResponse<Quote | null>>;
+    getQuote(params: QuoteParams): Promise<APIResponse<Quote>>;
     /**
      * Get historical prices for any asset type
      * @param params - Parameters for the historical price request
@@ -1614,6 +1959,12 @@ declare class SenateHouseEndpoints {
      * @returns Senate trading RSS feed
      */
     getSenateTradingRSSFeed(params: SenateHouseTradingRSSFeedParams): Promise<APIResponse<SenateTradingResponse[]>>;
+    /** Get Senate trades by name
+     * https://site.financialmodelingprep.com/developer/docs/stable#senate-trading-by-name
+     * @param name - The name of the senator to get the trades for
+     * @returns Senate trades by name
+     */
+    getSenateTradingByName(params: SenateHouseTradingByNameParams): Promise<APIResponse<SenateHouseTradingByNameResponse[]>>;
     /**
      * Get house trading data only
      * https://site.financialmodelingprep.com/developer/docs#house-disclosure
@@ -1626,7 +1977,206 @@ declare class SenateHouseEndpoints {
      * @param page - The page number to get
      * @returns House trading RSS feed
      */
-    getHouseTradingRSSFeed(params: SenateHouseTradingRSSFeedParams): Promise<APIResponse<SenateTradingResponse[]>>;
+    getHouseTradingRSSFeed(params: SenateHouseTradingRSSFeedParams): Promise<APIResponse<HouseTradingResponse[]>>;
+    /** Get house trading by name
+     * https://site.financialmodelingprep.com/developer/docs/stable#house-trading-by-name
+     * @param name - The name of the representative to get the trades for
+     * @returns House trading by name
+     */
+    getHouseTradingByName(params: SenateHouseTradingByNameParams): Promise<APIResponse<SenateHouseTradingByNameResponse[]>>;
+}
+
+declare class InstitutionalEndpoints {
+    private client;
+    constructor(client: FMPClient);
+    /**
+     * Get Form 13F institutional stock ownership data
+     * https://site.financialmodelingprep.com/developer/docs#form-13f-13f---institutional-stock-ownership
+     * @param symbol - The stock symbol to get the Form 13F data for
+     * @param date - The date to get the Form 13F data for (optional)
+     * @returns Form 13F institutional stock ownership data
+     */
+    getForm13F(params: Form13FParams): Promise<APIResponse<Form13FResponse[]>>;
+    /**
+     * Get Form 13F dates for institutional stock ownership
+     * https://site.financialmodelingprep.com/developer/docs#form-13f-dates-13f---institutional-stock-ownership
+     * @param symbol - The stock symbol to get the Form 13F dates for
+     * @returns Form 13F dates for institutional stock ownership
+     */
+    getForm13FDates(params: Form13FDatesParams): Promise<APIResponse<string[]>>;
+    /**
+     * Get institutional holders data
+     * https://site.financialmodelingprep.com/developer/docs#institutional-holder-13f---institutional-stock-ownership
+     * @param symbol - The stock symbol to get the institutional holders for
+     * @returns Institutional holders data
+     */
+    getInstitutionalHolders(params: InstitutionalHolderParams): Promise<APIResponse<InstitutionalHolderResponse[]>>;
+}
+
+declare class InsiderEndpoints {
+    private client;
+    constructor(client: FMPClient);
+    /**
+     * Get insider trading RSS feed
+     * https://site.financialmodelingprep.com/developer/docs#insider-trades-rss-insider-trading
+     * @param params - Parameters for the RSS feed request
+     * @returns An RSS feed of insider trades, updated in real time
+     */
+    getInsiderTradingRSS({ page, }: InsiderTradingRSSParams): Promise<APIResponse<InsiderTradingRSSResponse[]>>;
+    /**
+     * Search for insider trades
+     * https://site.financialmodelingprep.com/developer/docs#insider-trades-search-insider-trading
+     * @param params - Parameters for the insider trading search
+     * @returns A list of insider trades filtered by the provided parameters
+     */
+    searchInsiderTrading({ symbol, reportingCik, companyCik, transactionType, page, }: InsiderTradingSearchParams): Promise<APIResponse<InsiderTradingSearchResponse[]>>;
+    /**
+     * Get transaction types
+     * https://site.financialmodelingprep.com/developer/docs#transaction-types-insider-trading
+     * @returns A list of all insider transaction types
+     */
+    getTransactionTypes(): Promise<APIResponse<TransactionTypesResponse>>;
+    /**
+     * Get insiders by symbol
+     * https://site.financialmodelingprep.com/developer/docs#insiders-by-symbol-insider-trading
+     * @param params - Parameters for the insiders request
+     * @returns A list of insiders for a specific company
+     */
+    getInsidersBySymbol({ symbol, }: InsidersBySymbolParams): Promise<APIResponse<InsidersBySymbolResponse[]>>;
+    /**
+     * Get insider trade statistics
+     * https://site.financialmodelingprep.com/developer/docs#insider-trade-statistics-insider-trading
+     * @param params - Parameters for the statistics request
+     * @returns Statistics on insider trading activity for a specific company
+     */
+    getInsiderTradeStatistics({ symbol, }: InsiderTradeStatisticsParams): Promise<APIResponse<InsiderTradeStatisticsResponse[]>>;
+    /**
+     * Get CIK mapper
+     * https://site.financialmodelingprep.com/developer/docs#cik-mapper-insider-trading
+     * @param params - Parameters for the CIK mapper request
+     * @returns A list of CIK numbers and corresponding company names
+     */
+    getCikMapper({ page }: CikMapperParams): Promise<APIResponse<CikMapperResponse[]>>;
+    /**
+     * Get CIK mapper by name
+     * https://site.financialmodelingprep.com/developer/docs#cik-mapper-by-name-insider-trading
+     * @param params - Parameters for the CIK mapper by name request
+     * @returns A list of CIK numbers and corresponding names matching the search term
+     */
+    getCikMapperByName({ name, page, }: CikMapperByNameParams): Promise<APIResponse<CikMapperResponse[]>>;
+    /**
+     * Get CIK mapper by symbol
+     * https://site.financialmodelingprep.com/developer/docs#cik-mapper-company-insider-trading
+     * @param params - Parameters for the CIK mapper by symbol request
+     * @returns CIK number and corresponding company name for a specific symbol
+     */
+    getCikMapperBySymbol({ symbol, }: CikMapperBySymbolParams): Promise<APIResponse<CikMapperBySymbolResponse>>;
+    /**
+     * Get beneficial ownership acquisitions
+     * https://site.financialmodelingprep.com/developer/docs#acquisition-of-beneficial-ownership
+     * @param params - Parameters for the beneficial ownership request
+     * @returns A list of acquisitions of beneficial ownership for a specific company
+     */
+    getBeneficialOwnership({ symbol, }: BeneficialOwnershipParams): Promise<APIResponse<BeneficialOwnershipResponse[]>>;
+    /**
+     * Get fail to deliver data
+     * https://site.financialmodelingprep.com/developer/docs#fail-to-deliver
+     * @param params - Parameters for the fail to deliver request
+     * @returns A list of fail to deliver data for a specific company
+     */
+    getFailToDeliver({ symbol, page, }: FailToDeliverParams): Promise<APIResponse<FailToDeliverResponse[]>>;
+    /**
+     * Get all insider trades for a symbol (convenience method)
+     * @param symbol - The stock symbol to get insider trades for
+     * @param page - Page number for pagination (default: 0)
+     * @returns A list of insider trades for the specified symbol
+     */
+    getInsiderTradesBySymbol(symbol: string, page?: number): Promise<APIResponse<InsiderTradingSearchResponse[]>>;
+    /**
+     * Get insider trades by transaction type (convenience method)
+     * @param transactionType - The transaction type to filter by
+     * @param page - Page number for pagination (default: 0)
+     * @returns A list of insider trades filtered by transaction type
+     */
+    getInsiderTradesByType(transactionType: TransactionType | string, page?: number): Promise<APIResponse<InsiderTradingSearchResponse[]>>;
+    /**
+     * Get insider trades by reporting CIK (convenience method)
+     * @param reportingCik - The reporting CIK to filter by
+     * @param page - Page number for pagination (default: 0)
+     * @returns A list of insider trades filtered by reporting CIK
+     */
+    getInsiderTradesByReportingCik(reportingCik: string, page?: number): Promise<APIResponse<InsiderTradingSearchResponse[]>>;
+    /**
+     * Get insider trades by company CIK (convenience method)
+     * @param companyCik - The company CIK to filter by
+     * @param page - Page number for pagination (default: 0)
+     * @returns A list of insider trades filtered by company CIK
+     */
+    getInsiderTradesByCompanyCik(companyCik: string, page?: number): Promise<APIResponse<InsiderTradingSearchResponse[]>>;
+}
+
+declare class SECEndpoints {
+    private client;
+    constructor(client: FMPClient);
+    /**
+     * Get RSS feed of SEC filings
+     * https://site.financialmodelingprep.com/developer/docs#rss-feed-securities-and-exchange-commission-(s.e.c)
+     * @param params - RSS feed parameters
+     * @returns A real-time feed of SEC filings from publicly traded companies, including the filing type, link to SEC page, and direct link to the filing. This endpoint can be used to stay up-to-date on the latest SEC filings for all companies or for a specific set of companies.
+     */
+    getRSSFeed(params?: RSSFeedParams): Promise<APIResponse<RSSFeedItem[]>>;
+    /**
+     * Get RSS feed of all SEC filings
+     * https://site.financialmodelingprep.com/developer/docs#rss-feed-all-securities-and-exchange-commission-(s.e.c)
+     * @param params - RSS feed all parameters
+     * @returns A real-time feed of all SEC filings from publicly traded companies in the latest RSS feed format. This endpoint provides a comprehensive overview of all SEC filings, including the filing type, link to SEC page, and direct link to the filing.
+     */
+    getRSSFeedAll(params?: RSSFeedV3Params): Promise<APIResponse<RSSFeedAllItem[]>>;
+    /**
+     * Get RSS feed V3 of SEC filings
+     * https://site.financialmodelingprep.com/developer/docs#rss-feed-v3-securities-and-exchange-commission-(s.e.c)
+     * @param params - RSS feed V3 parameters
+     * @returns A real-time feed of SEC filings from publicly traded companies in the latest RSS feed format (V3)
+     */
+    getRSSFeedV3(params?: RSSFeedV3Params): Promise<APIResponse<RSSFeedV3Item[]>>;
+    /**
+     * Get RSS feed of 8-K SEC filings
+     * https://site.financialmodelingprep.com/developer/docs#rss-feed-8-k-securities-and-exchange-commission-(s.e.c)
+     * @param params - RSS feed 8-K parameters
+     * @returns A real-time feed of 8-K SEC filings from publicly traded companies
+     */
+    getRSSFeed8K(params?: RSSFeed8KParams): Promise<APIResponse<RSSFeed8KItem[]>>;
+    /**
+     * Get SEC filings for a specific company
+     * https://site.financialmodelingprep.com/developer/docs#sec-filings-securities-and-exchange-commission-(s.e.c)
+     * @param symbol - The stock symbol to get SEC filings for
+     * @param params - SEC filings parameters
+     * @returns Access direct links to SEC filings, including the filing type, link to the SEC page, and direct link to the specific filing
+     */
+    getSECFilings({ symbol, params, }: {
+        symbol: string;
+        params?: SECFilingsParams;
+    }): Promise<APIResponse<SECFiling[]>>;
+    /**
+     * Get individual industry classification
+     * https://site.financialmodelingprep.com/developer/docs#individual-industry-classification-standard-industrial-classification
+     * @param params - Industry classification parameters
+     * @returns Identify the industry in which a particular company operates, based on the Standard Industrial Classification (SIC) system
+     */
+    getIndividualIndustryClassification(params: IndividualIndustryClassificationParams): Promise<APIResponse<IndustryClassification>>;
+    /**
+     * Get all industry classifications
+     * https://site.financialmodelingprep.com/developer/docs#all-industry-classification-standard-industrial-classification
+     * @returns Get a comprehensive overview of all industries, classified according to the SIC system
+     */
+    getAllIndustryClassifications(): Promise<APIResponse<IndustryClassification[]>>;
+    /**
+     * Get industry classification codes
+     * https://site.financialmodelingprep.com/developer/docs#industry-classification-codes-standard-industrial-classification
+     * @param params - Industry classification codes parameters
+     * @returns Learn more about the SIC system and identify the SIC code for a particular industry
+     */
+    getIndustryClassificationCodes(params: IndustryClassificationCodesParams): Promise<APIResponse<IndustryClassificationCode[]>>;
 }
 
 /**
@@ -1665,6 +2215,9 @@ declare class FMP {
     readonly company: CompanyEndpoints;
     readonly quote: QuoteEndpoints;
     readonly senateHouse: SenateHouseEndpoints;
+    readonly institutional: InstitutionalEndpoints;
+    readonly insider: InsiderEndpoints;
+    readonly sec: SECEndpoints;
     constructor(config: FMPConfig);
     /**
      * Get the underlying client instance for advanced usage
@@ -1796,4 +2349,4 @@ declare const HTTP_STATUS: {
     readonly INTERNAL_SERVER_ERROR: 500;
 };
 
-export { type APIResponse, type AvailableIndexesList, type BalanceSheet, type BalanceSheetGrowth, COUNTRIES, CalendarEndpoints, type CashFlowStatement, type CashflowGrowth, CompanyEndpoints, type CompanyNotes, type CompanyProfile, CryptoEndpoints, type CryptoHistoricalParams, type CryptoList, type CryptoListParams, type CryptoQuote, DEFAULT_LIMIT, DEFAULT_TIMEOUT, type DateRangeParams, type DividendsCalendar, ERROR_MESSAGES, type ETFCountryWeighting, ETFEndpoints, type ETFHolder, type ETFHolding, type ETFHoldingDates, type ETFList, type ETFProfile, type ETFStockExposure, type ETFWeighting, EXCHANGES, type EarningsCalendar, type EarningsCallTranscript, type EarningsHistorical, type EarningsSurprises, EconomicEndpoints, type EconomicIndicator, type EconomicIndicatorName, type EconomicIndicatorParams, type EconomicsCalendar, type EnterpriseValue, type ErrorResponse, Exchange, type ExecutiveCompensation, FMP, FMPClient, type FMPConfig, FinancialEndpoints, type FinancialGrowth, type FinancialRatios, type FinancialStatementBase, type FinancialStatementsParams, ForexEndpoints, type ForexHistoricalParams, type ForexList, type ForexQuote, type GrowthStatementBase, HTTP_STATUS, type HistoricalEmployeeCount, type HistoricalPriceData, type HistoricalPriceParams, type HistoricalPriceResponse, type HistoricalSharesFloat, type HouseTradingResponse, type IPOCalendar, type IncomeGrowth, type IncomeStatement, type IntradayParams, type KeyMetrics, ListEndpoints, MAX_LIMIT, type MarketCap, MarketEndpoints, type MarketHoliday, type MarketHours, type MarketIndex, type MarketPerformance, type MarketSectorPerformance, MutualFundEndpoints, type MutualFundHolding, type MutualFundQuote, PERIODS, type PaginationParams, Period, type PeriodParams, type QueryParams, type Quote, QuoteEndpoints, type QuoteParams, SECTORS, SenateHouseEndpoints, type SenateHouseTradingParams, type SenateHouseTradingRSSFeedParams, type SenateTradingResponse, type SharesFloat, type SplitsCalendar, type StockDividend, type StockDividendResponse, StockEndpoints, type StockList, type StockQuote, type StockSplit, type StockSplitResponse, type SuccessResponse, type SymbolParams, type TreasuryRate, formatCurrency, formatDate, formatLargeNumber, formatNumber, formatPercentage, formatReadableDate, formatTimestamp, formatVolume, validateApiKey, validateDate, validateLimit, validatePage, validatePeriod, validateSymbol };
+export { type APIResponse, type AvailableIndexesList, type BalanceSheet, type BalanceSheetGrowth, type BeneficialOwnershipParams, type BeneficialOwnershipResponse, COUNTRIES, CalendarEndpoints, type CashFlowStatement, type CashflowGrowth, type CikMapperByNameParams, type CikMapperBySymbolParams, type CikMapperBySymbolResponse, type CikMapperParams, type CikMapperResponse, type CompaniesPriceListResponse, CompanyEndpoints, type CompanyNotes, type CompanyProfile, type CompanyTranscriptData, CryptoEndpoints, type CryptoHistoricalParams, type CryptoList, type CryptoListParams, type CryptoQuote, DEFAULT_LIMIT, DEFAULT_TIMEOUT, type DateRangeParams, type DividendsCalendar, ERROR_MESSAGES, type ETFCountryWeighting, ETFEndpoints, type ETFHolder, type ETFHolding, type ETFHoldingDates, type ETFList, type ETFProfile, type ETFStockExposure, type ETFWeighting, EXCHANGES, type EarningsCalendar, type EarningsCallTranscript, type EarningsConfirmed, type EarningsHistorical, type EarningsSurprises, EconomicEndpoints, type EconomicIndicator, type EconomicIndicatorName, type EconomicIndicatorParams, type EconomicsCalendar, type EnterpriseValue, Exchange, type ExecutiveCompensation, FMP, FMPClient, type FMPConfig, type FailToDeliverParams, type FailToDeliverResponse, FinancialEndpoints, type FinancialGrowth, type FinancialRatios, type FinancialStatementBase, type FinancialStatementsParams, ForexEndpoints, type ForexHistoricalParams, type ForexList, type ForexQuote, type Form13FDatesParams, type Form13FParams, type Form13FResponse, type GrowthStatementBase, HTTP_STATUS, type HistoricalEmployeeCount, type HistoricalPriceData, type HistoricalPriceParams, type HistoricalPriceResponse, type HistoricalSharesFloat, type HouseTradingResponse, type IPOCalendar, type IncomeGrowth, type IncomeStatement, type IndividualIndustryClassificationParams, type IndustryClassification, type IndustryClassificationCode, type IndustryClassificationCodesParams, InsiderEndpoints, type InsiderTradeStatisticsParams, type InsiderTradeStatisticsResponse, type InsiderTradingRSSParams, type InsiderTradingRSSResponse, type InsiderTradingSearchParams, type InsiderTradingSearchResponse, type InsidersBySymbolParams, type InsidersBySymbolResponse, InstitutionalEndpoints, type InstitutionalHolderParams, type InstitutionalHolderResponse, type IntradayParams, type KeyMetrics, ListEndpoints, MAX_LIMIT, type MarketCap, MarketEndpoints, type MarketHoliday, type MarketHours, type MarketIndex, type MarketPerformance, type MarketSectorPerformance, MutualFundEndpoints, type MutualFundHolding, type MutualFundQuote, PERIODS, type PaginationParams, Period, type PeriodParams, type QueryParams, type Quote, QuoteEndpoints, type QuoteParams, type RSSFeed8KItem, type RSSFeed8KParams, type RSSFeedAllItem, type RSSFeedItem, type RSSFeedParams, type RSSFeedV3Item, type RSSFeedV3Params, SECEndpoints, type SECFiling, type SECFilingsParams, SECTORS, SenateHouseEndpoints, type SenateHouseTradingByNameParams, type SenateHouseTradingByNameResponse, type SenateHouseTradingParams, type SenateHouseTradingRSSFeedParams, type SenateTradingResponse, type SharesFloat, type SplitsCalendar, type StockDividend, type StockDividendResponse, StockEndpoints, type StockList, type StockListResponse, type StockQuote, type StockRealTimePrice, type StockRealTimePriceFull, type StockSplit, type StockSplitResponse, type SymbolParams, TransactionType, type TransactionTypesResponse, type TreasuryRate, formatCurrency, formatDate, formatLargeNumber, formatNumber, formatPercentage, formatReadableDate, formatTimestamp, formatVolume, validateApiKey, validateDate, validateLimit, validatePage, validatePeriod, validateSymbol };