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

# Get Oracle Candlesticks

> Returns Chainlink candlestick data for markets configured with Chainlink Data Streams chart metadata. Useful for charting the underlying oracle price alongside prediction market prices.

<Tip>
  Only markets with a Chainlink Data Streams oracle return data from this endpoint. Use the candlestick data alongside prediction market prices to chart the underlying asset.
</Tip>


## OpenAPI

````yaml GET /markets/{addressOrSlug}/oracle-candles
openapi: 3.0.0
info:
  title: Limitless Exchange API
  description: >-
    Production-ready REST API for prediction market trading, portfolio
    management, and market data on Limitless Exchange (Base L2).
  version: '1.0'
  contact:
    name: API Support
    url: https://limitless.exchange
    email: help@limitless.network
servers:
  - url: https://api.limitless.exchange
    description: Production API
security: []
tags:
  - name: Authentication
    description: User authentication and session management
  - name: Markets
    description: Browse, search, and analyze prediction markets
  - name: Market Navigation
    description: Navigation tree, market pages, and property filters
  - name: Trading
    description: Create, manage, and cancel orders
  - name: Portfolio
    description: Position tracking, trade history, and performance
  - name: API Tokens
    description: Scoped API token management for partner integrations
  - name: Partner Accounts
    description: Sub-account creation and allowance recovery for partner integrations
  - name: System
    description: Public API state and availability information
paths:
  /markets/{addressOrSlug}/oracle-candles:
    get:
      tags:
        - Markets
      summary: Get oracle candlesticks
      description: >-
        Returns Chainlink candlestick data for markets configured with Chainlink
        Data Streams chart metadata. Useful for charting the underlying oracle
        price alongside prediction market prices.
      operationId: MarketController_getOracleCandles
      parameters:
        - name: addressOrSlug
          required: true
          in: path
          description: Market address (0x...) or slug identifier
          schema:
            type: string
            example: btc-above-100k-june
        - name: interval
          required: false
          in: query
          description: Candlestick interval
          schema:
            type: string
            enum:
              - 1m
              - 5m
              - 15m
              - 1h
              - 4h
              - 1d
            default: 1m
        - name: from
          required: false
          in: query
          description: >-
            Start timestamp in UNIX seconds. Defaults to market creation time
            minus 15 minutes.
          schema:
            type: number
            example: 1719792000
        - name: to
          required: false
          in: query
          description: End timestamp in UNIX seconds. Defaults to now.
          schema:
            type: number
            example: 1719878400
      responses:
        '200':
          description: Candlestick data for the underlying oracle
          content:
            application/json:
              schema:
                type: object
                properties:
                  interval:
                    type: string
                    description: The requested candlestick interval
                    example: 1h
                  source:
                    type: string
                    description: Data source identifier
                    example: chainlink
                  symbol:
                    type: string
                    description: The resolved Chainlink symbol
                    example: BTC/USD
                  timestampStart:
                    type: number
                    description: Start of the data range (UNIX seconds)
                    example: 1719792000
                  timestampEnd:
                    type: number
                    description: End of the data range (UNIX seconds)
                    example: 1719878400
                  rows:
                    type: array
                    description: Array of OHLCV candlestick rows
                    items:
                      type: object
                      properties:
                        timestamp:
                          type: number
                          description: Candle open time (UNIX seconds)
                        open:
                          type: number
                          description: Opening price
                        high:
                          type: number
                          description: Highest price
                        low:
                          type: number
                          description: Lowest price
                        close:
                          type: number
                          description: Closing price
                        volume:
                          type: number
                          description: Trading volume
        '400':
          description: >-
            Invalid interval, time range, or market does not have Chainlink
            oracle configured
        '404':
          description: Market not found
        '502':
          description: Failed to fetch data from Chainlink

````