Get Latest Stock Price

Get the most recent stock price data for any publicly traded company. This endpoint returns a single record for the latest available trading day, including the open, high, low, close, adjusted close, volume, VWAP, and daily change.

Use this endpoint when you need the current price for a single stock without fetching a full historical series. It is ideal for portfolio dashboards, watchlist displays, or any context where you only need today's data.

GEThttps://api.roic.ai/v2/stock-prices/latest/{identifier}
Request
curl "https://api.roic.ai/v2/stock-prices/latest/AAPL?apikey=YOUR_API_KEY"
Response
200 OK
{
  "date": "2024-12-20",
  "open": 254.77,
  "high": 255.27,
  "low": 248.68,
  "close": 249.79,
  "adj_close": 249.45,
  "volume": 57620328,
  "change": -4.98,
  "change_percent": -1.954,
  "vwap": 251.22
}

Parameters

Path parameters

identifierstringrequired

Company identifier — supports ticker symbol (e.g., AAPL), CIK, CUSIP, or ISIN.

Example: AAPL

Query parameters

formatstring

Response format. Use json for JSON (default) or excel for tab-separated values compatible with Google Sheets and Excel.

Default: jsonValues: jsonexcel

Response

Response fields

datestring

The trading day the prices refer to, in YYYY-MM-DD format.

opennumber

Price of the first trade of the regular session, in the listing currency.

highnumber

Highest price traded during the session.

lownumber

Lowest price traded during the session.

closenumber

Price of the last trade of the regular session. Not adjusted for splits or dividends that happened afterwards.

adj_closenumber

Closing price retroactively adjusted for stock splits and dividends. Use this series for return calculations and long-horizon charts.

volumenumber

Total number of shares traded during the session, adjusted for later stock splits.

changenumber

Absolute change of the closing price versus the previous trading day's close, in the listing currency. Negative on down days.

change_percentnumber

Percentage change of the closing price versus the previous trading day's close, e.g. -1.954 for a 1.954% decline.

vwapnumber

Volume-weighted average price of the session: total traded value divided by total volume. Commonly used as an execution benchmark.

Use Cases

  • Portfolio dashboards. Display the current price and daily change for each holding in a portfolio tracker
  • Watchlist alerts. Poll the latest price to trigger notifications when a stock crosses a target price
  • Pricing widgets. Embed a stock price widget on company pages, financial blogs, or research platforms
  • Spreadsheet models. Use format=excel with Google Sheets IMPORTDATA() to pull the latest quote into a live financial model
  • Market scanners. Fetch the latest price for a batch of tickers to screen for daily movers, volume spikes, or gap openings
  • Quick lookups. Build a simple API integration that returns the current price for any ticker on demand

Related Endpoints

  • Historical Stock Prices - Get daily price data for any date range with OHLCV, volume, and VWAP
  • Company Profile - Get company details including sector, industry, market cap, and description
  • Financial Ratios - Access profitability, liquidity, and valuation ratios alongside current price data