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

# Market candlestick

> Real-time candlestick/OHLCV data for one Decibel market address and interval. The same topic pattern supports perp and spot markets, but spot BTC and perp BTC are different markets with different addresses and require separate subscriptions. Candlestick items do not carry `asset_type`; the subscribed market address identifies the product.



## AsyncAPI

````yaml api-reference/asyncapi.json marketCandlestick
id: marketCandlestick
title: Market candlestick
description: >-
  Real-time candlestick/OHLCV data for one Decibel market address and interval.
  The same topic pattern supports perp and spot markets, but spot BTC and perp
  BTC are different markets with different addresses and require separate
  subscriptions. Candlestick items do not carry `asset_type`; the subscribed
  market address identifies the product.
servers:
  - id: testnet
    protocol: wss
    host: api.testnet.aptoslabs.com/decibel/ws
    bindings: []
    variables: []
address: market_candlestick:{marketAddr}:{interval}
parameters:
  - id: marketAddr
    jsonSchema:
      type: string
      description: Market address (Aptos address format, e.g. 0x456...)
    description: Market address (Aptos address format, e.g. 0x456...)
    type: string
    required: true
    deprecated: false
  - id: interval
    jsonSchema:
      type: string
      description: Candlestick interval (1m, 15m, 1h, 4h, or 1d)
    description: Candlestick interval (1m, 15m, 1h, 4h, or 1d)
    type: string
    required: true
    deprecated: false
bindings: []
operations:
  - &ref_0
    id: receivemarketCandlestick
    title: Receivemarket candlestick
    description: >-
      Receive updates for real-time candlestick/ohlcv data for one decibel
      market address and interval. the same topic pattern supports perp and spot
      markets, but spot btc and perp btc are different markets with different
      addresses and require separate subscriptions. candlestick items do not
      carry `asset_type`; the subscribed market address identifies the product.
    type: receive
    messages:
      - &ref_1
        id: MarketCandlestickMessage
        payload:
          - name: MarketCandlestickMessage
            description: >-
              Real-time candlestick/OHLCV data for one Decibel market address
              and interval. The same topic pattern supports perp and spot
              markets, but spot BTC and perp BTC are different markets with
              different addresses and require separate subscriptions.
              Candlestick items do not carry `asset_type`; the subscribed market
              address identifies the product.
            type: object
            properties:
              - name: candle
                type: object
                required: true
                properties:
                  - name: T
                    type: integer
                    required: true
                  - name: c
                    type: number
                    required: true
                  - name: h
                    type: number
                    required: true
                  - name: i
                    type: string
                    required: true
                  - name: l
                    type: number
                    required: true
                  - name: o
                    type: number
                    required: true
                  - name: t
                    type: integer
                    required: true
                  - name: v
                    type: number
                    required: true
              - name: topic
                type: string
                required: true
        headers: []
        jsonPayloadSchema:
          type: object
          required:
            - topic
            - candle
          properties:
            candle:
              type: object
              required:
                - t
                - T
                - o
                - h
                - l
                - c
                - v
                - i
              properties:
                T:
                  type: integer
                  format: int64
                  example: 1761591599999
                  x-parser-schema-id: <anonymous-schema-117>
                c:
                  type: number
                  format: double
                  example: 100
                  x-parser-schema-id: <anonymous-schema-118>
                h:
                  type: number
                  format: double
                  example: 102
                  x-parser-schema-id: <anonymous-schema-119>
                i:
                  type: string
                  example: 1h
                  x-parser-schema-id: <anonymous-schema-120>
                l:
                  type: number
                  format: double
                  example: 98
                  x-parser-schema-id: <anonymous-schema-121>
                o:
                  type: number
                  format: double
                  example: 100
                  x-parser-schema-id: <anonymous-schema-122>
                t:
                  type: integer
                  format: int64
                  example: 1761588000000
                  x-parser-schema-id: <anonymous-schema-123>
                v:
                  type: number
                  format: double
                  example: 1000
                  x-parser-schema-id: <anonymous-schema-124>
              x-parser-schema-id: CandlestickResponseItemDto
            topic:
              type: string
              x-parser-schema-id: <anonymous-schema-125>
          x-parser-schema-id: MarketCandlestickResponse
        title: Market candlestick message
        description: >-
          Real-time candlestick/OHLCV data for one Decibel market address and
          interval. The same topic pattern supports perp and spot markets, but
          spot BTC and perp BTC are different markets with different addresses
          and require separate subscriptions. Candlestick items do not carry
          `asset_type`; the subscribed market address identifies the product.
        example: |-
          {
            "topic": "market_candlestick:0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890:1h",
            "candle": {
              "t": 1699564800000,
              "T": 1699568400000,
              "o": 49800,
              "h": 50300,
              "l": 49600,
              "c": 50125.75,
              "v": 1250.5,
              "i": "1h"
            }
          }
        bindings: []
        extensions:
          - id: x-parser-unique-object-id
            value: MarketCandlestickMessage
          - id: x-parser-message-name
            value: MarketCandlestickMessage
    bindings: []
    extensions:
      - id: x-parser-unique-object-id
        value: marketCandlestick
sendOperations:
  - *ref_0
receiveOperations: []
sendMessages:
  - *ref_1
receiveMessages: []
extensions:
  - id: x-parser-unique-object-id
    value: marketCandlestick
securitySchemes: []

````