GET
/
historical
/
{symbol}
Get historical stock data
curl --request GET \
  --url https://api.financialcontext.com/historical/{symbol} \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "data": {
    "id": "qh_123456",
    "symbol": "AAPL",
    "datetime": "<string>",
    "open": 150.25,
    "high": 152.8,
    "low": 149.5,
    "close": 151.75,
    "adjusted_close": 151.75,
    "volume": 75000000,
    "turnover": 11375000000,
    "trade_count": 450000,
    "vwap": 151.67,
    "period": "1day",
    "currency": "USD",
    "is_adjusted": true,
    "adjustment_type": "all",
    "split_factor": 1,
    "dividend_amount": 0,
    "data_source": "YAHOO_FINANCE",
    "data_quality": "high",
    "is_trading_day": true,
    "market_status": "regular",
    "createdAt": "<string>",
    "updatedAt": "<string>"
  },
  "message": "<string>",
  "timestamp": "2023-11-07T05:31:56Z",
  "meta": {
    "pagination": {
      "currentPage": 1,
      "pageSize": 20,
      "totalItems": 150,
      "totalPages": 8,
      "hasMore": true,
      "hasPrevious": false
    }
  }
}

Authorizations

​
X-API-Key
string
header
required

Path Parameters

​
symbol
string
required

Stock symbol (e.g., AAPL, NASDAQ:AAPL)

Required string length: 1 - 20
Example:

"AAPL"

Query Parameters

​
periods
enum<string>[]

Filter by data periods

​
interval
enum<string>

Data interval filter

Available options:
1m,
2m,
5m,
15m,
30m,
60m,
90m,
1h,
1d,
5d,
1wk,
1mo,
3mo
Example:

"1d"

​
adjustment_type
enum<string>

Filter by adjustment type

Available options:
none,
splits,
dividends,
all
Example:

"all"

​
min_price
number

Minimum price filter

Required range: x > 0
Example:

100

​
max_price
number

Maximum price filter

Required range: x > 0
Example:

200

​
min_volume
integer

Minimum volume filter

Required range: 0 <= x <= 9007199254740991
Example:

1000000

​
max_volume
integer

Maximum volume filter

Required range: 0 <= x <= 9007199254740991
Example:

100000000

​
include_adjusted
boolean
default:true

Include adjusted prices

Example:

true

​
trading_days_only
boolean
default:true

Include only trading days

Example:

true

​
market_status
enum<string>[]

Filter by market status

​
data_quality
enum<string>[]

Filter by data quality

​
sort_by
enum<string>
default:datetime

Sort by field

Available options:
datetime,
volume,
close,
high,
low,
createdAt
Example:

"datetime"

​
sort_order
enum<string>
default:desc

Sort order

Available options:
asc,
desc
Example:

"desc"

​
aggregation
enum<string>
default:none

Data aggregation type

Available options:
none,
daily,
weekly,
monthly
Example:

"none"

​
from
string | null

Start date, format YYYY-MM-DD

Example:

"2023-01-01"

​
to
string | null

End date, format YYYY-MM-DD

Example:

"2023-12-31"

​
page
integer
default:1

Page number, starting from 1

Required range: -9007199254740991 <= x <= 9007199254740991
Example:

1

​
page_size
integer
default:10

Number of items per page, range 1-100

Required range: -9007199254740991 <= x <= 9007199254740991
Example:

10

Response

Historical data retrieved successfully

Single historical quote response

​
success
boolean
required

Indicates successful API response

​
data
object | null
required

Historical quote data Historical stock quote data

​
timestamp
string<date-time>
required

ISO 8601 timestamp of the response

​
message
string

Optional success message

​
meta
object

Optional metadata including pagination, statistics, and additional context