Finage Fundamentals API

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
    

# --- truncated at 32 KB (121 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/finage/refs/heads/main/openapi/finage-fundamentals-api-openapi.yml