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

# OHLCV(거래소)

각 거래소별 가상자산 마켓페어의 분/시간/일/주/월 캔들 데이터를 조회합니다.


## OpenAPI

````yaml api-docs.json POST /v2/api/coin/ohlcv/exchange
openapi: 3.1.0
info:
  title: Dayfin Data API
  description: Dayfin market data API
  version: v2
servers:
  - url: https://dev.dayfin.io
    description: Generated server url
security:
  - bearerAuth: []
tags:
  - name: Coin OHLCV
    description: 가상자산 OHLCV 캔들 조회 API
paths:
  /v2/api/coin/ohlcv/exchange:
    post:
      tags:
        - Coin OHLCV
      summary: 거래소별 OHLCV 조회
      description: 거래소와 마켓 코드를 기준으로 최신 또는 과거 OHLCV 캔들을 조회합니다.
      operationId: getOhlcvExchange
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ReqOhlcvData'
        required: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ResKoreaStandardQuoteChartInfoList'
components:
  schemas:
    ReqOhlcvData:
      type: object
      properties:
        tranDtime:
          type: string
          description: 요청 거래일시 (yyyyMMddHHmmss)
          example: '20261014143000'
          maxLength: 14
          minLength: 14
        tranNo:
          type: string
          description: 요청별 고유 거래번호
          example: '202610141430000001'
          minLength: 1
        marketCodes:
          type: array
          description: 마켓 코드 목록 (최대 10개)
          example:
            - KRW-BTC
          items:
            type: string
        exchangeNm:
          type: string
          description: 거래소명
          enum:
            - upbit
            - bithumb
            - coinone
            - digitalx
            - gopax
          example: upbit
        lastCandleDtm:
          type: string
          description: 조회 기준 마지막 캔들 일시 (yyyyMMddHHmm). 생략하면 현재 일시 기준으로 조회합니다.
          example: '202610141430'
        limit:
          type: string
          default: '1'
          description: 조회 캔들 수 (0~100, 기본값 1)
          example: '100'
        candleUnit:
          type: string
          default: I
          description: '캔들 단위 (I: 1분, H: 1시간, D: 1일, W: 1주, M: 1개월)'
          enum:
            - I
            - H
            - D
            - W
            - M
          example: I
      required:
        - exchangeNm
        - marketCodes
        - tranDtime
        - tranNo
    ResKoreaStandardQuoteChartInfoList:
      type: object
      properties:
        rspCode:
          type: string
          description: 처리 결과 코드
          example: A0000
        rspMessage:
          type: string
          description: 처리 결과 메시지
          example: 처리 성공
        dataList:
          type: array
          description: 캔들 조회 결과 목록
          items:
            $ref: '#/components/schemas/ResKoreaStandardQuoteChartInfoVO'
        dataListCnt:
          type: integer
          format: int32
          description: 응답 결과 수
          example: 1
    ResKoreaStandardQuoteChartInfoVO:
      type: object
      properties:
        marketCode:
          type: string
          description: 마켓 코드
          example: KRW-BTC
        assetId:
          type: string
          description: 자산 ID
          example: '1'
        exchangeNm:
          type: string
          description: 거래소명
          example: upbit
        candles:
          type: array
          description: 캔들 목록
          items:
            $ref: '#/components/schemas/CandleDataVO'
        candleCnt:
          type: integer
          format: int32
          description: 캔들 수
          example: 100
    CandleDataVO:
      type: object
      properties:
        open:
          type: string
          description: 시가
          example: '93000000'
        high:
          type: string
          description: 고가
          example: '93500000'
        low:
          type: string
          description: 저가
          example: '92500000'
        close:
          type: string
          description: 종가
          example: '93200000'
        accTradeVol:
          type: string
          description: 누적 거래량
          example: '12.3456789'
        candleDateTimeKst:
          type: string
          description: 캔들 기준 시각 (KST, yyyy-MM-dd HH:mm:ss)
          example: '2026-10-14 14:30:00'
        timestamp:
          type: string
          description: 캔들 생성 완료 시각 (Unix epoch milliseconds)
          example: '1791955800000'
        updateTs:
          type:
            - string
            - 'null'
          description: 최종 캔들 생성 완료 시각 (Unix epoch milliseconds)
          example: '1791955812345'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.