Stock Price API

The Stock Price API provides access to real-time and historical stock market prices for companies in every major exchange around the world.

/v1/stockprice GET

https://api.api-ninjas.com/v1/stockprice

Returns the current price information for any given ticker symbol. Want historical stock prices? Use the /v1/stockpricehistorical endpoint instead.


Parameters

  • ticker  required

    Stock ticker symbol (e.g., AAPL).

Headers

  • X-Api-Key  required

    API Key associated with your account.

Sample Request Live Demo!

ticker
https://api.api-ninjas.com/v1/stockprice?ticker=AAPL

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
1 2 3 4 5 6 7 8 { "ticker": "AAPL", "name": "Apple Inc.", "price": 192.42, "exchange": "NASDAQ", "updated": 1706302801, "currency": "USD" }

Code Examples

1 2 3 4 5 6 7 8 import requests symbol = 'AAPL' api_url = 'https://api.api-ninjas.com/v1/stockprice?ticker={}'.format(symbol) response = requests.get(api_url, headers={'X-Api-Key': 'YOUR_API_KEY'}) if response.status_code == requests.codes.ok: print(response.text) else: print("Error:", response.status_code, response.text)

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.

/v1/stockpricehistorical GETPremium Only

https://api.api-ninjas.com/v1/stockpricehistorical

Returns historical price data in OHLCV (Open, High, Low, Close, Volume) format for any given ticker symbol.

To get the 'price' for a particular period, use the close value from the response.


Parameters

  • ticker  required

    Stock ticker symbol (e.g., AAPL).

  • period  optional

    Time interval between data points. Valid values are: 1m, 5m, 15m, 30m, 1h, 4h. Default is 1h.

  • start  optional

    Start timestamp in Unix format. If not provided, defaults to 24 hours ago.

  • end  optional

    End timestamp in Unix format. If not provided, defaults to current time.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Historical Price Sample Request

https://api.api-ninjas.com/v1/stockpricehistorical?ticker=AAPL&period=1h&start=1706000000&end=1706302801

Historical Price Sample Response

JSON
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 [ { "open": 192.425, "low": 191.94, "high": 192.59, "close": 192.3, "volume": 8363236, "time": 1706283000 }, { "open": 192.48, "low": 192.34, "high": 192.975, "close": 192.425, "volume": 3467330, "time": 1706279400 }, { "open": 192.66, "low": 192.27, "high": 192.73, "close": 192.4751, "volume": 3375199, "time": 1706275800 }, "..." ]