fmp-node-api 0.0.2

package/dist/index.d.mts

@@ -0,0 +1,1431 @@
+import { AxiosRequestConfig, AxiosInstance } from 'axios';
+
+interface APIResponse<T = unknown> {
+    success: boolean;
+    data?: T;
+    error?: string;
+    status?: number;
+}
+interface SuccessResponse<T> extends APIResponse<T> {
+    success: true;
+    data: T;
+    status: number;
+}
+interface ErrorResponse extends APIResponse<never> {
+    success: false;
+    error: string;
+    status: number;
+}
+interface FMPConfig {
+    apiKey: string;
+    baseURL?: string;
+    timeout?: number;
+}
+interface SymbolParams {
+    symbol: string;
+}
+interface DateRangeParams {
+    from?: string;
+    to?: string;
+}
+interface PaginationParams {
+    limit?: number;
+    page?: number;
+}
+interface PeriodParams {
+    period?: 'annual' | 'quarter';
+}
+interface HistoricalPriceData {
+    date: string;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    adjClose: number;
+    volume: number;
+    unadjustedVolume: number;
+    change: number;
+    changePercent: number;
+    vwap: number;
+    label: string;
+    changeOverTime: number;
+}
+interface HistoricalPriceResponse {
+    symbol: string;
+    historical: HistoricalPriceData[];
+}
+interface QueryParams {
+    [key: string]: string | number | boolean | undefined;
+}
+interface Quote {
+    symbol: string;
+    price: number;
+    change: number;
+    changePercent: number;
+    dayLow: number;
+    dayHigh: number;
+    yearLow: number;
+    yearHigh: number;
+    marketCap: number;
+    priceAvg50: number;
+    priceAvg200: number;
+    volume: number;
+    avgVolume: number;
+    exchange: string;
+    open: number;
+    previousClose: number;
+    eps: number;
+    pe: number;
+    earningsAnnouncement: string;
+    sharesOutstanding: number;
+    timestamp: number;
+}
+interface CompanyProfile {
+    symbol: string;
+    price: number;
+    beta: number;
+    volAvg: number;
+    marketCap: number;
+    lastDiv: number;
+    range: string;
+    changes: number;
+    companyName: string;
+    currency: string;
+    cik: string;
+    isin: string;
+    cusip: string;
+    exchange: string;
+    exchangeShortName: string;
+    industry: string;
+    website: string;
+    description: string;
+    ceo: string;
+    sector: string;
+    country: string;
+    fullTimeEmployees: string;
+    phone: string;
+    address: string;
+    city: string;
+    state: string;
+    zip: string;
+    dcfDiff: number;
+    dcf: number;
+    image: string;
+    ipoDate: string;
+    defaultImage: boolean;
+    isEtf: boolean;
+    isActivelyTrading: boolean;
+    isAdr: boolean;
+    isFund: boolean;
+}
+declare const FMP_STABLE_URL = "https://financialmodelingprep.com/stable";
+
+type StockQuote = Quote;
+interface StockQuoteParams extends SymbolParams {
+}
+interface StockProfileParams extends SymbolParams {
+}
+interface StockHistoricalPriceParams extends SymbolParams, DateRangeParams {
+    timeseries?: number;
+}
+interface StockMarketCapParams extends SymbolParams {
+}
+interface StockEarningsCalendarParams {
+    from?: string;
+    to?: string;
+}
+interface StockSplitsParams extends SymbolParams {
+}
+interface StockDividendParams extends SymbolParams {
+}
+interface StockInsiderTradingParams extends SymbolParams, PaginationParams {
+}
+interface StockInstitutionalHoldersParams extends SymbolParams {
+}
+interface StockMutualFundHoldersParams extends SymbolParams {
+}
+interface StockMajorHoldersParams extends SymbolParams {
+}
+interface StockAnalystEstimatesParams extends SymbolParams, PaginationParams {
+}
+interface StockPriceTargetParams extends SymbolParams {
+}
+interface StockRatingParams extends SymbolParams {
+}
+interface StockGradeParams extends SymbolParams {
+}
+interface StockSectorPerformanceParams {
+}
+interface StockLosersParams {
+}
+interface StockGainersParams {
+}
+interface StockMostActiveParams {
+}
+interface StockSplit {
+    date: string;
+    label: string;
+    numerator: number;
+    denominator: number;
+}
+interface StockDividend {
+    date: string;
+    label: string;
+    adjDividend: number;
+    dividend: number;
+    recordDate: string;
+    paymentDate: string;
+    declarationDate: string;
+}
+interface InsiderTrading {
+    symbol: string;
+    companyName: string;
+    cik: string;
+    ownerName: string;
+    ownerCik: string;
+    ownerTitle: string;
+    transactionDate: string;
+    transactionCode: string;
+    transactionAmount: number;
+    transactionPrice: number;
+    transactionAcquiredDisposed: string;
+    postTransactionAmount: number;
+    secLink: string;
+}
+interface InstitutionalHolder {
+    holder: string;
+    shares: number;
+    dateReported: string;
+    change: number;
+    weightPercent: number;
+}
+interface MutualFundHolder {
+    holder: string;
+    shares: number;
+    dateReported: string;
+    change: number;
+    weightPercent: number;
+}
+interface MajorHolder {
+    holder: string;
+    shares: number;
+    dateReported: string;
+    change: number;
+    weightPercent: number;
+}
+interface AnalystEstimate {
+    symbol: string;
+    date: string;
+    estimatedRevenueLow: number;
+    estimatedRevenueHigh: number;
+    estimatedRevenueAvg: number;
+    estimatedEbitdaLow: number;
+    estimatedEbitdaHigh: number;
+    estimatedEbitdaAvg: number;
+    estimatedEbitLow: number;
+    estimatedEbitHigh: number;
+    estimatedEbitAvg: number;
+    estimatedNetIncomeLow: number;
+    estimatedNetIncomeHigh: number;
+    estimatedNetIncomeAvg: number;
+    estimatedSgaExpenseLow: number;
+    estimatedSgaExpenseHigh: number;
+    estimatedSgaExpenseAvg: number;
+    estimatedEpsAvg: number;
+    estimatedEpsHigh: number;
+    estimatedEpsLow: number;
+    numberAnalystEstimatedRevenue: number;
+    numberAnalystsEstimatedEps: number;
+}
+interface PriceTarget {
+    symbol: string;
+    targetMean: number;
+    targetMedian: number;
+    targetHigh: number;
+    targetLow: number;
+    targetCount: number;
+}
+interface StockRating {
+    symbol: string;
+    date: string;
+    rating: string;
+    ratingScore: number;
+    ratingRecommendation: string;
+    ratingDetailsDCFScore: number;
+    ratingDetailsDCFRecommendation: string;
+    ratingDetailsROEScore: number;
+    ratingDetailsROERecommendation: string;
+    ratingDetailsROAScore: number;
+    ratingDetailsROARecommendation: string;
+    ratingDetailsDEScore: number;
+    ratingDetailsDERecommendation: string;
+    ratingDetailsPEScore: number;
+    ratingDetailsPERecommendation: string;
+    ratingDetailsPBScore: number;
+    ratingDetailsPBRecommendation: string;
+}
+interface StockGrade {
+    symbol: string;
+    date: string;
+    gradingCompany: string;
+    previousGrade: string;
+    newGrade: string;
+    grade: string;
+}
+interface SectorPerformance {
+    sector: string;
+    changesPercentage: number;
+}
+interface StockList {
+    symbol: string;
+    name: string;
+    currency: string;
+    stockExchange: string;
+    exchangeShortName: string;
+}
+interface MarketCap {
+    symbol: string;
+    date: string;
+    marketCap: number;
+}
+interface EarningsCalendar {
+    date: string;
+    symbol: string;
+    eps: number;
+    estimatedEps: number;
+    time: string;
+    revenue: number;
+    estimatedRevenue: number;
+    fiscalDateEnding: string;
+    updatedFromDate: string;
+}
+interface StockHistoricalPriceData extends HistoricalPriceData {
+}
+interface StockHistoricalPriceResponse extends HistoricalPriceResponse {
+    historical: StockHistoricalPriceData[];
+}
+
+interface FinancialStatementsParams extends SymbolParams, PeriodParams {
+    limit?: number;
+}
+interface IncomeStatementParams extends FinancialStatementsParams {
+}
+interface BalanceSheetParams extends FinancialStatementsParams {
+}
+interface CashFlowParams extends FinancialStatementsParams {
+}
+interface FinancialGrowthParams extends FinancialStatementsParams {
+}
+interface KeyMetricsParams extends FinancialStatementsParams {
+}
+interface FinancialRatiosParams extends FinancialStatementsParams {
+}
+interface EnterpriseValueParams extends FinancialStatementsParams {
+}
+interface CompanyValuationParams extends FinancialStatementsParams {
+}
+interface FinancialStatement {
+    date: string;
+    symbol: string;
+    reportedCurrency: string;
+    cik: string;
+    fillingDate: string;
+    acceptedDate: string;
+    calendarYear: string;
+    period: string;
+    link: string;
+    finalLink: string;
+    [key: string]: string | number | boolean;
+}
+interface IncomeStatement extends FinancialStatement {
+    revenue: number;
+    costOfRevenue: number;
+    grossProfit: number;
+    grossProfitRatio: number;
+    researchAndDevelopmentExpenses: number;
+    generalAndAdministrativeExpenses: number;
+    sellingAndMarketingExpenses: number;
+    sellingGeneralAndAdministrativeExpenses: number;
+    otherExpenses: number;
+    operatingExpenses: number;
+    costAndExpenses: number;
+    interestExpense: number;
+    depreciationAndAmortization: number;
+    ebitda: number;
+    ebitdaratio: number;
+    operatingIncome: number;
+    operatingIncomeRatio: number;
+    totalOtherIncomeExpensesNet: number;
+    incomeBeforeTax: number;
+    incomeBeforeTaxRatio: number;
+    incomeTaxExpense: number;
+    netIncome: number;
+    netIncomeRatio: number;
+    eps: number;
+    epsDiluted: number;
+    ebit: number;
+    ebitRatio: number;
+}
+interface BalanceSheet extends FinancialStatement {
+    cashAndCashEquivalents: number;
+    shortTermInvestments: number;
+    cashAndShortTermInvestments: number;
+    netReceivables: number;
+    inventory: number;
+    totalCurrentAssets: number;
+    propertyPlantEquipmentNet: number;
+    goodwill: number;
+    intangibleAssets: number;
+    goodwillAndIntangibleAssets: number;
+    longTermInvestments: number;
+    taxAssets: number;
+    otherNonCurrentAssets: number;
+    totalNonCurrentAssets: number;
+    otherAssets: number;
+    totalAssets: number;
+    accountPayables: number;
+    shortTermDebt: number;
+    taxPayables: number;
+    deferredRevenue: number;
+    otherCurrentLiabilities: number;
+    totalCurrentLiabilities: number;
+    longTermDebt: number;
+    deferredRevenueNonCurrent: number;
+    deferredTaxLiabilitiesNonCurrent: number;
+    otherNonCurrentLiabilities: number;
+    totalNonCurrentLiabilities: number;
+    otherLiabilities: number;
+    capitalLeaseObligations: number;
+    totalLiabilities: number;
+    preferredStock: number;
+    commonStock: number;
+    retainedEarnings: number;
+    accumulatedOtherComprehensiveIncomeLoss: number;
+    othertotalStockholdersEquity: number;
+    totalStockholdersEquity: number;
+    totalEquity: number;
+    totalLiabilitiesAndStockholdersEquity: number;
+    minorityInterest: number;
+    totalLiabilitiesAndTotalEquity: number;
+    totalInvestments: number;
+    totalDebt: number;
+    netDebt: number;
+}
+interface CashFlowStatement extends FinancialStatement {
+    netIncome: number;
+    depreciationAndAmortization: number;
+    deferredIncomeTax: number;
+    changeInWorkingCapital: number;
+    accountsReceivables: number;
+    inventory: number;
+    accountsPayables: number;
+    otherWorkingCapital: number;
+    otherNonCashItems: number;
+    netCashProvidedByOperatingActivities: number;
+    investmentsInPropertyPlantAndEquipment: number;
+    acquisitionsNet: number;
+    purchasesOfInvestments: number;
+    salesMaturitiesOfInvestments: number;
+    otherInvestingActivites: number;
+    netCashUsedForInvestingActivites: number;
+    debtRepayment: number;
+    commonStockIssued: number;
+    commonStockRepurchased: number;
+    dividendsPaid: number;
+    otherFinancingActivites: number;
+    netCashUsedProvidedByFinancingActivities: number;
+    effectOfForexChangesOnCash: number;
+    netChangeInCash: number;
+    cashAtEndOfPeriod: number;
+    cashAtBeginningOfPeriod: number;
+    operatingCashFlow: number;
+    capitalExpenditure: number;
+    freeCashFlow: number;
+}
+interface KeyMetrics {
+    symbol: string;
+    date: string;
+    period: string;
+    revenuePerShare: number;
+    netIncomePerShare: number;
+    operatingCashFlowPerShare: number;
+    freeCashFlowPerShare: number;
+    cashPerShare: number;
+    bookValuePerShare: number;
+    tangibleBookValuePerShare: number;
+    shareholdersEquityPerShare: number;
+    interestDebtPerShare: number;
+    marketCap: number;
+    enterpriseValue: number;
+    peRatio: number;
+    priceToSalesRatio: number;
+    pocfratio: number;
+    pfcfRatio: number;
+    pbRatio: number;
+    ptbRatio: number;
+    evToSales: number;
+    enterpriseValueOverEBITDA: number;
+    evToOperatingCashFlow: number;
+    evToFreeCashFlow: number;
+    earningsYield: number;
+    freeCashFlowYield: number;
+    debtToEquity: number;
+    debtToAssets: number;
+    netDebtToEBITDA: number;
+    currentRatio: number;
+    interestCoverage: number;
+    incomeQuality: number;
+    dividendYield: number;
+    payoutRatio: number;
+    salesGeneralAndAdministrativeToRevenue: number;
+    researchAndDevelopmentToRevenue: number;
+    intangiblesToTotalAssets: number;
+    capexToOperatingCashFlow: number;
+    capexToRevenue: number;
+    capexToDepreciation: number;
+    stockBasedCompensationToRevenue: number;
+    grahamNumber: number;
+    roic: number;
+    returnOnTangibleAssets: number;
+    grahamNetNet: number;
+    workingCapital: number;
+    tangibleAssetValue: number;
+    netCurrentAssetValue: number;
+    investedCapital: number;
+    averageReceivables: number;
+    averagePayables: number;
+    averageInventory: number;
+    daysSalesOutstanding: number;
+    daysPayablesOutstanding: number;
+    daysOfInventoryOnHand: number;
+    receivablesTurnover: number;
+    payablesTurnover: number;
+    inventoryTurnover: number;
+    roe: number;
+    capexPerShare: number;
+}
+interface FinancialRatios {
+    symbol: string;
+    date: string;
+    period: string;
+    currentRatio: number;
+    quickRatio: number;
+    cashRatio: number;
+    daysOfSalesOutstanding: number;
+    daysOfInventoryOutstanding: number;
+    operatingCycle: number;
+    daysOfPayablesOutstanding: number;
+    cashConversionCycle: number;
+    grossProfitMargin: number;
+    operatingProfitMargin: number;
+    pretaxProfitMargin: number;
+    netProfitMargin: number;
+    effectiveTaxRate: number;
+    returnOnAssets: number;
+    returnOnEquity: number;
+    returnOnCapitalEmployed: number;
+    netIncomePerEBT: number;
+    ebtPerEbit: number;
+    ebitPerRevenue: number;
+    debtRatio: number;
+    debtEquityRatio: number;
+    longTermDebtToCapitalization: number;
+    totalDebtToCapitalization: number;
+    interestCoverage: number;
+    cashFlowToDebtRatio: number;
+    companyEquityMultiplier: number;
+    receivablesTurnover: number;
+    payablesTurnover: number;
+    inventoryTurnover: number;
+    fixedAssetTurnover: number;
+    assetTurnover: number;
+    operatingCashFlowPerShare: number;
+    freeCashFlowPerShare: number;
+    cashPerShare: number;
+    payoutRatio: number;
+    operatingCashFlowSalesRatio: number;
+    freeCashFlowOperatingCashFlowRatio: number;
+    cashFlowCoverageRatios: number;
+    shortTermCoverageRatios: number;
+    capitalExpenditureCoverageRatio: number;
+    dividendPaidAndCapexCoverageRatio: number;
+    dividendPayoutRatio: number;
+    priceBookValueRatio: number;
+    priceToBookRatio: number;
+    priceToSalesRatio: number;
+    priceEarningsRatio: number;
+    priceToFreeCashFlowsRatio: number;
+    priceToOperatingCashFlowsRatio: number;
+    priceCashFlowRatio: number;
+    priceEarningsToGrowthRatio: number;
+    priceSalesRatio: number;
+    dividendYield: number;
+    enterpriseValueMultiple: number;
+    priceFairValue: number;
+}
+interface EnterpriseValue {
+    symbol: string;
+    date: string;
+    stockPrice: number;
+    numberOfShares: number;
+    marketCapitalization: number;
+    minusCashAndCashEquivalents: number;
+    addTotalDebt: number;
+    enterpriseValue: number;
+}
+
+interface ForexQuoteParams extends SymbolParams {
+}
+interface ForexHistoricalParams extends SymbolParams, DateRangeParams {
+    timeseries?: number;
+}
+interface ForexListParams {
+}
+interface ForexQuote {
+    symbol: string;
+    price: number;
+    changesPercentage: number;
+    change: number;
+    dayLow: number;
+    dayHigh: number;
+    yearLow: number;
+    yearHigh: number;
+    marketCap: number;
+    priceAvg50: number;
+    priceAvg200: number;
+    volume: number;
+    avgVolume: number;
+    exchange: string;
+    open: number;
+    previousClose: number;
+    eps: number;
+    pe: number;
+    earningsAnnouncement: string;
+    sharesOutstanding: number;
+    timestamp: number;
+}
+interface ForexPair {
+    symbol: string;
+    name: string;
+    currency: string;
+    stockExchange: string;
+    exchangeShortName: string;
+}
+
+interface CryptoQuoteParams extends SymbolParams {
+}
+interface CryptoHistoricalParams extends SymbolParams, DateRangeParams {
+    timeseries?: number;
+}
+interface CryptoListParams {
+}
+interface CryptoQuote {
+    symbol: string;
+    price: number;
+    changesPercentage: number;
+    change: number;
+    dayLow: number;
+    dayHigh: number;
+    yearLow: number;
+    yearHigh: number;
+    marketCap: number;
+    priceAvg50: number;
+    priceAvg200: number;
+    volume: number;
+    avgVolume: number;
+    exchange: string;
+    open: number;
+    previousClose: number;
+    eps: number;
+    pe: number;
+    earningsAnnouncement: string;
+    sharesOutstanding: number;
+    timestamp: number;
+}
+interface CryptoCurrency {
+    symbol: string;
+    name: string;
+    currency: string;
+    stockExchange: string;
+    exchangeShortName: string;
+}
+
+interface ETFQuoteParams extends SymbolParams {
+}
+interface ETFProfileParams extends SymbolParams {
+}
+interface ETFHoldersParams extends SymbolParams, PaginationParams {
+}
+interface ETFListParams {
+}
+interface ETFQuote {
+    symbol: string;
+    price: number;
+    changesPercentage: number;
+    change: number;
+    dayLow: number;
+    dayHigh: number;
+    yearLow: number;
+    yearHigh: number;
+    marketCap: number;
+    priceAvg50: number;
+    priceAvg200: number;
+    volume: number;
+    avgVolume: number;
+    exchange: string;
+    open: number;
+    previousClose: number;
+    eps: number;
+    pe: number;
+    earningsAnnouncement: string;
+    sharesOutstanding: number;
+    timestamp: number;
+}
+interface ETFProfile {
+    symbol: string;
+    price: number;
+    beta: number;
+    volAvg: number;
+    marketCap: number;
+    lastDiv: number;
+    range: string;
+    changes: number;
+    companyName: string;
+    currency: string;
+    cik: string;
+    isin: string;
+    cusip: string;
+    exchange: string;
+    exchangeShortName: string;
+    industry: string;
+    website: string;
+    description: string;
+    ceo: string;
+    sector: string;
+    country: string;
+    fullTimeEmployees: string;
+    phone: string;
+    address: string;
+    city: string;
+    state: string;
+    zip: string;
+    dcfDiff: number;
+    dcf: number;
+    image: string;
+    ipoDate: string;
+    defaultImage: boolean;
+    isEtf: boolean;
+    isActivelyTrading: boolean;
+    isAdr: boolean;
+    isFund: boolean;
+}
+interface ETFHolding {
+    asset: string;
+    weightPercent: number;
+    shares: number;
+    marketValue: number;
+}
+interface ETFList {
+    symbol: string;
+    name: string;
+    currency: string;
+    stockExchange: string;
+    exchangeShortName: string;
+}
+
+interface MutualFundQuoteParams extends SymbolParams {
+}
+interface MutualFundProfileParams extends SymbolParams {
+}
+interface MutualFundHoldersParams extends SymbolParams, PaginationParams {
+}
+interface MutualFundListParams {
+}
+interface MutualFundQuote {
+    symbol: string;
+    price: number;
+    changesPercentage: number;
+    change: number;
+    dayLow: number;
+    dayHigh: number;
+    yearLow: number;
+    yearHigh: number;
+    marketCap: number;
+    priceAvg50: number;
+    priceAvg200: number;
+    volume: number;
+    avgVolume: number;
+    exchange: string;
+    open: number;
+    previousClose: number;
+    eps: number;
+    pe: number;
+    earningsAnnouncement: string;
+    sharesOutstanding: number;
+    timestamp: number;
+}
+interface MutualFundProfile {
+    symbol: string;
+    price: number;
+    beta: number;
+    volAvg: number;
+    marketCap: number;
+    lastDiv: number;
+    range: string;
+    changes: number;
+    companyName: string;
+    currency: string;
+    cik: string;
+    isin: string;
+    cusip: string;
+    exchange: string;
+    exchangeShortName: string;
+    industry: string;
+    website: string;
+    description: string;
+    ceo: string;
+    sector: string;
+    country: string;
+    fullTimeEmployees: string;
+    phone: string;
+    address: string;
+    city: string;
+    state: string;
+    zip: string;
+    dcfDiff: number;
+    dcf: number;
+    image: string;
+    ipoDate: string;
+    defaultImage: boolean;
+    isEtf: boolean;
+    isActivelyTrading: boolean;
+    isAdr: boolean;
+    isFund: boolean;
+}
+interface MutualFundHolding {
+    asset: string;
+    weightPercent: number;
+    shares: number;
+    marketValue: number;
+}
+interface MutualFundList {
+    symbol: string;
+    name: string;
+    currency: string;
+    stockExchange: string;
+    exchangeShortName: string;
+}
+
+interface BondQuoteParams extends SymbolParams {
+}
+interface BondHistoricalParams extends SymbolParams, DateRangeParams {
+    timeseries?: number;
+}
+interface BondListParams {
+}
+interface BondQuote {
+    symbol: string;
+    price: number;
+    changesPercentage: number;
+    change: number;
+    dayLow: number;
+    dayHigh: number;
+    yearLow: number;
+    yearHigh: number;
+    marketCap: number;
+    priceAvg50: number;
+    priceAvg200: number;
+    volume: number;
+    avgVolume: number;
+    exchange: string;
+    open: number;
+    previousClose: number;
+    eps: number;
+    pe: number;
+    earningsAnnouncement: string;
+    sharesOutstanding: number;
+    timestamp: number;
+}
+interface BondList {
+    symbol: string;
+    name: string;
+    currency: string;
+    stockExchange: string;
+    exchangeShortName: string;
+}
+
+interface EconomicIndicatorParams extends DateRangeParams {
+}
+interface TreasuryRateParams extends EconomicIndicatorParams {
+}
+interface FederalFundsRateParams extends EconomicIndicatorParams {
+}
+interface CPIParams extends EconomicIndicatorParams {
+}
+interface GDPParams extends EconomicIndicatorParams {
+}
+interface UnemploymentParams extends EconomicIndicatorParams {
+}
+interface EconomicIndicator {
+    date: string;
+    value: number;
+    change: number;
+    changePercent: number;
+}
+interface TreasuryRate {
+    date: string;
+    month1: number;
+    month2: number;
+    month3: number;
+    month6: number;
+    year1: number;
+    year2: number;
+    year3: number;
+    year5: number;
+    year7: number;
+    year10: number;
+    year20: number;
+    year30: number;
+}
+interface FederalFundsRate {
+    date: string;
+    value: number;
+}
+interface CPI {
+    date: string;
+    value: number;
+    change: number;
+    changePercent: number;
+}
+interface GDP {
+    date: string;
+    value: number;
+    change: number;
+    changePercent: number;
+}
+interface Unemployment {
+    date: string;
+    value: number;
+    change: number;
+    changePercent: number;
+}
+
+interface MarketHoursParams {
+}
+interface MarketPerformanceParams {
+}
+interface MarketGainersParams {
+}
+interface MarketLosersParams {
+}
+interface MarketMostActiveParams {
+}
+interface MarketSectorPerformanceParams {
+}
+interface MarketIndexParams extends DateRangeParams {
+}
+interface MarketHours {
+    stockExchangeName: string;
+    stockMarketHours: {
+        openingHour: string;
+        closingHour: string;
+        gmtOffset: number;
+    };
+    holidays: string[];
+    isTheStockMarketOpen: boolean;
+    isTheEuronextMarketOpen: boolean;
+    isTheForexMarketOpen: boolean;
+    isTheCryptoMarketOpen: boolean;
+}
+interface MarketPerformance {
+    ticker: string;
+    companyName: string;
+    price: number;
+    changesPercentage: number;
+    changes: number;
+    dayLow: number;
+    dayHigh: number;
+    yearLow: number;
+    yearHigh: number;
+    marketCap: number;
+    priceAvg50: number;
+    priceAvg200: number;
+    volume: number;
+    avgVolume: number;
+    exchange: string;
+    open: number;
+    previousClose: number;
+    eps: number;
+    pe: number;
+    earningsAnnouncement: string;
+    sharesOutstanding: number;
+    timestamp: number;
+}
+interface MarketSectorPerformance {
+    sector: string;
+    changesPercentage: number;
+}
+interface MarketIndex {
+    symbol: string;
+    name: string;
+    price: number;
+    changesPercentage: number;
+    change: number;
+    dayLow: number;
+    dayHigh: number;
+    yearLow: number;
+    yearHigh: number;
+    marketCap: number;
+    priceAvg50: number;
+    priceAvg200: number;
+    volume: number;
+    avgVolume: number;
+    exchange: string;
+    open: number;
+    previousClose: number;
+    eps: number;
+    pe: number;
+    earningsAnnouncement: string;
+    sharesOutstanding: number;
+    timestamp: number;
+}
+
+declare class FMPClient {
+    private client;
+    private apiKey;
+    private baseURL;
+    constructor(config: FMPConfig);
+    /**
+     * Make a GET request to the API
+     */
+    get<T = any>(endpoint: string, params?: Record<string, any>): Promise<APIResponse<T>>;
+    /**
+     * Make a POST request to the API
+     */
+    post<T = any>(endpoint: string, data?: any, config?: AxiosRequestConfig): Promise<APIResponse<T>>;
+    /**
+     * Get the underlying axios instance for advanced usage
+     */
+    getAxiosInstance(): AxiosInstance;
+}
+
+declare class StockEndpoints {
+    private client;
+    constructor(client: FMPClient);
+    /**
+     * Get real-time stock quote
+     */
+    getQuote({ symbol }: {
+        symbol: string;
+    }): Promise<APIResponse<StockQuote[]>>;
+    /**
+     * Get company profile
+     */
+    getCompanyProfile({ symbol }: {
+        symbol: string;
+    }): Promise<APIResponse<CompanyProfile[]>>;
+    /**
+     * Get historical stock prices
+     */
+    getHistoricalPrice({ symbol, from, to, }: {
+        symbol: string;
+        from?: string;
+        to?: string;
+    }): Promise<APIResponse<StockHistoricalPriceResponse>>;
+    /**
+     * Get list of all stocks
+     */
+    getStockList(): Promise<APIResponse<StockList[]>>;
+    /**
+     * Get market capitalization
+     */
+    getMarketCap({ symbol }: {
+        symbol: string;
+    }): Promise<APIResponse<MarketCap[]>>;
+    /**
+     * Get earnings calendar
+     */
+    getEarningsCalendar(params: {
+        from?: string;
+        to?: string;
+    }): Promise<APIResponse<EarningsCalendar[]>>;
+    /**
+     * Get stock splits
+     */
+    getStockSplits({ symbol }: {
+        symbol: string;
+    }): Promise<APIResponse<StockSplit[]>>;
+    /**
+     * Get dividend history
+     */
+    getDividendHistory({ symbol }: {
+        symbol: string;
+    }): Promise<APIResponse<StockDividend[]>>;
+}
+
+declare class FinancialEndpoints {
+    private client;
+    constructor(client: FMPClient);
+    /**
+     * Get income statement
+     */
+    getIncomeStatement({ symbol, period, limit, }: FinancialStatementsParams): Promise<APIResponse<FinancialStatement[]>>;
+    /**
+     * Get balance sheet
+     */
+    getBalanceSheet({ symbol, period, limit, }: FinancialStatementsParams): Promise<APIResponse<FinancialStatement[]>>;
+    /**
+     * Get cash flow statement
+     */
+    getCashFlowStatement({ symbol, period, limit, }: FinancialStatementsParams): Promise<APIResponse<FinancialStatement[]>>;
+    /**
+     * Get key metrics
+     */
+    getKeyMetrics({ symbol, period, limit, }: KeyMetricsParams): Promise<APIResponse<KeyMetrics[]>>;
+    /**
+     * Get financial ratios
+     */
+    getFinancialRatios({ symbol, period, limit, }: FinancialRatiosParams): Promise<APIResponse<FinancialRatios[]>>;
+    /**
+     * Get enterprise value
+     */
+    getEnterpriseValue({ symbol, period, limit, }: EnterpriseValueParams): Promise<APIResponse<EnterpriseValue[]>>;
+}
+
+declare class ForexEndpoints {
+    private client;
+    constructor(client: FMPClient);
+    /**
+     * Get real-time forex quote
+     */
+    getQuote(params: ForexQuoteParams): Promise<APIResponse<ForexQuote[]>>;
+    /**
+     * Get historical forex data
+     */
+    getHistoricalPrice(params: ForexHistoricalParams): Promise<APIResponse<HistoricalPriceResponse>>;
+    /**
+     * Get list of all forex pairs
+     * Using the forex-specific endpoint
+     */
+    getForexList(): Promise<APIResponse<ForexPair[]>>;
+    /**
+     * Get forex rates for a specific currency
+     */
+    getForexRates(baseCurrency?: string): Promise<APIResponse<Record<string, number>>>;
+    /**
+     * Get forex rates for all currencies
+     */
+    getAllForexRates(): Promise<APIResponse<Record<string, Record<string, number>>>>;
+}
+
+declare class CryptoEndpoints {
+    private client;
+    constructor(client: FMPClient);
+    /**
+     * Get real-time crypto quote
+     */
+    getQuote(params: CryptoQuoteParams): Promise<APIResponse<CryptoQuote[]>>;
+    /**
+     * Get historical crypto data
+     */
+    getHistoricalPrice(params: CryptoHistoricalParams): Promise<APIResponse<HistoricalPriceResponse>>;
+    /**
+     * Get list of all cryptocurrencies
+     */
+    getCryptoList(): Promise<APIResponse<CryptoCurrency[]>>;
+}
+
+declare class ETFEndpoints {
+    private client;
+    constructor(client: FMPClient);
+    /**
+     * Get real-time ETF quote
+     */
+    getQuote(params: ETFQuoteParams): Promise<APIResponse<ETFQuote[]>>;
+    /**
+     * Get ETF profile
+     */
+    getProfile(params: ETFProfileParams): Promise<APIResponse<ETFProfile[]>>;
+    /**
+     * Get ETF holdings
+     */
+    getHoldings(params: ETFHoldersParams): Promise<APIResponse<ETFHolding[]>>;
+    /**
+     * Get list of all ETFs
+     */
+    getETFList(): Promise<APIResponse<ETFList[]>>;
+}
+
+declare class MutualFundEndpoints {
+    private client;
+    constructor(client: FMPClient);
+    /**
+     * Get real-time mutual fund quote
+     */
+    getQuote(params: MutualFundQuoteParams): Promise<APIResponse<MutualFundQuote[]>>;
+    /**
+     * Get mutual fund profile
+     */
+    getProfile(params: MutualFundProfileParams): Promise<APIResponse<MutualFundProfile[]>>;
+    /**
+     * Get mutual fund holdings
+     */
+    getHoldings(params: MutualFundHoldersParams): Promise<APIResponse<MutualFundHolding[]>>;
+    /**
+     * Get list of all mutual funds
+     */
+    getMutualFundList(): Promise<APIResponse<MutualFundList[]>>;
+}
+
+declare class BondEndpoints {
+    private client;
+    constructor(client: FMPClient);
+    /**
+     * Get real-time bond quote
+     */
+    getQuote(params: BondQuoteParams): Promise<APIResponse<BondQuote[]>>;
+    /**
+     * Get historical bond data
+     */
+    getHistoricalPrice(params: BondHistoricalParams): Promise<APIResponse<HistoricalPriceResponse>>;
+    /**
+     * Get list of all bonds
+     */
+    getBondList(): Promise<APIResponse<BondList[]>>;
+}
+
+declare class EconomicEndpoints {
+    private client;
+    constructor(client: FMPClient);
+    /**
+     * Get treasury rates
+     */
+    getTreasuryRates(params?: TreasuryRateParams): Promise<APIResponse<TreasuryRate[]>>;
+    /**
+     * Get federal funds rate
+     */
+    getFederalFundsRate(params?: FederalFundsRateParams): Promise<APIResponse<FederalFundsRate[]>>;
+    /**
+     * Get CPI data
+     */
+    getCPI(params?: CPIParams): Promise<APIResponse<CPI[]>>;
+    /**
+     * Get GDP data
+     */
+    getGDP(params?: GDPParams): Promise<APIResponse<GDP[]>>;
+    /**
+     * Get unemployment data
+     */
+    getUnemployment(params?: UnemploymentParams): Promise<APIResponse<Unemployment[]>>;
+}
+
+declare class MarketEndpoints {
+    private client;
+    constructor(client: FMPClient);
+    /**
+     * Get market hours
+     */
+    getMarketHours(): Promise<APIResponse<MarketHours>>;
+    /**
+     * Get market performance
+     */
+    getMarketPerformance(): Promise<APIResponse<MarketPerformance[]>>;
+    /**
+     * Get market gainers
+     */
+    getGainers(): Promise<APIResponse<MarketPerformance[]>>;
+    /**
+     * Get market losers
+     */
+    getLosers(): Promise<APIResponse<MarketPerformance[]>>;
+    /**
+     * Get most active stocks
+     */
+    getMostActive(): Promise<APIResponse<MarketPerformance[]>>;
+    /**
+     * Get sector performance
+     */
+    getSectorPerformance(): Promise<APIResponse<MarketSectorPerformance[]>>;
+    /**
+     * Get market index data
+     */
+    getMarketIndex(params?: MarketIndexParams): Promise<APIResponse<MarketIndex[]>>;
+}
+
+/**
+ * Main FMP API client that provides access to all endpoints
+ *
+ * @example
+ * ```typescript
+ * import { FMP } from 'fmp-node-api';
+ *
+ * const fmp = new FMP({ apiKey: 'your-api-key' });
+ *
+ * // Get stock quote
+ * const quote = await fmp.stock.getQuote({ symbol: 'AAPL' });
+ *
+ * // Get financial statements
+ * const incomeStatement = await fmp.financial.getIncomeStatement({
+ *   symbol: 'AAPL',
+ *   period: 'annual'
+ * });
+ *
+ * // Get forex data
+ * const forexQuote = await fmp.forex.getQuote({ symbol: 'EURUSD' });
+ * ```
+ */
+declare class FMP {
+    readonly stock: StockEndpoints;
+    readonly financial: FinancialEndpoints;
+    readonly forex: ForexEndpoints;
+    readonly crypto: CryptoEndpoints;
+    readonly etf: ETFEndpoints;
+    readonly mutualFund: MutualFundEndpoints;
+    readonly bond: BondEndpoints;
+    readonly economic: EconomicEndpoints;
+    readonly market: MarketEndpoints;
+    constructor(config: FMPConfig);
+    /**
+     * Get the underlying client instance for advanced usage
+     */
+    getClient(): FMPClient;
+}
+
+/**
+ * Validate date format (YYYY-MM-DD)
+ */
+declare function validateDate(date: string): void;
+/**
+ * Validate period parameter
+ */
+declare function validatePeriod(period: string): void;
+/**
+ * Validate limit parameter
+ */
+declare function validateLimit(limit: number): void;
+/**
+ * Validate page parameter
+ */
+declare function validatePage(page: number): void;
+
+/**
+ * Format currency value
+ */
+declare function formatCurrency(value: number, currency?: string): string;
+/**
+ * Format percentage value
+ */
+declare function formatPercentage(value: number, decimals?: number): string;
+/**
+ * Format large numbers with K, M, B suffixes
+ */
+declare function formatLargeNumber(value: number): string;
+/**
+ * Format date to YYYY-MM-DD
+ */
+declare function formatDate(date: Date | string): string;
+/**
+ * Format date to readable format
+ */
+declare function formatReadableDate(date: Date | string): string;
+/**
+ * Format timestamp to readable format
+ */
+declare function formatTimestamp(timestamp: number): string;
+/**
+ * Format number with specified decimal places
+ */
+declare function formatNumber(value: number, decimals?: number): string;
+/**
+ * Format volume with appropriate units
+ */
+declare function formatVolume(volume: number): string;
+
+declare const DEFAULT_TIMEOUT = 10000;
+declare const DEFAULT_LIMIT = 100;
+declare const MAX_LIMIT = 1000;
+declare const PERIODS: {
+    readonly ANNUAL: "annual";
+    readonly QUARTER: "quarter";
+};
+declare const EXCHANGES: {
+    readonly NYSE: "NYSE";
+    readonly NASDAQ: "NASDAQ";
+    readonly AMEX: "AMEX";
+    readonly TSX: "TSX";
+    readonly LSE: "LSE";
+    readonly ASX: "ASX";
+    readonly NSE: "NSE";
+    readonly BSE: "BSE";
+};
+declare const SECTORS: {
+    readonly TECHNOLOGY: "Technology";
+    readonly HEALTHCARE: "Healthcare";
+    readonly FINANCIAL: "Financial";
+    readonly CONSUMER_DISCRETIONARY: "Consumer Discretionary";
+    readonly CONSUMER_STAPLES: "Consumer Staples";
+    readonly INDUSTRIALS: "Industrials";
+    readonly ENERGY: "Energy";
+    readonly MATERIALS: "Materials";
+    readonly UTILITIES: "Utilities";
+    readonly REAL_ESTATE: "Real Estate";
+    readonly COMMUNICATION_SERVICES: "Communication Services";
+};
+declare const COUNTRIES: {
+    readonly US: "US";
+    readonly CA: "CA";
+    readonly GB: "GB";
+    readonly AU: "AU";
+    readonly IN: "IN";
+    readonly DE: "DE";
+    readonly FR: "FR";
+    readonly JP: "JP";
+    readonly CN: "CN";
+    readonly BR: "BR";
+};
+declare const ERROR_MESSAGES: {
+    readonly API_KEY_REQUIRED: "API key is required";
+    readonly SYMBOL_REQUIRED: "Symbol is required";
+    readonly INVALID_SYMBOL: "Invalid symbol format";
+    readonly INVALID_DATE: "Invalid date format. Use YYYY-MM-DD";
+    readonly INVALID_PERIOD: "Period must be either \"annual\" or \"quarter\"";
+    readonly INVALID_LIMIT: "Limit must be between 1 and 1000";
+    readonly INVALID_PAGE: "Page must be a non-negative number";
+    readonly REQUEST_FAILED: "Request failed";
+    readonly RATE_LIMIT_EXCEEDED: "Rate limit exceeded";
+    readonly UNAUTHORIZED: "Unauthorized - Invalid API key";
+    readonly NOT_FOUND: "Resource not found";
+};
+declare const HTTP_STATUS: {
+    readonly OK: 200;
+    readonly CREATED: 201;
+    readonly BAD_REQUEST: 400;
+    readonly UNAUTHORIZED: 401;
+    readonly FORBIDDEN: 403;
+    readonly NOT_FOUND: 404;
+    readonly TOO_MANY_REQUESTS: 429;
+    readonly INTERNAL_SERVER_ERROR: 500;
+};
+
+declare class FMPError extends Error {
+    status?: number | undefined;
+    code?: string | undefined;
+    constructor(message: string, status?: number | undefined, code?: string | undefined);
+}
+declare function validateApiKey(apiKey: string): void;
+declare function validateSymbol(symbol: string): void;
+declare const FMP_BASE_URL = "https://financialmodelingprep.com/api/v3";
+declare const FMP_BASE_URL_V4 = "https://financialmodelingprep.com/api/v4";
+declare enum Period {
+    ANNUAL = "annual",
+    QUARTER = "quarter"
+}
+declare enum Exchange {
+    NYSE = "NYSE",
+    NASDAQ = "NASDAQ",
+    AMEX = "AMEX",
+    TSX = "TSX",
+    LSE = "LSE"
+}
+
+export { type APIResponse, type AnalystEstimate, type BalanceSheet, type BalanceSheetParams, BondEndpoints, type BondHistoricalParams, type BondList, type BondListParams, type BondQuote, type BondQuoteParams, COUNTRIES, type CPI, type CPIParams, type CashFlowParams, type CashFlowStatement, type CompanyProfile, type CompanyValuationParams, type CryptoCurrency, CryptoEndpoints, type CryptoHistoricalParams, type CryptoListParams, type CryptoQuote, type CryptoQuoteParams, DEFAULT_LIMIT, DEFAULT_TIMEOUT, type DateRangeParams, ERROR_MESSAGES, ETFEndpoints, type ETFHoldersParams, type ETFHolding, type ETFList, type ETFListParams, type ETFProfile, type ETFProfileParams, type ETFQuote, type ETFQuoteParams, EXCHANGES, type EarningsCalendar, EconomicEndpoints, type EconomicIndicator, type EconomicIndicatorParams, type EnterpriseValue, type EnterpriseValueParams, type ErrorResponse, Exchange, FMP, FMPClient, type FMPConfig, FMPError, FMP_BASE_URL, FMP_BASE_URL_V4, FMP_STABLE_URL, type FederalFundsRate, type FederalFundsRateParams, FinancialEndpoints, type FinancialGrowthParams, type FinancialRatios, type FinancialRatiosParams, type FinancialStatement, type FinancialStatementsParams, ForexEndpoints, type ForexHistoricalParams, type ForexListParams, type ForexPair, type ForexQuote, type ForexQuoteParams, type GDP, type GDPParams, HTTP_STATUS, type HistoricalPriceData, type HistoricalPriceResponse, type IncomeStatement, type IncomeStatementParams, type InsiderTrading, type InstitutionalHolder, type KeyMetrics, type KeyMetricsParams, MAX_LIMIT, type MajorHolder, type MarketCap, MarketEndpoints, type MarketGainersParams, type MarketHours, type MarketHoursParams, type MarketIndex, type MarketIndexParams, type MarketLosersParams, type MarketMostActiveParams, type MarketPerformance, type MarketPerformanceParams, type MarketSectorPerformance, type MarketSectorPerformanceParams, MutualFundEndpoints, type MutualFundHolder, type MutualFundHoldersParams, type MutualFundHolding, type MutualFundList, type MutualFundListParams, type MutualFundProfile, type MutualFundProfileParams, type MutualFundQuote, type MutualFundQuoteParams, PERIODS, type PaginationParams, Period, type PeriodParams, type PriceTarget, type QueryParams, type Quote, SECTORS, type SectorPerformance, type StockAnalystEstimatesParams, type StockDividend, type StockDividendParams, type StockEarningsCalendarParams, StockEndpoints, type StockGainersParams, type StockGrade, type StockGradeParams, type StockHistoricalPriceData, type StockHistoricalPriceParams, type StockHistoricalPriceResponse, type StockInsiderTradingParams, type StockInstitutionalHoldersParams, type StockList, type StockLosersParams, type StockMajorHoldersParams, type StockMarketCapParams, type StockMostActiveParams, type StockMutualFundHoldersParams, type StockPriceTargetParams, type StockProfileParams, type StockQuote, type StockQuoteParams, type StockRating, type StockRatingParams, type StockSectorPerformanceParams, type StockSplit, type StockSplitsParams, type SuccessResponse, type SymbolParams, type TreasuryRate, type TreasuryRateParams, type Unemployment, type UnemploymentParams, formatCurrency, formatDate, formatLargeNumber, formatNumber, formatPercentage, formatReadableDate, formatTimestamp, formatVolume, validateApiKey, validateDate, validateLimit, validatePage, validatePeriod, validateSymbol };