fmp-node-api 0.0.2 → 0.0.4

package/dist/index.js

@@ -7,31 +7,39 @@ function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 var axios__default = /*#__PURE__*/_interopDefault(axios);
 
 // src/client.ts
+function unwrapSingleObject(data) {
+  if (Array.isArray(data) && data.length === 1) {
+    return data[0];
+  }
+  return data;
+}
 var FMPClient = class {
   constructor(config) {
     this.apiKey = config.apiKey;
-    this.baseURL = config.baseURL || "https://financialmodelingprep.com/api/v3";
-    this.client = axios__default.default.create({
-      baseURL: this.baseURL,
-      timeout: config.timeout || 1e4,
-      headers: {
-        "Content-Type": "application/json"
-      }
+    this.v3Client = this.createClient("https://financialmodelingprep.com/api/v3", config.timeout);
+    this.v4Client = this.createClient("https://financialmodelingprep.com/api/v4", config.timeout);
+    this.stableClient = this.createClient(
+      "https://financialmodelingprep.com/api/stable",
+      config.timeout
+    );
+  }
+  createClient(baseURL, timeout) {
+    const client = axios__default.default.create({
+      baseURL,
+      timeout: timeout || 1e4,
+      headers: { "Content-Type": "application/json" }
     });
-    this.client.interceptors.request.use((config2) => {
-      config2.params = {
-        ...config2.params,
-        apikey: this.apiKey
-      };
-      return config2;
+    client.interceptors.request.use((config) => {
+      config.params = { ...config.params, apikey: this.apiKey };
+      return config;
     });
+    return client;
   }
-  /**
-   * Make a GET request to the API
-   */
-  async get(endpoint, params) {
+  // Standard get method - returns raw API response
+  async get(endpoint, version = "v3", params) {
+    const client = this.getClientForVersion(version);
     try {
-      const response = await this.client.get(endpoint, { params });
+      const response = await client.get(endpoint, { params });
       return {
         success: true,
         data: response.data,
@@ -45,15 +53,14 @@ var FMPClient = class {
       };
     }
   }
-  /**
-   * Make a POST request to the API
-   */
-  async post(endpoint, data, config) {
+  // Get method for single-object endpoints - unwraps single-item arrays
+  async getSingle(endpoint, version = "v3", params) {
+    const client = this.getClientForVersion(version);
     try {
-      const response = await this.client.post(endpoint, data, config);
+      const response = await client.get(endpoint, { params });
       return {
         success: true,
-        data: response.data,
+        data: unwrapSingleObject(response.data),
         status: response.status
       };
     } catch (error) {
@@ -64,11 +71,17 @@ var FMPClient = class {
       };
     }
   }
-  /**
-   * Get the underlying axios instance for advanced usage
-   */
-  getAxiosInstance() {
-    return this.client;
+  getClientForVersion(version) {
+    switch (version) {
+      case "v3":
+        return this.v3Client;
+      case "v4":
+        return this.v4Client;
+      case "stable":
+        return this.stableClient;
+      default:
+        return this.v3Client;
+    }
   }
 };
 
@@ -81,36 +94,22 @@ var FMPError = class extends Error {
     this.name = "FMPError";
   }
 };
+
+// src/utils/validation.ts
 function validateApiKey(apiKey) {
-  if (!apiKey || typeof apiKey !== "string") {
-    throw new FMPError("API key is required and must be a string");
+  if (!apiKey || typeof apiKey !== "string" || apiKey.trim().length === 0) {
+    throw new FMPError("API key is required and must be a non-empty string");
   }
 }
 function validateSymbol(symbol) {
-  if (!symbol || typeof symbol !== "string") {
-    throw new FMPError("Symbol is required and must be a string");
+  if (!symbol || typeof symbol !== "string" || symbol.trim().length === 0) {
+    throw new FMPError("Symbol is required and must be a non-empty string");
   }
-}
-var FMP_BASE_URL = "https://financialmodelingprep.com/api/v3";
-var FMP_BASE_URL_V4 = "https://financialmodelingprep.com/api/v4";
-var Period = /* @__PURE__ */ ((Period2) => {
-  Period2["ANNUAL"] = "annual";
-  Period2["QUARTER"] = "quarter";
-  return Period2;
-})(Period || {});
-var Exchange = /* @__PURE__ */ ((Exchange2) => {
-  Exchange2["NYSE"] = "NYSE";
-  Exchange2["NASDAQ"] = "NASDAQ";
-  Exchange2["AMEX"] = "AMEX";
-  Exchange2["TSX"] = "TSX";
-  Exchange2["LSE"] = "LSE";
-  return Exchange2;
-})(Exchange || {});
-
-// src/utils/validation.ts
-function validateApiKey2(apiKey) {
-  if (!apiKey || typeof apiKey !== "string" || apiKey.trim().length === 0) {
-    throw new FMPError("API key is required and must be a non-empty string");
+  const symbolRegex = /^[A-Z0-9.-]+$/;
+  if (!symbolRegex.test(symbol.toUpperCase())) {
+    throw new FMPError(
+      "Invalid symbol format. Symbols should contain only letters, numbers, dots, and hyphens"
+    );
   }
 }
 function validateDate(date) {
@@ -149,68 +148,59 @@ var StockEndpoints = class {
   }
   /**
    * Get real-time stock quote
+   * https://site.financialmodelingprep.com/developer/docs#full-quote-quote
+   * @param symbol - The stock symbol to get the quote for
+   * @returns This endpoint gives you the latest bid and ask prices for a stock, as well as the volume and last trade price in real time.
    */
   async getQuote({ symbol }) {
-    return this.client.get(`/quote/${symbol}`);
-  }
-  /**
-   * Get company profile
-   */
-  async getCompanyProfile({ symbol }) {
-    return this.client.get(`/profile/${symbol}`);
+    return this.client.getSingle(`/quote/${symbol}`, "v3");
   }
   /**
    * Get historical stock prices
+   * https://site.financialmodelingprep.com/developer/docs#daily-chart-charts
+   * @param symbol - The stock symbol to get the historical prices for
+   * @param from - The start date to get the historical prices for
+   * @param to - The end date to get the historical prices for
+   * @returns The FMP Daily Chart endpoint provides daily stock data for a specified company, including opening, high, low, and closing prices, with a default limit of 5 years of historical data. To access data beyond this limit, use the from and to parameters for custom date ranges, each with a 5-year limit
    */
   async getHistoricalPrice({
     symbol,
     from,
     to
   }) {
-    const params = new URLSearchParams();
-    if (from) params.append("from", from);
-    if (to) params.append("to", to);
-    const queryString = params.toString();
-    return this.client.get(
-      `/historical-price-full/${symbol}${queryString ? `?${queryString}` : ""}`
-    );
-  }
-  /**
-   * Get list of all stocks
-   */
-  async getStockList() {
-    return this.client.get("/stock/list");
+    const params = {};
+    if (from) params.from = from;
+    if (to) params.to = to;
+    return this.client.getSingle(`/historical-price-full/${symbol}`, "v3", params);
   }
   /**
-   * Get market capitalization
+   * Get market cap
+   * https://site.financialmodelingprep.com/developer/docs#market-cap-company-information
+   * @param symbol - The stock symbol to get the market cap for
+   * @returns The FMP Market Cap endpoint provides the current market capitalization of a company. Market cap is a measure of the size and relative importance of a company in the stock market. It is calculated by multiplying the current share price by the number of outstanding shares.
    */
   async getMarketCap({ symbol }) {
-    return this.client.get(`/market-capitalization/${symbol}`);
-  }
-  /**
-   * Get earnings calendar
-   */
-  async getEarningsCalendar(params) {
-    const queryParams = {};
-    if (params.from) queryParams.from = params.from;
-    if (params.to) queryParams.to = params.to;
-    return this.client.get("/earning_calendar", queryParams);
+    return this.client.getSingle(`/market-capitalization/${symbol}`, "v3");
   }
   /**
    * Get stock splits
+   * https://site.financialmodelingprep.com/developer/docs#splits-historical-splits
+   * @param symbol - The stock symbol to get the splits for
+   * @returns A list of historical stock splits for publicly traded companies, including the date of the stock split, the split ratio, and the type of stock split.
    */
   async getStockSplits({ symbol }) {
-    return this.client.get(`/stock_split_calendar/${symbol}`);
+    return this.client.get(`/historical-price-full/stock_split/${symbol}`, "v3");
   }
   /**
    * Get dividend history
+   * https://site.financialmodelingprep.com/developer/docs#dividends-historical-dividends
+   * @param symbol - The stock symbol to get the dividend history for
+   * @returns A list of historical dividend payments for publicly traded companies, including the date of the dividend payment, the ex-dividend date, and the dividend per share.
    */
-  async getDividendHistory({ symbol }) {
-    const response = await this.client.get(`/historical-price-full/stock_dividend/${symbol}`);
-    return {
-      ...response,
-      data: response.success && response.data && Array.isArray(response.data.historical) ? response.data.historical : []
-    };
+  async getDividendHistory({
+    symbol
+  }) {
+    return this.client.getSingle(`/historical-price-full/stock_dividend/${symbol}`, "v3");
   }
 };
 
@@ -221,63 +211,190 @@ var FinancialEndpoints = class {
   }
   /**
    * Get income statement
+   * https://site.financialmodelingprep.com/developer/docs#income-statements-financial-statements
+   * @param symbol - The stock symbol to get the income statement for
+   * @param period - The period to get the income statement for (annual or quarter)
+   * @param limit - The number of periods to get
+   * @returns FMP's Income Statement API provides access to real-time income statement data for a wide range of companies, including public companies, private companies, and ETFs. This data can be used to track a company's profitability over time, to compare a company to its competitors, and to identify trends in a company's business.
    */
   async getIncomeStatement({
     symbol,
     period = "annual",
     limit = 5
   }) {
-    return this.client.get(`/income-statement/${symbol}?period=${period}&limit=${limit}`);
+    return this.client.get(`/income-statement/${symbol}?period=${period}&limit=${limit}`, "v3");
   }
   /**
    * Get balance sheet
+   * https://site.financialmodelingprep.com/developer/docs#balance-sheet-statements-financial-statements
+   * @param symbol - The stock symbol to get the balance sheet for
+   * @param period - The period to get the balance sheet for (annual or quarter)
+   * @param limit - The number of periods to get
+   * @returns The balance sheet is a financial statement that displays a company's total assets, liabilities, and shareholder equity over a specific timeframe (quarterly or yearly). Investors can use this statement to determine if the company can fund its operations, meet its debt obligations, and pay a dividend.
    */
   async getBalanceSheet({
     symbol,
     period = "annual",
     limit = 5
   }) {
-    return this.client.get(`/balance-sheet-statement/${symbol}?period=${period}&limit=${limit}`);
+    return this.client.get(
+      `/balance-sheet-statement/${symbol}?period=${period}&limit=${limit}`,
+      "v3"
+    );
   }
   /**
    * Get cash flow statement
+   * https://site.financialmodelingprep.com/developer/docs#cashflow-statements-financial-statements
+   * @param symbol - The stock symbol to get the cash flow statement for
+   * @param period - The period to get the cash flow statement for (annual or quarter)
+   * @param limit - The number of periods to get
+   * @returns The cash flow statement is a financial statement that highlights how cash moves through the company, including both cash inflows and outflows. This statement shows the cash flows in 3 main categories "Operating Cash Flows", "Investing Cash Flows", and "Financing Cash Flows", which help investors to understand if the company is making money or losing money by conducting business.
    */
   async getCashFlowStatement({
     symbol,
     period = "annual",
     limit = 5
   }) {
-    return this.client.get(`/cash-flow-statement/${symbol}?period=${period}&limit=${limit}`);
+    return this.client.get(`/cash-flow-statement/${symbol}?period=${period}&limit=${limit}`, "v3");
   }
   /**
    * Get key metrics
+   * https://site.financialmodelingprep.com/developer/docs#key-metrics-statement-analysis
+   * @param symbol - The stock symbol to get the key metrics for
+   * @param period - The period to get the key metrics for (annual or quarter)
+   * @param limit - The number of periods to get
+   * @returns Get key financial metrics for a company, including revenue, net income, and price-to-earnings ratio (P/E ratio). Assess a company's financial performance and compare it to its competitors.
    */
   async getKeyMetrics({
     symbol,
     period = "annual",
     limit = 5
   }) {
-    return this.client.get(`/key-metrics/${symbol}?period=${period}&limit=${limit}`);
+    return this.client.get(`/key-metrics/${symbol}?period=${period}&limit=${limit}`, "v3");
   }
   /**
    * Get financial ratios
+   * https://site.financialmodelingprep.com/developer/docs#ratios-statement-analysis
+   * @param symbol - The stock symbol to get the financial ratios for
+   * @param period - The period to get the financial ratios for (annual or quarter)
+   * @param limit - The number of periods to get
+   * @returns Get financial ratios for a company, such as the P/B ratio and the ROE. Assess a company's financial health and compare it to its competitors.
    */
   async getFinancialRatios({
     symbol,
     period = "annual",
     limit = 5
   }) {
-    return this.client.get(`/ratios/${symbol}?period=${period}&limit=${limit}`);
+    return this.client.get(`/ratios/${symbol}?period=${period}&limit=${limit}`, "v3");
   }
   /**
    * Get enterprise value
+   * https://site.financialmodelingprep.com/developer/docs#enterprise-values-statement-analysis
+   * @param symbol - The stock symbol to get the enterprise value for
+   * @param period - The period to get the enterprise value for (annual or quarter)
+   * @param limit - The number of periods to get
+   * @returns Get the enterprise value of a company, which is the total value of a company, including its equity and debt. Assess a company's overall value and compare it to its peers.
    */
   async getEnterpriseValue({
     symbol,
     period = "annual",
     limit = 5
   }) {
-    return this.client.get(`/enterprise-value/${symbol}?period=${period}&limit=${limit}`);
+    return this.client.get(`/enterprise-value/${symbol}?period=${period}&limit=${limit}`, "v3");
+  }
+  /**
+   * Get cashflow growth
+   * https://site.financialmodelingprep.com/developer/docs#cashflow-growth-statement-analysis
+   * @param symbol - The stock symbol to get the cashflow growth for
+   * @param period - The period to get the cashflow growth for (annual or quarter)
+   * @param limit - The number of periods to get
+   * @returns Get the cash flow growth rate for a company. Measure how quickly a company's cash flow is growing.
+   */
+  async getCashflowGrowth({
+    symbol,
+    period = "annual",
+    limit = 5
+  }) {
+    return this.client.get(
+      `/cash-flow-statement-growth/${symbol}?period=${period}&limit=${limit}`,
+      "v3"
+    );
+  }
+  /**
+   *  Get income growth
+   * https://site.financialmodelingprep.com/developer/docs#income-growth-statement-analysis
+   * @param symbol - The stock symbol to get the income growth for
+   * @param period - The period to get the income growth for (annual or quarter)
+   * @param limit - The number of periods to get
+   * @returns Get the income growth rate for a company. Measure how quickly a company's income is growing.
+   */
+  async getIncomeGrowth({
+    symbol,
+    period = "annual",
+    limit = 5
+  }) {
+    return this.client.get(
+      `/income-statement-growth/${symbol}?period=${period}&limit=${limit}`,
+      "v3"
+    );
+  }
+  /**
+   * Get balance sheet growth
+   * https://site.financialmodelingprep.com/developer/docs#balance-sheet-growth-statement-analysis
+   * @param symbol - The stock symbol to get the balance sheet growth for
+   * @param period - The period to get the balance sheet growth for (annual or quarter)
+   * @param limit - The number of periods to get
+   * @returns Get the balance sheet growth rate for a company. Measure how quickly a company's assets and liabilities are growing.
+   */
+  async getBalanceSheetGrowth({
+    symbol,
+    period = "annual",
+    limit = 5
+  }) {
+    return this.client.get(
+      `/balance-sheet-statement-growth/${symbol}?period=${period}&limit=${limit}`,
+      "v3"
+    );
+  }
+  /**
+   * Get financial growth
+   * https://site.financialmodelingprep.com/developer/docs#financial-growth-statement-analysis
+   * @param symbol - The stock symbol to get the financial growth for
+   * @param period - The period to get the financial growth for (annual or quarter)
+   * @param limit - The number of periods to get
+   * @returns Financial Growth Get the financial growth rate for a company. Measure how quickly a company's overall financial performance is improving.
+   */
+  async getFinancialGrowth({
+    symbol,
+    period = "annual",
+    limit = 5
+  }) {
+    return this.client.get(`/financial-growth/${symbol}?period=${period}&limit=${limit}`, "v3");
+  }
+  /**
+   * Get earnings historical
+   * https://site.financialmodelingprep.com/developer/docs#earnings-historical-earnings
+   * @param symbol - The stock symbol to get the earnings historical for
+   * @param limit - The number of periods to get
+   * @returns A list of historical & upcoming earnings announcements for a specific company, including the date, estimated EPS, and actual EPS.
+   */
+  async getEarningsHistorical({
+    symbol,
+    limit = 5
+  }) {
+    return this.client.get(`/historical/earning_calendar/${symbol}?limit=${limit}`, "v3");
+  }
+  /**
+   * Get earnings surprises
+   * https://site.financialmodelingprep.com/developer/docs#earnings-surprises-earnings
+   * @param symbol - The stock symbol to get the earnings surprises for
+   * @param limit - The number of periods to get
+   * @returns A list of earnings announcements for publicly traded companies that were either positive or negative surprises. This endpoint includes the date of the earnings announcement, the estimated EPS, the actual EPS, and the earnings surprise.
+   */
+  async getEarningsSurprises({
+    symbol
+  }) {
+    return this.client.get(`/earnings-surprises/${symbol}`, "v3");
   }
 };
 
@@ -287,59 +404,44 @@ var ForexEndpoints = class {
     this.client = client;
   }
   /**
-   * Get real-time forex quote
+   * Get forex quote
+   * @param params - Parameters for the forex quote request
+   * @returns Forex quote data
    */
   async getQuote(params) {
-    return this.client.get(`/quote/${params.symbol}`);
-  }
-  /**
-   * Get historical forex data
-   */
-  async getHistoricalPrice(params) {
-    const queryParams = {};
-    if (params.from) queryParams.from = params.from;
-    if (params.to) queryParams.to = params.to;
-    if (params.timeseries) queryParams.timeseries = params.timeseries;
-    return this.client.get(`/historical-price-full/${params.symbol}`, queryParams);
+    return this.client.get("/quote", "v3", params);
   }
   /**
-   * Get list of all forex pairs
-   * Using the forex-specific endpoint
+   * Get historical forex prices
+   * @param symbol - The forex symbol to get the historical prices for
+   * @param from - The start date to get the historical prices for
+   * @param to - The end date to get the historical prices for
+   * @returns Historical forex price data
    */
-  async getForexList() {
-    try {
-      const response = await this.client.get("/forex-list");
-      if (!response.success || !response.data) {
-        const fallbackResponse = await this.client.get("/forex");
-        return {
-          ...fallbackResponse,
-          data: Array.isArray(fallbackResponse.data) ? fallbackResponse.data : Array.isArray(fallbackResponse.data?.forexList) ? fallbackResponse.data.forexList : []
-        };
-      }
-      return {
-        ...response,
-        data: Array.isArray(response.data) ? response.data : Array.isArray(response.data?.forexList) ? response.data.forexList : []
-      };
-    } catch (error) {
-      return {
-        success: false,
-        error: "Failed to fetch forex pairs",
-        status: 500,
-        data: []
-      };
-    }
+  async getHistoricalPrice({
+    symbol,
+    from,
+    to
+  }) {
+    const params = {};
+    if (from) params.from = from;
+    if (to) params.to = to;
+    return this.client.get(`/historical-price-full/${symbol}`, "v3", params);
   }
   /**
-   * Get forex rates for a specific currency
+   * Get forex rates for a specific base currency
+   * @param baseCurrency - The base currency to get forex rates for
+   * @returns Forex rates data
    */
   async getForexRates(baseCurrency = "USD") {
-    return this.client.get(`/forex/${baseCurrency}`);
+    return this.client.get(`/forex/${baseCurrency}`, "v3");
   }
   /**
-   * Get forex rates for all currencies
+   * Get all forex rates
+   * @returns All forex rates data
    */
   async getAllForexRates() {
-    return this.client.get("/forex");
+    return this.client.get("/forex", "v3");
   }
 };
 
@@ -349,26 +451,31 @@ var CryptoEndpoints = class {
     this.client = client;
   }
   /**
-   * Get real-time crypto quote
-   */
-  async getQuote(params) {
-    return this.client.get(`/quote/${params.symbol}`);
-  }
-  /**
-   * Get historical crypto data
+   * Get crypto quote
+   * https://site.financialmodelingprep.com/developer/docs#full-quote-crypto
+   * @param symbol - The crypto symbol to get the quote for
+   * @returns Crypto quote data
    */
-  async getHistoricalPrice(params) {
-    const queryParams = {};
-    if (params.from) queryParams.from = params.from;
-    if (params.to) queryParams.to = params.to;
-    if (params.timeseries) queryParams.timeseries = params.timeseries;
-    return this.client.get(`/historical-price-full/${params.symbol}`, queryParams);
+  async getQuote({ symbol }) {
+    return this.client.getSingle(`/quote/${symbol}`, "v3");
   }
   /**
-   * Get list of all cryptocurrencies
+   * Get historical crypto prices
+   * https://site.financialmodelingprep.com/developer/docs#cryptocurrency-daily-crypto
+   * @param symbol - The crypto symbol to get the historical prices for
+   * @param from - The start date to get the historical prices for
+   * @param to - The end date to get the historical prices for
+   * @returns Provides daily price data for all cryptocurrencies that are traded on exchanges around the world.
    */
-  async getCryptoList() {
-    return this.client.get("/cryptocurrency");
+  async getHistoricalPrice({
+    symbol,
+    from,
+    to
+  }) {
+    const params = {};
+    if (from) params.from = from;
+    if (to) params.to = to;
+    return this.client.getSingle(`/historical-price-full/${symbol}`, "v3", params);
   }
 };
 
@@ -378,31 +485,78 @@ var ETFEndpoints = class {
     this.client = client;
   }
   /**
-   * Get real-time ETF quote
+   * Get ETF holding dates
+   * https://site.financialmodelingprep.com/developer/docs#etf-holding-dates-etf-holdings
+   * @param symbol - The symbol of the ETF to get the holding dates for
+   * @returns The FMP ETF Holding Dates endpoint provides a list of the dates on which ETF holdings are updated. For example, an investor may want to know when an ETF's holdings are updated in order to make sure that they are still aligned with their investment goals.
    */
-  async getQuote(params) {
-    return this.client.get(`/quote/${params.symbol}`);
+  async getHoldingDates({ symbol }) {
+    const params = {};
+    if (symbol) params.symbol = symbol;
+    return this.client.get("/etf-holdings/portfolio-date", "v4", params);
+  }
+  /**
+   * Get ETF holdings
+   * https://site.financialmodelingprep.com/developer/docs#etf-holdings-etf-holdings
+   * @param symbol - The symbol of the ETF to get the holdings for
+   * @param date - The date to get the holdings for
+   * @returns The FMP ETF Holdings endpoint provides a list of all the institutional investors that own shares of an ETF. For example, an investor may want to know which ETF has the highest exposure to a particular industry or sector.
+   */
+  async getHoldings({
+    symbol,
+    date
+  }) {
+    const params = {};
+    if (symbol) params.symbol = symbol;
+    if (date) params.date = date;
+    return this.client.get("/etf-holdings", "v4", params);
+  }
+  /**
+   * Get ETF holder
+   * https://site.financialmodelingprep.com/developer/docs#etf-holder-etf-holdings
+   * @param symbol - The symbol of the ETF to get the holder for
+   * @returns This endpoint returns all stocks held by a specific ETF. Assets, share number, and weight are among the fields returned. For example you can get components of SPY, VOO and more.
+   */
+  async getHolder({ symbol }) {
+    return this.client.get(`/etf-holder/${symbol}`, "v3");
   }
   /**
    * Get ETF profile
+   * https://site.financialmodelingprep.com/developer/docs#etf-information-etf-holdings
+   * @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.
    */
-  async getProfile(params) {
-    return this.client.get(`/profile/${params.symbol}`);
+  async getProfile({ symbol }) {
+    const params = {};
+    if (symbol) params.symbol = symbol;
+    return this.client.getSingle("/etf-info", "v4", params);
   }
   /**
-   * Get ETF holdings
+   * Get ETF sector weighting
+   * https://site.financialmodelingprep.com/developer/docs#etf-sector-weighting-etf-holdings
+   * @param symbol - The symbol of the ETF to get the sector exposure for
+   * @returns The FMP ETF Sector Weighting endpoint provides a breakdown of the percentage of an ETF's assets that are invested in each sector. For example, an investor may want to invest in an ETF that has a high exposure to the technology sector if they believe that the technology sector is poised for growth.
    */
-  async getHoldings(params) {
-    const queryParams = {};
-    if (params.limit) queryParams.limit = params.limit;
-    if (params.page) queryParams.page = params.page;
-    return this.client.get(`/etf-holder/${params.symbol}`, queryParams);
+  async getSectorWeighting({ symbol }) {
+    return this.client.get(`/etf-sector-weightings/${symbol}`, "v3");
   }
   /**
-   * Get list of all ETFs
+   * Get ETF country weighting
+   * https://site.financialmodelingprep.com/developer/docs#etf-country-weighting-etf-holdings
+   * @param symbol - The symbol of the ETF to get the country weighting for
+   * @returns The FMP ETF Country Weighting endpoint provides a breakdown of the percentage of an ETF's assets that are invested in each country. For example, an investor may want to invest in an ETF that has a high exposure to China if they believe that the Chinese economy is poised for growth.
    */
-  async getETFList() {
-    return this.client.get("/etf/list");
+  async getCountryWeighting({ symbol }) {
+    return this.client.get(`/etf-country-weightings/${symbol}`, "v3");
+  }
+  /**
+   * Get ETF Stock exposure
+   * https://site.financialmodelingprep.com/developer/docs#etf-sector-exposure-etf-holdings
+   * @param symbol - The symbol of the ETF to get the stock exposure for
+   * @returns This endpoint returns asset exposure from all ETFs that have it in their holdings. It has properties like market value, share number or weight percentage. It can be useful for looking up stock you like to check what ETF has it on their portfolio.
+   */
+  async getStockExposure({ symbol }) {
+    return this.client.get(`/etf-stock-exposure/${symbol}`, "v3");
   }
 };
 
@@ -412,31 +566,24 @@ var MutualFundEndpoints = class {
     this.client = client;
   }
   /**
-   * Get real-time mutual fund quote
+   * Get mutual fund quote
+   * @param params - Parameters for the mutual fund quote request
+   * @returns Mutual fund quote data
    */
   async getQuote(params) {
-    return this.client.get(`/quote/${params.symbol}`);
+    return this.client.get("/quote", "v3", params);
   }
   /**
    * Get mutual fund profile
    */
   async getProfile(params) {
-    return this.client.get(`/profile/${params.symbol}`);
+    return this.client.get("/profile", "v3", params);
   }
   /**
    * Get mutual fund holdings
    */
   async getHoldings(params) {
-    const queryParams = {};
-    if (params.limit) queryParams.limit = params.limit;
-    if (params.page) queryParams.page = params.page;
-    return this.client.get(`/mutual-fund-holder/${params.symbol}`, queryParams);
-  }
-  /**
-   * Get list of all mutual funds
-   */
-  async getMutualFundList() {
-    return this.client.get("/mutual-fund/list");
+    return this.client.get("/holdings", "v3", params);
   }
 };
 
@@ -446,26 +593,29 @@ var BondEndpoints = class {
     this.client = client;
   }
   /**
-   * Get real-time bond quote
+   * Get bond quote
+   * @param params - Parameters for the bond quote request
+   * @returns Bond quote data
    */
   async getQuote(params) {
-    return this.client.get(`/quote/${params.symbol}`);
-  }
-  /**
-   * Get historical bond data
-   */
-  async getHistoricalPrice(params) {
-    const queryParams = {};
-    if (params.from) queryParams.from = params.from;
-    if (params.to) queryParams.to = params.to;
-    if (params.timeseries) queryParams.timeseries = params.timeseries;
-    return this.client.get(`/historical-price-full/${params.symbol}`, queryParams);
+    return this.client.get("/quote", "v3", params);
   }
   /**
-   * Get list of all bonds
+   * Get historical bond prices
+   * @param symbol - The bond symbol to get the historical prices for
+   * @param from - The start date to get the historical prices for
+   * @param to - The end date to get the historical prices for
+   * @returns Historical bond price data
    */
-  async getBondList() {
-    return this.client.get("/bond/list");
+  async getHistoricalPrice({
+    symbol,
+    from,
+    to
+  }) {
+    const params = {};
+    if (from) params.from = from;
+    if (to) params.to = to;
+    return this.client.get(`/historical-price-full/${symbol}`, "v3", params);
   }
 };
 
@@ -478,46 +628,31 @@ var EconomicEndpoints = class {
    * Get treasury rates
    */
   async getTreasuryRates(params = {}) {
-    const queryParams = {};
-    if (params.from) queryParams.from = params.from;
-    if (params.to) queryParams.to = params.to;
-    return this.client.get("/treasury-rates", queryParams);
+    return this.client.get("/treasury-rates", "v3", params);
   }
   /**
    * Get federal funds rate
    */
   async getFederalFundsRate(params = {}) {
-    const queryParams = {};
-    if (params.from) queryParams.from = params.from;
-    if (params.to) queryParams.to = params.to;
-    return this.client.get("/federal-funds-rate", queryParams);
+    return this.client.get("/federal-funds-rate", "v3", params);
   }
   /**
    * Get CPI data
    */
   async getCPI(params = {}) {
-    const queryParams = {};
-    if (params.from) queryParams.from = params.from;
-    if (params.to) queryParams.to = params.to;
-    return this.client.get("/economic-indicator/cpi", queryParams);
+    return this.client.get("/economic/cpi", "v3", params);
   }
   /**
    * Get GDP data
    */
   async getGDP(params = {}) {
-    const queryParams = {};
-    if (params.from) queryParams.from = params.from;
-    if (params.to) queryParams.to = params.to;
-    return this.client.get("/economic-indicator/gdp", queryParams);
+    return this.client.get("/economic/gdp", "v3", params);
   }
   /**
    * Get unemployment data
    */
   async getUnemployment(params = {}) {
-    const queryParams = {};
-    if (params.from) queryParams.from = params.from;
-    if (params.to) queryParams.to = params.to;
-    return this.client.get("/economic-indicator/unemployment", queryParams);
+    return this.client.get("/economic/unemployment", "v3", params);
   }
 };
 
@@ -530,63 +665,282 @@ var MarketEndpoints = class {
    * Get market hours
    */
   async getMarketHours() {
-    return this.client.get("/market-hours");
+    return this.client.get("/market-hours", "v3");
   }
   /**
    * Get market performance
    */
   async getMarketPerformance() {
-    return this.client.get("/market-performance");
+    return this.client.get("/market-performance", "v3");
   }
   /**
-   * Get market gainers
+   * Get top gainers
+   * https://site.financialmodelingprep.com/developer/docs#market-biggest-gainers-market-overview
+   * @returns The FMP Market Biggest Gainers endpoint provides a list of the stocks that have gained the most value on a given day. This information can be used by investors to identify stocks that are momentum and to potential investment opportunities.
    */
   async getGainers() {
-    return this.client.get("/gainers");
+    return this.client.get("/stock_market/gainers", "v3");
   }
   /**
-   * Get market losers
+   * Get top losers
+   * https://site.financialmodelingprep.com/developer/docs#market-biggest-losers-market-overview
+   * @returns The FMP Market Biggest Losers endpoint provides a list of the stocks that have lost the most value on a given day. This information can be used by investors to identify stocks that are underperforming and to potential trading opportunities.
    */
   async getLosers() {
-    return this.client.get("/losers");
+    return this.client.get("/stock_market/losers", "v3");
   }
   /**
    * Get most active stocks
    */
   async getMostActive() {
-    return this.client.get("/most-active");
+    return this.client.get("/stock_market/actives", "v3");
   }
   /**
    * Get sector performance
+   * https://site.financialmodelingprep.com/developer/docs#sector-performance-market-overview
+   * @returns The FMP Sector Performance endpoint provides the performance of each sector of the stock market over a specified period of time. This information can be used by investors to identify sectors that are outperforming or underperforming the market.
    */
   async getSectorPerformance() {
-    return this.client.get("/sector-performance");
+    return this.client.get("/sector-performance", "v3");
+  }
+  /**
+   * Get market indices
+   * https://site.financialmodelingprep.com/developer/docs#market-index-market-overview
+   * @returns The FMP Market Index endpoint provides a list of all the major stock market indices, such as the S&P 500, the Dow Jones Industrial Average, and the Nasdaq Composite Index. This information can be used by investors to track the performance of the overall stock market and to identify sectors and industries that are outperforming or underperforming the market.
+   */
+  async getMarketIndex() {
+    return this.client.get("/quotes/index", "v3");
+  }
+};
+
+// src/endpoints/list.ts
+var ListEndpoints = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Get stock list
+   * https://site.financialmodelingprep.com/developer/docs#symbol-list-stock-list
+   * @returns The stock list
+   */
+  async getStockList() {
+    return this.client.get("/stock/list");
+  }
+  /**
+   * Get ETF list
+   * https://site.financialmodelingprep.com/developer/docs#exchange-traded-fund-search-stock-list
+   * @returns The ETF list
+   */
+  async getETFList() {
+    return this.client.get("/etf/list");
+  }
+  /**
+   * Get crypto list
+   * https://site.financialmodelingprep.com/developer/docs#cryptocurrencies-list-crypto
+   * @returns The crypto list
+   */
+  async getCryptoList() {
+    return this.client.get("/symbol/available-cryptocurrencies");
+  }
+  /**
+   * Get forex list
+   * https://site.financialmodelingprep.com/developer/docs#forex-list-forex
+   * @returns The forex list
+   */
+  async getForexList() {
+    return this.client.get("/symbol/available-forex-currency-pairs");
+  }
+  /**
+   * Get available indexes list
+   * https://site.financialmodelingprep.com/developer/docs#available-indexes
+   * @returns The available indexes list
+   */
+  async getAvailableIndexes() {
+    return this.client.get("/symbol/available-indexes");
+  }
+};
+
+// src/endpoints/calendar.ts
+var CalendarEndpoints = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Get earnings calendar
+   * https://site.financialmodelingprep.com/developer/docs#earnings-calendar-earnings
+   * @param from - The start date to get the earnings calendar for
+   * @param to - The end date to get the earnings calendar for
+   * @returns The earnings calendar
+   */
+  async getEarningsCalendar({ from, to } = {}) {
+    const params = {};
+    if (from) params.from = from;
+    if (to) params.to = to;
+    return this.client.get("/earning_calendar", "v3", params);
   }
   /**
-   * Get market index data
+   * Get dividends calendar
+   * https://site.financialmodelingprep.com/developer/docs#dividends-calendar-dividends
+   * @param from - The start date to get the dividends calendar for
+   * @param to - The end date to get the dividends calendar for
+   * @returns The dividends calendar
    */
-  async getMarketIndex(params = {}) {
-    const queryParams = {};
-    if (params.from) queryParams.from = params.from;
-    if (params.to) queryParams.to = params.to;
-    return this.client.get("/market-index", queryParams);
+  async getDividendsCalendar({ from, to } = {}) {
+    const params = {};
+    if (from) params.from = from;
+    if (to) params.to = to;
+    return this.client.get("/stock_dividend_calendar", "v3", params);
+  }
+  /**
+   * Get economics calendar
+   * https://site.financialmodelingprep.com/developer/docs#economics-calendar-economics-data
+   * @param from - The start date to get the economics calendar for
+   * @param to - The end date to get the economics calendar for
+   * @returns The economics calendar
+   */
+  async getEconomicsCalendar({ from, to } = {}) {
+    const params = {};
+    if (from) params.from = from;
+    if (to) params.to = to;
+    return this.client.get("/economic_calendar", "v3", params);
+  }
+  /**
+   * Get IPO calendar
+   * https://site.financialmodelingprep.com/developer/docs#ipo-calender-by-ipo-calendar
+   * @param from - The start date to get the IPO calendar for
+   * @param to - The end date to get the IPO calendar for
+   * @returns The IPO calendar
+   */
+  async getIPOCalendar({ from, to } = {}) {
+    const params = {};
+    if (from) params.from = from;
+    if (to) params.to = to;
+    return this.client.get("/ipo_calendar", "v3", params);
+  }
+  /**
+   * Get stock splits calendar
+   * https://site.financialmodelingprep.com/developer/docs#splits-calendar-splits
+   * @param from - The start date to get the stock splits calendar for
+   * @param to - The end date to get the stock splits calendar for
+   * @returns The stock splits calendar
+   */
+  async getSplitsCalendar({ from, to } = {}) {
+    const params = {};
+    if (from) params.from = from;
+    if (to) params.to = to;
+    return this.client.get("/stock_split_calendar", "v3", params);
+  }
+};
+
+// src/endpoints/company.ts
+var CompanyEndpoints = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Get company profile
+   * https://site.financialmodelingprep.com/developer/docs#company-profile-company-information
+   * @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.
+   */
+  async getCompanyProfile({
+    symbol
+  }) {
+    return this.client.getSingle(`/profile/${symbol}`, "v3");
+  }
+  /**
+   * Get executive compensation
+   * https://site.financialmodelingprep.com/developer/docs#executive-compensation-company-information
+   * @param symbol - The stock symbol to get the executive compensation for
+   * @returns Understand how a company compensates its executives with our Executive Compensation endpoint. This endpoint provides information such as salary, bonus, and stock options for each executive.
+   */
+  async getExecutiveCompensation({
+    symbol
+  }) {
+    const params = { symbol };
+    return this.client.get(`/governance/executive_compensation`, "v4", params);
+  }
+  /**
+   * 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.
+   */
+  async getCompanyNotes({
+    symbol
+  }) {
+    const params = { symbol };
+    return this.client.get(`/company-notes`, "v4", params);
+  }
+  /**
+   * Get historical employee count
+   * https://site.financialmodelingprep.com/developer/docs#historical-employee-company-information
+   * @param symbol - The stock symbol to get the historical employee count for
+   * @returns Track a company's employee count over time with our Historical Employee Count endpoint. This endpoint provides information about the number of employees a company has had each year.
+   */
+  async getHistoricalEmployeeCount({
+    symbol
+  }) {
+    const params = { symbol };
+    return this.client.get(`/historical/employee_count`, "v4", params);
+  }
+  /**
+   * Get shares float
+   * https://site.financialmodelingprep.com/developer/docs#company-share-float-share-float
+   * @param symbol - The stock symbol to get the shares float for
+   * @returns The FMP Company Share Float endpoint provides the total number of shares that are publicly traded for a given company. This is also known as the company's float. The float is calculated by subtracting the number of restricted shares from the total number of outstanding shares.
+   */
+  async getSharesFloat({ symbol }) {
+    const params = { symbol };
+    return this.client.getSingle(`/shares_float`, "v4", params);
+  }
+  /**
+   * Get historical shares float
+   * https://site.financialmodelingprep.com/developer/docs#company-historical-share-float
+   * @param symbol - The stock symbol to get the historical shares float for
+   * @returns The FMP Historical Share Float endpoint provides historical data on the number of shares that are publicly traded for a given company. This is also known as the company's float. The float is calculated by subtracting the number of restricted shares from the total number of outstanding shares.
+   */
+  async getHistoricalSharesFloat({
+    symbol
+  }) {
+    const params = { symbol };
+    return this.client.get(`/historical/shares_float`, "v4", params);
+  }
+  /**
+   * Get earnings call transcript
+   * https://site.financialmodelingprep.com/developer/docs#earnings-transcript-earnings-transcripts
+   * @param symbol - The stock symbol to get the earnings call transcript for
+   * @param year - The year of the earnings call
+   * @param quarter - The quarter of the earnings call
+   * @returns The FMP Earnings Call Transcript endpoint provides the transcript of a company's earnings call.
+   */
+  async getEarningsCallTranscript({
+    symbol,
+    year,
+    quarter
+  }) {
+    const params = { year, quarter };
+    return this.client.getSingle(`/earning_call_transcript/${symbol}`, "v3", params);
   }
 };
 
 // src/fmp.ts
 var FMP = class {
   constructor(config) {
-    validateApiKey2(config.apiKey);
+    validateApiKey(config.apiKey);
     const client = new FMPClient(config);
     this.stock = new StockEndpoints(client);
     this.financial = new FinancialEndpoints(client);
-    this.forex = new ForexEndpoints(client);
     this.crypto = new CryptoEndpoints(client);
     this.etf = new ETFEndpoints(client);
-    this.mutualFund = new MutualFundEndpoints(client);
-    this.bond = new BondEndpoints(client);
-    this.economic = new EconomicEndpoints(client);
     this.market = new MarketEndpoints(client);
+    this.list = new ListEndpoints(client);
+    this.calendar = new CalendarEndpoints(client);
+    this.company = new CompanyEndpoints(client);
+    this.forex = new ForexEndpoints(client);
+    this.economic = new EconomicEndpoints(client);
+    this.bond = new BondEndpoints(client);
+    this.mutualFund = new MutualFundEndpoints(client);
   }
   /**
    * Get the underlying client instance for advanced usage
@@ -597,7 +951,22 @@ var FMP = class {
 };
 
 // src/types/common.ts
-var FMP_STABLE_URL = "https://financialmodelingprep.com/stable";
+var Period = /* @__PURE__ */ ((Period2) => {
+  Period2["ANNUAL"] = "annual";
+  Period2["QUARTER"] = "quarter";
+  return Period2;
+})(Period || {});
+var Exchange = /* @__PURE__ */ ((Exchange2) => {
+  Exchange2["NYSE"] = "NYSE";
+  Exchange2["NASDAQ"] = "NASDAQ";
+  Exchange2["AMEX"] = "AMEX";
+  Exchange2["TSX"] = "TSX";
+  Exchange2["LSE"] = "LSE";
+  Exchange2["ASX"] = "ASX";
+  Exchange2["NSE"] = "NSE";
+  Exchange2["BSE"] = "BSE";
+  return Exchange2;
+})(Exchange || {});
 
 // src/utils/formatting.ts
 function formatCurrency(value, currency = "USD") {
@@ -720,6 +1089,8 @@ var HTTP_STATUS = {
 
 exports.BondEndpoints = BondEndpoints;
 exports.COUNTRIES = COUNTRIES;
+exports.CalendarEndpoints = CalendarEndpoints;
+exports.CompanyEndpoints = CompanyEndpoints;
 exports.CryptoEndpoints = CryptoEndpoints;
 exports.DEFAULT_LIMIT = DEFAULT_LIMIT;
 exports.DEFAULT_TIMEOUT = DEFAULT_TIMEOUT;
@@ -730,13 +1101,10 @@ exports.EconomicEndpoints = EconomicEndpoints;
 exports.Exchange = Exchange;
 exports.FMP = FMP;
 exports.FMPClient = FMPClient;
-exports.FMPError = FMPError;
-exports.FMP_BASE_URL = FMP_BASE_URL;
-exports.FMP_BASE_URL_V4 = FMP_BASE_URL_V4;
-exports.FMP_STABLE_URL = FMP_STABLE_URL;
 exports.FinancialEndpoints = FinancialEndpoints;
 exports.ForexEndpoints = ForexEndpoints;
 exports.HTTP_STATUS = HTTP_STATUS;
+exports.ListEndpoints = ListEndpoints;
 exports.MAX_LIMIT = MAX_LIMIT;
 exports.MarketEndpoints = MarketEndpoints;
 exports.MutualFundEndpoints = MutualFundEndpoints;