fmp-node-api 0.0.7 → 0.0.8

package/dist/index.js

@@ -61,11 +61,13 @@ var FMPClient = class {
       return {
         success: true,
         data,
+        error: null,
         status: response.status
       };
     } catch (error) {
       return {
         success: false,
+        data: null,
         error: error.message || "Unknown error occurred",
         status: error.response?.status || 500
       };
@@ -84,11 +86,13 @@ var FMPClient = class {
       return {
         success: true,
         data,
+        error: null,
         status: response.status
       };
     } catch (error) {
       return {
         success: false,
+        data: null,
         error: error.message || "Unknown error occurred",
         status: error.response?.status || 500
       };
@@ -1123,6 +1127,289 @@ var SenateHouseEndpoints = class {
   }
 };
 
+// src/endpoints/institutional.ts
+var InstitutionalEndpoints = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * 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
+   */
+  async getForm13F(params) {
+    const { cik, date } = params;
+    const queryParams = {};
+    if (date) queryParams.date = date;
+    return this.client.get(`/form-thirteen/${cik}`, "v3", queryParams);
+  }
+  /**
+   * 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
+   */
+  async getForm13FDates(params) {
+    const { cik } = params;
+    return this.client.get(`/form-thirteen-date/${cik}`, "v3");
+  }
+  /**
+   * 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
+   */
+  async getInstitutionalHolders(params) {
+    const { symbol } = params;
+    return this.client.get(`/institutional-holder/${symbol}`, "v3");
+  }
+};
+
+// src/endpoints/insider.ts
+var InsiderEndpoints = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * 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
+   */
+  async getInsiderTradingRSS({
+    page
+  }) {
+    return this.client.get(`/insider-trading-rss-feed`, "v4", { page });
+  }
+  /**
+   * 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
+   */
+  async searchInsiderTrading({
+    symbol,
+    reportingCik,
+    companyCik,
+    transactionType,
+    page
+  }) {
+    const params = { page };
+    if (symbol) params.symbol = symbol;
+    if (reportingCik) params.reportingCik = reportingCik;
+    if (companyCik) params.companyCik = companyCik;
+    if (transactionType) params.transactionType = transactionType;
+    return this.client.get(`/insider-trading`, "v4", params);
+  }
+  /**
+   * Get transaction types
+   * https://site.financialmodelingprep.com/developer/docs#transaction-types-insider-trading
+   * @returns A list of all insider transaction types
+   */
+  async getTransactionTypes() {
+    return this.client.get(`/insider-trading-transaction-type`, "v4");
+  }
+  /**
+   * 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
+   */
+  async getInsidersBySymbol({
+    symbol
+  }) {
+    return this.client.get(`/insider-roaster`, "v4", { symbol });
+  }
+  /**
+   * 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
+   */
+  async getInsiderTradeStatistics({
+    symbol
+  }) {
+    return this.client.get(`/insider-roaster-statistic`, "v4", { symbol });
+  }
+  /**
+   * 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
+   */
+  async getCikMapper({ page }) {
+    return this.client.get(`/mapper-cik-name`, "v4", { page });
+  }
+  /**
+   * 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
+   */
+  async getCikMapperByName({
+    name,
+    page = 0
+  }) {
+    return this.client.get(`/mapper-cik-name`, "v4", { name, page });
+  }
+  /**
+   * 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
+   */
+  async getCikMapperBySymbol({
+    symbol
+  }) {
+    return this.client.getSingle(`/mapper-cik-company/${symbol}`, "v4");
+  }
+  /**
+   * 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
+   */
+  async getBeneficialOwnership({
+    symbol
+  }) {
+    return this.client.get(`/insider/ownership/acquisition_of_beneficial_ownership`, "v4", {
+      symbol
+    });
+  }
+  /**
+   * 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
+   */
+  async getFailToDeliver({
+    symbol,
+    page = 0
+  }) {
+    return this.client.get(`/fail_to_deliver`, "v4", { symbol, page });
+  }
+  /**
+   * 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
+   */
+  async getInsiderTradesBySymbol(symbol, page = 0) {
+    return this.searchInsiderTrading({ symbol, page });
+  }
+  /**
+   * 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
+   */
+  async getInsiderTradesByType(transactionType, page = 0) {
+    return this.searchInsiderTrading({ transactionType, page });
+  }
+  /**
+   * 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
+   */
+  async getInsiderTradesByReportingCik(reportingCik, page = 0) {
+    return this.searchInsiderTrading({ reportingCik, page });
+  }
+  /**
+   * 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
+   */
+  async getInsiderTradesByCompanyCik(companyCik, page = 0) {
+    return this.searchInsiderTrading({ companyCik, page });
+  }
+};
+
+// src/endpoints/sec.ts
+var SECEndpoints = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * 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.
+   */
+  async getRSSFeed(params) {
+    return this.client.get("/rss_feed", "v4", params);
+  }
+  /**
+   * 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.
+   */
+  async getRSSFeedAll(params) {
+    return this.client.get("/rss_feed_all", "v4", params);
+  }
+  /**
+   * 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)
+   */
+  async getRSSFeedV3(params) {
+    return this.client.get("/rss_feed", "v3", params);
+  }
+  /**
+   * 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
+   */
+  async getRSSFeed8K(params) {
+    return this.client.get("/rss_feed_8k", "v4", params);
+  }
+  /**
+   * 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
+   */
+  async getSECFilings({
+    symbol,
+    params
+  }) {
+    return this.client.get(`/sec_filings/${symbol}`, "v3", params);
+  }
+  /**
+   * 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
+   */
+  async getIndividualIndustryClassification(params) {
+    return this.client.getSingle("/standard_industrial_classification", "v4", params);
+  }
+  /**
+   * 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
+   */
+  async getAllIndustryClassifications() {
+    return this.client.get("/standard_industrial_classification/all", "v4");
+  }
+  /**
+   * 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
+   */
+  async getIndustryClassificationCodes(params) {
+    return this.client.get("/standard_industrial_classification_list", "v4", params);
+  }
+};
+
 // src/fmp.ts
 var FMP = class {
   constructor(config) {
@@ -1138,6 +1425,9 @@ var FMP = class {
     this.company = new CompanyEndpoints(client);
     this.quote = new QuoteEndpoints(client);
     this.senateHouse = new SenateHouseEndpoints(client);
+    this.institutional = new InstitutionalEndpoints(client);
+    this.insider = new InsiderEndpoints(client);
+    this.sec = new SECEndpoints(client);
     this.forex = new ForexEndpoints(client);
     this.economic = new EconomicEndpoints(client);
     this.mutualFund = new MutualFundEndpoints(client);
@@ -1168,6 +1458,29 @@ var Exchange = /* @__PURE__ */ ((Exchange2) => {
   return Exchange2;
 })(Exchange || {});
 
+// src/types/insider.ts
+var TransactionType = /* @__PURE__ */ ((TransactionType2) => {
+  TransactionType2["AWARD"] = "A-Award";
+  TransactionType2["CONVERSION"] = "C-Conversion";
+  TransactionType2["RETURN"] = "D-Return";
+  TransactionType2["EXPIRE_SHORT"] = "E-ExpireShort";
+  TransactionType2["IN_KIND"] = "F-InKind";
+  TransactionType2["GIFT"] = "G-Gift";
+  TransactionType2["EXPIRE_LONG"] = "H-ExpireLong";
+  TransactionType2["DISCRETIONARY"] = "I-Discretionary";
+  TransactionType2["OTHER"] = "J-Other";
+  TransactionType2["SMALL"] = "L-Small";
+  TransactionType2["EXEMPT"] = "M-Exempt";
+  TransactionType2["OUT_OF_THE_MONEY"] = "O-OutOfTheMoney";
+  TransactionType2["PURCHASE"] = "P-Purchase";
+  TransactionType2["SALE"] = "S-Sale";
+  TransactionType2["TENDER"] = "U-Tender";
+  TransactionType2["WILL"] = "W-Will";
+  TransactionType2["IN_THE_MONEY"] = "X-InTheMoney";
+  TransactionType2["TRUST"] = "Z-Trust";
+  return TransactionType2;
+})(TransactionType || {});
+
 // src/utils/formatting.ts
 function formatCurrency(value, currency = "USD") {
   return new Intl.NumberFormat("en-US", {
@@ -1303,6 +1616,8 @@ exports.FMPClient = FMPClient;
 exports.FinancialEndpoints = FinancialEndpoints;
 exports.ForexEndpoints = ForexEndpoints;
 exports.HTTP_STATUS = HTTP_STATUS;
+exports.InsiderEndpoints = InsiderEndpoints;
+exports.InstitutionalEndpoints = InstitutionalEndpoints;
 exports.ListEndpoints = ListEndpoints;
 exports.MAX_LIMIT = MAX_LIMIT;
 exports.MarketEndpoints = MarketEndpoints;
@@ -1310,9 +1625,11 @@ exports.MutualFundEndpoints = MutualFundEndpoints;
 exports.PERIODS = PERIODS;
 exports.Period = Period;
 exports.QuoteEndpoints = QuoteEndpoints;
+exports.SECEndpoints = SECEndpoints;
 exports.SECTORS = SECTORS;
 exports.SenateHouseEndpoints = SenateHouseEndpoints;
 exports.StockEndpoints = StockEndpoints;
+exports.TransactionType = TransactionType;
 exports.formatCurrency = formatCurrency;
 exports.formatDate = formatDate;
 exports.formatLargeNumber = formatLargeNumber;