Technical Indicator

GET/gateway/v1/market/price-indicator

Returns a technical indicator for a trading pair on a given exchange and interval.

Modes: - Set `from`/`to` for time-series - Omit for latest value only

Indicator-specific tuning via `options` (e.g. `period:7`, `fast_period:8,slow_period:21,signal_period:5`, `period:10,stddev:1.5`).

Available indicators: `rsi`, `macd`, `ema`, `sma`, `bbands`, `stoch`, `adx`, `atr`, `cci`, `obv`, `vwap`, `dmi`, `ichimoku`, `supertrend`.

Query Parameters

indicatorenum<string>required

Technical indicator name. Can be `rsi`, `macd`, `ema`, `sma`, `bbands`, `stoch`, `adx`, `atr`, `cci`, `obv`, `vwap`, `dmi`, `ichimoku`, or `supertrend`.

Available options:rsimacdemasmabbandsstochadxatrcciobvvwapdmiichimokusupertrend

Example: rsi

symbolstringrequired

Trading pair as `BTC/USDT` or bare symbol like `BTC`

Example: BTC

intervalenum<string>

Candlestick interval — bucket size for each point in the indicator series: `1m`, `5m`, `15m`, `30m`, `1h`, `2h`, `4h`, `12h`, `1d`, or `1w`. This endpoint uses `interval` only; it does NOT accept `time_range`. Use `from`/`to` to bound the series.

Available options:1m5m15m30m1h2h4h12h1d1w

Example: 1d

exchangeenum<string>

Exchange for price data. Can be `binance`, `bybit`, `coinbase`, or `kraken`.

Available options:binancebybitcoinbasekraken

Example: binance

fromstring

Start of time range. When set, returns time-series instead of latest value. Accepts Unix seconds (`1704067200`) or date string (`2024-01-01`)

Example: 2024-01-01

tostring

End of time range. Defaults to now when from is set. Accepts Unix seconds (`1706745600`) or date string (`2024-02-01`)

Example: 2024-02-01

optionsstring

Indicator-specific options as comma-separated key:value pairs. Available options by indicator: `period` — lookback period for rsi (default 14), sma (default 20), ema (default 20), bbands (default 20), adx (default 14), atr (default 14), cci (default 20), dmi (default 14), stoch (default 14), supertrend (default 10). `stddev` — standard deviation for bbands (default 2). `multiplier` — multiplier for supertrend (default 3). `fast_period` — MACD fast EMA (default 12). `slow_period` — MACD slow EMA (default 26). `signal_period` — MACD signal smoothing (default 9). Examples: `period:7`, `period:200`, `fast_period:8,slow_period:21,signal_period:5`, `period:10,stddev:1.5`.

Example: period:7

Technical Indicator

const options = {method: 'GET'};

fetch('https://api.asksurf.ai/gateway/v1/market/price-indicator?indicator=rsi&symbol=BTC&interval=1d&exchange=binance&from=2024-01-01&to=2024-02-01&options=period:7', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "$schema": "https://example.com/schemas/DataResponseMarketIndicatorItem.json",
  "data": [
    {
      "interval": "<string>",
      "name": "<string>",
      "project_id": "<string>",
      "symbol": "<string>",
      "timestamp": 123,
      "updated_at": 123,
      "value": 123,
      "values": {
        "bbands_lower": 123,
        "bbands_middle": 123,
        "bbands_upper": 123,
        "dmi_adx": 123,
        "dmi_mdi": 123,
        "dmi_pdi": 123,
        "ichimoku_base": 123,
        "ichimoku_conversion": 123,
        "ichimoku_current_span_a": 123,
        "ichimoku_current_span_b": 123,
        "ichimoku_lagging_span_a": 123,
        "ichimoku_lagging_span_b": 123,
        "ichimoku_span_a": 123,
        "ichimoku_span_b": 123,
        "macd_hist": 123,
        "macd_signal": 123,
        "macd_value": 123,
        "stoch_d": 123,
        "stoch_k": 123,
        "supertrend_advice": "<string>",
        "supertrend_value": 123
      }
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123,
    "empty_reason": "<string>",
    "has_more": true,
    "limit": 123,
    "offset": 123,
    "total": 123,
    "watermark": 123
  }
}