fmp-node-api 0.0.2 → 0.0.3

package/dist/index.js

@@ -7,34 +7,42 @@ 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) {
+  // Smart routing method
+  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,
+        data: unwrapSingleObject(response.data),
         status: response.status
       };
     } catch (error) {
@@ -45,31 +53,18 @@ var FMPClient = class {
       };
     }
   }
-  /**
-   * Make a POST request to the API
-   */
-  async post(endpoint, data, config) {
-    try {
-      const response = await this.client.post(endpoint, data, config);
-      return {
-        success: true,
-        data: response.data,
-        status: response.status
-      };
-    } catch (error) {
-      return {
-        success: false,
-        error: error.message || "Unknown error occurred",
-        status: error.response?.status || 500
-      };
+  getClientForVersion(version) {
+    switch (version) {
+      case "v3":
+        return this.v3Client;
+      case "v4":
+        return this.v4Client;
+      case "stable":
+        return this.stableClient;
+      default:
+        return this.v3Client;
     }
   }
-  /**
-   * Get the underlying axios instance for advanced usage
-   */
-  getAxiosInstance() {
-    return this.client;
-  }
 };
 
 // src/shared.ts
@@ -81,36 +76,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 +130,63 @@ 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.get(`/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.get(`/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);
+  async getMarketCap({
+    symbol
+  }) {
+    return this.client.get(`/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}`);
+  async getStockSplits({
+    symbol
+  }) {
+    return this.client.get(`/stock-split-calendar/${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.get(`/historical-price-full/stock_dividend/${symbol}`, "v3");
   }
 };
 
@@ -221,63 +197,165 @@ 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");
   }
 };
 
@@ -287,59 +365,35 @@ var ForexEndpoints = class {
     this.client = client;
   }
   /**
-   * Get real-time forex quote
+   * Get forex quote
    */
   async getQuote(params) {
-    return this.client.get(`/quote/${params.symbol}`);
+    return this.client.get("/quote", "v3", params);
   }
   /**
-   * Get historical forex data
+   * Get historical forex prices
    */
-  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);
-  }
-  /**
-   * Get list of all forex pairs
-   * Using the forex-specific endpoint
-   */
-  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
    */
   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
    */
   async getAllForexRates() {
-    return this.client.get("/forex");
+    return this.client.get("/forex", "v3");
   }
 };
 
@@ -349,26 +403,23 @@ var CryptoEndpoints = class {
     this.client = client;
   }
   /**
-   * Get real-time crypto quote
+   * Get crypto quote
    */
   async getQuote(params) {
-    return this.client.get(`/quote/${params.symbol}`);
-  }
-  /**
-   * Get historical crypto 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 cryptocurrencies
+   * Get historical crypto prices
    */
-  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.get(`/historical-price-full/${symbol}`, "v3", params);
   }
 };
 
@@ -378,31 +429,22 @@ var ETFEndpoints = class {
     this.client = client;
   }
   /**
-   * Get real-time ETF quote
+   * Get ETF quote
    */
   async getQuote(params) {
-    return this.client.get(`/quote/${params.symbol}`);
+    return this.client.get("/quote", "v3", params);
   }
   /**
    * Get ETF profile
    */
   async getProfile(params) {
-    return this.client.get(`/profile/${params.symbol}`);
+    return this.client.get("/profile", "v3", params);
   }
   /**
    * Get ETF holdings
    */
   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);
-  }
-  /**
-   * Get list of all ETFs
-   */
-  async getETFList() {
-    return this.client.get("/etf/list");
+    return this.client.get("/holdings", "v3", params);
   }
 };
 
@@ -412,31 +454,22 @@ var MutualFundEndpoints = class {
     this.client = client;
   }
   /**
-   * Get real-time mutual fund quote
+   * Get mutual fund quote
    */
   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 +479,23 @@ var BondEndpoints = class {
     this.client = client;
   }
   /**
-   * Get real-time bond quote
+   * Get bond quote
    */
   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
    */
-  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 +508,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,53 +545,263 @@ 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
    */
   async getGainers() {
-    return this.client.get("/gainers");
+    return this.client.get("/gainers", "v3");
   }
   /**
-   * Get market losers
+   * Get top losers
    */
   async getLosers() {
-    return this.client.get("/losers");
+    return this.client.get("/losers", "v3");
   }
   /**
    * Get most active stocks
    */
   async getMostActive() {
-    return this.client.get("/most-active");
+    return this.client.get("/most-active", "v3");
   }
   /**
    * Get sector performance
    */
   async getSectorPerformance() {
-    return this.client.get("/sector-performance");
+    return this.client.get("/sector-performance", "v3");
   }
   /**
-   * Get market index data
+   * Get market indices
    */
   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);
+    return this.client.get("/market-index", "v3", params);
+  }
+};
+
+// 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 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 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.get(`/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.get(`/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.get(`/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);
@@ -587,6 +812,9 @@ var FMP = class {
     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);
   }
   /**
    * Get the underlying client instance for advanced usage
@@ -597,7 +825,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 +963,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 +975,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;