openapi: 3.2.0 info: title: Finage Market Data Fundamentals API description: Finage is a real-time and historical market data provider covering US and global stocks, forex, cryptocurrencies, indices, ETFs, bonds, and company fundamentals. This OpenAPI was generated by API Evangelist from Finage's own machine-readable docs database (https://api.finage.co.uk/op/v1/endpoints/list — the same JSON the docs at https://finage.co.uk/docs/api render); every path, parameter, and example comes from that source. All endpoints are read-only GET requests authenticated with an apikey query parameter. Responses must be requested with gzip Accept-Encoding (the API returns 406 "GZip compression required" otherwise). version: 1.0.0 contact: name: Finage Support email: support@finage.co.uk url: https://finage.co.uk x-apievangelist: generated: '2026-07-22' method: generated source: https://api.finage.co.uk/op/v1/endpoints/list servers: - url: https://api.finage.co.uk security: - apiKey: [] tags: - name: Fundamentals paths: /symbol-list/{type}: get: operationId: fullSymbolListApi summary: Full Symbol List API description: 'You can download and view our symbols and get more details from the symbols page. If you want to get the all symbols with one endpoint, this endpoint will be useful in your product. You can use our search endpoints to search one or more specific tickers. Forex and Crypto pages include 500 symbols, US Market pages include 2500 symbols.' tags: - Fundamentals parameters: - name: type in: path required: true description: Market type (us-stock, ca-stock, in-stock, ru-stock, forex, crypto, index) schema: type: string - name: page in: query required: false description: Default page is 1 schema: type: string - name: search in: query required: false description: 'You can search symbol or name by this query. (eg: BTC, or Bitcoin) [Optional]' schema: type: string responses: '200': description: Full Symbol List API response. content: application/json: schema: type: object properties: page: type: integer description: Page number symbols: type: string description: Symbol Descripiton example: page: 1 symbols: - symbol: AEDAUD name: 'United Arab Emirates dirham - Australian dollar ' - symbol: AEDBHD name: 'United Arab Emirates dirham - Bahraini dinar ' - symbol: AEDCAD name: 'United Arab Emirates dirham - Canadian dollar ' '401': $ref: '#/components/responses/Unauthorized' /news/market/{symbol}: get: operationId: marketNewsApi summary: Market News API description: We provide you the latest market news via the Market News API. tags: - Fundamentals parameters: - name: symbol in: path required: true description: Stock symbol name schema: type: string - name: limit in: query required: false description: Limit of the news. Default is 10 and maximum allowed limit is 30. schema: type: string responses: '200': description: Market News API response. content: application/json: schema: type: object properties: ticker: type: string description: Ticker name limit: type: integer description: Limit amount news: type: array items: {} description: News source: type: string description: Title of News title: type: string description: Description of News description: type: string description: Url Address url: type: string description: News Source date: type: string description: Date of News example: ticker: AMZN limit: 10 news: - source: Seeking Alpha title: Six Amazon warehouse workers confirmed dead after tornado strike description: At least 30 tornados teared across six U.S. states on Friday and early Saturday morning, with some even causing paths of destruction over 200 miles long url: https://seekingalpha.com/news/3779358-six-amazon-warehouse-workers-confirmed-dead-after-tornado-strike date: '2021-12-12T09:42:07.000Z' - source: Reuters title: Six dead, no hope of more survivors after tornadoes destroy Amazon warehouse near St Louis description: Six Amazon.com Inc workers were confirmed dead on Saturday after a series of tornadoes roared through a warehouse near St. Louis, ripping off its roof and causing 11-inch thick concrete walls longer than football fields to collapse on themselves. url: https://www.reuters.com/article/us-usa-illinois-accident/six-dead-no-hope-of-more-survivors-after-tornadoes-destroy-amazon-warehouse-near-st-louis-idUSKBN2IQ03Z date: '2021-12-12T02:35:44.000Z' '401': $ref: '#/components/responses/Unauthorized' /news/forex/{symbol}: get: operationId: forexNewsApi summary: Forex News API description: By using our Forex News API, you can get the latest news about the currencies and the countries which is using the selected currency. tags: - Fundamentals parameters: - name: symbol in: path required: true description: Forex symbol name schema: type: string - name: limit in: query required: false description: Limit of the news. Default is 10 and maximum allowed limit is 30. schema: type: string responses: '200': description: Forex News API response. content: application/json: schema: type: object properties: ticker: type: string description: Ticker Name limit: type: integer description: Limit amount news: type: array items: {} description: News title: type: string description: Title of News description: type: string description: Description of News url: type: string description: Url Address source: type: string description: News Source date: type: string description: Date of News example: ticker: GBP limit: 10 news: - title: United Kingdom 5 Year Note Yield description: UK 5 Year Bond Yield was 0.33 percent on Thursday June 10, according to over-the-counter interbank yield quotes for this government bond maturity. Historically, the United Kingdom 5 Year Note Yield reached an all time high of 13.58 in May of 1990. url: https://tradingeconomics.com/united-kingdom/5-year-note-yield source: Trading Economics date: '2021-06-10T19:17:00' '401': $ref: '#/components/responses/Unauthorized' /news/cryptocurrency/{symbol}: get: operationId: cryptoNewsApi summary: Crypto News API description: Finage's Crypto News API is the fastest crypto news API in the market. Our In-Memory Cache Engine will cache the old news according to the request frequency. It will help you to build faster websites and applications. Your customers will have a quick access without waiting for the news to load. tags: - Fundamentals parameters: - name: symbol in: path required: true description: Crypto symbol name [Eg. BTC, ETH, DOGE] schema: type: string - name: limit in: query required: false description: Limit of the news. Default is 10 and maximum allowed limit is 30. schema: type: string responses: '200': description: Crypto News API response. content: application/json: schema: type: object properties: ticker: type: string description: Ticker Name limit: type: integer description: Limit amount news: type: string description: News title: type: string description: Title of News description: type: string description: Description of News url: type: string description: Url Address source: type: string description: News Source date: type: string description: Date of News example: ticker: BTC limit: 10 news: - title: 'The Grayscale Bitcoin Trust on Track to Surpass the Largest Gold ETF: Bloomberg' description: The massive BTC price surge and the ongoing institutional adoption could help the Grayscale Bitcoin Trust surpass the largest commodity ETF soon. url: https://cryptopotato.com/the-grayscale-bitcoin-trust-on-track-to-surpass-the-largest-gold-etf-bloomberg/ source: CryptoPotato date: '2021-04-17T12:41:00+00:00' - title: 'On-Chain Analysis: This Is not What the Bitcoin Top Looks Like' description: In today's on-chain analysis, we are trying to answer the question of whether there are reasons to fear the ending of the ongoing Bitcoin bull run. We are looking at the activity of long-term hodlers who stopped selling their coins again in the last week. url: https://beincrypto.com/on-chain-analysis-this-is-not-what-the-bitcoin-top-looks-like/ source: BeInCrypto date: '2021-04-17T12:30:00+00:00' '401': $ref: '#/components/responses/Unauthorized' /marketstatus: get: operationId: marketStatusApi summary: Market Status API description: Market Status API is an endpoint that shows the market, forex and crypto statuses. You can check the market is closed, open or in extended hours with our Market Status API. tags: - Fundamentals parameters: - name: country in: query required: false description: Check the specified country's market status. Default is US schema: type: string - name: currencies in: query required: false description: You can display or hide currencies part from the output. Default is true. schema: type: string - name: holidays in: query required: false description: Display selected country's holidays. Default is false schema: type: string - name: trading_hours in: query required: false description: Display trading hours of the market. Default is false schema: type: string - name: extended_hours in: query required: false description: Display extended hours of the market. Default is false schema: type: string responses: '200': description: Market Status API response. content: application/json: schema: type: object properties: market: type: string description: Market Status timezone: type: string description: Timezone country: type: string description: Country Short Code exchanges: type: array items: {} description: Exchanges List currencies: type: array items: {} description: Currency Market List example: market: open timezone: UTC-05:00 country: US exchanges: nyse: open nasdaq: open otc: open currencies: fx: open crypto: open '401': $ref: '#/components/responses/Unauthorized' /fnd/economic-calendar: get: operationId: economicCalendar summary: Economic Calendar description: 'Our Economic Calendar API will show you the previous and the future events. Choose the from and to dates to receive a certain range of events. In the economic calendar actual, previous, change, changePercentage or estimate value could be null according to the event or date of the event.' tags: - Fundamentals parameters: - name: from in: query required: true description: Start date schema: type: string - name: to in: query required: true description: End date schema: type: string responses: '200': description: Economic Calendar response. content: application/json: schema: type: object properties: event: type: string description: Event Name date: type: string description: Date of Event country: type: string description: County Short Code countryFlag: type: string description: Country Flag Image actual: type: number description: Actual Value previous: type: number description: Previous Value change: type: number description: Change Amount changePercentage: type: number description: Change Percentage estimate: type: number description: Estimate Amount example: - event: Personal Consumption Expenditures - Price Index (YoY) date: '2020-10-30 12:30:00' country: US countryFlag: https://finage.s3.eu-west-2.amazonaws.com/flags/160x120/us.png actual: 1.4 previous: 1.3 change: 0.1 changePercentage: 7.692 estimate: 1.3 - event: Core Personal Consumption Expenditure - Price Index (MoM) date: '2020-10-30 12:30:00' country: US countryFlag: https://finage.s3.eu-west-2.amazonaws.com/flags/160x120/us.png actual: 0.2 previous: 0.3 change: -0.1 changePercentage: 33.333 estimate: 0.2 '401': $ref: '#/components/responses/Unauthorized' /fnd/earning-calendar: get: operationId: earningsCalendar summary: Earnings Calendar description: 'Our Earnings Calendar API will show you the earnings release for companies. In the earnings calendar eps, estimated_eps, revenue, or estimated_revenue value could be null according to the event or date of the event.' tags: - Fundamentals responses: '200': description: Earnings Calendar response. content: application/json: schema: type: object properties: symbol: type: string description: Symbol Name eps: type: number description: EPS value estimated_eps: type: number description: Estimated EPS revenue: type: number description: Revenue Amount estimated_revenue: type: integer description: Estimated Revenue Amount time: type: string description: Time date: type: string description: Date example: - symbol: XOG eps: null estimated_eps: 2.72 revenue: 0 estimated_revenue: 219400000 time: bmo date: '2021-11-08' - symbol: CANSF eps: null estimated_eps: null revenue: 0 estimated_revenue: 0 time: bmo date: '2021-11-08' '401': $ref: '#/components/responses/Unauthorized' /fnd/ipo-calendar: get: operationId: ipoCalendar summary: IPO Calendar description: 'Our IPO Calendar API will show you the recent and upcoming IPOs. In the IPO calendar shares, price_range, market_cap, value could be null according to the event or date of the event.' tags: - Fundamentals parameters: - name: from in: query required: true description: Start date schema: type: string - name: to in: query required: true description: End date schema: type: string responses: '200': description: IPO Calendar response. content: application/json: schema: type: object properties: symbol: type: string description: Symbol Name date: type: string description: Date exchange: type: string description: Exchange status: type: string description: Status of Stock shares: type: integer description: Shares Amount price_range: type: string description: Price Range market_cap: type: integer description: Market Cap Value company: type: string description: Company Name example: - symbol: JAB.P.V date: '2020-12-16' exchange: TSXV status: Priced shares: 1350000 price_range: 0.11 - 0.11 market_cap: 148500 company: Jabbo Capital Corp '401': $ref: '#/components/responses/Unauthorized' /fnd/stock-split-calendar: get: operationId: stockSplitCalendar summary: Stock Split Calendar description: Our Stock Split API will show you the splits data. tags: - Fundamentals parameters: - name: from in: query required: true description: Start date schema: type: string - name: to in: query required: true description: End date schema: type: string responses: '200': description: Stock Split Calendar response. content: application/json: schema: type: object properties: symbol: type: string description: Symbol Name numerator_factor: type: integer description: Numerator Factor denominator_factor: type: integer description: Denomiator Factor Value label: type: string description: Date Label date: type: string description: Date example: - symbol: PILANIINVS.NS numerator_factor: 7 denominator_factor: 5 label: December 31, 20 date: '2020-12-31' - symbol: AMRH numerator_factor: 1 denominator_factor: 4 label: December 31, 20 date: '2020-12-31' '401': $ref: '#/components/responses/Unauthorized' /fnd/historical-stock-splits/AAPL: get: operationId: historicalStockSplitCalendar summary: Historical Stock Split Calendar description: Our Historical Stock Split API will show you the splits data for a specific company. tags: - Fundamentals parameters: - name: symbol in: query required: true description: Stock symbol name schema: type: string responses: '200': description: Historical Stock Split Calendar response. content: application/json: schema: type: object properties: numerator_factor: type: integer description: Numerator Factor denominator_factor: type: integer description: Denominator Factor label: type: string description: Label Date date: type: string description: Date example: - numerator_factor: 4 denominator_factor: 1 label: August 31, 20 date: '2020-08-31' - numerator_factor: 7 denominator_factor: 1 label: June 09, 14 date: '2014-06-09' - numerator_factor: 2 denominator_factor: 1 label: February 28, 05 date: '2005-02-28' '401': $ref: '#/components/responses/Unauthorized' /fnd/dividend-calendar: get: operationId: dividendsCalendar summary: Dividends Calendar description: Our Dividends API will show you the dividend data for stocks going back 30 years. tags: - Fundamentals parameters: - name: from in: query required: true description: Start date schema: type: string - name: to in: query required: true description: End date schema: type: string responses: '200': description: Dividends Calendar response. content: application/json: schema: type: object properties: symbol: type: string description: Symbol Name label: type: string description: Label Date adj_dividend: type: number description: Adj Dividend Value date: type: string description: Date example: - symbol: BLSR.TA label: January 10, 21 adj_dividend: 517.912 date: '2021-01-10' - symbol: 7200.SR label: January 10, 21 adj_dividend: 0.88 date: '2021-01-10' - symbol: GORO label: January 08, 21 adj_dividend: 0.003 date: '2021-01-08' '401': $ref: '#/components/responses/Unauthorized' /fnd/historical-dividends/AAPL: get: operationId: historicalDividendsCalendar summary: Historical Dividends Calendar description: Our Historical Dividends API will show you the dividends data for a specific company. tags: - Fundamentals parameters: - name: symbol in: query required: true description: Stock symbol name schema: type: string responses: '200': description: Historical Dividends Calendar response. content: application/json: schema: type: object properties: label: type: string description: Label Date adj_dividend: type: number description: Adj Dividend Value dividend: type: number description: Dividend Value record_date: type: string description: Record Date payment_date: type: string description: Payment Date declaration_date: type: string description: Declaration Date date: type: string description: Date example: - label: November 05, 21 adj_dividend: 0.22 dividend: 0.22 record_date: '2021-11-08' payment_date: '2021-11-11' declaration_date: '2021-10-28' date: '2021-11-05' - label: August 06, 21 adj_dividend: 0.22 dividend: 0.22 record_date: '2021-08-09' payment_date: '2021-08-12' declaration_date: '2021-07-27' date: '2021-08-06' '401': $ref: '#/components/responses/Unauthorized' /fnd/delisted-companies: get: operationId: delistedCompanies summary: Delisted Companies description: Our Delisted Companies API will show you the companies delisted from exchanges. tags: - Fundamentals parameters: - name: limit in: query required: false description: Limit of the results. Default is 50. schema: type: string responses: '200': description: Delisted Companies response. content: application/json: schema: type: object properties: symbol: type: string description: Symbol Name company_name: type: string description: Company Name exchange: type: string description: Exchange Name ipo_date: type: string description: IPO Date delisted_date: type: string description: Delisted Date example: - symbol: CEO company_name: Cnooc Ltd exchange: NYSE ipo_date: '2001-02-27' delisted_date: '2021-11-05' '401': $ref: '#/components/responses/Unauthorized' /fnd/cash-flow-statement/{symbol}: get: operationId: cashFlowStatements summary: Cash Flow Statements description: Cash flow statements of the U.S. companies. tags: - Fundamentals parameters: - name: symbol in: path required: true description: US Stock symbol schema: type: string - name: limit in: query required: false description: Response limit schema: type: string - name: period in: query required: false description: Time period. Default is annual. [annual, quarter] schema: type: string responses: '200': description: Cash Flow Statements response. content: application/json: schema: type: object properties: date: type: string description: Date symbol: type: string description: Stock Symbol fillingDate: type: string description: Filling Date acceptedDate: type: string description: Accept Date period: type: string description: Period netIncome: type: integer description: Net Income depreciationAndAmortization: type: integer description: Depreciation And Amortization deferredIncomeTax: type: integer description: Deferred Income Tax stockBasedCompensation: type: integer description: Stock Based Compensation changeInWorkingCapital: type: integer description: Change In Working Capital accountsReceivables: type: integer description: Accounts Receivables inventory: type: integer description: Inventory accountsPayables: type: integer description: Accounts Payables otherWorkingCapital: type: integer description: Other Working Capital otherNonCashItems: type: integer description: Other Non Cash Items netCashProvidedByOperatingActivities: type: integer description: Net Cash Provided By Operating Activities investmentsInPropertyPlantAndEquipment: type: integer description: Investments In Property Plant And Equipment acquisitionsNet: type: integer description: Acquisitions Net purchasesOfInvestments: type: integer description: Purchases Of Investments salesMaturitiesOfInvestments: type: integer description: Sales Maturities Of Investments otherInvestingActivites: type: integer description: Other Investing Activities netCashUsedForInvestingActivites: type: integer description: Net Cash Used For Investing Activities debtRepayment: type: integer description: Debt Repayment commonStockIssued: type: integer description: Common Stock Issued commonStockRepurchased: type: integer description: Common Stock Repurchased dividendsPaid: type: integer description: Dividends Paid otherFinancingActivites: type: integer description: Other Financing Activites netCashUsedProvidedByFinancingActivities: type: integer description: Net Cash Used Provided By Financing Activities effectOfForexChangesOnCash: type: integer description: Effect Of Forex Changes On Cash netChangeInCash: type: integer description: Net Change In Cash cashAtEndOfPeriod: type: integer description: Cash At End Of Period cashAtBeginningOfPeriod: type: integer description: Cash At BeginningOf Period operatingCashFlow: type: integer description: Operating Cash Flow capitalExpenditure: type: integer description: Capital Expenditure freeCashFlow: type: integer description: Free Cash Flow link: type: string description: Link finalLink: type: string description: Final Link example: - date: '2020-09-26' symbol: AAPL fillingDate: '2020-10-30' acceptedDate: '2020-10-29 18:06:25' period: FY netIncome: 57411000000 depreciationAndAmortization: 11056000000 deferredIncomeTax: -215000000 stockBasedCompensation: 6829000000 changeInWorkingCapital: -18780000000 accountsReceivables: 6917000000 inventory: -127000000 accountsPayables: -4062000000 otherWorkingCapital: 38321000000 otherNonCashItems: 0 netCashProvidedByOperatingActivities: 80674000000 investmentsInPropertyPlantAndEquipment: -7309000000 acquisitionsNet: -1524000000 purchasesOfInvestments: -114938000000 salesMaturitiesOfInvestments: 0 otherInvestingActivites: 0 netCashUsedForInvestingActivites: -4289000000 debtRepayment: -12629000000 commonStockIssued: 880000000 commonStockRepurchased: -72358000000 dividendsPaid: -14081000000 otherFinancingActivites: 0 netCashUsedProvidedByFinancingActivities: -86820000000 effectOfForexChangesOnCash: 0 netChangeInCash: -10435000000 cashAtEndOfPeriod: 39789000000 cashAtBeginningOfPeriod: 50224000000 operatingCashFlow: 80674000000 capitalExpenditure: 7309000000 freeCashFlow: 73365000000 link: https://www.sec.gov/Archives/edgar/data/320193/000032019320000096/0000320193-20-000096-index.htm finalLink: https://www.sec.gov/Archives/edgar/data/320193/000032019320000096/aapl-20200926.htm '401': $ref: '#/components/responses/Unauthorized' /fnd/balance-sheet-statements/{symbol}: get: operationId: balanceSheetStatements summary: Balance Sheet Statements description: Balance sheet statements of the U.S. companies. tags: - Fundamentals parameters: - name: symbol in: path required: true description: US Stock symbol schema: type: string - name: limit in: query required: true description: Response limit schema: type: string - name: period in: query required: true description: Time period. Default is annual. [annual, quarter] schema: type: string responses: '200': description: Balance Sheet Statements response. content: application/json: schema: type: object properties: date: type: string description: Date symbol: type: string description: Stock Symbol fillingDate: type: string description: Filling Date acceptedDate: type: string description: Accepted Date period: type: string description: Period of Statement cashAndCashEquivalents: type: integer description: Cash And Cash Equivalents shortTermInvestments: type: integer description: Short Term Investment cashAndShortTermInvestments: type: integer description: Cash And Short Term Investments netReceivables: type: integer description: Net Receivables inventory: type: integer description: Inventory otherCurrentAssets: type: integer description: Other Current Assets totalCurrentAssets: type: integer description: Total Current Assets propertyPlantEquipmentNet: type: integer description: Property Plant Equipment Net goodwill: type: integer description: Goodwill intangibleAssets: type: integer description: Intangible Assets goodwillAndIntangibleAssets: type: integer description: Goodwill And Intangible Assets doubleTermInvestments: type: integer description: Double TermInvestments taxAssets: type: integer description: Tax Assets otherNonCurrentAssets: type: integer description: Other Non Current Assets totalNonCurrentAssets: type: integer description: Total Non Current Assets otherAssets: type: integer description: Other Assets totalAssets: type: integer description: Total Assets accountPayables: type: integer description: Account Payables shortTermDebt: type: integer description: Short Term Debt taxPayables: type: integer description: Tax Payables deferredRevenue: type: integer description: Deferred Revenue otherCurrentLiabilities: type: integer description: Other Current Liabilities totalCurrentLiabilities: type: integer description: Total Current Liabilities doubleTermDebt: type: integer description: Double Term Debt deferredRevenueNonCurrent: type: integer description: deferredRevenueNonCurrent deferredTaxLiabilitiesNonCurrent: type: integer description: Deferred Tax Liabilities Non Current otherNonCurrentLiabilities: type: integer description: Other Non Curren tLiabilities totalNonCurrentLiabilities: type: integer description: Total Non Current Liabilities otherLiabilities: type: integer description: Other Liabilities totalLiabilities: type: integer description: Total Liabilities commonStock: type: integer description: Common Stock retainedEarnings: type: integer description: Retained Earnings accumulatedOtherComprehensiveIncomeLoss: type: integer description: Accumulated Other Comprehensive Income Loss othertotalStockholdersEquity: type: integer description: Othertotal Stockholders Equity totalStockholdersEquity: type: integer description: Total Stockholders Equity totalLiabilitiesAndStockholdersEquity: type: integer description: Total Liabilities And Stockholders Equity totalInvestments: type: integer description: Total Investments totalDebt: type: integer description: Total Debt netDebt: type: integer description: Net Debt link: type: string description: Link finalLink: type: string description: Final Link example: - date: '2020-09-26' symbol: AAPL filingDate: '2020-10-30' acceptedDate: '2020-10-29 18:06:25' period: FY cashAndCashEquivalents: 38016000000 shortTermInvestments: 52927000000 cashAndShortTermInvestments: 90943000000 netReceivables: 16120000000 inventory: 4061000000 otherCurrentAssets: 32589000000 totalCurrentAssets: 143713000000 propertyPlantEquipmentNet: 36766000000 goodwill: 0 intangibleAssets: 0 goodwillAndIntangibleAssets: 0 longTermInvestments: 0 taxAssets: 0 otherNonCurrentAssets: 42522000000 totalNonCurrentAssets: 180175000000 otherAssets: 90482000000 totalAssets: 323888000000 accountPayables: 42296000000 shortTermDebt: 8773000000 taxPayables: 0 deferredRevenue: 6643000000 otherCurrentLiabilities: 47680000000 totalCurrentLiabilities: 105392000000 longTermDebt: 0 deferredRevenueNonCurrent: 0 deferredTaxLiabilitiesNonCurrent: 0 otherNonCurrentLiabilities: 54490000000 totalNonCurrentLiabilities: 153157000000 otherLiabilities: 0 totalLiabilities: 258549000000 commonStock: 16976763000 retainedEarnings: 14966000000 accumulatedOtherComprehensiveIncomeLoss: -406000000 totalStockholdersEquity: 65339000000 totalLiabilitiesAndStockholdersEquity: 323888000000 totalInvestments: 153814000000 totalDebt: 107440000000 netDebt: 69424000000 link: https://www.sec.gov/Archives/edgar/data/320193/000032019320000096/0000320193-20-000096-index.htm finalLink: https://www.sec.gov/Archives/edgar/data/320193/000032019320000096/aapl-20200926.htm '401': $ref: '#/components/responses/Unauthorized' /fnd/income-statement/{symbol}: get: operationId: incomeStatements summary: Income Statements description: Income statements of the U.S. companies. tags: - Fundamentals parameters: - name: symbol in: path required: true description: US Stock symbol schema: type: string - name: limit in: query required: true description: Response limit schema: type: string - name: period in: query required: true description: Time period. Default is annual. annual, quarter schema: type: string responses: '200': description: Income Statements response. content: application/json: schema: type: object properties: date: type: string description: Date symbol: type: string description: Stock Symbol fillingDate: type: string description: Filling Date acceptedDate: type: string description: Accepted Date period: type: string description: Period revenue: type: integer description: Revenue costOfRevenue: type: integer description: Cost Of Revenue grossProfit: type: integer description: Gross Profit grossProfitRatio: type: integer description: Gross Profit Ratio researchAndDevelopmentExpenses: type: integer description: Research And Development Expenses generalAndAdministrativeExpenses: type: integer description: General And Administrative Expenses sellingAndMarketingExpenses: type: integer description: Selling And Marketing Expenses otherExpenses: type: integer description: Other Expenses operatingExpenses: type: integer description: Operating Expenses costAndExpenses: type: integer description: Cost And Expenses interestExpense: type: integer description: Interest Expense depreciationAndAmortization: type: integer description: Depreciation And Amortization ebitda: type: integer description: Ebitda ebitdaratio: type: integer description: Ebitda Ratio operatingIncome: type: integer description: Operating Income operatingIncomeRatio: type: integer description: Operating Income Ratio totalOtherIncomeExpensesNet: type: integer description: Total Other Income Expenses Net incomeBeforeTax: type: integer description: Income Before Tax incomeBeforeTaxRatio: type: integer description: Income Before Tax Ratio incomeTaxExpense: type: integer description: Income Tax Expense netIncome: type: integer description: Net Income netIncomeRatio: type: integer description: Net Income Ratio eps: type: integer description: Eps epsdiluted: type: integer description: Eps Diluted weightedAverageShsOut: type: integer description: Weighted Average Shs Out weightedAverageShsOutDil: type: integer description: Weighted Average Shs Out Dil link: type: string description: Link finalLink: type: string description: Final Link example: - date: '2020-09-26' symbol: AAPL filingDate: '2020-10-30' acceptedDate: '2020-10-29 18:06:25' period: Q4 revenue: 64698000000 costOfRevenue: 40009000000 grossProfit: 24689000000 grossProfitRatio: 0.38160375900337 researchAndDevelopmentExpenses: 4978000000 generalAndAdministrativeExpenses: 4936000000 sellingAndMarketingExpenses: 0 otherExpenses: 126000000 operatingExpenses: 9914000000 costAndExpenses: 49923000000 interestExpense: 0 depreciationAndAmortization: 2702000000 ebitda: 17477000000 ebitdaRatio: 0.270131997897926 operatingIncome: 14775000000 operatingIncomeRatio: 0.228368728554206 totalOtherIncomeExpensesNet: 126000000 incomeBeforeTax: 14901000000 incomeBeforeTaxRatio: 0.230316238523602 incomeTaxExpense: 2228000000 netIncome: 12673000000 netIncomeRatio: 0.195879316207611 eps: 0.73 epsDiluted: 0.73 weightedAverageShsOut: 17352119000 weightedAverageShsOutDil: 17528214000 link: https://www.sec.gov/Archives/edgar/data/320193/000032019320000096/0000320193-20-000096-index.htm finalLink: https://www.sec.gov/Archives/edgar/data/320193/000032019320000096/aapl-20200926.htm '401': $ref: '#/components/responses/Unauthorized' /fnd/income-statement/{symbol.exchange_code}: get: operationId: internationalFilings summary: International Filings description: 'Income statements for International companies. UK Stock Market: L Canadian Stock Market: TO Russian Stock Market: ME Indian Stock Market: NS Hong Kong Stock Market: HK Germany Stock Market: DE European Stock Market: PA Norway Stock Market: OL Australian Stock Market: AX Swiss Stock Market: SW' tags: - Fundamentals parameters: - name: symbol.exchange_code in: path required: true description: '' schema: type: string - name: symbol in: query required: true description: International Stock symbol schema: type: string - name: exchange_code in: query required: true description: International Stock Exchanges schema: type: string - name: period in: query required: true description: Time period. Default is annual. [annual, quarter] schema: type: string - name: limit in: query required: true description: Response limit schema: type: string responses: '200': description: International Filings response. content: application/json: schema: type: object properties: date: type: string description: Date symbol: type: integer description: Stock Symbol fillingDate: type: integer description: Filling Date acceptedDate: type: integer description: Accepted Date period: type: integer description: Period revenue: type: integer description: Revenue costOfRevenue: type: integer description: Cost Of Revenue grossProfit: type: integer description: Gross Profit grossProfitRatio: type: integer description: Gross Profit Ratio researchAndDevelopmentExpenses: type: integer description: Research And Development Expenses generalAndAdministrativeExpenses: type: integer description: General And Administrative Expenses sellingAndMarketingExpenses: type: integer description: Selling And Marketing Expenses otherExpenses: type: integer description: Other Expenses operatingExpenses: type: integer description: Operating Expenses costAndExpenses: type: integer description: Cost And Expenses interestExpense: type: integer description: Interest Expense depreciationAndAmortization: type: integer description: Depreciation And Amortization ebitda: type: integer description: Ebitda ebitdaratio: type: integer description: Ebitda Ratio operatingIncome: type: integer description: Operating Income operatingIncomeRatio: type: integer description: Operating Income Ratio totalOtherIncomeExpensesNet: type: integer description: Total Other Income Expenses Net incomeBeforeTax: type: integer description: Income Before Tax incomeBeforeTaxRatio: type: integer description: Income Before Tax Ratio incomeTaxExpense: type: integer description: Income Tax Expense netIncome: type: integer description: Net Income netIncomeRatio: type: integer description: Net Income Ratio eps: type: integer description: Eps epsdiluted: type: integer description: Eps Diluted weightedAverageShsOut: type: integer description: Weighted Average Shs Out weightedAverageShsOutDil: type: integer description: Weighted Average Shs Out Dil link: type: string description: Link finalLink: type: string description: Final Link example: - date: '2021-08-31' symbol: TBP.TO fillingDate: '2021-08-31' acceptedDate: '2021-08-31' period: Q3 revenue: 0 costOfRevenue: 0 grossProfit: 0 grossProfitRatio: 0 researchAndDevelopmentExpenses: 2438060 generalAndAdministrativeExpenses: 3405064 sellingAndMarketingExpenses: 0 otherExpenses: 26676 operatingExpenses: 5869800 costAndExpenses: 5869800 interestExpense: 0 depreciationAndAmortization: 26676 ebitda: -6063709 ebitdaratio: 0 operatingIncome: -5869800 operatingIncomeRatio: 0 totalOtherIncomeExpensesNet: -94899 incomeBeforeTax: -5774901 incomeBeforeTaxRatio: 0 incomeTaxExpense: 0 netIncome: -5774901 netIncomeRatio: 0 eps: -0.01 epsdiluted: -0.01 weightedAverageShsOut: 401565469 weightedAverageShsOutDil: 401565469 link: https://www.sedar.com/ModifyCompanyDocumentSearchForm.do?lang=EN&company_search=Tetra%20Bio-Pharma%20Inc.&document_selection=0&industry_group=A&FromDate=13&FromMonth=05&FromYear=2000&ToDate=13&ToMonth=11&ToYear=2020&Variable=Issuer finalLink: https://www.sedar.com/ModifyCompanyDocumentSearchForm.do?lang=EN&company_search=Tetra%20Bio-Pharma%20Inc.&document_selection=0&industry_group=A&FromDate=13&FromMonth=05&FromYear=2000&ToDate=13&ToMonth=11&ToYear=2020&Variable=Issuer '401': $ref: '#/components/responses/Unauthorized' /fnd/detail/stock/{symbol}: get: operationId: stockMarketDetailsApi summary: Stock Market Details API description: With the Stock Market Details API, you can get the stock market details. tags: - Fundamentals parameters: - name: symbol in: path required: true description: Symbol of the stock schema: type: string responses: '200': description: Stock Market Details API response. content: application/json: schema: type: object properties: symbol: type: string description: Stock Symbol logo: type: string description: Logo name: type: string description: Name url: type: string description: Url description: type: string description: Description exchange: type: string description: Exchange ceo: type: string description: Ceo industry: type: string description: Industry state: type: string description: State address: type: string description: Address employees: type: integer description: Employees sector: type: string description: Sector marketcap: type: integer description: Marketcap example: - symbol: AAPL logo: https://finage.s3.eu-west-2.amazonaws.com/stock/logo/AAPL.png name: Apple Inc. url: http://www.apple.com description: Apple Inc is designs, manufactures and markets mobile communication and media devices and personal computers, and sells a variety of related software, services, accessories, networking solutions and third-party digital content and applications. exchange: US Stock ceo: Timothy D. Cook industry: Computer Hardware state: CA address: 1 Infinite Loop Cupertino CA, 95014 employees: 123000 sector: Technology marketcap: 908316631180 '401': $ref: '#/components/responses/Unauthorized' /fnd/funds/institutional-holder/{symbol}: get: operationId: institutionalHoldersApi summary: Institutional Holders API description: The Institutional Holders API provides a more detailed view of the Institutional stock holdings. tags: - Fundamentals parameters: - name: symbol in: path required: true description: Symbol of the stock schema: type: string responses: '200': description: Institutional Holders API response. content: application/json: schema: type: object properties: holder: type: string description: Holder shares: type: integer description: Shares change: type: integer description: Change report_date: type: string description: Report Date example: - holder: HSBC Global Asset Management (UK) Limited shares: 18974100 change: 3766990 report_date: '2020-06-30' - holder: ClearArc Capital, Inc. shares: 8092260 change: -55184 report_date: '2020-06-30' '401': $ref: '#/components/responses/Unauthorized' /fnd/funds/mutual-fund-holder/{symbol}: get: operationId: mutualFundHoldersApi summary: Mutual Fund Holders API description: The Mutual Fund Holders API provides a more detailed view of the Mutual Fund Holders of the selected symbol. tags: - Fundamentals parameters: - name: symbol in: path required: true description: Symbol of the stock schema: type: string responses: '200': description: Mutual Fund Holders API response. content: application/json: schema: type: object properties: holder: type: string description: Holder shares: type: integer description: Shares change: type: integer description: Change report_date: type: string description: Report Date weight_percentage: type: number description: Weight Percentage example: - holder: MFS Variable Insurance Trust II Blended Research Core Equity Portfolio shares: 319516 change: -3108 report_date: '2020-07-31' weight_percentage: 7.81 - holder: UBS (CH) Investment Fund - Equities Global Climate Aware II shares: 319172 change: 137196 report_date: '2020-05-31' weight_percentage: 3.85 '401': $ref: '#/components/responses/Unauthorized' /fnd/funds/rss-feed: get: operationId: secRssFeedApi summary: SEC RSS Feed API description: The following SEC RSS feeds are a helpful online resource for staying current on the most recent materials posted to the SEC website, including EDGAR filings. tags: - Fundamentals responses: '200': description: SEC RSS Feed API response. content: application/json: schema: type: object properties: title: type: string description: Title date: type: string description: Date link: type: string description: Link cik: type: string description: Cik form_type: type: string description: Form Type ticker: type: string description: Ticker example: - title: 6-K - Draganfly Inc. (0001786286) (Filer) date: '2025-01-16 14:28:53' link: https://www.sec.gov/Archives/edgar/data/1786286/000149315225002541/0001493152-25-002541-index.htm cik: 0001786286 form_type: 6-K ticker: DPRO '401': $ref: '#/components/responses/Unauthorized' /fnd/technical-indicator/{type}/{time}/{symbol}: get: operationId: technicalIndicators summary: Technical Indicators description: The Finage Technical Indicators API aims to provide dynamic results for a large number of technical analysis calculations such as DEMA, EMA, SMA, WMA, RSI, TEMA, Williams, ADX and others. tags: - Fundamentals parameters: - name: type in: path required: true description: Indicator type. [ DEMA, EMA, SMA, WMA, RSI, TEMA, Williams, ADX ] schema: type: string - name: time in: path required: true description: Time interval [ daily, 1min , 5min, 15min, 30min, 1hour, 4hour ] schema: type: string - name: symbol in: path required: true description: Symbol of the stock schema: type: string - name: period in: query required: false description: Time period. Default is 10. schema: type: string responses: '200': description: Technical Indicators response. content: application/json: schema: type: object properties: type: type: string description: Type date: type: string description: Date open: type: string description: Open high: type: string description: High low: type: string description: Low close: type: string description: Close volume: type: string description: Volume value: type: string description: Value example: - type: SMA date: '2020-12-24' open: '131.32' high: '133.46' low: '131.1' close: '131.97' volume: 5.4930064E7 value: '127.8280007' - type: SMA date: '2020-12-23' open: '132.160004' high: '132.429993' low: '130.779999' close: '130.960007' volume: 8.82237E7 value: '126.9550005' '401': $ref: '#/components/responses/Unauthorized' /fnd/market-information/us/most-actives: get: operationId: mostActiveUsStocksApi summary: Most Active US Stocks API description: '' tags: - Fundamentals responses: '200': description: Most Active US Stocks API response. content: application/json: schema: type: object properties: symbol: type: string description: Symbol price: type: string description: Price change: type: integer description: Change change_percentage: type: string description: Change Percentage company_name: type: string description: Company Name example: - symbol: NNOX price: '56.66' change: 2581870080 change_percentage: 12.62% company_name: NANO-X IMAGING LTD - symbol: PUBM price: '29.45' change: 1408489980 change_percentage: 47.25% company_name: PubMatic, Inc. '401': $ref: '#/components/responses/Unauthorized' /fnd/market-information/us/most-gainers: get: operationId: topUsStockGainersApi summary: Top US Stock Gainers API description: This API provides the top-gaining stocks today, including share price change and percentage. tags: - Fundamentals responses: '200': description: Top US Stock Gainers API response. content: application/json: schema: type: object properties: symbol: type: string description: Symbol price: type: string description: Price change: type: string description: Change change_percentage: type: string description: Change Percentage company_name: type: string description: Company Name example: - symbol: AIRT price: '38.38' change: '28.63' change_percentage: +293.64% company_name: Air T Inc - symbol: ADXN price: '24.19' change: '11.69' change_percentage: +93.52% company_name: Addex Therapeutics Ltd '401': $ref: '#/components/responses/Unauthorized' /fnd/market-information/us/most-losers: get: operationId: topUsStockLosersApi summary: Top US Stock Losers API description: This API provides the most losers stocks today, including share price change and percentage. tags: - Fundamentals responses: '200': description: Top US Stock Losers API response. content: application/json: schema: type: object properties: symbol: type: string description: Symbol price: type: string description: Price change: type: string description: Change change_percentage: type: string description: Change Percentage company_name: type: string description: Company Name example: - symbol: TZACU price: '11.5' change: '-12.2' change_percentage: -51.48% company_name: Tenzing Acquisition Corp. - symbol: OCGN price: '1.76' change: '-0.84' change_percentage: -32.31% company_name: Ocugen Inc '401': $ref: '#/components/responses/Unauthorized' /fnd/market-information/us/sector-performance: get: operationId: sectorPerformanceApi summary: Sector Performance API description: The Finage sector performance API provides specific sector performance daily basis including change and percentage. tags: - Fundamentals responses: '200': description: Sector Performance API response. content: application/json: schema: type: object properties: sector: type: string description: Sector change_percentage: type: string description: Change Percentage example: - sector: Aerospace & Defense change_percentage: -5.2123% - sector: Airlines change_percentage: 1.1583% - sector: Auto Components change_percentage: -0.4965% '401': $ref: '#/components/responses/Unauthorized' /fnd/shares-float/{symbol}: get: operationId: sharesFloatApi summary: Shares Float API description: You can get the shares float by using this endpoint. tags: - Fundamentals parameters: - name: symbol in: path required: true description: Symbol name (eg. AAPL, AMZN) schema: type: string responses: '200': description: Shares Float API response. content: application/json: schema: type: object properties: symbol: type: string description: Symbol public_float: type: number description: Public Float stock_float: type: integer description: Stock Float outstanding_shares: type: integer description: Outstanding Shares date: type: string description: Date example: - symbol: AMZN public_float: 90.09050689636028 stock_float: 454348048 outstanding_shares: 504324000 date: '2021-10-20' '401': $ref: '#/components/responses/Unauthorized' /fnd/search/market/{market}/{key}: get: operationId: marketSearchApi summary: Market Search API description: You can search markets by stock name or company description. tags: - Fundamentals parameters: - name: market in: path required: true description: Market name like "us" , eu" etc. (Finage only support US market for now.) schema: type: string - name: key in: path required: true description: Search key schema: type: string - name: limit in: query required: true description: Result limit schema: type: string responses: '200': description: Market Search API response. content: application/json: schema: type: object properties: key: type: string description: Key market: type: string description: Market limit: type: integer description: Limit results: type: array items: {} description: Results symbol: type: string description: Symbol description: type: string description: Description s_type: type: string description: Stock Type example: - key: apple market: us limit: 5 results: - symbol: APLE description: Apple Hospitality REIT, Inc. s_type: NYSE - symbol: MLP description: Maui Land & Pineapple Co. s_type: NYSE '401': $ref: '#/components/responses/Unauthorized' /fnd/search/country/{key}: get: operationId: countrySearch summary: Country Search description: You can search the countries by country name or currency code. tags: - Fundamentals parameters: - name: key in: path required: true description: Search key schema: type: string - name: limit in: query required: false description: ' Result limit. [Default is 5]' schema: type: string responses: '200': description: Country Search response. content: application/json: schema: type: object properties: key: type: string description: Key limit: type: integer description: Limit results: type: array items: {} description: Results country: type: string description: Country country_code: type: string description: Country Code currency: type: string description: Currency currency_code: type: string description: Currency Code phone_code: type: string description: Phone Code country_flag: type: string description: Country Flag example: - key: gbp limit: 5 results: - country: South Georgia and the South Sandwich Islands country_code: GS currency: Sterling currency_code: GBP phone_code: '+500' country_flag: https://finage.s3.eu-west-2.amazonaws.com/flags/160x120/gs.png '401': $ref: '#/components/responses/Unauthorized' /fnd/detail/country/{country_code}: get: operationId: countryDetails summary: Country Details description: You can get the country details by country code. tags: - Fundamentals parameters: - name: country_code in: path required: true description: Country code [US, GB, DE, ...] schema: type: string responses: '200': description: Country Details response. content: application/json: schema: type: object properties: country: type: string description: Country country_code: type: string description: Country Code currency: type: string description: Currency currency_code: type: string description: Currency Code phone_code: type: string description: Phone Code country_flag: type: string description: Country Flag example: - country: United Kingdom country_code: GB currency: Sterling currency_code: GBP phone_code: '+44' country_flag: https://finage.s3.eu-west-2.amazonaws.com/flags/160x120/gb.png '401': $ref: '#/components/responses/Unauthorized' /fnd/search/currency/{key}: get: operationId: forexCurrencySearch summary: Forex Currency Search description: You can search the forex currencies by symbol name or currency details. tags: - Fundamentals parameters: - name: key in: path required: true description: Search key schema: type: string - name: limit in: query required: false description: Result limit. [Default is 5] schema: type: string responses: '200': description: Forex Currency Search response. content: application/json: schema: type: object properties: key: type: string description: Key limit: type: integer description: Limit results: type: array items: {} description: Results symbol: type: string description: Symbol from: type: string description: From to: type: string description: To from_flag: type: string description: From Flag to_flag: type: string description: To Flag example: - key: gbp limit: 5 results: - symbol: AEDGBP from: United Arab Emirates dirham to: 'Pound sterling ' from_flag: https://finage.s3.eu-west-2.amazonaws.com/flags/160x120/ae.png to_flag: https://finage.s3.eu-west-2.amazonaws.com/flags/160x120/gb.png '401': $ref: '#/components/responses/Unauthorized' /fnd/detail/currency/{symbol}: get: operationId: forexCurrencyDetails summary: Forex Currency Details description: You can get the currency details by currency name. tags: - Fundamentals parameters: - name: symbol in: path required: true description: Forex currency symbol [eg. GBPUSD] schema: type: string responses: '200': description: Forex Currency Details response. content: application/json: schema: type: object properties: symbol: type: string description: Symbol from: type: string description: From to: type: string description: To from_flag: type: string description: From Flag to_flag: type: string description: To Flag example: - symbol: GBPUSD from: Pound sterling to: 'United States dollar ' from_flag: https://finage.s3.eu-west-2.amazonaws.com/flags/160x120/gb.png to_flag: https://finage.s3.eu-west-2.amazonaws.com/flags/160x120/us.png '401': $ref: '#/components/responses/Unauthorized' /fnd/search/cryptocurrency/{key}: get: operationId: cryptoSearchApi summary: Crypto Search API description: You can get the details of the crypto by its name or symbol. tags: - Fundamentals parameters: - name: key in: path required: true description: Search key schema: type: string - name: limit in: query required: true description: Result limit schema: type: string responses: '200': description: Crypto Search API response. content: application/json: schema: type: object properties: limit: type: integer description: Limit key: type: string description: Key results: type: array items: {} description: Results name: type: string description: Name symbol: type: string description: Symbol type: type: string description: Type isActive: type: boolean description: Is Active example: - limit: 5 key: bitcoin results: - name: Bitcoin symbol: BTC type: coin isActive: true - name: Bitcoin Cash symbol: BCH type: coin isActive: true - name: Bitcoin SV symbol: BSV type: coin isActive: true '401': $ref: '#/components/responses/Unauthorized' /fnd/detail/cryptocurrency/{key}: get: operationId: cryptoDetailsApi summary: Crypto Details API description: You can search crypto by crypto name, description or symbol. tags: - Fundamentals parameters: - name: key in: path required: true description: Symbol or full name of the crypto schema: type: string responses: '200': description: Crypto Details API response. content: application/json: schema: type: object properties: name: type: string description: Name symbol: type: string description: Symbol type: type: string description: Type isActive: type: boolean description: Is Active description: type: string description: Description developers: type: array items: {} description: Developers position: type: string description: Position opensource: type: boolean description: Opensource startedAt: type: string description: Started At hashAlgorithm: type: string description: Hash Algorithm links: type: string description: Links explorer: type: string description: Explorer facebook: type: string description: Facebook reddit: type: string description: Reddit source_code: type: string description: Source Code website: type: string description: Website youtube: type: string description: Youtube thumbnail: type: string description: Thumbnail developmentStatus: type: string description: Development Status hardwareWallet: type: boolean description: Hardware Wallet example: name: Bitcoin symbol: BTC type: coin isActive: true description: Bitcoin is a cryptocurrency and worldwide payment system. It is the first decentralized digital currency, as the system works without a central bank or single administrator. developers: - name: Satoshi Nakamoto position: Founder - name: Wladimir J. van der Laan position: Blockchain Developer - name: Jonas Schnelli position: Blockchain Developer - name: Marco Falke position: Blockchain Developer opensource: true startedAt: '2009-01-03T00:00:00' hashAlgorithm: SHA256 links: explorer: - http://blockchain.com/explorer - https://blockstream.info/ - https://blockchair.com/bitcoin - https://live.blockcypher.com/btc/ - https://btc.cryptoid.info/btc/ facebook: - https://www.facebook.com/bitcoins/ reddit: - https://www.reddit.com/r/bitcoin source_code: - https://github.com/bitcoin/bitcoin website: - https://bitcoin.org/ youtube: - https://www.youtube.com/watch?v=Gc2en3nHxA4& thumbnail: https://finage.s3.eu-west-2.amazonaws.com/cryptocurrency/128x128/bitcoin.png developmentStatus: Working product hardwareWallet: true '401': $ref: '#/components/responses/Unauthorized' /fnd/list/cryptocurrency: get: operationId: cryptoMarketCapRanksApi summary: Crypto Market Cap Ranks API description: Crypto market cap rank endpoint will help you to get a list of crypto with name, thumbnail, market cap, and all-time high price with one API request. tags: - Fundamentals parameters: - name: limit in: query required: false description: Output limit. Default is 10. schema: type: string - name: page in: query required: false description: This query will help you to use pagination. Default is 1. schema: type: string - name: sort in: query required: false description: You can use DESC to get the most valuable crypto or ASC to get opposite. Default is DESC. schema: type: string responses: '200': description: Crypto Market Cap Ranks API response. content: application/json: schema: type: object properties: totalResults: type: integer description: Total Results results: type: array items: {} description: Results symbol: type: string description: Symbol name: type: string description: Name thumbnail: type: string description: Thumbnail market_cap: type: integer description: Market Cap ath: type: integer description: Ath ath_date: type: string description: Ath Date order: type: integer description: Order example: - totalResults: 2 results: - symbol: btc name: Bitcoin thumbnail: https://finage.s3.eu-west-2.amazonaws.com/cryptocurrency/128x128/bitcoin.png market_cap: 682075777928 ath: 69045 ath_date: '2021-11-10T14:24:11.849Z' order: 1 - symbol: eth name: Ethereum thumbnail: https://finage.s3.eu-west-2.amazonaws.com/cryptocurrency/128x128/ethereum.png market_cap: 284193954165 ath: 4878.26 ath_date: '2021-11-10T14:24:19.604Z' order: 2 '401': $ref: '#/components/responses/Unauthorized' /fnd/last/crypto/detailed/btcusd: get: operationId: cryptoDetailedLastPriceApi summary: Crypto Detailed Last Price API description: Finage has more than 5500+ cryptocurrency symbols in real-time. tags: - Fundamentals parameters: - name: symbol in: query required: true description: Crypto symbol that you want to get price schema: type: string responses: '200': description: Crypto Detailed Last Price API response. content: application/json: schema: type: object properties: symbol: type: string description: Symbol name: type: string description: Name price: type: number description: Price changesPercentage: type: number description: Changes Percentage change: type: number description: Change high: type: number description: High open: type: number description: Open low: type: number description: Low close: type: number description: Close yearHigh: type: number description: Year High yearLow: type: number description: Year Low marketCap: type: integer description: Market Cap priceAvg50: type: number description: Price Avg 50 priceAvg200: type: number description: Price Avg 200 volume: type: integer description: Volume avgVolume: type: integer description: Avg Volume exchange: type: string description: Exchange sharesOutstanding: type: integer description: Shares Outstanding timestamp: type: integer description: Timestamp example: - symbol: BTCUSD name: Bitcoin USD price: 18622.28 changesPercentage: 0.91 change: 167.532 high: 18729.865 open: 18454.748 low: 18002.09 close: 18454.748 yearHigh: 18936.621 yearLow: 4106.981 marketCap: 345478856704 priceAvg50: 13804.334 priceAvg200: 11091.029 volume: 43721678848 avgVolume: 28791630355 exchange: CRYPTO sharesOutstanding: 18551910 timestamp: 1606131739 '401': $ref: '#/components/responses/Unauthorized' /fnd/financial-ratios/{symbol}: get: operationId: financialRatios summary: Financial Ratios description: Evaluate a company’s financial health with the Financial Ratios API. This API delivers in-depth insights into profitability, liquidity, and efficiency ratios, allowing users to analyze operational and financial performance across multiple key metrics. tags: - Fundamentals parameters: - name: symbol in: path required: true description: Symbol name (eg. AAPL, AMZN) schema: type: string responses: '200': description: Financial Ratios response. content: application/json: schema: type: object properties: symbol: type: string description: Symbol date: type: string description: Date fiscalYear: type: string description: Fiscal Year period: type: string description: Period reportedCurrency: type: string description: Reported Currency grossProfitMargin: type: number description: Gross Profit Margin ebitMargin: type: number description: Ebit Margin ebitdaMargin: type: number description: Ebitda Margin operatingProfitMargin: type: number description: Operating Profit Margin pretaxProfitMargin: type: number description: Pretax Profit Margin continuousOperationsProfitMargin: type: number description: Continuous Operations Profit Margin netProfitMargin: type: number description: Net Profit Margin bottomLineProfitMargin: type: number description: Bottom Line Profit Margin receivablesTurnover: type: number description: Receivables Turnover payablesTurnover: type: number description: Payables Turnover inventoryTurnover: type: number description: Inventory Turnover fixedAssetTurnover: type: number description: Fixed Asset Turnover assetTurnover: type: number description: Asset Turnover currentRatio: type: number description: Current Ratio quickRatio: type: number description: Quick Ratio solvencyRatio: type: number description: Solvency Ratio cashRatio: type: number description: Cash Ratio priceToEarningsRatio: type: number description: Price To Earnings Ratio priceToEarningsGrowthRatio: type: number description: Price To Earnings Growth Ratio forwardPriceToEarningsGrowthRatio: type: number description: Forward Price To Earnings Growth Ratio priceToBookRatio: type: number description: Price To Book Ratio priceToSalesRatio: type: number description: Price To Sales Ratio priceToFreeCashFlowRatio: type: number description: Price to Free Cash Flow Ratio priceToOperatingCashFlowRatio: type: number description: Price to Operating Cash Flow Ratio debtToAssetsRatio: type: number description: Debt to Assets Ratio debtToEquityRatio: type: number description: Debt to Equity Ratio debtToCapitalRatio: type: number description: Debt to Capital Ratio longTermDebtToCapitalRatio: type: number description: Long Term Debt to Capital Ratio financialLeverageRatio: type: number description: Financial Leverage Ratio workingCapitalTurnoverRatio: type: number description: Working Capital Turnover Ratio operatingCashFlowRatio: type: number description: Operating Cash Flow Ratio operatingCashFlowSalesRatio: type: number description: Operating Cash Flow Sales Ratio freeCashFlowOperatingCashFlowRatio: type: number description: Free Cash Flow Operating Cash Flow Ratio debtServiceCoverageRatio: type: number description: Debt Service Coverage Ratio interestCoverageRatio: type: number description: Interest Coverage Ratio shortTermOperatingCashFlowCoverageRatio: type: number description: Short Term Operating Cash Flow Coverage Ratio operatingCashFlowCoverageRatio: type: number description: Operating Cash Flow Coverage Ratio capitalExpenditureCoverageRatio: type: number description: Capital Expenditure Coverage Ratio dividendPaidAndCapexCoverageRatio: type: number description: Dividend Paid and Capex Coverage Ratio dividendPayoutRatio: type: number description: Dividend Payout Ratio dividendYield: type: number description: Dividend Yield revenuePerShare: type: number description: Revenue Per Share netIncomePerShare: type: number description: Net Income Per Share interestDebtPerShare: type: number description: Interest Debt Per Share cashPerShare: type: number description: Cash Per Share bookValuePerShare: type: number description: Book Value Per Share tangibleBookValuePerShare: type: number description: Tangible Book Value Per Share shareholdersEquityPerShare: type: number description: Shareholders Equity Per Share operatingCashFlowPerShare: type: number description: Operating Cash Flow Per Share capexPerShare: type: number description: Capex Per Share freeCashFlowPerShare: type: number description: Free Cash Flow Per Share netIncomePerEBT: type: number description: Net Income Per EBT ebtPerEbit: type: number description: Ebt Per Ebit priceToFairValue: type: number description: Price to Fair Value debtToMarketCap: type: number description: Debt to Market Cap effectiveTaxRate: type: number description: Effective Tax Rate enterpriseValueMultiple: type: number description: Enterprise Value Multiple example: - symbol: TSLA date: '2024-12-31' fiscalYear: '2024' period: FY reportedCurrency: USD grossProfitMargin: 0.17862626676220697 ebitMargin: 0.09560855768246494 ebitdaMargin: 0.1505578871941857 operatingProfitMargin: 0.07243320708363189 pretaxProfitMargin: 0.09202579588494217 continuousOperationsProfitMargin: 0.07322141467908691 netProfitMargin: 0.07258675401781145 bottomLineProfitMargin: 0.07301668543351418 receivablesTurnover: 22.111815301041194 payablesTurnover: 6.4325797659131 inventoryTurnover: 6.677207289672963 fixedAssetTurnover: 1.8968563717209375 assetTurnover: 0.8002785287130335 currentRatio: 2.024912390270983 quickRatio: 1.6079594739946568 solvencyRatio: 0.257470551766894 cashRatio: 1.268623573089067 priceToEarningsRatio: 182.98377097729514 priceToEarningsGrowthRatio: -3.462052946890424 forwardPriceToEarningsGrowthRatio: -3.462052946890424 priceToBookRatio: 17.79570062951737 priceToSalesRatio: 13.28219797318047 priceToFreeCashFlowRatio: 355.6847368421053 priceToOperatingCashFlowRatio: 86.94886550961603 debtToAssetsRatio: 0.0672810682395347 debtToEquityRatio: 0.11264109280923841 debtToCapitalRatio: 0.10123758104676676 longTermDebtToCapitalRatio: 0.07317910258039914 financialLeverageRatio: 1.6741870448342546 workingCapitalTurnoverRatio: 3.8760489614537663 operatingCashFlowRatio: 0.5177821727212796 operatingCashFlowSalesRatio: 0.15275872658409254 freeCashFlowOperatingCashFlowRatio: 0.24445486832406352 debtServiceCoverageRatio: 4.586956521739131 interestCoverageRatio: 20.217142857142857 shortTermOperatingCashFlowCoverageRatio: 6.07614006514658 operatingCashFlowCoverageRatio: 1.816997443078047 capitalExpenditureCoverageRatio: 1.3153812252093433 dividendPaidAndCapexCoverageRatio: 1.3153812252093433 dividendPayoutRatio: 0 dividendYield: 0 dividendYieldPercentage: 0 revenuePerShare: 30.40460628695923 netIncomePerShare: 2.206971677559913 interestDebtPerShare: 2.6651104886399004 cashPerShare: 11.379707438530968 bookValuePerShare: 22.931839402427638 tangibleBookValuePerShare: 22.809212573918455 shareholdersEquityPerShare: 22.693121693121693 operatingCashFlowPerShare: 4.644568938686586 capexPerShare: 3.530967942732649 freeCashFlowPerShare: 1.1353874883286648 netIncomePerEBT: 0.7887652947719689 ebtPerEbit: 1.2704918032786885 priceToFairValue: 17.79570062951737 debtToMarketCap: 0.006329680137594745 effectiveTaxRate: 0.20433815350389323 enterpriseValueMultiple: 86.29235246124559 '401': $ref: '#/components/responses/Unauthorized' /fnd/signals/forex/{timeframe}/{symbol}: get: operationId: forexTechnicalIndicators summary: Forex Technical Indicators description: The Forex Technical Indicators API is designed to provide dynamic results for a wide range of technical analysis calculations, including signals like confidence, as well as indicators such as SMA, RSI, MACD, Bollinger Bands, and more. tags: - Fundamentals parameters: - name: timeframe in: path required: true description: The time interval for the technical indicators and signals (daily, weekly). schema: type: string - name: symbol in: path required: true description: The currency pair symbol you want to query (e.g., EURUSD, GBPUSD). schema: type: string responses: '200': description: Forex Technical Indicators response. content: application/json: schema: type: object properties: timestamp: type: string description: Timestamp [date] symbol: type: string description: The currency pair symbol (e.g., EURUSD). signal: type: string description: The trading signal generated based on the indicators (e.g., buy, sell, hold). confidence: type: number description: A score between 0 and 1 indicating the strength of the signal (calculated by us). indicators: type: array items: {} description: An object containing technical indicator values used in the signal calculation. sma_20: type: number description: The 20-period simple moving average (SMA). sma_50: type: number description: The 50-period simple moving average (SMA). rsi: type: number description: The relative strength index (RSI), showing momentum on a scale of 0 to 100. macd: type: number description: The moving average convergence divergence (MACD) value. macd_signal: type: number description: The signal line of the MACD. macd_diff: type: number description: The difference between MACD and the MACD signal line. bollinger_high: type: number description: The upper band of the Bollinger Bands. bollinger_low: type: number description: The lower band of the Bollinger Bands. ma_crossover: type: boolean description: A boolean showing whether a moving average crossover has occurred (true/false). macd_cross: type: boolean description: A boolean showing whether the MACD and signal line have crossed (true/false). price: type: number description: The latest price of the currency pair at the time of data generation. example: - timestamp: '2025-05-06T10:41:32.571747715Z' symbol: EURUSD signal: hold confidence: 0.5 indicators: sma_20: 1.13228 sma_50: 1.13269 rsi: 42.61 macd: -4.0e-05 macd_signal: 0.00023 macd_diff: -0.00027 bollinger_high: 1.1347 bollinger_low: 1.13069 ma_crossover: false macd_cross: false price: 1.1317059 '401': $ref: '#/components/responses/Unauthorized' /fnd/signals/forex/{interval}/{symbol}: get: operationId: forexSignalApi summary: Forex Signal API description: The Finage Signal API is an forecasting tool that delivers real-time trading signals based on widely used technical indicators such as RSI, MACD, SMA, and Bollinger Bands. Each response includes a recommended signal (buy, sell, or hold), a confidence score, and the full set of indicators used to generate the result. tags: - Fundamentals parameters: - name: interval in: path required: true description: 'Specifies the time frame used for signal analysis. Available values: daily, weekly.' schema: type: string - name: symbol in: path required: true description: The market symbol for which the signal should be generated. Accepts currency pairs such as GBPUSD, EURUSD, USDJPY, etc. schema: type: string responses: '200': description: Forex Signal API response. content: application/json: schema: type: object properties: timestamp: type: string description: Timestamp symbol: type: string description: Symbol Name signal: type: string description: 'Trading signal: buy, sell, or hold, based on market indicators.' confidence: type: number description: A score between 0 and 1 indicating the confidence level of the signal. Higher means more reliable. indicators: type: array items: {} description: Indicator Parameters sma_20: type: number description: 20-period Simple Moving Average of the price, indicating short-term trend. sma_50: type: number description: 50-period Simple Moving Average, used for detecting medium-term trend direction. rsi: type: number description: Relative Strength Index (0–100), indicating whether the asset is overbought (>70) or oversold (<30). macd: type: number description: Moving Average Convergence Divergence value; helps track momentum and trend strength. macd_signal: type: number description: Signal line derived from the MACD, used to detect buy/sell crossovers. macd_diff: type: number description: Difference between macd and macd_signal; positive values may indicate bullish momentum. bollinger_high: type: number description: Upper band of the Bollinger Bands; a potential resistance or overbought zone. bollinger_low: type: number description: Lower band of the Bollinger Bands; a potential support or oversold zone. ma_crossover: type: boolean description: Boolean value indicating whether a short-term MA crossed above a long-term MA (bullish). macd_cross: type: boolean description: Boolean value indicating if the MACD line crossed the signal line (often a trade trigger). price: type: number description: The market price of the asset at the moment the signal was generated. example: timestamp: '2025-07-25T12:18:23.261462863Z' symbol: GBPUSD signal: buy confidence: 0.65 indicators: sma_20: 1.34534 sma_50: 1.34589 rsi: 39.46 macd: -0.00096 macd_signal: -0.00099 macd_diff: 3.0e-05 bollinger_high: 1.3476 bollinger_low: 1.34417 ma_crossover: false macd_cross: true price: 1.3453123 '401': $ref: '#/components/responses/Unauthorized' /fnd/signals/us-stock/{interval}/{symbol}: get: operationId: usStocksSignalApi summary: US Stocks Signal API description: The Finage US Stocks Signal API is an forecasting tool that delivers real-time trading signals based on widely used technical indicators such as RSI, MACD, SMA, and Bollinger Bands. Each response includes a recommended signal (buy, sell, or hold), a confidence score, and the full set of indicators used to generate the result. tags: - Fundamentals parameters: - name: interval in: path required: true description: 'Specifies the time frame used for signal analysis. Available values: daily, weekly.' schema: type: string - name: symbol in: path required: true description: The market symbol for which the signal should be generated. Accepts us stocks symbols such as AAPL,TSLA,GOOGL, etc. schema: type: string responses: '200': description: US Stocks Signal API response. content: application/json: schema: type: object properties: timestamp: type: string description: Timestamp symbol: type: string description: Symbol Name signal: type: string description: 'Trading signal: buy, sell, or hold, based on market indicators.' confidence: type: number description: A score between 0 and 1 indicating the confidence level of the signal. Higher means more reliable. indicators: type: array items: {} description: Indicator Parameters sma_20: type: number description: 20-period Simple Moving Average of the price, indicating short-term trend. sma_50: type: number description: 50-period Simple Moving Average, used for detecting medium-term trend direction. rsi: type: number description: Relative Strength Index (0–100), indicating whether the asset is overbought (>70) or oversold (<30). macd: type: number description: Moving Average Convergence Divergence value; helps track momentum and trend strength. macd_signal: type: number description: Signal line derived from the MACD, used to detect buy/sell crossovers. macd_diff: type: number description: Difference between macd and macd_signal; positive values may indicate bullish momentum. bollinger_high: type: number description: Upper band of the Bollinger Bands; a potential resistance or overbought zone. bollinger_low: type: number description: Lower band of the Bollinger Bands; a potential support or oversold zone. ma_crossover: type: boolean description: Boolean value indicating whether a short-term MA crossed above a long-term MA (bullish). macd_cross: type: boolean description: Boolean value indicating if the MACD line crossed the signal line (often a trade trigger). price: type: number description: The market price of the asset at the moment the signal was generated. example: timestamp: '2025-07-29T11:52:34.299321493Z' symbol: AAPL signal: hold confidence: 0.5 indicators: sma_20: 213.94422 sma_50: 214.02437 rsi: 34.45 macd: -0.03553 macd_signal: -0.01618 macd_diff: -0.01935 bollinger_high: 214.24073 bollinger_low: 213.80801 ma_crossover: false macd_cross: false price: 213.8911607 '401': $ref: '#/components/responses/Unauthorized' components: responses: Unauthorized: description: Missing or invalid API key, or your plan does not include this market. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: Please use your APIKey to make a request. schemas: Error: type: object description: Finage error envelope — a single error string. properties: error: type: string description: Human-readable error message. securitySchemes: apiKey: type: apiKey name: apikey in: query description: Finage API key, passed as the apikey query parameter on every request. Get one at https://moon.finage.co.uk/register. externalDocs: description: Finage API documentation url: https://finage.co.uk/docs/api