> ## 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.

# 체결(Trades)

거래소×마켓페어 별로 과거 특정 기간의 체결 데이터를 조회합니다. (1회 최대 Count : 100건)


## OpenAPI

````yaml api-docs.json POST /v2/api/trade/exchange/history
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/trade/exchange/history:
    post:
      tags:
        - Trade
      summary: 거래소 체결 이력 조회
      description: 거래소와 마켓 코드를 기준으로 지정 시각 이전의 체결 내역을 최신순으로 조회합니다.
      operationId: inqExchangeTradeHistory
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ReqExchangeTradeHistory'
        required: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ResExchangeTradeHistory'
components:
  schemas:
    ReqExchangeTradeHistory:
      type: object
      properties:
        tranDtime:
          type: string
          description: 요청 거래일시 (yyyyMMddHHmmss)
          example: '20261014143000'
          maxLength: 14
          minLength: 14
        tranNo:
          type: string
          description: 요청별 고유 거래번호
          example: '202610141430000001'
          minLength: 1
        exchangeNm:
          type: string
          description: 거래소명
          enum:
            - upbit
            - bithumb
            - coinone
            - digitalx
            - gopax
          example: upbit
        marketCode:
          type: string
          description: 마켓 코드
          example: KRW-BTC
        lastTranDtm:
          type: string
          description: 마지막 조회 체결 일시 (yyyyMMddHHmmss). 생략하면 현재 일시 기준으로 조회합니다.
          example: '20261014143000'
        count:
          type: string
          default: '100'
          description: 조회 거래 수 (1~200, 기본값 100)
          example: '100'
      required:
        - exchangeNm
        - marketCode
        - tranDtime
        - tranNo
    ResExchangeTradeHistory:
      type: object
      properties:
        rspCode:
          type: string
          description: 처리 결과 코드
          example: A0000
        rspMessage:
          type: string
          description: 처리 결과 메시지
          example: 처리 성공
        exchangeNm:
          type: string
          description: 거래소명
          example: upbit
        marketCode:
          type: string
          description: 마켓 코드
          example: KRW-BTC
        assetId:
          type: string
          description: 자산 ID
          example: '1'
        lastTranDtm:
          type: string
          description: 마지막 조회 체결 일시 (yyyyMMddHHmmss)
          example: '20261014143000'
        tradeCount:
          type: integer
          format: int32
          description: 체결 데이터 수
          example: 100
        trade:
          type: array
          description: 체결 내역
          items:
            $ref: '#/components/schemas/TradeHistory'
    TradeHistory:
      type: object
      properties:
        tradePrice:
          type: string
          description: 체결 가격
          example: '93000000'
        tradeVol:
          type: string
          description: 체결량
          example: '0.001'
        tradeTp:
          type: string
          description: 매수·매도 구분
          enum:
            - BUY
            - SELL
          example: BUY
        tradeDtm:
          type: string
          description: 체결 일시 (yyyyMMddHHmmss)
          example: '20261014142959'
        sequenceId:
          type: string
          description: 거래 번호
          example: '123456789'
        exchangeTs:
          type: integer
          format: int64
          description: 거래소 체결 시각 (Unix epoch milliseconds)
          example: 1791955799000
        timestamp:
          type: integer
          format: int64
          description: 체결 데이터 수신 시각 (Unix epoch milliseconds)
          example: 1791955800000
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

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