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

Stock Last Quote

You can get the last quote for a symbol with this endpoint.

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

Params

```
symbol
```
= Stock symbol that you want to get prices

Queries

```
apikey
```
= Your API key
```
ts
```
= Timestamp type. Default is ms (Millisecond). You can use ns for nanosecond timestamp.

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

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

Response

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

Please login to make an API request

{
	"symbol":"AAPL",
	"ask":118.55,
	"bid":118.53,
    "asize":3,
    "bsize":1,
	"timestamp":1604710766331
}

Parameters
- ```
symbol
```
  = Symbol of the stock
- ```
ask
```
  = Ask Price
- ```
bid
```
  = Bid Price
- ```
bsize
```
  = Bid size [lots]
- ```
asize
```
  = Ask size [lots]
- ```
timestamp
```
  = Last update (Defult is ms)

Multiple Stock Last Quotes

You can get the last quote for multiple symbols with this endpoint.

https://api.finage.co.uk/last/stocks/?symbols={ SYMBOL1, SYMBOL2, ... }&apikey=YOUR_API_KEY

Queries

```
symbols
```
= Multiple stock symbols seperated with commas. You can call up to 100 symbols in one request. Please note that calling one symbol always will give you more faster responses.
```
apikey
```
= Your API key
```
ts
```
= Timestamp type. Default is ms (Millisecond). You can use ns for nanosecond timestamp.

https://api.finage.co.uk/last/stocks/?symbols=AAPL,TSLA,GOGL&apikey=YOUR_API_KEY

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

Response

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

Please login to make an API request

{
  [
    {
      symbol: "AAPL",
      ask: 136.64,
      bid: 136.63,
      asize: 20,
      bsize: 8,
      timestamp: 1612799228260,
    },
    {
      symbol: "TSLA",
      ask: 869.37,
      bid: 869.1,
      asize: 1,
      bsize: 1,
      timestamp: 1612799228580,
    },
    {
      symbol: "GOGL",
      ask: 5.15,
      bid: 5.14,
      asize: 10,
      bsize: 44,
      timestamp: 1612799214069,
    },
  ];
}

Parameters
- ```
symbol
```
  = Symbol of the stock
- ```
ask
```
  = Ask Price
- ```
bid
```
  = Bid Price
- ```
bsize
```
  = Bid size [lots]
- ```
asize
```
  = Ask size [lots]
- ```
timestamp
```
  = Last update (Defult is ms)

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

Stock Last Trade

You can get the last trade for a symbol with this endpoint.

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

Params

```
symbol
```
= Stock symbol that you want to get prices

Queries

```
apikey
```
= Your API key
```
dp_filter
```
= You can filter the dark pools by setting this query as true. You will receive dp parameter in your responses to filter the dark pools. Default is false.
```
ts
```
= Timestamp type. Default is ms (Millisecond). You can use ns for nanosecond timestamp.

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

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

Response

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

Please login to make an API request

{
  "symbol": "AAPL",
  "price": 131.99,
  "size": 5,
  "timestamp": 1608847193770
}

Parameters
- ```
symbol
```
  = Symbol of the stock
- ```
price
```
  = Last Price
- size = Size of the last trade
- ```
timestamp
```
  = Last update (Defult is ms)

Stock Trade Ticks API

You can get the historical trades with tick level basis for a symbol with this endpoint.

https://api.finage.co.uk/ticks/trade/stock/{ symbol }?apikey=YOUR_API_KEY&date=REQUESTED_DATE

Params

```
symbol
```
= Stock symbol that you want to get prices

Queries

```
apikey
```
= Your API key
```
date
```
= Requested date [YYYY-MM-dd]. You can get the trade tickers for a day.
```
t
```
= Timestamp Offset. Recommended for pagination or starting from an exact timestamp.
```
sort
```
= You can use ASC or DESC for sorting the output. Default is ASC.
```
limit
```
= Result limit. (optional, default is 10)

https://api.finage.co.uk/ticks/trade/stock/AAPL?apikey=YOUR_API_KEY&date=2021-10-13

With the given example above, you can get historical trades with the tick level basis of the AAPL.

Response

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

Please login to make an API request

{
  "symbol": "AAPL",
  "totalResults": 10,
  "results": [
      {
        "p": 140.2,
        "c": [ 12, 41 ],
        "e": 11,
        "f": null,
        "v": 595,
        "sn": 3634,
        "t": 1634112000089980815
      },
      {
        "p": 140.1,
        "c": [ 12,  37 ],
        "e": 11,
        "f": null,
        "v": 6,
        "sn": 3675,
        "t": 1634112001024694367
      },...
  ]
}

Parameters
- ```
symbol
```
  = Symbol of the stock
- ```
totalResults
```
  = Total result count
- p = Last Price
- ```
c
```
  = Conditions
- ```
e
```
  = Market ID
- ```
f
```
  = Trade Reporting Facility
- ```
v
```
  = Volume
- ```
sn
```
  = Unique sequence number
- ```
t
```
  = Timestamp

Multiple Stock Last Trades

You can get the last trades for multiple symbols with this endpoint.

https://api.finage.co.uk/last/trade/stocks?symbols={ symbols }&apikey=YOUR_API_KEY

Queries

```
symbols
```
= Multiple stock symbols seperated with commas. You can call up to 100 symbols in one request. Please note that calling one symbol always will give you more faster responses.
```
apikey
```
= Your API key
```
ts
```
= Timestamp type. Default is ms (Millisecond). You can use ns for nanosecond timestamp.

https://api.finage.co.uk/last/trade/stocks?symbols=AAPL,TSLA,AMZN&apikey=YOUR_API_KEY

With the given example above, you can get the last prices of the AAPL, TSLA and AMZN.

Response

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

Please login to make an API request

[
  {
    symbol: "AAPL",
    price: 154.093,
    size: 70,
    timestamp: 1630677535003,
  },
  {
    symbol: "TSLA",
    price: 731.32,
    size: 10,
    timestamp: 1630677534830,
  },
  {
    symbol: "AMZN",
    price: 3447.74,
    size: 1,
    timestamp: 1630677534954,
  },
];

Parameters
- ```
symbol
```
  = Symbol of the stock
- ```
price
```
  = Last Price
- size = Size of the last trade
- ```
timestamp
```
  = Last update (Defult is ms)

US Stock Historical End of Day Data

End of day US Stock data updated every night at 12:00 ET.

https://api.finage.co.uk/history/stock/open-close?stock={ symbol }&date={ date }&apikey=YOUR_API_KEY

Queries

```
stock
```
= Requested stock
```
date
```
= Requested date (YYYY-MM-dd)
```
apikey
```
= Your API key

https://api.finage.co.uk/history/stock/open-close?stock=AAPL&date=2009-02-03&apikey=YOUR_API_KEY

Response

Please login to make an API request

{
  "symbol": "AAPL",
  "open": 3.2829,
  "high": 3.335,
  "low": 3.2243,
  "close": 3.3207,
  "volume": 599443264,
  "from": "2009-02-03"
}

Stock NBBO Quote Ticks API

You can get the US market NBBO quotes with a tick level basis for a symbol with this endpoint.

https://api.finage.co.uk/ticks/quote/stock/nbbo/{ symbol }?apikey=YOUR_API_KEY&date=REQUSTED_DATE

Params

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

Queries

```
apikey
```
= Your API key
```
date
```
= Requested date (YYYY-MM-dd)
```
t
```
= Timestamp Offset (optional)
```
sort
```
= You can use ASC or DESC for sorting the output. Default is ASC.
```
limit
```
= Result limit. (optional, default is 10)

https://api.finage.co.uk/ticks/quote/stock/nbbo/AAPL?date=2021-02-02&apikey=YOUR_API_KEY

With the given example above, you can get the NBBO quotes from selected date for AAPL.

Response

Please login to make an API request

{
  "symbol": "AAPL",
  "totalResults": 10,
  "results": [
    ...,
    {
      "a": 133.77,
      "b": 134,
      "asz": 3,
      "bsz": 2,
      "t": 1612170003738256030
    },
    {
      "a": 133.77,
      "b": 134,
      "asz": 2,
      "bsz": 2,
      "t": 1612170003763671034
    },...
  ]
}

Stock Market Aggregates API

With the Stock Market Aggregates endpoint, you can get the OHLCV bars of the stock market.

https://api.finage.co.uk/agg/stock/{ symbol }/{ multiply }/{ time }/{ from }/{ to }?apikey=YOUR_API_KEY

Params

```
symbol
```
= Symbol of the stock
```
multiply
```
= Time multiplier
```
time
```
= Size of the time. [minute, hour, day, week, month, quarter, year]
from = Start date
to = End date

Queries

```
apikey
```
= Your API key
```
unadjusted
```
= Unadjust the prices. Default is true.
```
limit
```
= Limit of the results. Default is 100, maximum allowed limit is 50000. Please set a limit if you are using the API in the production.
```
sort
```
= You can sort the results by timestamp. asc will return ascending results oldest to newest, desc will return descending results newest to oldest. Default is asc.
```
dbt_filter
```
= Daily-based time filter. You can allow the time filters to filter daily based. Otherwise, the filter will only trim the start and end of the output. Default is false.
st = Start time in UTC. (Eg. 17:30)
```
et
```
= End time in UTC. (Eg. 17:45)

https://api.finage.co.uk/agg/stock/AAPL/1/day/2020-02-05/2020-02-07?apikey=YOUR_API_KEY

You can get the tick bars of the AAPL with the given example above.

Response

Please login to make an API request

{
	"symbol":"AAPL",
	"totalResults":3,
	"results": [
		{ "o":80.88,"h":81.19,"l":79.7375,"c":80.3625,"v":118746872,"t":1580878800000 },
		{ "o":80.6425,"h":81.305,"l":80.0662,"c":81.3025,"v":105392140,"t":1580965200000 },
		{ "o":80.5925,"h":80.85,"l":79.5,"c":80.0075,"v":117684048,"t":1581051600000 }
	]
}

Parameters
- ```
symbol
```
  = Symbol of the stock
- ```
totalResults
```
  = Total result size
- ```
o
```
  = Open price
- ```
h
```
  = High price
- ```
l
```
  = Low price
- ```
c
```
  = Close price
- ```
v
```
  = Volume
- ```
t
```
  = Timestamp [ms]

Stock Market Batch Aggregates API

With the Stock Market Batch Aggregates endpoint, you can get the daily OHLCV bars of the entire stock market.

https://api.finage.co.uk/agg/stock/us/all{ date }?apikey=YOUR_API_KEY

Params

```
date
```
= The date that you want to get the daily aggregate bar.

Queries

```
apikey
```
= Your API key
```
unadjusted
```
= Unadjust the prices. Default is true.

https://api.finage.co.uk/agg/stock/us/all/2022-11-08?apikey=YOUR_API_KEY

You can get the daily tick bars of the entire US stock market.

Response

Please login to make an API request

{
	"totalResults":15339,
	"results": [
      { "s": "FRHLF", "o": 12.56, "h": 13.16, "l": 12.56, "c": 13.06, "v": 32132 },
      { "s": "CRXTQ", "o": 0.028, "h": 0.0299, "l": 0.0201, "c": 0.021, "v": 84737 },
    ...
	]
}

Parameters
- ```
totalResults
```
  = Total results
- ```
s
```
  = Symbol of the stock
- ```
o
```
  = Open price
- ```
h
```
  = High price
- ```
l
```
  = Low price
- ```
c
```
  = Close price
- ```
v
```
  = Volume

Stock Market Previous Close

With the Stock Market Previous Close API, you can get the previous day's last tick bar of the stock market.

https://api.finage.co.uk/agg/stock/prev-close/{ symbol }?apikey=YOUR_API_KEY

Params

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

Queries

```
apikey
```
= Your API key
```
unadjusted
```
= Unadjust the prices. Default is true.

https://api.finage.co.uk/agg/stock/prev-close/AAPL?apikey=YOUR_API_KEY

You can get the previous day's last tick bar of the AAPL with the given example above.

Response

Please login to make an API request

{
  "symbol": "AAPL",
  "totalResults": 1,
  "results": [
    {
      "o": 124.81,
      "h": 125.71,
      "l": 121.84,
      "c": 122.06,
      "v": 112966340,
      "t": 1614805200000
    }
  ]
}

Parameters
- ```
symbol
```
  = Symbol of the stock
- ```
totalResults
```
  = Total result size
- ```
o
```
  = Open price
- ```
h
```
  = High price
- ```
l
```
  = Low price
- ```
c
```
  = Close price
- ```
v
```
  = Volume
- ```
t
```
  = Timestamp [ms]

Stock Snapshot API

Stock Snapshot API will give you access to all U.S Market with one single API request. You can get the latest trades, quotes or both of them with one request.

Snapshot might not be available if the market is closed for a while.

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

Queries

```
quotes
```
= Enable or disable last quotes. Default is true.
```
trades
```
= Enable or disable last trades. Default is false.
```
symbols
```
= You can get the data from specific symbols by using this query. If you leave it empty, you will get the all available last data. (Separate symbols with commas.)
```
apikey
```
= Your API key

https://api.finage.co.uk/snapshot/stock?quotes=true&trades=true&symbols=AAPL,TSLA&apikey=YOUR_API_KEY

📌 You can enable Gzip compression to obtain the best performance in your application. Check out the pros of the Gzip Compression.

Response

Please login to make an API request

{
  "totalResults": 2,
  "lastQuotes": [
    {
      "s": "AAPL",
      "a": 158.91,
      "b": 158.9,
      "asz": 1,
      "bsz": 1,
      "t": 1643228002555941
    },
    {
      "s": "TSLA",
      "a": 923.94,
      "b": 922.25,
      "asz": 1,
      "bsz": 2,
      "t": 1643228002555043
    }
  ],
  "lastTrades": [
    {
      "s": "AAPL",
      "p": 158.91,
      "sz": 100,
      "t": 1643228002555941
    },
    {
      "s": "TSLA",
      "p": 923.4,
      "sz": 200,
      "t": 1643228002555043
    }
  ]
}

Parameters
- ```
s
```
  = Stock symbol
- p = Last trade price
- a = Last ask price
- b = Last bid price
- ```
asz
```
  = Ask size
- ```
bsz
```
  = Bid size
- ```
sz
```
  = Trade size
- ```
t
```
  = Timestamp (microseconds)
- ```
totalResults
```
  = Total incoming symbol number.

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