financialmodelingprep / stocks-api

That describes how to use stock API's on financialmodelingprep.com.

Stock API Documentation

This describes how to use a free stock API's using financialmodelingprep.com.

GET YOUR APIKEY IN SECOND ON https://site.financialmodelingprep.com/developer/docs

1. Real-time price
2. Stock price list
3. Stock historical prices

Real-time price

GET https://financialmodelingprep.com/v3/quote-short/{symbol}?apikey=YOUR_API_KEY

This is a quick endpoint that only returns the stock price. If you only need a price, this endpoint is preferable to the profile endpoint or quote because it is faster and lighter. The price returned is the current price at the time you made your request.

Documentation: https://site.financialmodelingprep.com/developer/docs/realtime-stock-quote-api#Stock-Real-time-Price

Request Parameters:

String symbol : Company Symbol, ex. AAPL
String apikey : your ApiKey

Response Example:

{
  "symbol" : "AAPL",
  "price" : 318.68
}

Stock price list

GET https://financialmodelingprep.com/api/v3/quotes/{exchange}?apikey=YOUR_API_KEY

All Real-time stock prices.

Documentation: https://site.financialmodelingprep.com/developer/docs/realtime-stock-quote-api#Stock-Price-list

Request Parameters:

String exchange : String, ex. nyse
String apikey : your ApiKey

Response Example:

[{
  "symbol" : "AAPL",
  "name" : "Apple Inc.",
  "price" : 156.81000000,
  "changesPercentage" : -3.16784300,
  "change" : -5.13000500,
  "dayLow" : 156.36000000,
  "dayHigh" : 160.44800000,
  "yearHigh" : 165.70000000,
  "yearLow" : 116.21000000,
  "marketCap" : 2572687507456.00000000,
  "priceAvg50" : 148.28620000,
  "priceAvg200" : 138.18630000,
  "volume" : 72367719,
  "avgVolume" : 78850734,
  "exchange" : "NASDAQ",
  "open" : 159.56500000,
  "previousClose" : 161.94000000,
  "eps" : 5.61000000,
  "pe" : 27.95187000,
  "earningsAnnouncement" : "2022-01-25T10:59:00.000+0000",
  "sharesOutstanding" : 16406399512,
  "timestamp" : 1638015369
},{
  "symbol" : "FB",
  "name" : "Meta Platforms, Inc.",
  "price" : 333.12000000,
  "changesPercentage" : -2.32803700,
  "change" : -7.94000240,
  "dayLow" : 331.90200000,
  "dayHigh" : 337.75000000,
  "yearHigh" : 384.33000000,
  "yearLow" : 244.61000000,
  "marketCap" : 948745732096.00000000,
  "priceAvg50" : 335.99740000,
  "priceAvg200" : 327.78296000,
  "volume" : 12059658,
  "avgVolume" : 21449852,
  "exchange" : "NASDAQ",
  "open" : 335.79500000,
  "previousClose" : 341.06000000,
  "eps" : 13.97400000,
  "pe" : 23.83855600,
  "earningsAnnouncement" : "2022-01-25T10:59:00.000+0000",
  "sharesOutstanding" : 2848059955,
  "timestamp" : 1638015468
},{}]

GET https://financialmodelingprep.com/api/v3/historical-price-full/{symbol}?apikey=YOUR_API_KEY

Stock historical prices

These endpoints provides access to historical prices that can be used to create charts. It's updated every day and can go back 15 years in time. You can also get a more than one stock with a single request, for example: historical-price-full/AAPL,FB.

Request Parameters:

String symbol : Company Symbol, ex. AAPL
String apikey : your ApiKey

Response Example:

{
  "symbol" : "AAPL",
  "historical" : [ {
      "date" : "2021-10-08",
      "open" : 144.03,
      "high" : 144.17,
      "low" : 142.56,
      "close" : 142.9,
      "adjClose" : 142.9,
      "volume" : 5.545036E7,
      "unadjustedVolume" : 5.545036E7,
      "change" : -1.13,
      "changePercent" : -0.785,
      "vwap" : 143.21,
      "label" : "October 08, 21",
      "changeOverTime" : -0.00785
    }, {
      "date" : "2021-10-07",
      "open" : 143.06,
      "high" : 144.215,
      "low" : 142.73,
      "close" : 143.29,
      "adjClose" : 143.29,
      "volume" : 6.1863761E7,
      "unadjustedVolume" : 6.1863761E7,
      "change" : 0.23,
      "changePercent" : 0.161,
      "vwap" : 143.41167,
      "label" : "October 07, 21",
      "changeOverTime" : 0.00161
    }, { "...": "..." }
  ]
}

GET /v3/historical-chart/1min/{symbol}

Stock one minute historical stock prices.

Documentation: https://site.financialmodelingprep.com/developer/docs/historical-stock-data-free-api#1-minute-historical-stock-prices-with-volume

GET /v3/historical-chart/5min/{symbol}

Stock five minutes historical stock prices.

Documentation: https://site.financialmodelingprep.com/developer/docs/historical-stock-data-free-api#5-minutes-historical-stock-prices-with--volume

GET /v3/historical-chart/15min/{symbol}

Stock fifteen minutes historical stock prices.

Documentation: https://site.financialmodelingprep.com/developer/docs/historical-stock-data-free-api#15-minutes-historical-stock-prices-with-volume

GET /v3/historical-chart/30min/{symbol}

Stock thirty minutes historical stock prices.

Documentation: https://site.financialmodelingprep.com/developer/docs/historical-stock-data-free-api#30-minutes-historical-stock-prices-with-volume

GET /v3/historical-chart/1hour/{symbol}

Stock hour historical stock prices.

Documentation: https://site.financialmodelingprep.com/developer/docs/historical-stock-data-free-api#Hour-historical-stock-prices-with-volume

GET /v3/historical-chart/4hour/{symbol}

Stock four hours historical stock prices.

Documentation: https://site.financialmodelingprep.com/developer/docs/historical-stock-data-free-api#4-Hours-historical-stock-prices-with-volume

GET /v3/historical-price-full/{symbol}

Stock daily historical prices.

You may pass more parameters here:

to : YYYY-MM-DD, ex. 2020-08-15
from : YYYY-MM-DD, ex. 2020-08-14
timeseries : Number (return last x days), ex. 5

And also you may pass more than one company, ex: AAPL,GOOGL, FB. Limited to 3.

Documentation: https://site.financialmodelingprep.com/developer/docs/historical-stock-data-free-api#Historical-Daily-Prices