# Datum API — Full Endpoint Inventory **API:** Datum API v2.7.0 (OpenAPI 3.0.2) **Endpoints:** 100 (all GET) ## Categories | Category | Count | |---|---| | `/calculations` | 36 | | `/intraday` | 17 | | `/daily` | 8 | | `/dvd` | 6 | | `/tickers` | 6 | | `/cache` | 3 | | `/auctions` | 2 | | `/bics_sectors` | 2 | | `/calendar` | 2 | | `/corporate_actions` | 2 | | `/latest_close_prices` | 2 | | `/opg_and_clo` | 2 | | `/ratings` | 2 | | `/reports` | 2 | | `/countries` | 1 | | `/futures` | 1 | | `/holidays` | 1 | | `/imbalance` | 1 | | `/release_notes` | 1 | | `/short_days` | 1 | | `/snapshots` | 1 | | `/working_days` | 1 | ## /auctions ### `GET /auctions` **Get Auctions** Get Auctions. ## Parameters: ### Date parameters - start_date: str in iso format (YYYY-MM-DD) in query params - end_date: str in iso format (YYYY-MM-DD, example: 2022-01-01) in query params ### Ticker ticker: str, optional, in query params, if it is null, endpoint returns auctions of active US stocks, but in this case max date range of auction data is 5 days ### Auction auction_type: str, optional, in query params, can be: - open - close - reopen - empty (null) - in this case endpoint returns all of above auctions **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `start_date` | query | `string` | ✅ | `` | | | `end_date` | query | `string` | ✅ | `` | | | `ticker` | query | `string` | | `` | | | `auction_type` | query | `string` | | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /auctions/gaps` **Get Auctions** Get auction gaps: diff in percents between open auction and previous market date close auction. ## Parameters: ### Date parameters - start_date: str in iso format (YYYY-MM-DD, example: 2022-01-01) in query params - end_date: str in iso format (YYYY-MM-DD) in query params ### Ticker ticker: str, optional, in query params, if it is null, endpoint returns auctions of active US stocks, but in this case max date range of auction data is 5 days **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `start_date` | query | `string` | ✅ | `` | | | `end_date` | query | `string` | ✅ | `` | | | `ticker` | query | `string` | | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ## /bics_sectors ### `GET /bics_sectors` **Get Bics Sectors By Ticker** ## Parameters: ### Ticker parameters - ticker: str in query params - tickers: list in body of the request (disabled in this swagger) ### bics sector levels parameters - lvl1: bool Level 1 in bics. Default: False - lvl2: bool Level 2 in bics. Default: False - lvl3: bool Level 3 in bics. Default: True - lvl4: bool Level 4 in bics. Default: False - lvl5: bool Level 5 in bics. Default: False **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `ticker` | query | `string` | | `` | | | `lvl1` | query | `boolean` | | `False` | | | `lvl2` | query | `boolean` | | `False` | | | `lvl3` | query | `boolean` | | `True` | | | `lvl4` | query | `boolean` | | `False` | | | `lvl5` | query | `boolean` | | `False` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /bics_sectors/{level}` **Get Sector List By Level** **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `level` | path | `string` | ✅ | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ## /cache ### `GET /cache/charts_zip` **Get Charts Zip** returns cache with charts > ⚠️ DEPRECATED **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `filename` | query | `string` | | `Charts.zip` | | --- ### `GET /cache/files` **Get Charts Zip** Returns all archive files with chart data for requested file_group. ## Parameters: ### file_group str. The name of the archive group. It is also part of archive names ("-.zip"). The following groups are allowed: - ChartsV2 - Charts_futures For example, providing "ChartsV2" will return: ["ChartsV2-2025-01-09.zip", "ChartsV2-2025-01-08.zip"] > ⚠️ DEPRECATED **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `file_group` | query | `string` | | `ChartsV2` | | --- ### `GET /cache/signed_urls` **Get Gcp Charts Zip** Returns signed URLs to download the requested chart cache file archive from GCP bucket. each URL is valid for a limited time (5 minutes). ## Parameters: ### file_group str. The name of the archive group. It is also part of archive names ("-.zip"). The following groups are allowed: - ChartsV2 - Charts_futures **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `file_group` | query | `string` | | `ChartsV2` | | --- ## /calculations ### `GET /calculations/avg_daily_value_traded_20d` **Get Average Daily Value Traded 20D** **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `date_as_of_str` | query | `string` | ✅ | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /calculations/avg_daily_value_traded_3m` **Get Average Daily Value Traded 3M** **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `date_as_of_str` | query | `string` | ✅ | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /calculations/avg_daily_volume_20d` **Get Average Daily Volume 20D** A metric that returns the average daily volume over the last 20 market days Calculation is based on daily data. ## Parameters: - tickers: list in body of the request (disabled in this swagger), not required. If it is not used, method returns measures of US tickers. - date_as_of: str in query params **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `date_as_of` | query | `string` | ✅ | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /calculations/avg_daily_volume_90d` **Get Average Daily Volume 90D** A metric that returns the average daily volume over the last 90 market days Calculation is based on daily data. ## Parameters: - tickers: list in body of the request (disabled in this swagger), not required. If it is not used, method returns measures of US tickers. - date_as_of: str in query params **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `date_as_of` | query | `string` | ✅ | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /calculations/avg_daily_volume_ex_finr_20d` **Get Average Daily Volume Ex Finr 20D** Get average daily volume excluding FINR trades over the last 20 market days Calculation is based on tape data. ## Parameters: - date_as_of: str in query params **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `date_as_of` | query | `string` | ✅ | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /calculations/avg_daily_volume_ex_finr_90d` **Get Average Daily Volume Ex Finr 90D** Get average daily volume excluding FINR trades over the last 90 market days Calculation is based on tape data. ## Parameters: - date_as_of: str in query params **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `date_as_of` | query | `string` | ✅ | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /calculations/avg_postmarket_volume_ex_finr_90d` **Get Average Postmarket Volume Ex Finr 90D** Get average postmarket volume excluding FINR trades over the last 90 calendar days. Calculation is based on tape data (same values as PostVolTape field in the Analyzer or postmkt field in the /daily/volume_ex_finr endpoint). **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `date_as_of` | query | `string` | ✅ | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /calculations/avg_premarket_value_traded_ex_finr_20d` **Get Avg Premarket Value Traded Ex Finr 20D** Average daily money traded in premarket hours over the last 20 market days, excluding FINR trades Calculation is based on tape data. **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `date_as_of` | query | `string` | ✅ | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /calculations/avg_premarket_value_traded_ex_finr_3m` **Get Avg Premarket Value Traded Ex Finr 3M** Average daily money traded in premarket hours over the last 3 calendar months, excluding FINR trades Calculation is based on tape data. **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `date_as_of` | query | `string` | ✅ | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /calculations/avg_premarket_volume_90d` **Get Average Premarket Volume 90D** Get average premarket volume over the last 90 calendar days. Calculation is based on intraday chart data (same values as PreVolChart field in the Analyzer) by default and tape data if parameter by_tape is True (same as PreVolTape field in the Analyzer). ## Parameters: - date_as_of: str in query params - by_tape: bool, optional in query params, if it is True, calculation is based on tape data, in other cases - on daily data. **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `date_as_of` | query | `string` | ✅ | `` | | | `by_tape` | query | `boolean` | | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /calculations/avg_premarket_volume_ex_finr_90d` **Get Average Premarket Volume Ex Finr 90D** Get average premarket volume excluding FINR trades over the last 90 calendar days. Calculation is based on tape data (same values as PreVolTape field in the Analyzer or premkt field in the /daily/volume_ex_finr endpoint). **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `date_as_of` | query | `string` | ✅ | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /calculations/avg_true_range_14d` **Get Average True Range 14D** **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `date_as_of` | query | `string` | ✅ | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /calculations/corr_beta` **Get Corr Beta** Get correlation coefficient and beta for x_ticker on each ticker from y_tickers, entered as csv (comma-separated values). Endpoint returns values in descending order by correlation coefficient ## Parameters: - x_ticker: str - y_tickers: str in csv format, default: "QQQ,SPY" **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `x_ticker` | query | `string` | | `` | | | `y_tickers` | query | `string` | | `QQQ,SPY` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /calculations/corr_beta/v2` **Get Corr Beta V2** Get correlation coefficient and beta for each ticker in x_tickers on each ticker from y_tickers, like in the Profiler ## Parameters: - x_tickers: str ticker list in csv format, for example: "AAPL,AMZN" - y_tickers: str etf list in csv format, for example: "QQQ,SPY" - period: str period of data calculation, default: "3 months", can be one of ["2 weeks (no sector filter)", "1 month (no sector filter)", "3 months", "6 months", "12 months"] - as_pivot: bool return data in pivot table format **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `x_tickers` | query | `string` | | `` | | | `y_tickers` | query | `string` | | `` | | | `period` | query | `string` | | `3 months` | | | `as_pivot` | query | `boolean` | | `False` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /calculations/high_low_52w` **Get High Low 52W** Get 52-Week High/Low for active US stocks by date. ## Parameters: ### Date date: str in iso format (YYYY-MM-DD, example: 2022-01-01) **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `date_as_of` | query | `string` | ✅ | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /calculations/high_low_all_time` **Get High Low All Time** Get the all time High/Low for active US stocks up to the date_as_of. ## Parameters: ### Date date_as_of: str in iso format (YYYY-MM-DD, example: 2024-01-01) **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `date_as_of` | query | `string` | ✅ | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /calculations/median_auction_money_traded_20d` **Get Median Auction Money Traded 20D** Get median auction volume over the last 20 market days: ## Parameters: - date_as_of: str in query params; - auction_type: str in query params, can be: open, close, reopen; - exclude_reports: bool in query params, default: True, if True, exclude reports from calculations. **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `date_as_of` | query | `string` | ✅ | `` | | | `auction_type` | query | `string` | | `open` | | | `exclude_reports` | query | `boolean` | | `True` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /calculations/median_daily_value_traded_20d` **Get Median Daily Value Traded 20D** **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `date_as_of_str` | query | `string` | ✅ | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /calculations/median_daily_value_traded_3m` **Get Median Daily Value Traded 3M** **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `date_as_of_str` | query | `string` | ✅ | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /calculations/median_daily_volume_20d` **Get Median Daily Volume 20D** A metric that returns the median daily volume over the last 20 market days. Calculation is based on daily data. ## Parameters: - tickers: list in body of the request (disabled in this swagger), not required. If it is not used, method returns measures of US tickers. - date_as_of: str in query params **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `date_as_of` | query | `string` | ✅ | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /calculations/median_daily_volume_90d` **Get Median Daily Volume 90D** A metric that returns the median daily volume over the last 90 market days Calculation is based on daily data. ## Parameters: - tickers: list in body of the request (disabled in this swagger), not required. If it is not used, method returns measures of US tickers. - date_as_of: str in query params **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `date_as_of` | query | `string` | ✅ | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /calculations/median_daily_volume_ex_finr_20d` **Get Median Daily Volume Ex Finr 20D** Get median daily volume excluding FINR trades over the last 20 market days Calculation is based on tape data. ## Parameters: - date_as_of: str in query params **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `date_as_of` | query | `string` | ✅ | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /calculations/median_daily_volume_ex_finr_90d` **Get Median Daily Volume Ex Finr 90D** Get median daily volume excluding FINR trades over the last 90 market days. Calculation is based on tape data. ## Parameters: - date_as_of: str in query params **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `date_as_of` | query | `string` | ✅ | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /calculations/median_opg_volume_20d` **Get Median Opg Volume 20D** Get median OPEN auction (OPG) volume over the last 20 market days: ## Parameters: - date_as_of: str in query params **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `date_as_of` | query | `string` | ✅ | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /calculations/median_postmarket_volume_ex_finr_90d` **Get Median Postmarket Volume Ex Finr 90D** Get median postmarket volume excluding FINR trades over the last 90 calendar days. Calculation is based on tape data (same values as PostVolTape field in the Analyzer or postmkt field in the /daily/volume_ex_finr endpoint). **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `date_as_of` | query | `string` | ✅ | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /calculations/median_premarket_value_traded_ex_finr_20d` **Get Median Premarket Value Traded Ex Finr 20D** Median daily money traded in premarket hours over the last 20 market days, excluding FINR trades Calculation is based on tape data. **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `date_as_of` | query | `string` | ✅ | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /calculations/median_premarket_value_traded_ex_finr_3m` **Get Median Premarket Value Traded Ex Finr 3M** Median daily money traded in premarket hours over the last 3 calendar months, excluding FINR trades Calculation is based on tape data. **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `date_as_of` | query | `string` | ✅ | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /calculations/median_premarket_volume_90d` **Get Median Premarket Volume 90D** Get median premarket volume over the last 90 calendar days. Calculation is based on intraday chart data (same values as PreVolChart field in the Analyzer). **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `date_as_of` | query | `string` | ✅ | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /calculations/median_premarket_volume_ex_finr_90d` **Get Median Premarket Volume Ex Finr 90D** Get median premarket volume excluding FINR trades over the last 90 calendar days. Calculation is based on tape data (same values as PreVolTape field in the Analyzer or premkt field in the /daily/volume_ex_finr endpoint). **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `date_as_of` | query | `string` | ✅ | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /calculations/median_true_range_20d` **Get Median True Range 20D** Get median true range (MTR) over the last 20 market days calculated as: - TR = max(high-low, abs(high-prev_close), abs(low-prev_close))/prev_close); - TR% = (TR/prev_close)*100%; - MTR = median(TR%) over the last 20 market days ## Parameters: - date_as_of: str in query params **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `date_as_of` | query | `string` | ✅ | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /calculations/profiler_top_correlation` **Get Profiler Top Correlation** Get correlation coefficients between tickers (from US Base and US Secondary sorter), similar to the Profiler top correlation table. It returns the top correlated tickers with a coefficient > 0.5, but not more than 30 tickers. Results are sorted by correlation coefficient in descending order. ## Parameters: - ticker: str ticker for which find top correlations **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `ticker` | query | `string` | | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /calculations/profiler_volume` **Get Profiler Volume** Get volume calculations which are used in the Profiler: - avg_premkt_vol - avg_premkt_vol_reports **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /calculations/volatility` **Get Volatility** Get volatility (abstract meaning, as measure of price fluctuations) values, which you can find in the TickerDays product. All values are scaled to daily. It makes comparison between price moves (like gaps, cls%, etc.) and volatility measures easier. For more details about volatility, please, refer to #1210 publication in Datum. ## Parameters: ### Date parameters: To set date range for volatility values, use both of the following parameters: - start_date: str in iso format (YYYY-MM-DD, example: 2024-01-01) in query params - end_date: str in iso format (YYYY-MM-DD, example: 2024-01-01) in query params ### Ticker ticker: str, in query params, if it is null, endpoint returns volatility of active US stocks, but in this case max date range is 5 days ### Fields fields: str, in csv format; This parameter set fields will be returned by the endpoint. Accepted fields are: - atr_14d: Average True Range over the last 14 market days - atrp_14d: Average True Range Percentage over the last 14 market days - sigma_7d: Historical volatility (standard deviation of daily returns (close to close move in %)) over the last 7 market days - sigma_20d: Historical volatility (standard deviation of daily returns (close to close move in %)) over the last 20 market days - sigma_90d: Historical volatility (standard deviation of daily returns (close to close move in %)) over the last 90 market days - sigma_260d: Historical volatility (standard deviation of daily returns (close to close move in %)) over the last 260 market days For example, "sigma_7d,sigma_20d" will return sigma values for the last 7 and 20 market days. **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `start_date` | query | `string` | ✅ | `` | | | `end_date` | query | `string` | ✅ | `` | | | `ticker` | query | `string` | | `` | | | `fields` | query | `string` | | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /calculations/volatility_20d` **Get Volatility 20D** The 20-day price volatility (volatility_20d) equals the annualized standard deviation of the logarithm of relative price change (close/prev_close) for the 20 most recent trading days closing price, expressed as a percentage (Bloomberf Classical method). Calculation is based on daily data. **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `date_as_of_str` | query | `string` | ✅ | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /calculations/volatility_260d` **Get Volatility 260D** The 260-day price volatility (volatility_260d) equals the annualized standard deviation of the logarithm of relative price change (close/prev_close) for the 260 most recent trading days closing price, expressed as a percentage (Bloomberf Classical method). Calculation is based on daily data. **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `date_as_of_str` | query | `string` | ✅ | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /calculations/volatility_90d` **Get Volatility 90D** The 90-day price volatility (volatility_90d) equals the annualized standard deviation of the logarithm of relative price change (close/prev_close) for the 90 most recent trading days closing price, expressed as a percentage (Bloomberf Classical method). Calculation is based on daily data. **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `date_as_of_str` | query | `string` | ✅ | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ## /calendar ### `GET /calendar` **Get Macro News** Get Calendar events. ## Parameters: ### Date parameters - start_date: str in iso format (YYYY-MM-DD) in query params - end_date: str in iso format (YYYY-MM-DD, example: 2022-01-01) in query params ### Event Type event_type: str, optional, in query params, can be: - Payrolls - FOMC Rate Decision - FOMC Minutes - CPI - GDP - Triples/Quadruples - empty (null) - in this case endpoint returns all of above events **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `start_date` | query | `string` | ✅ | `` | | | `end_date` | query | `string` | ✅ | `` | | | `event_type` | query | `string` | | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /calendar/timerange_chunks` **Get Timerange Chunks** Get Timerange chunks to deal with date/datetime limits in other enpoints. ## Parameters: ### Date parameters - start_date: str in iso format (YYYY-MM-DD) in query params - end_date: str in iso format (YYYY-MM-DD) in query params ### Chunk Size chunk_size: str, optional, in query params, can be: - 5D - 5 days (date range limit for /daily, /auction, etc endpoints if ticker is not set) - 90D - 90 days (datetime range limit for intraday and /ratings/grades endpoints if ticker is not set) - 365D - 365 days (date range limit for daily, auction, etc endpoints if ticker is not set) ### Return Datetime return_datetime: bool, optional, in query params, if True then start and end dates will be returned as datetime strings (YYYY-MM-DD HH:MM:SS), otherwise as date strings (YYYY-MM-DD). Useful for intraday endpoints. **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `start_date` | query | `string` | ✅ | `` | | | `end_date` | query | `string` | ✅ | `` | | | `chunk_size` | query | `string` | | `90D` | | | `return_datetime` | query | `boolean` | | `False` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ## /corporate_actions ### `GET /corporate_actions/listings` **Get Listings** **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `start_eff_date` | query | `string` | ✅ | `` | | | `end_eff_date` | query | `string` | ✅ | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /corporate_actions/ticker_changes` **Get Ticker Changes** **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `start_eff_date` | query | `string` | ✅ | `` | | | `end_eff_date` | query | `string` | ✅ | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ## /countries ### `GET /countries` **Get Countries** Get list of countries **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ## /daily ### `GET /daily` **Get Daily Chart** Get daily chart. ## Parameters: ### Date parameters - start_date: str in iso format (YYYY-MM-DD) in query params (only used together with end_date) - end_date: str in iso format (YYYY-MM-DD, example: 2022-01-01) in query params (only used together with start_date) - start_unix_timestamp: int, unix_timestamp in query params (only used together with end_unix_timestamp) - end_unix_timestamp: int, unix_timestamp in query params (only used together with start_unix_timestamp) start_unix_timestamp and end_unix_timestamp are more preferred than start_date and end_date. Format of the entered dates sets the format of the returned dates (unix_timestamp in, unix_timestamp out) or (string in, string out) ### Chart type chart_type: str; default: ohlc. This is an abbreviation (acronym) that stands for a combination of the daily chart fields. There are next fields in daily chart: - Open (o) - High (h) - Low (l) - Close (c) - Volume (v) - Gap (g) - Previous close (p) For example: hl returns high and low prices, c - only closes, or g - only gaps etc. ### Ticker ticker: str, in query params, if it is null, endpoint returns daily of active US stocks, but in this case max date range of daily chart is 5 days **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `chart_type` | query | `string` | | `ohlc` | | | `start_unix_timestamp` | query | `integer` | | `` | | | `end_unix_timestamp` | query | `integer` | | `` | | | `start_date` | query | `string` | | `` | | | `end_date` | query | `string` | | `` | | | `ticker` | query | `string` | | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /daily/aggs` **Get Daily Aggs Chart** Get daily aggregated chart. ## Parameters: ### Date parameters - start_date: str in iso format (YYYY-MM-DD) in query params (only used together with end_date) - end_date: str in iso format (YYYY-MM-DD, example: 2022-01-01) in query params (only used together with start_date) - start_unix_timestamp: int, unix_timestamp in query params (only used together with end_unix_timestamp) - end_unix_timestamp: int, unix_timestamp in query params (only used together with start_unix_timestamp) start_unix_timestamp and end_unix_timestamp are more preferred than start_date and end_date. Format of the entered dates sets the format of the returned dates (unix_timestamp in, unix_timestamp out) or (string in, string out) ### Chart type chart_type: str; default: ohlc. This is an abbreviation (acronym) that stands for a combination of the daily chart fields. There are next fields for daily aggregated chart: - Open (o) - High (h) - Low (l) - Close (c) - Volume (v) For example: hl returns high and low prices, c - only closes, etc. ### Ticker ticker: str, in query params. ### Interval interval: str, interval of the candles, CONTAINS 2 SYMBOLS in the next order: - number of base periods; can be one of these [1, 2, 3, 4, 5] - base period; can be one of these abbreviations: - W - week - M - month - Q - quarter - A - year (annual) For example, 3W returns daily aggregated by 3 weeks **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `chart_type` | query | `string` | | `ohlc` | | | `start_unix_timestamp` | query | `integer` | | `` | | | `end_unix_timestamp` | query | `integer` | | `` | | | `start_date` | query | `string` | | `` | | | `end_date` | query | `string` | | `` | | | `ticker` | query | `string` | ✅ | `` | | | `interval` | query | `string` | | `1W` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /daily/gaps` **Get Gaps** ## Parameters: ### Ticker parameters - ticker: str in query params - tickers: list in body of the request (disabled in this swagger) ### Date parameters - start_date: str in query params (only used together with end_date) - end_date: str in query params (only used together with start_date) - dates: list in body of the request (disabled in this swagger) **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `ticker` | query | `string` | | `` | | | `start_date` | query | `string` | | `` | | | `end_date` | query | `string` | | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /daily/high_low_ex_finr` **Get high/low prices excluding FINRA** Get high/low prices excluding FINRA calculated from tape data by market session. ## Parameters: ### Date parameters - start_date: str in iso format (YYYY-MM-DD) in query params - end_date: str in iso format (YYYY-MM-DD, example: 2025-01-13) in query params ### Ticker ticker: str, in query params, if it is null, endpoint returns premarket high/low prices of active US stocks, but in this case max date range is 5 days ### Market session market_session: str, in query params. There are three possible values: - premarket - core - postmarket If it is empty (not set), endpoint returns high/low prices for all market sessions **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `start_date` | query | `string` | ✅ | `` | | | `end_date` | query | `string` | ✅ | `` | | | `ticker` | query | `string` | | `` | | | `market_session` | query | `string` | | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /daily/money_traded` **Get Money Traded** Get money traded (sum(price*volume)) from tape data - value of sum money, which was traded this day: - moneytr: money traded - moneytr_ex_finr: money traded without finr ## Parameters: - start_date: str in iso format (YYYY-MM-DD) in query params - end_date: str in iso format (YYYY-MM-DD, example: 2022-01-01) in query params - ticker: str, in query params, if it is null, endpoint returns money traded of active US stocks, but in this case max date range is 5 days **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `start_date` | query | `string` | ✅ | `` | | | `end_date` | query | `string` | ✅ | `` | | | `ticker` | query | `string` | | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /daily/pre_mh_volume` **Get Pre-Market hours volume** Get Pre-Market hours volume. ## Parameters: - start_date: str in iso format (YYYY-MM-DD) in query params - end_date: str in iso format (YYYY-MM-DD, example: 2022-01-01) in query params - ticker: str, in query params, if it is null, endpoint returns Pre-Market hours volume of active US stocks, but in this case max date range is 5 days **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `start_date` | query | `string` | ✅ | `` | | | `end_date` | query | `string` | ✅ | `` | | | `ticker` | query | `string` | | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /daily/prev_date` **Get Daily Of Previous Date** Get daily chart of previous market date. ## Parameters: ### Date date: str in iso format (YYYY-MM-DD, example: 2022-01-01) ### Chart type chart_type: str; default: ohlc. This is an abbreviation (acronym) that stands for a combination of the daily chart fields. There are next fields in daily chart: - Open (o) - High (h) - Low (l) - Close (c) - Volume (v) For example: hl returns high and low prices, c - only closes, etc. **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `chart_type` | query | `string` | | `ohlc` | | | `date` | query | `string` | | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /daily/volume_ex_finr` **Get Volume Ex Finr** Get volume ex finr from tape data: - daily: whole day volume - premkt: premarket volume - postmkt: postmarket volume ## Parameters: - start_date: str in iso format (YYYY-MM-DD) in query params - end_date: str in iso format (YYYY-MM-DD, example: 2022-01-01) in query params - ticker: str, in query params, if it is null, endpoint returns volume of active US stocks, but in this case max date range is 5 days **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `start_date` | query | `string` | ✅ | `` | | | `end_date` | query | `string` | ✅ | `` | | | `ticker` | query | `string` | | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ## /dvd ### `GET /dvd` **Get Dvd** Get dividends by date range and ticker. ## Parameters: ### Ticker - ticker: str, optional, in query params, if not set, endpoint returns all dividends for all tickers, but there is a limit in date range: 365 days ### Date parameters - start_date: str in iso format (YYYY-MM-DD) in query params - end_date: str in iso format (YYYY-MM-DD) in query params ### Dividend Type - dvd_type: str, optional, in query params, accepted values is is /dvd/dvd_types endpoint ### Dividend Frequency - dvd_frequency: str, optional, in query params, accepted values is is /dvd/dvd_frequencies endpoint **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `ticker` | query | `string` | | `` | | | `start_date` | query | `string` | | `` | | | `end_date` | query | `string` | | `` | | | `dvd_type` | query | `string` | | `` | | | `dvd_frequency` | query | `string` | | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /dvd/cash_dividends` **Get Cash Dividends** **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `ticker` | query | `string` | | `` | | | `date` | query | `string` | | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /dvd/dvd_frequencies` **Get Dvd Frequency** **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /dvd/dvd_types` **Get Dvd Type** **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /dvd/splits` **Get Splits** **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `ticker` | query | `string` | | `` | | | `date` | query | `string` | | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /dvd/stock_dividends` **Get Stock Dividends** **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `ticker` | query | `string` | | `` | | | `date` | query | `string` | | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ## /futures ### `GET /futures/active_contracts` **Get Active Contracts** Get active contracts for futures tickers ## Parameters: ### Date Parameters: - date: str in iso format (YYYY-MM-DD, example: 2024-01-01), in query params. - start_date: str in iso format (YYYY-MM-DD) in the body (in json format) - end_date: str in iso format (YYYY-MM-DD) in the body (in json format) Default value (in case if date, start_date and end_date are not set) is date of previous working session for futures (the last day with data in our DB, but not older than 10 days). ### Ticker Parameters: - ticker: str, futures base (for example "GC" for gold) ticker in query params - tickers: list, in the body (in json format) If ticker parameters are not set endpoint return data for all futures Parameters in the body have higher priority then in the query params and return more complex data. **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `ticker` | query | `string` | | `` | | | `date` | query | `string` | | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ## /holidays ### `GET /holidays` **Get Holidays** Get list of exchange holidays ## Parameters - gte_date: str in iso format (YYYY-MM-DD, example: 2023-01-01) - greater than equal to date - lte_date: str in iso format (YYYY-MM-DD, example: 2023-01-01) - less than equal to date - holiday_name: bool add to response field holiday_name **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `gte_date` | query | `string` | | `` | | | `lte_date` | query | `string` | | `` | | | `holiday_name` | query | `boolean` | | `False` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ## /imbalance ### `GET /imbalance/imb_09_25` **Get Imbalance 09 25** Get the first imbalance after 09:25 **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `ticker` | query | `string` | | `` | | | `start_date` | query | `string` | | `` | | | `end_date` | query | `string` | | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ## /intraday ### `GET /intraday` **Get Intraday Chart** Get intraday chart. ## Parameters: ### Datetime parameters - start_datetime: str in iso format (YYYY-MM-DD HH:MM:SS) in query params (only used together with end_datetime) - end_datetime: str in iso format (YYYY-MM-DD HH:MM:SS, example: 2022-01-01 00:00:00) in query params (only used together with start_datetime) - start_unix_timestamp: int, unix_timestamp in query params (only used together with end_unix_timestamp) - end_unix_timestamp: int, unix_timestamp in query params (only used together with start_unix_timestamp) start_unix_timestamp and end_unix_timestamp are more preferred than start_datetime and end_datetime. Format of the entered datetimes sets the format of the returned datetimes (unix_timestamp in, unix_timestamp out) or (string in, string out) ### Chart type chart_type: str; default: ohlc. This is an abbreviation (acronym) that stands for a combination of the daily chart fields. There are next fields in daily chart: - Open (o) - High (h) - Low (l) - Close (c) - Volume (v) For example: hl returns high and low prices, c - only closes etc. ### Ticker ticker: str, in query params ### Interval interval: int, interval of the candles in minutes, can be one of these [1, 2, 3, 4, 5, 15, 30, 60, 240] ### Blue Ocean Session include_boats: bool, default False, include candles of Blue Ocean ATS (BOATS) to response (if True) or not (any else) **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `interval` | query | `integer` | ✅ | `` | | | `chart_type` | query | `string` | | `ohlcv` | | | `start_unix_timestamp` | query | `integer` | | `` | | | `end_unix_timestamp` | query | `integer` | | `` | | | `start_datetime` | query | `string` | | `` | | | `end_datetime` | query | `string` | | `` | | | `ticker` | query | `string` | ✅ | `` | | | `include_boats` | query | `boolean` | | `False` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /intraday/benchmark` **Get Benchmark Chart** Get benchmark chart. ## Parameters: ### Datetime parameters - start_datetime: str in iso format (YYYY-MM-DD HH:MM:SS) in query params (only used together with end_datetime) - end_datetime: str in iso format (YYYY-MM-DD HH:MM:SS, example: 2022-01-01 00:00:00) in query params (only used together with start_datetime) - start_unix_timestamp: int, unix_timestamp in query params (only used together with end_unix_timestamp) - end_unix_timestamp: int, unix_timestamp in query params (only used together with start_unix_timestamp) start_unix_timestamp and end_unix_timestamp are more preferred than start_datetime and end_datetime. Format of the entered datetimes sets the format of the returned datetimes (unix_timestamp in, unix_timestamp out) or (string in, string out) ### Main Ticker main_ticker: str, in query params ticker over benchmark ### Benchmark Ticker benchmark_ticker: str, in query params. If this field is empty, the benchmark ticker will be the one with the highest correlation coefficient from the list ["QQQ", "SPY"]. ### Interval interval: int, interval of the candles in minutes, can be one of these [1, 2, 3, 4, 5, 15, 30, 60, 240] ### Beta Applying apply_beta: bool, default False. If it is True, benchmark chart will applied by beta (the regression coefficient, signifies the amount by which change in x must be multiplied to give the corresponding average change in y) ### Blue Ocean Session include_boats: bool, default False, include candles of Blue Ocean ATS (BOATS) to response (if True) or not (any else) **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `interval` | query | `integer` | ✅ | `` | | | `start_unix_timestamp` | query | `integer` | | `` | | | `end_unix_timestamp` | query | `integer` | | `` | | | `start_datetime` | query | `string` | | `` | | | `end_datetime` | query | `string` | | `` | | | `main_ticker` | query | `string` | ✅ | `` | | | `benchmark_ticker` | query | `string` | | `` | | | `apply_beta` | query | `boolean` | | `False` | | | `include_boats` | query | `boolean` | | `False` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /intraday/blue_ocean` **Get Blue Ocean Chart** Get intraday chart of Blue Ocean. ## Parameters: ### Datetime parameters - start_datetime: str in iso format (YYYY-MM-DD HH:MM:SS) in query params (only used together with end_datetime) - end_datetime: str in iso format (YYYY-MM-DD HH:MM:SS, example: 2022-01-01 00:00:00) in query params (only used together with start_datetime) - start_unix_timestamp: int, unix_timestamp in query params (only used together with end_unix_timestamp) - end_unix_timestamp: int, unix_timestamp in query params (only used together with start_unix_timestamp) start_unix_timestamp and end_unix_timestamp are more preferred than start_datetime and end_datetime. Format of the entered datetimes sets the format of the returned datetimes (unix_timestamp in, unix_timestamp out) or (string in, string out) ### Chart type chart_type: str; default: ohlc. This is an abbreviation (acronym) that stands for a combination of the daily chart fields. There are next fields in daily chart: - Open (o) - High (h) - Low (l) - Close (c) - Volume (v) For example: hl returns high and low prices, c - only closes etc. ### Ticker ticker: str, in query params ### Interval interval: int, interval of the candles in minutes, can be one of these [1, 2, 3, 4, 5, 15, 30, 60, 240] **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `interval` | query | `integer` | ✅ | `` | | | `chart_type` | query | `string` | | `ohlcv` | | | `start_unix_timestamp` | query | `integer` | | `` | | | `end_unix_timestamp` | query | `integer` | | `` | | | `start_datetime` | query | `string` | | `` | | | `end_datetime` | query | `string` | | `` | | | `ticker` | query | `string` | ✅ | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /intraday/extended_high_low` **Get Extended High Low** **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `date` | query | `string` | ✅ | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /intraday/extended_high_low_postmarket` **Get Extended High Low Postmarket** **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `date` | query | `string` | ✅ | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /intraday/last_n_candles` **Get Last N Candles** **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `unix_timestamp` | query | `integer` | ✅ | `` | | | `n_candles` | query | `integer` | ✅ | `` | | | `interval` | query | `integer` | ✅ | `` | | | `ticker` | query | `string` | ✅ | `` | | | `include_boats` | query | `boolean` | | `False` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /intraday/last_prices` **Get Last Prices** Get last prices from tape data. The endpoint returns price of the last prints (satisfying the conditions) before next times: - 05:00 (returned field: price_05_00; **condition: last non-FINR print**); - 06:00 (returned field: price_06_00; **condition: last non-FINR print**); - 07:00 (returned field: price_07_00; **condition: last non-FINR print**); - 08:00 (returned field: price_08_00; **condition: last non-FINR print**); - 08:30 (returned field: price_08_30; **condition: last non-FINR print**); - 09:00 (returned field: price_09_00; **condition: last non-FINR print**); - 09:15 (returned field: price_09_15; **condition: last non-FINR print**); - 09:25 (returned field: price_09_25; **condition: last non-FINR print**); - 09:35 (returned field: price_09_35; **condition: last non-FINR print**); - 09:45 (returned field: price_09_45; **condition: last non-FINR print**); - 10:00 (returned field: price_10_00; **condition: last non-FINR print**); - 10:30 (returned field: price_10_30; **condition: last non-FINR print**); - 16:30 (returned field: price_16_30; **condition: last non-FINR print**); - 17:00 (returned field: price_17_00; **condition: last non-FINR print**); - 18:00 (returned field: price_18_00; **condition: last non-FINR print**); - 20:00 (returned field: price_20_00; **condition: last non-FINR, non-odd print**); ## Parameters: - start_date: str in iso format (YYYY-MM-DD, example: 2024-01-01) in query params - end_date: str in iso format (YYYY-MM-DD, example: 2024-01-01) in query params - ticker: str, in query params, if it is null, endpoint returns last prices of active US stocks, but in this case max date range is 5 days > ⚠️ DEPRECATED **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `start_date` | query | `string` | ✅ | `` | | | `end_date` | query | `string` | ✅ | `` | | | `ticker` | query | `string` | | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /intraday/last_prices/v2` **Get Last Prices** Get last prices from tape data at specified times. These values are the same as in the TickerDays product. The endpoint returns the price of the last prints (satisfying the conditions) before corresponding time points of the requested fields. ## Parameters: ### Date parameters - start_date: str in iso format (YYYY-MM-DD, example: 2024-01-01) in query params - end_date: str in iso format (YYYY-MM-DD, example: 2024-01-01) in query params ### Ticker parameter ticker: str, in query params, if it is null, endpoint returns last prices of active US stocks, but in this case max date range is 5 days ### Fields parameter fields: str, in csv format, default: "price_20_00"; This parameter set fields will be returned by the endpoint. Accepted fields are listed below: - price_04_01: last non-FINR print before 04:01 - price_05_00: last non-FINR print before 05:00 - price_06_00: last non-FINR print before 06:00 - price_07_00: last non-FINR print before 07:00 - price_08_00: last non-FINR print before 08:00 - price_08_30: last non-FINR print before 08:30 - price_09_00: last non-FINR print before 09:00 - price_09_15: last non-FINR print before 09:15 - price_09_25: last non-FINR print before 09:25 - price_09_35: last non-FINR print before 09:35 - price_09_45: last non-FINR print before 09:45 - price_10_00: last non-FINR print before 10:00 - price_10_30: last non-FINR print before 10:30 - price_11_00: last non-FINR print before 11:00 - price_12_00: last non-FINR print before 12:00 - price_13_00: last non-FINR print before 13:00 - price_14_00: last non-FINR print before 14:00 - price_15_00: last non-FINR print before 15:00 - price_15_30: last non-FINR print before 15:30 - price_15_50: last non-FINR print before 15:50 - price_16_30: last non-FINR print before 16:30 - price_17_00: last non-FINR print before 17:00 - price_18_00: last non-FINR print before 18:00 - price_19_00: last non-FINR print before 19:00 - price_20_00: last **non-odd**, non-FINR print before 20:00 For example, "price_09_00,price_09_15,price_09_25" will return last prices at 09:00, 09:15 and 09:25. **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `start_date` | query | `string` | ✅ | `` | | | `end_date` | query | `string` | ✅ | `` | | | `ticker` | query | `string` | | `` | | | `fields` | query | `string` | ✅ | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /intraday/money_traded_segments` **Get Money Traded Segments** Get money traded from tape data calculated based on the prints before specified time. These values are the same as in the TickerDays product. The endpoint returns the money traded as aggregated value sum(price*size) of the prints (satisfying the conditions) before corresponding time points of the requested fields. ## Parameters: ### Date parameters - start_date: str in iso format (YYYY-MM-DD, example: 2024-01-01) in query params - end_date: str in iso format (YYYY-MM-DD, example: 2024-01-01) in query params ### Ticker parameter ticker: str, in query params, if it is null, endpoint returns money traded of active US stocks, but in this case max date range is 5 days ### Fields parameter fields: str, in csv format, default: "money_traded_20_00"; This parameter set fields will be returned by the endpoint. Accepted fields are listed below: - money_traded_04_01: money traded aggregation of non-FINR prints before 04:01 - money_traded_05_00: money traded aggregation of non-FINR prints before 05:00 - money_traded_06_00: money traded aggregation of non-FINR prints before 06:00 - money_traded_07_00: money traded aggregation of non-FINR prints before 07:00 - money_traded_08_00: money traded aggregation of non-FINR prints before 08:00 - money_traded_08_30: money traded aggregation of non-FINR prints before 08:30 - money_traded_09_00: money traded aggregation of non-FINR prints before 09:00 - money_traded_09_15: money traded aggregation of non-FINR prints before 09:15 - money_traded_09_25: money traded aggregation of non-FINR prints before 09:25 - money_traded_09_35: money traded aggregation of non-FINR prints before 09:35 - money_traded_09_45: money traded aggregation of non-FINR prints before 09:45 - money_traded_10_00: money traded aggregation of non-FINR prints before 10:00 - money_traded_10_30: money traded aggregation of non-FINR prints before 10:30 - money_traded_11_00: money traded aggregation of non-FINR prints before 11:00 - money_traded_12_00: money traded aggregation of non-FINR prints before 12:00 - money_traded_13_00: money traded aggregation of non-FINR prints before 13:00 - money_traded_14_00: money traded aggregation of non-FINR prints before 14:00 - money_traded_15_00: money traded aggregation of non-FINR prints before 15:00 - money_traded_15_30: money traded aggregation of non-FINR prints before 15:30 - money_traded_15_50: money traded aggregation of non-FINR prints before 15:50 - money_traded_16_30: money traded aggregation of non-FINR prints before 16:30 - money_traded_17_00: money traded aggregation of non-FINR prints before 17:00 - money_traded_18_00: money traded aggregation of non-FINR prints before 18:00 - money_traded_19_00: money traded aggregation of non-FINR prints before 19:00 - money_traded_20_00: money traded aggregation of **non-odd**, non-FINR prints before 20:00 For example, "money_traded_09_00,money_traded_09_15" will return money traded at 09:00 and 09:15. **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `start_date` | query | `string` | ✅ | `` | | | `end_date` | query | `string` | ✅ | `` | | | `ticker` | query | `string` | | `` | | | `fields` | query | `string` | ✅ | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /intraday/percents` **Get Percent From Prev Clo** Get the percentage change in price from the previous close ## Parameters: ### Datetime parameters - start_datetime: str in iso format (YYYY-MM-DD HH:MM:SS) in query params (only used together with end_datetime) - end_datetime: str in iso format (YYYY-MM-DD HH:MM:SS, example: 2022-01-01 00:00:00) in query params (only used together with start_datetime) - start_unix_timestamp: int, unix_timestamp in query params (only used together with end_unix_timestamp) - end_unix_timestamp: int, unix_timestamp in query params (only used together with start_unix_timestamp) start_unix_timestamp and end_unix_timestamp are more preferred than start_datetime and end_datetime. Format of the entered datetimes sets the format of the returned datetimes (unix_timestamp in, unix_timestamp out) or (string in, string out) ### Ticker ticker: str, in query params ### Interval interval: int, interval of the candles in minutes, can be one of these [1, 2, 3, 4, 5, 15, 30, 60, 240] ### Use open use_open: bool, default false. If it is true, the percentage change is calculatedas as the difference between the candlestick open and the previous day's close (as in the Charts app). Otherwise, the percentage change will be calculated as the difference between the candlestick's close and the previous day's close. ### Blue Ocean Session include_boats: bool, default False, include candles of Blue Ocean ATS (BOATS) to response (if True) or not (any else) **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `interval` | query | `integer` | ✅ | `` | | | `start_unix_timestamp` | query | `integer` | | `` | | | `end_unix_timestamp` | query | `integer` | | `` | | | `start_datetime` | query | `string` | | `` | | | `end_datetime` | query | `string` | | `` | | | `ticker` | query | `string` | ✅ | `` | | | `use_open` | query | `boolean` | | `False` | | | `include_boats` | query | `boolean` | | `False` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /intraday/ticker_count_at_open` **Get Ticker Count At Open** **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `date` | query | `string` | | `2026-04-16` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /intraday/v3` **Get Intraday Chart** Get intraday chart. ## Parameters: ### Datetime parameters - start_datetime: str in iso format (YYYY-MM-DD HH:MM:SS) in query params (only used together with end_datetime) - end_datetime: str in iso format (YYYY-MM-DD HH:MM:SS, example: 2022-01-01 00:00:00) in query params (only used together with start_datetime) - start_unix_timestamp: int, unix_timestamp in query params (only used together with end_unix_timestamp) - end_unix_timestamp: int, unix_timestamp in query params (only used together with start_unix_timestamp) start_unix_timestamp and end_unix_timestamp are more preferred than start_datetime and end_datetime. Format of the entered datetimes sets the format of the returned datetimes (unix_timestamp in, unix_timestamp out) or (string in, string out) ### Chart type chart_type: str; default: ohlc. This is an abbreviation (acronym) that stands for a combination of the daily chart fields. There are next fields in daily chart: - Open (o) - High (h) - Low (l) - Close (c) - Volume (v) For example: hl returns high and low prices, c - only closes etc. ### Ticker ticker: str, in query params ### Interval interval: int, interval of the candles in minutes, can be one of these [1, 2, 3, 4, 5, 15, 30, 60, 240] ### Blue Ocean Session include_boats: bool, default False, include candles of Blue Ocean ATS (BOATS) to response (if True) or not (any else) **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `interval` | query | `integer` | ✅ | `` | | | `chart_type` | query | `string` | | `ohlcv` | | | `start_unix_timestamp` | query | `integer` | | `` | | | `end_unix_timestamp` | query | `integer` | | `` | | | `start_datetime` | query | `string` | | `` | | | `end_datetime` | query | `string` | | `` | | | `ticker` | query | `string` | ✅ | `` | | | `include_boats` | query | `boolean` | | `False` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /intraday/v3/benchmark` **Get Benchmark Chart** Get benchmark chart. ## Parameters: ### Datetime parameters - start_datetime: str in iso format (YYYY-MM-DD HH:MM:SS) in query params (only used together with end_datetime) - end_datetime: str in iso format (YYYY-MM-DD HH:MM:SS, example: 2022-01-01 00:00:00) in query params (only used together with start_datetime) - start_unix_timestamp: int, unix_timestamp in query params (only used together with end_unix_timestamp) - end_unix_timestamp: int, unix_timestamp in query params (only used together with start_unix_timestamp) start_unix_timestamp and end_unix_timestamp are more preferred than start_datetime and end_datetime. Format of the entered datetimes sets the format of the returned datetimes (unix_timestamp in, unix_timestamp out) or (string in, string out) ### Main Ticker main_ticker: str, in query params ticker over benchmark ### Benchmark Ticker benchmark_ticker: str, in query params. If this field is empty, the benchmark ticker will be the one with the highest correlation coefficient from the list ["QQQ", "SPY"]. ### Interval interval: int, interval of the candles in minutes, can be one of these [1, 2, 3, 4, 5, 15, 30, 60, 240] ### Beta Applying apply_beta: bool, default False. If it is True, benchmark chart will applied by beta (the regression coefficient, signifies the amount by which change in x must be multiplied to give the corresponding average change in y) ### Blue Ocean Session include_boats: bool, default False, include candles of Blue Ocean ATS (BOATS) to response (if True) or not (any else) **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `interval` | query | `integer` | ✅ | `` | | | `start_unix_timestamp` | query | `integer` | | `` | | | `end_unix_timestamp` | query | `integer` | | `` | | | `start_datetime` | query | `string` | | `` | | | `end_datetime` | query | `string` | | `` | | | `main_ticker` | query | `string` | ✅ | `` | | | `benchmark_ticker` | query | `string` | | `` | | | `apply_beta` | query | `boolean` | | `False` | | | `include_boats` | query | `boolean` | | `False` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /intraday/v3/blue_ocean` **Get Blue Ocean Chart** Get intraday chart of Blue Ocean. ## Parameters: ### Datetime parameters - start_datetime: str in iso format (YYYY-MM-DD HH:MM:SS) in query params (only used together with end_datetime) - end_datetime: str in iso format (YYYY-MM-DD HH:MM:SS, example: 2022-01-01 00:00:00) in query params (only used together with start_datetime) - start_unix_timestamp: int, unix_timestamp in query params (only used together with end_unix_timestamp) - end_unix_timestamp: int, unix_timestamp in query params (only used together with start_unix_timestamp) start_unix_timestamp and end_unix_timestamp are more preferred than start_datetime and end_datetime. Format of the entered datetimes sets the format of the returned datetimes (unix_timestamp in, unix_timestamp out) or (string in, string out) ### Chart type chart_type: str; default: ohlc. This is an abbreviation (acronym) that stands for a combination of the daily chart fields. There are next fields in daily chart: - Open (o) - High (h) - Low (l) - Close (c) - Volume (v) For example: hl returns high and low prices, c - only closes etc. ### Ticker ticker: str, in query params ### Interval interval: int, interval of the candles in minutes, can be one of these [1, 2, 3, 4, 5, 15, 30, 60, 240] **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `interval` | query | `integer` | ✅ | `` | | | `chart_type` | query | `string` | | `ohlcv` | | | `start_unix_timestamp` | query | `integer` | | `` | | | `end_unix_timestamp` | query | `integer` | | `` | | | `start_datetime` | query | `string` | | `` | | | `end_datetime` | query | `string` | | `` | | | `ticker` | query | `string` | ✅ | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /intraday/v3/last_n_candles` **Get Last N Candles** **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `unix_timestamp` | query | `integer` | ✅ | `` | | | `n_candles` | query | `integer` | ✅ | `` | | | `interval` | query | `integer` | ✅ | `` | | | `ticker` | query | `string` | ✅ | `` | | | `include_boats` | query | `boolean` | | `False` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /intraday/v3/percents` **Get Percent From Prev Clo** Get the percentage change in price from the previous close ## Parameters: ### Datetime parameters - start_datetime: str in iso format (YYYY-MM-DD HH:MM:SS) in query params (only used together with end_datetime) - end_datetime: str in iso format (YYYY-MM-DD HH:MM:SS, example: 2022-01-01 00:00:00) in query params (only used together with start_datetime) - start_unix_timestamp: int, unix_timestamp in query params (only used together with end_unix_timestamp) - end_unix_timestamp: int, unix_timestamp in query params (only used together with start_unix_timestamp) start_unix_timestamp and end_unix_timestamp are more preferred than start_datetime and end_datetime. Format of the entered datetimes sets the format of the returned datetimes (unix_timestamp in, unix_timestamp out) or (string in, string out) ### Ticker ticker: str, in query params ### Interval interval: int, interval of the candles in minutes, can be one of these [1, 2, 3, 4, 5, 15, 30, 60, 240] ### Use open use_open: bool, default false. If it is true, the percentage change is calculatedas as the difference between the candlestick open and the previous day's close (as in the Charts app). Otherwise, the percentage change will be calculated as the difference between the candlestick's close and the previous day's close. ### Blue Ocean Session include_boats: bool, default False, include candles of Blue Ocean ATS (BOATS) to response (if True) or not (any else) **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `interval` | query | `integer` | ✅ | `` | | | `start_unix_timestamp` | query | `integer` | | `` | | | `end_unix_timestamp` | query | `integer` | | `` | | | `start_datetime` | query | `string` | | `` | | | `end_datetime` | query | `string` | | `` | | | `ticker` | query | `string` | ✅ | `` | | | `use_open` | query | `boolean` | | `False` | | | `include_boats` | query | `boolean` | | `False` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /intraday/volume_segments` **Get Volume Segments** Get traded volume from tape data before specified time. These values are the same as in the TickerDays product. The endpoint returns the volume as aggregated value sum(size) of the prints (satisfying the conditions) before corresponding time points of the requested fields. ## Parameters: ### Date parameters - start_date: str in iso format (YYYY-MM-DD, example: 2024-01-01) in query params - end_date: str in iso format (YYYY-MM-DD, example: 2024-01-01) in query params ### Ticker parameter ticker: str, in query params, if it is null, endpoint returns volume of active US stocks, but in this case max date range is 5 days ### Fields parameter fields: str, in csv format, default: "volume_20_00"; This parameter set fields will be returned by the endpoint. Accepted fields are listed below: - volume_04_01: volume of non-FINR prints before 04:01 - volume_05_00: volume of non-FINR prints before 05:00 - volume_06_00: volume of non-FINR prints before 06:00 - volume_07_00: volume of non-FINR prints before 07:00 - volume_08_00: volume of non-FINR prints before 08:00 - volume_08_30: volume of non-FINR prints before 08:30 - volume_09_00: volume of non-FINR prints before 09:00 - volume_09_15: volume of non-FINR prints before 09:15 - volume_09_25: volume of non-FINR prints before 09:25 - volume_09_35: volume of non-FINR prints before 09:35 - volume_09_45: volume of non-FINR prints before 09:45 - volume_10_00: volume of non-FINR prints before 10:00 - volume_10_30: volume of non-FINR prints before 10:30 - volume_11_00: volume of non-FINR prints before 11:00 - volume_12_00: volume of non-FINR prints before 12:00 - volume_13_00: volume of non-FINR prints before 13:00 - volume_14_00: volume of non-FINR prints before 14:00 - volume_15_00: volume of non-FINR prints before 15:00 - volume_15_30: volume of non-FINR prints before 15:30 - volume_15_50: volume of non-FINR prints before 15:50 - volume_16_30: volume of non-FINR prints before 16:30 - volume_17_00: volume of non-FINR prints before 17:00 - volume_18_00: volume of non-FINR prints before 18:00 - volume_19_00: volume of non-FINR prints before 19:00 - volume_20_00: volume of **non-odd**, non-FINR prints before 20:00 For example, "volume_09_00,volume_09_15" will return volume at 09:00 and 09:15. **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `start_date` | query | `string` | ✅ | `` | | | `end_date` | query | `string` | ✅ | `` | | | `ticker` | query | `string` | | `` | | | `fields` | query | `string` | ✅ | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ## /latest_close_prices ### `GET /latest_close_prices` **Get Latest Close Price** **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /latest_close_prices/` **Get Latest Close Price** > ⚠️ DEPRECATED **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ## /opg_and_clo ### `GET /opg_and_clo` **Get OPG and CLO** **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `start_date` | query | `string` | | `` | | | `end_date` | query | `string` | | `` | | | `ticker` | query | `string` | | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /opg_and_clo/adjusted_closes` **Get Adjusted Closes** **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `start_date` | query | `string` | ✅ | `` | | | `end_date` | query | `string` | ✅ | `` | | | `ticker` | query | `string` | | `` | | | `only_adjusted` | query | `boolean` | | `False` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ## /ratings ### `GET /ratings` **Get Ratings** Get ratings within a specified date range and optional ticker. The response data will be the same as in Analyzer. So this endpoint does not return unique grades. For example, if there are multiple tickers (A, B) for the same company, and some grade was published on A (it was stored related to company in our DB). The response will include 2 separate rows with one grade for each ticker (for A and B). IF you want to get unique grades, you can use the /ratings/grades endpoint. ## Parameters: ### Date range: - start_date: str, in iso format (YYYY-MM-DD), defines the start date of the date range for which grades are requested. - end_date: str, in iso format (YYYY-MM-DD), defines the end date of the date range for which grades are requested. ### Ticker: ticker: optional, str, Filter grades by ticker (on which company the grade is in our DB) if it is null, endpoint returns all grades but in this case max date range is 90 days ### Fields fields: str, in csv format, for example: "date,time,ticker,action,firm"; This parameter set fields will be returned by the endpoint. Fields "date", "time", "ticker", "action" is included by default in response, if fields parameter is empty endpoint returns these default fields. Accepted fields to this parameter are: - move_date: move date of the rating; - old_price: old price target; - new_price: new price target; - firm: name of the firm (analyst) that made the grade; - source: source of the rating; - old_rating; - new_rating; - company: full name of the company (the same on as in /tickers endpoint); - main_ticker: main ticker of the company; - orig_ticker: original ticker of the company (the symbol was in the title of ratings news). **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `start_date` | query | `string` | ✅ | `` | | | `end_date` | query | `string` | ✅ | `` | | | `ticker` | query | `string` | | `` | | | `fields` | query | `string` | | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /ratings/grades` **Get Grades By Companies** Get unique grades(ratings) within a specified date range and optional orig_ticker. We save grades (as news) related to companies in our database. So there are 2 tickers field: orog_ticker and main_ticker. The orig_ticker is the ticker of the company that was in the title of the news, main_ticker is the primary ticker of the company which was related to the news. ## Parameters: ### Date range: - start_date: str, in iso format (YYYY-MM-DD), defines the start date of the date range for which grades are requested. - end_date: str, in iso format (YYYY-MM-DD), defines the end date of the date range for which grades are requested. ### Orig ticker: orig_ticker: optional, str, Filter grades by orig ticker (the symbol was in the title of ratings news) if it is null, endpoint returns all grades but in this case max date range is 90 days ### Fields fields: str, in csv format, for example: "date,time,orig_ticker,action,firm"; This parameter set fields will be returned by the endpoint. Fields "date", "time", "orig_ticker", "action" is included by default in response, if fields parameter is empty endpoint returns these default fields. Accepted fields to this parameter are: - move_date: move date of the rating; - old_price: old price target; - new_price: new price target; - firm: name of the firm (analyst) that made the grade; - source: source of the rating; - old_rating; - new_rating; - company: full name of the company (the same on as in /tickers endpoint); - main_ticker: main ticker of the company. **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `start_date` | query | `string` | ✅ | `` | | | `end_date` | query | `string` | ✅ | `` | | | `orig_ticker` | query | `string` | | `` | | | `fields` | query | `string` | | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ## /release_notes ### `GET /release_notes` **Get Release Notes** Get full list of Datum API release notes ## Parameters: - newest_first: bool, default True **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `newest_first` | query | `boolean` | | `True` | | --- ## /reports ### `GET /reports` **Get Reports** Get report data ## Parameters - move_date_str: deprecated, str, in iso format (YYYY-MM-DD, example: 2022-01-01), has lower priority than start_move_date and end_move_date - start_move_date: str, in iso format (YYYY-MM-DD), must be set together with end_move_date - end_move_date: str, in iso format (YYYY-MM-DD), must be set together with start_move_date - ticker: str, if it is null, endpoint returns report data of US stocks, but in this case max date range of report data is 365 days - conf_call: bool, if true, response includes earnings conference call date and time (fields: call_date, call_time), otherwise these fields are not included in the response. If there is no conference call data for the report, call_date and call_time fields will have null values. **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `move_date_str` | query | `string` | | `` | | | `start_move_date` | query | `string` | | `` | | | `end_move_date` | query | `string` | | `` | | | `ticker` | query | `string` | | `` | | | `conf_call` | query | `boolean` | | `False` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /reports/extended` **Get Reports** Get extended reports (from main sources and alternative sources) as it is in Morning. If report is in both sources, data from main source is returned (without duplicates). Response includes next fields: - ticker; - announcement_date; - announcement_time; - move_date; - call_date (if conf_call=true); - call_time (if conf_call=true); - source. ## Parameters - start_move_date: str, in iso format (YYYY-MM-DD), must be set together with end_move_date - end_move_date: str, in iso format (YYYY-MM-DD), must be set together with start_move_date - ticker: str, if it is null, endpoint returns report data of US stocks, but in this case max date range of report data is 365 days - conf_call: bool, if true, response includes earnings conference call date and time (fields: call_date, call_time), otherwise these fields are not included in the response. If there is no conference call data for the report, call_date and call_time fields will have null values. **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `start_move_date` | query | `string` | | `` | | | `end_move_date` | query | `string` | | `` | | | `ticker` | query | `string` | | `` | | | `conf_call` | query | `boolean` | | `False` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ## /short_days ### `GET /short_days` **Get Short Days** Get list of shortened trading days ## Parameters - gte_date: str in iso format (YYYY-MM-DD, example: 2023-01-01) - greater than equal to date - lte_date: str in iso format (YYYY-MM-DD, example: 2023-01-01) - less than equal to date - short_day_name: bool add to response field short_day_name **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `gte_date` | query | `string` | | `` | | | `lte_date` | query | `string` | | `` | | | `short_day_name` | query | `boolean` | | `False` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ## /snapshots ### `GET /snapshots/yesterday_values` **Get yesterday's values for all stocks** Get yesterday's (previous trading day in regard to the provided date in the date parameter) trading values (prices, volumes, highs, lows, etc). Returned fields (11 fields, excluding ticker): - YOpen: yesterday's opening price - YCls: yesterday's official closing price - YLstPrс: yesterday's last traded price at 20:00 (the same as the price_20_00 field in the /intraday/last_prices endpoint) - YVolNF: yesterday's total volume excluding FINRA - YPreMhVolNF: yesterday's pre-market hours volume excluding FINRA - YPostMhVolNF: yesterday's post-market hours volume excluding FINRA - YDayLo: yesterday's intraday low price - YDayHi: yesterday's intraday high price - YExtLo: yesterday's extended hours (from pre/post market sessions) low price - YExtHi: yesterday's extended hours (from pre/post market sessions) high price - YPostVW: yesterday's volume-weighted average price. Calculated as sum(price * volume) / sum(volume) for all trades excluding FINRA. ## Parameters: ### Date parameter - date: str in iso format (YYYY-MM-DD) in query params, optional. If not set, the previous working day relative to current date is used. **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `date` | query | `string` | | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ## /tickers ### `GET /tickers` **Get Tickers** ## Parameters: ### active: bool, filter tickers by active if: - true: endpoint returns only active tickers - false: endpoint returns only non-active tickers - empty: endpoint returns all tickers (active and non-active). Parameter active has higher priority than only_active ### us_exchange: bool, filter tickers by country of exchange: - true: endpoint returns only tickers which primary exchange is in US - false: endpoint returns only tickers which primary exchange is in the whole world except US - empty: endpoint returns all tickers (from the whole world). ### listed: bool, filter tickers by exchange: - true: endpoint returns only listed tickers (not from OTC) - false: endpoint returns only unlisted tickers (from OTC) - empty: endpoint returns all tickers ### fields str, in csv format, default: "country,equity_type,lvl3,active"; This parameter set fields will be returned by the endpoint. Field "ticker" is included by default. Accepted fields: - active: is ticker active or not - country: country of the exchange - country_hq: country of company`s headquarter - equity_type: equity type of the stock (for example ETF) - lvl1: Level 1 in bics - lvl2: Level 2 in bics - lvl3: Level 3 in bics - lvl4: Level 4 in bics - lvl5: Level 5 in bics - exchange: Exchange name - company: Company name - market_cap: market capitalization of the company in millions(M) $ - rlot: Round Lot Size - etf_leverage: (***deprecated***) ETF leverage coef - etf_has_leverage: has leverage (for ETFs) - etf_leverage_amount: leverage amount (for ETFs) - shares_float: shares float in millions(M) - short_float: short float in percents(%) if fields is empty endpoint returns only the list of tickers **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `active` | query | `boolean` | | `` | | | `us_exchange` | query | `boolean` | | `` | | | `listed` | query | `boolean` | | `` | | | `fields` | query | `string` | | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /tickers/all_ptps` **Get 3 PTP sorter`s tickers** **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /tickers/etf` **Get ETF tickers** **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /tickers/futures` **Get Futures** **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /tickers/sorters` **Get Sorters** returns list of sorter pairs : ; path_key is used to get tickers of sorter which name is sorter_name at next endpoint: GET .../sorters/ **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ### `GET /tickers/sorters/{sorter}` **Get Tickers Of Sorter** returns ticker list of sorter ## Parameters: sorter: str, values from the list: - 'sp500': S&P 500 sorter - 'us_base': US Base sorter - 'us_secondary': US Secondary sorter - 'top50': Top 50 sorter - 'foreign_base': Foreign Base sorter - 'profiler_etfs': Profiler ETFs sorter - 'ptp': US PTPs sorter - 'ptp_taxable': ptp_taxable sorter - 'ptp_exempt': ptp_exempt sorter - 'ptp_frr': ptp_frr sorter To get the actual list of sorters, do GET of root endpoint '.../sorters' **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `sorter` | path | `string` | ✅ | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | --- ## /working_days ### `GET /working_days` **Get Working Days** **Parameters:** | Name | In | Type | Required | Default | Description | |---|---|---|---|---|---| | `start_date` | query | `string` | ✅ | `` | | | `end_date` | query | `string` | ✅ | `` | | | `format` | query | `string` | | `json_records` | ### Response format str, set a format of response. Accepted response formats: - csv: comma separated values in file - cs | ---