Finage - Documentation

Docs

API

WebSocket

Symbols

Widgets

Home Page

Back

Docs /

Getting Started

Gzip Compression

U.S Stocks

Forex

Crypto

CFD Indices

CFD ETFS

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)

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 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 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 Role of Smart Contracts in Automated Trading

By now you should have heard of smart contracts. This is true especially for those that deal with cryptocurrency. This together with anything built on blockchain technology relies on smart contracts. The use of this tool extends to many areas, especially finance. They have revolutionized the way t

Strategic ETF Investments: New Perspectives for Higher Returns

Exchange-traded funds (ETFs) have revolutionized the investment landscape, offering investors a flexible and cost-effective way to diversify their portfolios. As the ETF market continues to expand, strategic approaches to ETF investments are becoming increasingly important for achieving higher ret

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 2024