> ## Documentation Index
> Fetch the complete documentation index at: https://docs.asksurf.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Technical Indicator



## OpenAPI

````yaml openapi.json GET /gateway/v1/market/price-indicator
openapi: 3.1.0
info:
  title: Hermod
  version: 0.0.1
servers:
  - url: https://api.asksurf.ai
security: []
paths:
  /gateway/v1/market/price-indicator:
    get:
      tags:
        - Market
      summary: Technical Indicator
      description: >-
        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`.
      operationId: market-price-indicator
      parameters:
        - description: >-
            Technical indicator name. Can be `rsi`, `macd`, `ema`, `sma`,
            `bbands`, `stoch`, `adx`, `atr`, `cci`, `obv`, `vwap`, `dmi`,
            `ichimoku`, or `supertrend`.
          explode: false
          in: query
          name: indicator
          required: true
          schema:
            description: >-
              Technical indicator name. Can be `rsi`, `macd`, `ema`, `sma`,
              `bbands`, `stoch`, `adx`, `atr`, `cci`, `obv`, `vwap`, `dmi`,
              `ichimoku`, or `supertrend`.
            enum:
              - rsi
              - macd
              - ema
              - sma
              - bbands
              - stoch
              - adx
              - atr
              - cci
              - obv
              - vwap
              - dmi
              - ichimoku
              - supertrend
            examples:
              - rsi
            type: string
        - description: Trading pair as `BTC/USDT` or bare symbol like `BTC`
          explode: false
          in: query
          name: symbol
          required: true
          schema:
            description: Trading pair as `BTC/USDT` or bare symbol like `BTC`
            examples:
              - BTC
            type: string
        - description: >-
            Candlestick interval. Can be `1m`, `5m`, `15m`, `30m`, `1h`, `2h`,
            `4h`, `12h`, `1d`, or `1w`.
          explode: false
          in: query
          name: interval
          schema:
            default: 1d
            description: >-
              Candlestick interval. Can be `1m`, `5m`, `15m`, `30m`, `1h`, `2h`,
              `4h`, `12h`, `1d`, or `1w`.
            enum:
              - 1m
              - 5m
              - 15m
              - 30m
              - 1h
              - 2h
              - 4h
              - 12h
              - 1d
              - 1w
            examples:
              - 1d
            type: string
        - description: >-
            Exchange for price data. Can be `binance`, `bybit`, `coinbase`, or
            `kraken`.
          explode: false
          in: query
          name: exchange
          schema:
            default: binance
            description: >-
              Exchange for price data. Can be `binance`, `bybit`, `coinbase`, or
              `kraken`.
            enum:
              - binance
              - bybit
              - coinbase
              - kraken
            examples:
              - binance
            type: string
        - description: >-
            Start of time range. When set, returns time-series instead of latest
            value. Accepts Unix seconds (`1704067200`) or date string
            (`2024-01-01`)
          explode: false
          in: query
          name: from
          schema:
            description: >-
              Start of time range. When set, returns time-series instead of
              latest value. Accepts Unix seconds (`1704067200`) or date string
              (`2024-01-01`)
            examples:
              - '2024-01-01'
            type: string
        - description: >-
            End of time range. Defaults to now when from is set. Accepts Unix
            seconds (`1706745600`) or date string (`2024-02-01`)
          explode: false
          in: query
          name: to
          schema:
            description: >-
              End of time range. Defaults to now when from is set. Accepts Unix
              seconds (`1706745600`) or date string (`2024-02-01`)
            examples:
              - '2024-02-01'
            type: string
        - description: >-
            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`.
          explode: false
          in: query
          name: options
          schema:
            description: >-
              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`.
            examples:
              - period:7
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SimpleListResponseMarketIndicatorItem'
          description: OK
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataAPIError'
          description: Error
      security:
        - AccessToken: []
components:
  schemas:
    SimpleListResponseMarketIndicatorItem:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
            - >-
              https://example.com/schemas/SimpleListResponseMarketIndicatorItem.json
          format: uri
          readOnly: true
          type: string
        data:
          items:
            $ref: '#/components/schemas/MarketIndicatorItem'
          type:
            - array
            - 'null'
        meta:
          $ref: '#/components/schemas/ObjectResponseMeta'
      required:
        - data
        - meta
      type: object
    DataAPIError:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
            - https://example.com/schemas/DataAPIError.json
          format: uri
          readOnly: true
          type: string
        error:
          $ref: '#/components/schemas/DataAPIErrorDetail'
      required:
        - error
      type: object
    MarketIndicatorItem:
      additionalProperties: false
      properties:
        interval:
          description: Time interval used to compute the indicator like `1h`, `4h`, or `1d`
          type: string
        name:
          description: Indicator name like `rsi`, `macd`, or `bbands`
          type: string
        symbol:
          description: Token symbol this indicator is computed for
          type: string
        timestamp:
          description: >-
            Candle open timestamp in Unix seconds (present in time-series
            responses)
          format: int64
          type: integer
        updated_at:
          description: Unix timestamp in seconds when the indicator was last computed
          format: int64
          type: integer
        value:
          description: Primary indicator value
          format: double
          type: number
        values:
          $ref: '#/components/schemas/IndicatorValues'
          description: >-
            Component values for multi-value indicators. Present for macd,
            bbands, stoch, dmi, ichimoku, supertrend. Nil for single-value
            indicators (rsi, ema, sma, atr, cci, obv, vwap).
      required:
        - name
        - symbol
        - interval
        - value
      type: object
    ObjectResponseMeta:
      additionalProperties: false
      properties:
        cached:
          description: Whether this response was served from cache
          type: boolean
        credits_used:
          description: Credits deducted for this request
          format: int64
          type: integer
      required:
        - credits_used
        - cached
      type: object
    DataAPIErrorDetail:
      additionalProperties: false
      properties:
        code:
          type: string
        message:
          type: string
      required:
        - code
        - message
      type: object
    IndicatorValues:
      additionalProperties: false
      properties:
        bbands_lower:
          description: Bollinger lower band
          format: double
          type: number
        bbands_middle:
          description: Bollinger middle band (SMA)
          format: double
          type: number
        bbands_upper:
          description: Bollinger upper band
          format: double
          type: number
        dmi_adx:
          description: Average Directional Index value
          format: double
          type: number
        dmi_mdi:
          description: Negative Directional Indicator (-DI)
          format: double
          type: number
        dmi_pdi:
          description: Positive Directional Indicator (+DI)
          format: double
          type: number
        ichimoku_base:
          description: Ichimoku baseline (Kijun-sen)
          format: double
          type: number
        ichimoku_conversion:
          description: Ichimoku conversion line (Tenkan-sen)
          format: double
          type: number
        ichimoku_current_span_a:
          description: Ichimoku current span A
          format: double
          type: number
        ichimoku_current_span_b:
          description: Ichimoku current span B
          format: double
          type: number
        ichimoku_lagging_span_a:
          description: Ichimoku lagging span A
          format: double
          type: number
        ichimoku_lagging_span_b:
          description: Ichimoku lagging span B
          format: double
          type: number
        ichimoku_span_a:
          description: Ichimoku leading span A (Senkou A)
          format: double
          type: number
        ichimoku_span_b:
          description: Ichimoku leading span B (Senkou B)
          format: double
          type: number
        macd_hist:
          description: MACD histogram (MACD minus signal)
          format: double
          type: number
        macd_signal:
          description: MACD signal line
          format: double
          type: number
        macd_value:
          description: MACD line value
          format: double
          type: number
        stoch_d:
          description: Stochastic %D (slow line)
          format: double
          type: number
        stoch_k:
          description: Stochastic %K (fast line)
          format: double
          type: number
        supertrend_advice:
          description: >-
            Supertrend direction: `buy` (price above supertrend, bullish) or
            `sell` (price below supertrend, bearish)
          type: string
        supertrend_value:
          description: Supertrend line value
          format: double
          type: number
      type: object

````