# Know sure thing The Know Sure Thing (KST) endpoint provides a momentum oscillator that combines four smoothed rates of change into a single trend-following indicator. This endpoint returns data that helps users identify potential trend reversals, as well as overbought or oversold conditions in the market. **API credits cost:** `1` per symbol ## Parameters - `symbol` (string, optional, see notes) Symbol ticker of the instrument. E.g. `AAPL`, `EUR/USD`, `ETH/BTC`, ... - `figi` (string, optional, see notes) The FIGI of an instrument for which data is requested. This request parameter is available starting with the Ultra plan - `isin` (string, optional, see notes) Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section - `cusip` (string, optional, see notes) The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section - `interval` (string, required) Interval between two consecutive points in time series - `exchange` (string, optional) Exchange where instrument is traded - `mic_code` (string, optional) Market Identifier Code (MIC) under ISO 10383 standard - `country` (string, optional) The country where the instrument is traded, e.g., `United States` or `US` - `roc_period_1` (integer, optional) The time period for the first Rate of Change calculation. - `roc_period_2` (integer, optional) The time period for the second Rate of Change calculation. - `roc_period_3` (integer, optional) The time period for the third Rate of Change calculation. - `roc_period_4` (integer, optional) The time period for the forth Rate of Change calculation. - `sma_period_1` (integer, optional) The time period for the first Simple Moving Average. - `sma_period_2` (integer, optional) The time period for the second Simple Moving Average. - `sma_period_3` (integer, optional) The time period for the third Simple Moving Average. - `sma_period_4` (integer, optional) The time period for the forth Simple Moving Average. - `signal_period` (integer, optional) The time period used for generating the signal line. - `type` (string, optional) The asset class to which the instrument belongs - `outputsize` (integer, optional) Number of data points to retrieve. Supports values in the range from `1` to `5000`. Default `30` when no date parameters are set, otherwise set to maximum - `format` (string, optional) The format of the response data - `delimiter` (string, optional) The separator used in the CSV response data - `prepost` (boolean, optional) Returns quotes that include pre-market and post-market data. Only for `Pro` and above plans. Available at the `1min`, `5min`, `15min`, and `30min` intervals for US equities. Open, high, low, close values are supplied without volume - `dp` (integer, optional) Specifies the number of decimal places for floating values. Should be in range [0, 11] inclusive. By default, the number of decimal places is automatically determined based on the values provided - `order` (string, optional) Sorting order of the output - `include_ohlc` (boolean, optional) Specify if OHLC values should be added in the output - `timezone` (string, optional) Timezone at which output datetime will be displayed. Supports: 1. Exchange for local exchange time 2. UTC for datetime at universal UTC standard 3. Timezone name according to the IANA Time Zone Database. E.g. America/New_York, Asia/Singapore. Full list of timezones can be found here Take note that the IANA Timezone name is case-sensitive - `date` (string, optional) Specifies the exact date to get the data for. Could be the exact date, e.g. `2021-10-27`, or in human language `today` or `yesterday` - `start_date` (string, optional) Can be used separately and together with `end_date`. Format `2006-01-02` or `2006-01-02T15:04:05` Default location: Forex and Cryptocurrencies - UTC Stocks - where exchange is located (e.g. for AAPL it will be America/New_York) Both parameters take into account if timezone parameter is provided. If timezone is given then, start_date and end_date will be used in the specified location Examples: 1. &symbol=AAPL&start_date=2019-08-09T15:50:00&… Returns all records starting from 2019-08-09T15:50:00 New York time up to current date 2. &symbol=EUR/USD&timezone=Asia/Singapore&start_date=2019-08-09T15:50:00&… Returns all records starting from 2019-08-09T15:50:00 Singapore time up to current date 3. &symbol=ETH/BTC&timezone=Europe/Zurich&start_date=2019-08-09T15:50:00&end_date=2019-08-09T15:55:00&... Returns all records starting from 2019-08-09T15:50:00 Zurich time up to 2019-08-09T15:55:00 - `end_date` (string, optional) The ending date and time for data selection, see `start_date` description for details. - `previous_close` (boolean, optional) A boolean parameter to include the previous closing price in the time_series data. If true, adds previous bar close price value to the current object - `adjust` (string, optional) Adjusting mode for prices **Notes:** - At least one of the following parameters is required: `symbol`, `isin`, `figi`, `cusip`. ## Response - `meta` (object) Json object with request general information - `symbol` (string) The ticker symbol of an instrument for which data was requested. - `interval` (string) The time gap between consecutive data points. - `currency` (string) The currency of a traded instrument. - `exchange_timezone` (string) The timezone of the exchange where the instrument is traded. - `exchange` (string) The exchange name where the instrument is traded. - `mic_code` (string) The Market Identifier Code (MIC) of the exchange where the instrument is traded. - `type` (string) The asset class to which the instrument belongs. - `indicator` (object) Technical indicator information - `name` (string) Name of the technical indicator - `roc_period_1` (integer) The time period for the first Rate of Change calculation - `roc_period_2` (integer) The time period for the second Rate of Change calculation - `roc_period_3` (integer) The time period for the third Rate of Change calculation - `roc_period_4` (integer) The time period for the forth Rate of Change calculation - `sma_period_1` (integer) The time period for the first Simple Moving Average - `sma_period_2` (integer) The time period for the second Simple Moving Average - `sma_period_3` (integer) The time period for the third Simple Moving Average - `sma_period_4` (integer) The time period for the forth Simple Moving Average - `signal_period` (integer) The time period used for generating the signal line - `values` (array of object) Array of time series data points - `datetime` (string) Datetime in local market time for equities and in UTC for forex and cryptocurrencies referring to when the bar with specified interval was opened - `kst` (string) KST value - `kst_signal` (string) KST signal value - `status` (string) Response status ## Example Request ```bash curl "https://api.twelvedata.com/kst?symbol=AAPL&interval=1min&apikey=demo" ``` ## Example Response ```json { "meta": { "symbol": "AAPL", "interval": "1min", "currency": "USD", "exchange_timezone": "America/New_York", "exchange": "NASDAQ", "mic_code": "XNAS", "type": "Common Stock", "indicator": { "name": "KST - Know Sure Thing", "roc_period_1": 10, "roc_period_2": 15, "roc_period_3": 20, "roc_period_4": 30, "sma_period_1": 10, "sma_period_2": 10, "sma_period_3": 10, "sma_period_4": 15, "signal_period": 9 } }, "values": [ { "datetime": "2019-08-09 15:59:00", "kst": "-4.58644", "kst_signal": "-2.05236" } ], "status": "ok" } ```