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

# 시세프리미엄

BTC, ETH 국내 대표가격 대비 해외 대표가격의 차이(프리미엄)를 일자별로 조회합니다.\
(1회 최대 조회건수: 100건)


## OpenAPI

````yaml api-docs.json POST /v2/api/coinInfo/premium
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/coinInfo/premium:
    post:
      tags:
        - Coin Info
      summary: 시세 프리미엄 이력 조회
      description: 자산과 비교 페어를 기준으로 CMC 대비 시세 프리미엄을 일자별로 조회합니다.
      operationId: getPremium
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ReqPremium'
        required: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ResPremium'
components:
  schemas:
    ReqPremium:
      type: object
      properties:
        tranDtime:
          type: string
          description: 요청 거래일시 (yyyyMMddHHmmss)
          example: '20261014143000'
          maxLength: 14
          minLength: 14
        tranNo:
          type: string
          description: 요청별 고유 거래번호
          example: '202610141430000001'
          minLength: 1
        pair:
          type: string
          description: '비교 페어 (1: K-VWAP/CMC, 2: 업비트/CMC)'
          enum:
            - '1'
            - '2'
          example: '1'
        assetSymbols:
          type: array
          description: 자산 심볼 목록 (BTC, ETH)
          example:
            - BTC
            - ETH
          items:
            type: string
        startDt:
          type: string
          description: 조회 시작 일자 (yyyyMMdd). 생략하면 요청일 기준으로 조회합니다.
          example: '20261001'
        endDt:
          type: string
          description: 조회 종료 일자 (yyyyMMdd). 생략하면 현재 코인 기준일로 조회합니다.
          example: '20261014'
      required:
        - assetSymbols
        - pair
        - tranDtime
        - tranNo
    ResPremium:
      type: object
      properties:
        rspCode:
          type: string
          description: 처리 결과 코드
          example: A0000
        rspMessage:
          type: string
          description: 처리 결과 메시지
          example: 정상 처리되었습니다.
        pair:
          type: string
          description: 비교 페어
          example: '1'
        dataList:
          type: array
          description: 자산별 프리미엄 조회 결과 목록
          items:
            $ref: '#/components/schemas/DataGroupByMarketCode'
    DataGroupByMarketCode:
      type: object
      properties:
        assetSymbol:
          type: string
          description: 가상자산 심볼
          example: BTC
        data:
          type: array
          description: 일자별 프리미엄 목록
          items:
            $ref: '#/components/schemas/PremiumData'
    PremiumData:
      type: object
      properties:
        date:
          type: string
          description: 기준 일자 (yyyyMMdd)
          example: '20261014'
        premium:
          type: string
          description: 프리미엄 가격 (KST 09시 기준)
          example: '1500000'
        premiumRate:
          type: string
          description: 프리미엄 비율 (%, KST 09시 기준)
          example: '1.62345'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

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