Finage - Documentation

Docs

API

WebSocket

Symbols

Widgets

Home Page

Back

Docs /

Getting Started

Gzip Compression

U.S Stocks

Forex

Crypto

UK Stock Market

Indian Market

Canada Market

Russian Market

Bonds

Fundamentals

Full Symbol List API

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.

https://api.finage.co.uk/symbol-list/{ type }?apikey=YOUR_API_KEY

Params

type = Market type (us-stock, ca-stock, in-stock, ru-stock, forex, crypto, index)

Queries

```
page
```
= Default page is 1
```
search
```
= You can search symbol or name by this query. (eg: BTC, or Bitcoin) [Optional]
```
apikey
```
= Your API key

https://api.finage.co.uk/symbol-list/forex?page=1&apikey=YOUR_API_KEY

Response

Please login to make an API request


{
  "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 "
    },
    ...
  ]
}

Forex and Crypto pages include 500 symbols, US Market pages include 2500 symbols.

You can learn more in the symbols page.

Market News API

We provide you the latest market news via the Market News API.

https://api.finage.co.uk/news/market/{ symbol }?apikey=YOUR_API_KEY

Params

```
symbol
```
= Stock symbol name

Queries

```
limit
```
= Limit of the news. Default is 10 and maximum allowed limit is 30.
```
apikey
```
= Your API key

https://api.finage.co.uk/news/market/amzn?apikey=YOUR_API_KEY

Response

Please login to make an API request

{
  "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"
    },
    ...
  ]
}

Forex News API

By using our Forex News API, you can get the latest news about the currencies and the countries which is using the selected currency.

https://api.finage.co.uk/news/forex/{ symbol }?apikey=YOUR_API_KEY

Params

```
symbol
```
= Forex symbol name

Queries

```
limit
```
= Limit of the news. Default is 10 and maximum allowed limit is 30.
```
apikey
```
= Your API key

https://api.finage.co.uk/news/forex/gbp?apikey=YOUR_API_KEY

Response

Please login to make an API request


{
  "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"
    },
    ...
  ]
}

Finage is working hard to provide you the most comprehensive forex market news feed.

Crypto News API

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.

https://api.finage.co.uk/news/cryptocurrency/{ symbol }?apikey=YOUR_API_KEY

Params

```
symbol
```
= Crypto symbol name [Eg. BTC, ETH, DOGE]

Queries

```
limit
```
= Limit of the news. Default is 10 and maximum allowed limit is 30.
```
apikey
```
= Your API key

https://api.finage.co.uk/news/cryptocurrency/BTC?apikey=YOUR_API_KEY

Response

Please login to make an API request

{
  "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"
    },
    ...
  ]
}

Market Status API

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.

https://api.finage.co.uk/marketstatus?apikey=YOUR_API_KEY

Queries

```
country
```
= Check the specified country's market status. Default is US
```
currencies
```
= You can display or hide currencies part from the output. Default is true.
```
holidays
```
= Display selected country's holidays. Default is false
```
trading_hours
```
= Display trading hours of the market. Default is false
```
extended_hours
```
= Display extended hours of the market. Default is false
```
apikey
```
= Your API key

Response

Please login to make an API request

{
  "market": "open",
  "timezone": "UTC-05:00",
  "country": "US"
  "exchanges": {
    "nyse": "open",
    "nasdaq": "open",
    "otc": "open"
  },
  "currencies": {
    "fx": "open",
    "crypto": "open"
  }
}

Economic Calendar

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.

https://api.finage.co.uk/economic-calendar?from={ from }&to={ to }&apikey=YOUR_API_KEY

Queries

from = Start date
to = End date
```
apikey
```
= Your API key

https://api.finage.co.uk/economic-calendar?from=2020-10-01&to=2020-11-01&apikey=YOUR_API_KEY

Response

Please login to make an API request

[
	...,
	{
		"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
	}
	...
]

In the economic calender actual,

previous

change

changePercentage

estimate

value could be null according to the event or date of the event.

Earnings Calendar

Our Earnings Calendar API will show you the earnings relases for companies.

https://api.finage.co.uk/earning-calendar?apikey=YOUR_API_KEY

Queries

```
apikey
```
= Your API key

https://api.finage.co.uk/earning-calendar?apikey=YOUR_API_KEY

Response

Please login to make an API request

[
	...,
 {
    "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"
  },
	...
]

In the earnings calender

eps

estimated_eps

revenue

, or

estimated_revenue

value could be null according to the event or date of the event.

IPO Calendar

Our IPO Calendar API will show you the recent and upcoming IPOs.

https://api.finage.co.uk/ipo-calendar?apikey=API_KEY&from=2020-01-01&to=2021-01-01

Queries

from = Start date
to = End date
```
apikey
```
= Your API key

https://api.finage.co.uk/ipo-calendar?apikey=YOUR_API_KEY

Response

Please login to make an API request

[
	...,
  {
    "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"
  },
	...
]

In the IPO calender

shares

price_range

market_cap

, value could be null according to the event or date of the event.

Stock Split Calendar

Our Stock Split API will show you the splits data.

https://api.finage.co.uk/stock-split-calendar?apikey=API_KEY&from=2020-01-01&to=2021-01-01

Queries

from = Start date
to = End date
```
apikey
```
= Your API key

https://api.finage.co.uk/stock-split-calendar?apikey=YOUR_API_KEY

Response

Please login to make an API request

[
	...,
  {
    "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"
  },
	...
]

Historical Stock Split Calendar

Our Historical Stock Split API will show you the splits data for a specific company.

https://api.finage.co.uk/historical-stock-splits/AAPL?apikey=API_KEY

Queries

```
symbol
```
= Stock symbol name
```
apikey
```
= Your API key

https://api.finage.co.uk/historical-stock-splits?apikey=YOUR_API_KEY

Response

Please login to make an API request

[
	...,
  {
    "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"
  },
	...
]

Dividends Calendar

Our Dividends API will show you the dividend data for stocks going back 30 years.

https://api.finage.co.uk/dividend-calendar?apikey=YOUR_API_KEY&from=2021-01-01&to=2021-01-10

Queries

from = Start date
to = End date
```
apikey
```
= Your API key

https://api.finage.co.uk/dividend-calendar?apikey=YOUR_API_KEY

Response

Please login to make an API request

[
	...,
  {
    "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"
  },
	...
]

Historical Dividends Calendar

Our Historical Dividends API will show you the dividends data for a specific company.

https://api.finage.co.uk/historical-dividends/AAPL?apikey=YOUR_API_KEY

Queries

```
symbol
```
= Stock symbol name
```
apikey
```
= Your API key

https://api.finage.co.uk/historical-dividends/AAPL?apikey=YOUR_API_KEY

Response

Please login to make an API request

[
	...,
  {
    "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"
  },
	...
]

Delisted Companies

Our Delisted Companies API will show you the companies delisted from exchanges.

https://api.finage.co.uk/delisted-companies?apikey=YOUR_API_KEY

Queries

```
limit
```
= Limit of the results. Default is 50.
```
apikey
```
= Your API key

https://api.finage.co.uk/delisted-companies?apikey=YOUR_API_KEY

Response

Please login to make an API request

[
	...,
  {
    "symbol": "CEO",
    "company_name": "Cnooc Ltd",
    "exchange": "NYSE",
    "ipo_date": "2001-02-27",
    "delisted_date": "2021-11-05"
  },
	...
]

Cash Flow Statements

Cash flow statements of the U.S. companies.

https://api.finage.co.uk/cash-flow-statement/{ symbol }?limit=LIMIT&period=TIME_PERIOD&apikey=YOUR_API_KEY

Params

```
symbol
```
= US Stock symbol

Queries

```
limit
```
= Response limit
```
period
```
= Time period. Default is annual. [
```
annual
```
,
```
quarter
```
]
```
apikey
```
= Your API key

https://api.finage.co.uk/cash-flow-statement/AAPL?limit=10&period=quarter&apikey=YOUR_API_KEY

Response

Please login to make an API request

[
  {
    "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"
  },
  ...
]

Balance Sheet Statements

Balance sheet statements of the U.S. companies.

https://api.finage.co.uk/balance-sheet-statements/{ symbol }?limit=LIMIT&period=TIME_PERIOD&apikey=YOUR_API_KEY

Params

```
symbol
```
= US Stock symbol

Queries

```
limit
```
= Response limit
```
period
```
= Time period. Default is annual. [
```
annual
```
,
```
quarter
```
]
```
apikey
```
= Your API key

https://api.finage.co.uk/balance-sheet-statements/AAPL?limit=10&apikey=YOUR_API_KEY

Response

Please login to make an API request

[
  {
    "date": "2020-09-26",
    "symbol": "AAPL",
    "fillingDate": "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,
    "doubleTermInvestments": 0,
    "taxAssets": 0,
    "otherNonCurrentAssets": 42522000000,
    "totalNonCurrentAssets": 180175000000,
    "otherAssets": 90482000000,
    "totalAssets": 323888000000,
    "accountPayables": 42296000000,
    "shortTermDebt": 8773000000,
    "taxPayables": 0,
    "deferredRevenue": 6643000000,
    "otherCurrentLiabilities": 47680000000,
    "totalCurrentLiabilities": 105392000000,
    "doubleTermDebt": 0,
    "deferredRevenueNonCurrent": 0,
    "deferredTaxLiabilitiesNonCurrent": 0,
    "otherNonCurrentLiabilities": 54490000000,
    "totalNonCurrentLiabilities": 153157000000,
    "otherLiabilities": 0,
    "totalLiabilities": 258549000000,
    "commonStock": 16976763000,
    "retainedEarnings": 14966000000,
    "accumulatedOtherComprehensiveIncomeLoss": -406000000,
    "othertotalStockholdersEquity": 33802237000,
    "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"
  },
  ...
]

Income Statements

Income statements of the U.S. companies.

https://api.finage.co.uk/income-statement/{ symbol }?limit=LIMIT&period=TIME_PERIOD&apikey=YOUR_API_KEY

Params

```
symbol
```
= US Stock symbol

Queries

```
limit
```
= Response limit
```
period
```
= Time period. Default is annual. [
```
annual
```
,
```
quarter
```
]
```
apikey
```
= Your API key

https://api.finage.co.uk/income-statement/AAPL?limit=10&period=quarter&apikey=YOUR_API_KEY

Response

Please login to make an API request

[
  {
    "date": "2020-09-26",
    "symbol": "AAPL",
    "fillingDate": "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"
  },
  ...
]

International Filings

Income statements for International companies.

https://api.finage.co.uk/income-statement/{ symbol.exchange_code }?apikey=YOUR_API_KEY

Params

```
symbol
```
= International Stock symbol
```
exchange_code
```
= International Stock Exchanges

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

Queries

```
period
```
= Time period. Default is annual. [
```
annual
```
,
```
quarter
```
]
```
limit
```
= Response limit
```
apikey
```
= Your API key

https://api.finage.co.uk/income-statement/TBP.TO?&period=quarter&apikey=YOUR_API_KEY

Response

Please login to make an API request

[
  {
    "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 Bio-Pharma Inc.&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 Bio-Pharma Inc.&document_selection=0&industry_group=A&FromDate=13&FromMonth=05&FromYear=2000&ToDate=13&ToMonth=11&ToYear=2020&Variable=Issuer"
  },
  ...
]

Stock Market Details API

With the Stock Market Details API, you can get the details of the stock market.

If you want to get a full U.S. coverage stock data package, please contact us via E-Mail or live chat.

https://api.finage.co.uk/detail/stock/{ symbol }?apikey=YOUR_API_KEY

Params

```
symbol
```
= Symbol of the stock

Queries

```
apikey
```
= Your API key

https://api.finage.co.uk/detail/stock/AAPL?apikey=YOUR_API_KEY

You can get the details of the AAPL with the given example above.

Response

Please login to make an API request

{
	"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
}

Institutional Holders API

The Institutional Holders API provides a more detailed view of the Institutional stock holdings.

https://api.finage.co.uk/funds/institutional-holder/{ symbol }?apikey=YOUR_API_KEY

Params

```
symbol
```
= Symbol of the stock

Queries

```
apikey
```
= Your API key

https://api.finage.co.uk/funds/institutional-holder/AAPL?apikey=YOUR_API_KEY

Response

Please login to make an API request

[
  {
    "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"
  },
  ...
]

Mutual Fund Holders API

The Mutual Fund Holders API provides a more detailed view of the Mutual Fund Holders of the selected symbol.

https://api.finage.co.uk/funds/mutual-fund-holder/{ symbol }?apikey=YOUR_API_KEY

Params

```
symbol
```
= Symbol of the stock

Queries

```
apikey
```
= Your API key

https://api.finage.co.uk/funds/mutual-fund-holder/AAPL?apikey=YOUR_API_KEY

Response

Please login to make an API request

[
  {
    "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
  },
  ...
]

SEC RSS Feed API

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.

https://api.finage.co.uk/funds/rss-feed?apikey=YOUR_API_KEY

Queries

```
apikey
```
= Your API key

https://api.finage.co.uk/funds/rss-feed?apikey=YOUR_API_KEY

Response

Please login to make an API request

[
  {
    "title": "6-K - CONTINENTAL ENERGY CORP (0000852747) (Filer)",
    "date": "2020-12-23 17:18:30",
    "link": "https://www.sec.gov/Archives/edgar/data/852747/000137647420000330/0001376474-20-000330-index.htm",
    "cik": "0000852747",
    "form_type": "6-K",
    "ticker": "CPPXF"
  },
  ...
]

Technical Indicators

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.

https://api.finage.co.uk/technical-indicator/{ type }/{ time }/{ symbol }?period={ period }&apikey=YOUR_API_KEY

Params

```
symbol
```
= Symbol of the stock
type = Indicator type. [ DEMA, EMA, SMA, WMA, RSI, TEMA, Williams, ADX ]
```
time
```
= Time interval [ daily, 1min , 5min, 15min, 30min, 1hour, 4hour ]

Queries

```
apikey
```
= Your API key
```
period
```
= Time period. Default is 10.

https://api.finage.co.uk/technical-indicator/sma/daily/aapl?apikey=YOUR_API_KEY

Response

Please login to make an API request

[
  {
    "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"
  },
  ...
]

Most Active US Stocks API

This API provides most active stocks today, including share price change and percentage.

https://api.finage.co.uk/market-information/us/most-actives?apikey=YOUR_API_KEY

Queries

```
apikey
```
= Your API key

https://api.finage.co.uk/market-information/us/most-actives?apikey=YOUR_API_KEY

Response

Please login to make an API request

[
  {
    "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."
  },
  ...
]

Top US Stock Gainers API

This API provides the top gaining stocks today, including share price change and percentage.

https://api.finage.co.uk/market-information/us/most-gainers?apikey=YOUR_API_KEY

Queries

```
apikey
```
= Your API key

https://api.finage.co.uk/market-information/us/most-gainers?apikey=YOUR_API_KEY

Response

Please login to make an API request

[
  {
    "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"
  },
  ...
]

Top US Stock Losers API

This API provides the most losers stocks today, including share price change and percentage.

https://api.finage.co.uk/market-information/us/most-losers?apikey=YOUR_API_KEY

Queries

```
apikey
```
= Your API key

https://api.finage.co.uk/market-information/us/most-losers?apikey=YOUR_API_KEY

Response

Please login to make an API request

[
  {
    "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"
  },
  ...
]

Sector Performance API

The Finage sector performance API provides specific sector performance daily basis including change and percentage.

https://api.finage.co.uk/market-information/us/sector-performance?apikey=YOUR_API_KEY

Queries

```
apikey
```
= Your API key

https://api.finage.co.uk/market-information/us/sector-performance?apikey=YOUR_API_KEY

Response

Please login to make an API request

[
  {
    "sector": "Aerospace & Defense",
    "change_percentage": "-5.2123%"
  },
  {
    "sector": "Airlines",
    "change_percentage": "1.1583%"
  },
  {
    "sector": "Auto Components",
    "change_percentage": "-0.4965%"
  },
  ...
]

Shares Float API

You can get the shares float by using this endpoint.

https://api.finage.co.uk/shares-float/{ symbol }?apikey=YOUR_API_KEY

Params

```
symbol
```
= Symbol name (eg. AAPL, AMZN)

Queries

```
apikey
```
= Your API key

Response

Please login to make an API request

{
  "symbol": "AMZN",
  "public_float": 90.09050689636028,
  "stock_float": 454348048,
  "outstanding_shares": 504324000,
  "date": "2021-10-20"
}

Market Search API

You can search markets by stock name or company description.

https://api.finage.co.uk/search/market/{ market }/{ key }?limit={ limit }&apikey=YOUR_API_KEY

Params

```
market
```
= Market name like "us" , eu" etc. (Finage only support US market for now.)
key = Search key
```
limit
```
= Result limit

Queries

```
apikey
```
= Your API key

https://api.finage.co.uk/search/market/us/apple?limit=5&apikey=YOUR_API_KEY

Response

Please login to make an API request

{
  "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"
    }
  ]
}

Country Search

You can search the countries by country name or currency code.

https://api.finage.co.uk/search/country/{ key }?limit={ limit }&apikey=YOUR_API_KEY

Params

key = Search key
```
limit
```
= Result limit. [Default is 5]

Queries

```
apikey
```
= Your API key

https://api.finage.co.uk/search/country/gbp?limit=5&apikey=YOUR_API_KEY

Response

Please login to make an API request

{
  "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"
    },
    ...
  ]
}

Country Details

You can get the country details by country code.

https://api.finage.co.uk/detail/country/{ country_code }?apikey=YOUR_API_KEY

Params

```
country_code
```
= Country code [US, GB, DE, ...]

Queries

```
apikey
```
= Your API key

https://api.finage.co.uk/detail/country/gb?&apikey=YOUR_API_KEY

Response

Please login to make an API request

{
  "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"
}

Forex Currency Search

You can search the forex currencies by symbol name or currency details.

https://api.finage.co.uk/search/currency/{ key }?limit={ limit }&apikey=YOUR_API_KEY

Params

key = Search key
```
limit
```
= Result limit. [Default is 5]

Queries

```
apikey
```
= Your API key

https://api.finage.co.uk/search/currency/gbp?limit=5&apikey=YOUR_API_KEY

Response

Please login to make an API request

{
  "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"
    },
    ...
  ]
}

Forex Currency Details

You can get the currency details by currency name.

https://api.finage.co.uk/detail/currency/{ symbol }?apikey=YOUR_API_KEY

Params

```
symbol
```
= Forex currency symbol [eg. GBPUSD]

Queries

```
apikey
```
= Your API key

https://api.finage.co.uk/detail/currency/gbpusd?&apikey=YOUR_API_KEY

Response

Please login to make an API request

{
  "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"
}

Crypto Search API

You can get the details of the crypto by its name or symbol.

https://api.finage.co.uk/search/cryptocurrency/{ key }?limit={ limit }&apikey=YOUR_API_KEY

Params

key = Search key
```
limit
```
= Result limit

Queries

```
apikey
```
= Your API key

https://api.finage.co.uk/search/cryptocurrency/bitcoin?limit=5&apikey=YOUR_API_KEY

Response

Please login to make an API request

{
	"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},
		...
	]
}

Crypto Details API

You can search crypto by crypto name, description or symbol.

https://api.finage.co.uk/detail/cryptocurrency/{ key }?apikey=YOUR_API_KEY

Params

key = Symbol or full name of the crypto

Queries

```
apikey
```
= Your API key

https://api.finage.co.uk/detail/cryptocurrency/bitcoin?apikey=YOUR_API_KEY

Response

Please login to make an API request

{
	"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
}

Crypto Market Cap Ranks API

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.

https://api.finage.co.uk/list/cryptocurrency?apikey=YOUR_API_KEY

Queries

```
limit
```
= Output limit. Default is 10.
```
page
```
= This query will help you to use pagination. Default is 1.
```
sort
```
= You can use DESC to get the most valuable crypto or ASC to get opposite. Default is DESC.
```
apikey
```
= Your API key

https://api.finage.co.uk/list/cryptocurrency?apikey=YOUR_API_KEY&limit=2

Response

Please login to make an API request

{
    "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
        }
    ]
}

Crypto Detailed Last Price API

Finage has more than 1300+ cryptocurrency symbols in real-time.

https://api.finage.co.uk/last/crypto/detailed/btcusd?apikey=YOUR_API_KEY

Params

```
symbol
```
= Crypto symbol that you want to get price

Queries

```
apikey
```
= Your API key

https://api.finage.co.uk/last/crypto/detailed/btcusd?apikey=YOUR_API_KEY

With the given example above, you can get the last prices of the BTCUSD.

Response

An example response given below when you make an API request.

Please login to make an API request

{
	"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
}

It's that simple to use the last price API for the crypto.

Request a consultation

Products

Company

Apply for Partnership

Resources

Apps

Blog

The Evolution of High-Frequency Trading Technologies

Introduction High-frequency trading (HFT) stands as a groundbreaking technological leap within financial markets, placing paramount importance on speed and efficiency. It operates through intricate algorithms and high-speed data networks, enabling the execution of an extensive volume of orders at

The Role of APIs in Financial Innovation

Introduction Application Programming Interfaces (APIs) have emerged as catalysts for profound transformation within the financial sector, sparking innovation and revolutionizing the delivery of financial services. These APIs serve as pivotal bridges between disparate software applications, facilit

Please note that all data provided under Finage and on this website, including the prices displayed on the ticker and charts pages, are not necessarily real-time or accurate. They are strictly intended for informational purposes and should not be relied upon for investing or trading decisions. Redistribution of the information displayed on or provided by Finage is strictly prohibited. Please be aware that the data types offered are not sourced directly or indirectly from any exchanges, but rather from over-the-counter, peer-to-peer, and market makers. Therefore, the prices may not be accurate and could differ from the actual market prices. We want to emphasize that we are not liable for any trading or investing losses that you may incur. By using the data, charts, or any related information, you accept all responsibility for any risks involved. Finage will not accept any liability for losses or damages arising from the use of our data or related services. By accessing our website or using our services, all users/visitors are deemed to have accepted these conditions.

Finage LTD 2023