Historical Price Data

Security Identification

You can identify securities using either a symbol or an ISIN, but not both simultaneously. Choose the method that best fits your use case.

Symbol Usage

Use the symbol parameter when you know the specific ticker symbol:

{ symbol: "AAPL" }

ISIN Usage

Use the isin parameter when you have the International Securities Identification Number:

{ isin: "US0378331005" }

Important Notes

Multiple Tickers per ISIN

⚠️ Note: A single ISIN may correspond to multiple ticker symbols, as the same security can be traded on different exchanges. When using an ISIN, our system will automatically select the best matching ticker based on:

Trading volume
Exchange priority
Data availability
Market hours alignment

Examples of Multiple Tickers

For example, the ISIN US0378331005 (Apple Inc.) might be found as:

AAPL on NASDAQ
APC.DE on Frankfurt Stock Exchange
AAPL.MX on Mexican Stock Exchange

The system will prioritize the most liquid and relevant market for your query.

Parameter Rules

✅ Use either symbol OR isin
❌ Never use both parameters together
✅ System handles ticker selection automatically for ISINs
✅ Results will indicate which ticker was selected

Error Handling

If you provide both parameters, the API will return an error:

{
  "error": "Cannot use both 'symbol' and 'isin' parameters. Please choose one."
}

Ordering Guarantee

All data entries are ordered ascending by date by default.
This ordering is guaranteed and does not require manual sorting.

Field Descriptions

Field	Type	Description
symbol	string	The ticker symbol of the security (e.g., "MSFT").
currency	string	The currency in which prices are denominated (e.g., "USD").
adjusted	boolean	Indicates if prices are adjusted for splits and dividends.
data	array	Array of historical price data objects.
date	string	ISO 8601 formatted date of the price record (e.g., "1986-03-13").
close	number	Closing price of the security on the specified date.

API Status Codes

Here are the common HTTP status codes you may encounter when using our API:

Status Code	Meaning	Description
200	OK	✅ The request was successful, and the expected data was returned.
401	Unauthorised	🔐 Your API key is missing or invalid. Please authenticate properly.
403	Forbidden	⛔ You are authenticated but do not have access to this resource.
404	Not Found	🔎 The requested endpoint or resource could not be found.
500	Server Error	🛠️ An unexpected error occurred on our servers. Please try again later.