옵션 시세

시세라이센스 정책에 따라 API v3으로 업데이트되었으니 참고해주시길 바랍니다.

상품/지수 옵션시장에 상장된 종목 리스트, 종목 마스터, 종목 체결, 호가 잔량등을 제공한다.

Syntax

HTTP methods | GET

Authentication | API Key

marketcode및 issuecode는 코드표 > "시장코드표"를 참조하세요.

issuecode(옵션) ex) KR4201KC1756 → 201KC175

상품/지수옵션 종목 리스트

/v2/market/options/{marketcode}/lists

GET https://{APIGWAddr}/v2/market/options/{marketcode}/lists

Path Parameters

Name	Type	Description
marketcode	string	시장코드

Name

Type

Description

marketcode

string

시장코드

{
   "trdDd": "20180307",
   "mktEndTm": "1550",
   "isuLists": [ 
    {
       "isuSrtCd": "201N3240",
       "isuCd": "KR4201N32402",
       "isuKorNm": "KOSPI 200 콜옵션 1803 240.0",
       "isuKorAbbr": "K200 옵션 1803 C240.0",
       "map_to": "201N3240*006" 
    },
    {
       "isuSrtCd": "201N3242",
       "isuCd": "KR4201N32428",
       "isuKorNm": "KOSPI 200 콜옵션 1803 242.5",
       "isuKorAbbr": "K200 옵션 1803 C242.5",
       "map_to": "201N3242*006" 
    },
     ... 이하생략...
  ]
}

Response Parameters

Name

Type

Description

trdDd

String(8)

체결일자, 거래일자, 매매일자

YYYYMMDD

isuLists

Array(4)

종목리스트

isuCd

String(12)

종목코드

표준코

isuSrtCd

String(9)

종목단축코드

예) KR4201KC1756 → 201KC175

isuKorNm

String(80)

종목한글명

isuKorAbbrv

String(40)

종목한글약명

가나다

상품/지수옵션 종목 마스터

/v2/market/options/{marketcode}/{issuecode}/master

GET https://{APIGWAddr}/v2/market/options/{marketcode}/{issuecode}/master

Path Parameters

Name	Type	Description
marketcode	string	시장코드
issuecode	string	종목코드

Name

Type

Description

marketcode

string

시장코드

issuecode

string

종목코드

{
   "jsonrpc": "2.0",
   "result": 
  {
     "isuSrtCd": "201N6220",
     "midyyHgstprc": 100.5,
     "midyyHgstprcDd": 20180419,
     "midyyLwstprc": 100.5,
     "midyyLwstprcDd": 20180419,
     "inlistHgstprc": 100.5,
     "inlistHgstprcDd": 20180419,
     "inlistLwstprc": 100.5,
     "inlistLwstprcDd": 20180419,
     "prevddClsprc": 100.95,
     "prevddOpnprc": 100.95,
     "prevddHgprc": 100.95,
     "prevddLwprc": 100.95,
     "prevddAccTrdvol": 0,
     "prevddAccTrdval": 0,
     "prevddOpnintQty": 1,
     "setlPrcTheoPrcDivrgRt": 0,
     "impVolt": 0.1,
     "BzDd": 20180508,
     "basPrc": 97.15,
     "isuKorNm": "KOSPI 200 콜옵션 1806 220.0",
     "isuKorAbbrv": "K200 옵션 1806 C220.0",
     "isuCd": "KR4201N62201",
     "listDd": 20160610,
     "remainDys": 38,
     "cdInt": 1.65,
     "lsttrdDd": 20180614,
     "expDd": 201806,
     "exerPrc": 220,
     "ulyId": "KOSPI200",
     "prcLmtStep1Uplmtprc": 122.45,
     "prcLmtStep2Uplmtprc": 144.6,
     "prcLmtStep3Uplmtprc": 160.45,
     "prcLmtStep1Lwlmtprc": 71.8,
     "prcLmtStep2Lwlmtprc": 49.65,
     "prcLmtStep3Lwlmtprc": 33.8,
     "setlmult": 250000,
     "setlTheoPrc": 0,
     "basTheoPrc": 97.13 
  } 
}

Response Parameters

Name

Type

Description

trdDd

string(8)

체결일자, 거래일자, 매매일자

YYYYMMDD

isuCd

string(12)

종목코드

isuSrtCd

string(9)

종목단축코드

예) KR4201KC1756 → 201KC175

isuKorNm

string(80)

종목한글명

isuKorAbbrv

string(40)

종목한글약명

가나다

listDd

string(8)

상장일자

YYYYMMDD

prcLmtStep1Uplmtprc

number(12)

가격제한1단계상한가

prcLmtStep1Lwlmtprc

number(12)

가격제한1단계하한가

prcLmtStep2Uplmtprc

number(12)

가격제한2단계상한가

prcLmtStep2Lwlmtprc

number(12)

가격제한2단계하한가

prcLmtStep3Uplmtprc

number(12)

가격제한3단계상한가

prcLmtStep3Lwlmtprc

number(12)

가격제한3단계하한가

basPrc

number(11)

기준가격,기준가액

ulyId

string(3)

기초자산명

lsttrdDd

string(8)

최종거래일자

expDd

string(8)

만기년월

권리행사 가능한 만기년월

업종

number(22)

거래승수

약정대금 및 결제시 사용하는 계산승수

remainDys

number(8)

잔존일수

setlTheoPrc

number(16)

정산이론가격

basTheoPrc

number(16)

기준이론가격

prevddClsprc

number(11)

전일종가

prevddOpnprc

number(11)

전일시가

prevddHgprc

number(11)

전일고가

prevddLwprc

number(11)

전일저가

setlPrcTheoPrcDivrgRt

number(13)

정산가격이론가격괴리율

prevddOpnintQty

number(12)

전일미결제약정수량

impVolt

number(11)

내재변동성

inlistHgstprc

number(11)

상장중최고가

inlistLwstprc

number(11)

상장중최저가

midyyHgstprc

number(11)

연중최고가

midyyLwstprc

number(11)

연중최저가

inlistHgstprcDd

string(8)

상장중최고가일자

inlistLwstprcDd

string(8)

상장중최저가일자

midyyHgstprcDd

string(8)

연중최고가일자

midyyLwstprcDd

string(8)

연중최저가일자

prevddAccTrdvol

number(15)

전일체결수량,전일거래량

prevddAccTrdval

number(22)

전일거래대금

cdInt

number(7)

CD금리

예) 999.999

상품/지수옵션 종목 종가

/v2/market/options/{marketcode}/{issuecode}/closeprice

GET https://{APIGWAddr}/v2/market/options/{marketcode}/{issuecode}/closeprice

Path Parameters

Name	Type	Description
marketcode	string	시장코드
issuecode	string	종목코드

Name

Type

Description

marketcode

string

시장코드

issuecode

string

종목코드

{
   "jsonrpc": "2.0",
   "result": 
  {
     "isuSrtCd": "201N6220",
     "trdPrc": 96.35,
     "cmpprevddTpCd": "0",
     "opnprc": 96.35,
     "hgprc": 96.35,
     "lwprc": 96.35,
     "accTrdvol": 0,
     "accTrdval": 0,
     "cmpprevddPrc": 0 
  } 
}

{
   "error": "당일 종가 제공 시간이 아닙니다." 
}

Response Parameters

Name

Type

Description

isuSrtCd

String(9)

종목단축코드

예) KR4101C90009 → K101C9000

cmpprevddTpCd

String(1)

전일대비구분코드

1:상한/2:상승/3:보합/4:하한/5:하락/6:기세상한/7:기세상승/8:기세하한/9:기세하락

cmpprevddPrc

number(11)

전일대비가격

단위:원 / 신주인수권 증서&증권의 신규 상장 당일 : 0

opnprc

number(11)

시가

단위:원

hgprc

number(11)

고가

단위:원

lwprc

number(11)

저가

단위:원

trdPrc

number(11)

체결가격

accTrdvol

number(12)

누적체결수량,누적거래량

단위:주

accTrdval

number(22)

누적거래대금

단위:원

상품/지수옵션 종목 체결

/v2/market/options/{marketcode}/{issuecode}/price

GET https://{APIGWAddr}/v2/market/options/{marketcode}/{issuecode}/price

Path Parameters

Name	Type	Description
marketcode	string	시장코드
issuecode	string	종목코드

Name

Type

Description

marketcode

string

시장코드

issuecode

string

종목코드

{
   "jsonrpc": "2.0",
   "result": 
  {
     "isuSrtCd": "201N6220*006",
     "trdPrc": 96.35,
     "opnprc": 96.35,
     "hgprc": 96.35,
     "lwprc": 96.35,
     "accTrdvol": 0,
     "trdTm": 31000000,
     "trdvol": 0,
     "lstTrdTpCd": 0,
     "accTrdval": 0,
     "isuCd": "KR4201N62201",
     "negoBlkAccTrdvol": 0,
     "realtmUplmtprc": 121.65,
     "realtmLwlmtprc": 71.1 
  } 
}

Response Parameters

Name

Type

Description

isuCd

string(12)

종목코드

표준코드

opnprc

number(11)

시가

단위:원

hgprc

number(11)

고가

단위:원

lwprc

number(11)

저가

단위:원

trdPrc

number(11)

체결가격

trdvol

number(10)

체결수량, 거래량

trdTm

string(8)

체결시각,거래시각

*테이블 하단 참고

accTrdvol

number(12)

누적체결수량,누적거래량

단위:주

accTrdval

number(22)

누적거래대금

단위:원

negoBlkAccTrdvol

number(15)

협의대량누적체결수량

lstAskbidTpCd

string(1)

최종매도매수구분코드

1:매도, 2:매수 (최종으로 들어온 호가의 매도매수구분값)

realtmUplmtprc

number(11)

실시간상한가

realtmLwlmtprc

number(11)

실시간하한가

trdTm "HHMMSSmm" 형태로 시간전송 - 정규장 개시전 또는 정규장 체결 발생 이전 : 0 - 장운영시그널, 대량체결 포함 ※ 장운영시그널 정규장마감(15:00):31000000 /장종료시간외마감(15:30):41000000 /단일가마감(18:00):81000000 /일반Buy-in마감(18:00):91000007 /당일Buy-in마감(18:00):91000008 ※ 대량체결시 장전대량매매체결:51000000/장중대량매매체결:61000000/장후대량매매체결:71000000"

상품/지수옵션 종목 우선호가

/v2/market/options/{marketcode}/{issuecode}/orderbook

GET https://{APIGWAddr}/v2/market/options/{marketcode}/{issuecode}/orderbook

Path Parameters

Name	Type	Description
marketcode	string	시장코드
issuecode	string	종목코드

Name

Type

Description

marketcode

string

시장코드

issuecode

string

종목코드

{
   "jsonrpc": "2.0",
   "result": 
  {
     "isuSrtCd": "201N6220",
     "askStep1BstordPrc": 122.35,
     "askStep2BstordPrc": 0,
     "askStep3BstordPrc": 0,
     "askStep4BstordPrc": 0,
     "askStep5BstordPrc": 0,
     "askStep1BstordRqty": 10,
     "askStep2BstordRqty": 0,
     "askStep3BstordRqty": 0,
     "askStep4BstordRqty": 0,
     "askStep5BstordRqty": 0,
     "bidStep1BstordPrc": 71.9,
     "bidStep2BstordPrc": 0,
     "bidStep3BstordPrc": 0,
     "bidStep4BstordPrc": 0,
     "bidStep5BstordPrc": 0,
     "bidStep1BstordRqty": 10,
     "bidStep2BstordRqty": 0,
     "bidStep3BstordRqty": 0,
     "bidStep4BstordRqty": 0,
     "bidStep5BstordRqty": 0,
     "askTotOrdRqty": 10,
     "bidTotOrdRqty": 10,
     "askStep1BstordCnt": 1,
     "bidStep1BstordCnt": 1,
     "askStep2BstordCnt": 0,
     "bidStep2BstordCnt": 0,
     "askStep3BstordCnt": 0,
     "bidStep3BstordCnt": 0,
     "askStep4BstordCnt": 0,
     "bidStep4BstordCnt": 0,
     "askStep5BstordCnt": 0,
     "bidStep5BstordCnt": 0,
     "askValidOrdCnt": 1,
     "bidValidOrdCnt": 1,
     "ordAcptTm": 9012700,
     "deemTrdPrc": 0 
  } 
}

Response Parameters

Name

Type

Description

isuSrtCd

String(12)

종목단축코드

단축코드

bidTotOrdRqty

number(12)

매수총호가잔량

bidStep1BstordPrc

number(11)

매수1단계우선호가가격

bidStep1BstordRqty

number(12)

매수1단계우선호가잔량

bidStep2BstordPrc

number(11)

매수2단계우선호가가격

bidStep2BstordRqty

number(12)

매수2단계우선호가잔량

bidStep3BstordPrc

number(11)

매수3단계우선호가가격

bidStep3BstordRqty

number(12)

매수3단계우선호가잔량

bidStep4BstordPrc

number(11)

매수4단계우선호가가격

bidStep4BstordRqty

number(12)

매수4단계우선호가잔량

bidStep5BstordPrc

number(11)

매수5단계우선호가가격

bidStep5BstordRqty

number(12)

매수5단계우선호가잔량

askTotOrdRqty

number(12)

매도총호가잔량

askStep1BstordPrc

number(11)

매도1단계우선호가가격

askStep1BstordRqty

number(12)

매도1단계우선호가잔량

askStep2BstordPrc

number(11)

매도2단계우선호가가격

askStep2BstordRqty

number(12)

매도2단계우선호가잔량

askStep3BstordPrc

number(11)

매도3단계우선호가가격

askStep3BstordRqty

number(12)

매도3단계우선호가잔량

askStep4BstordPrc

number(11)

매도4단계우선호가가격

askStep4BstordRqty

number(12)

매도4단계우선호가잔량

askStep5BstordPrc

number(11)

매도5단계우선호가가격

askStep5BstordRqty

number(12)

매도5단계우선호가잔량

bidValidOrdCnt

number(11)

매수유효호가건수

bidStep1BstordCnt

number(11)

매수1단계우선호가건수

bidStep2BstordCnt

number(11)

매수2단계우선호가건수

bidStep3BstordCnt

number(11)

매수3단계우선호가건수

bidStep4BstordCnt

number(11)

매수4단계우선호가건수

bidStep5BstordCnt

number(11)

매수5단계우선호가건수

askValidOrdCnt

number(11)

매도유효호가건수

askStep1BstordCnt

number(11)

매도1단계우선호가건수

askStep2BstordCnt

number(11)

매도2단계우선호가건수

askStep1BstordCnt

number(11)

매도3단계우선호가건수

askStep1BstordCnt

number(11)

매도4단계우선호가건수

askStep1BstordCnt

number(11)

매도5단계우선호가건수

ordAcptTm

number(11)

호가접수시각

deemTrdPrc

number(11)

예상체결가격

시장별 투자자별 매매동향

/v2/market/options/{marketcode}/market/investors

GET https://{APIGWAddr}/v2/market/options/{marketcode}/market/investors

상품/지수선물 종

Path Parameters

Name	Type	Description
marketcode	string	시장코드

Name

Type

Description

marketcode

string

시장코드

{
   "jsonrpc": "2.0",
   "result": 
  {
     "Tm": "10415900",
     "invstLists": [ 
      {
         "invstCd": "01",
         "CallAccAskTrdvol": 152062,
         "CallAccAskTrdval": 6600222,
         "CallAccBidTrdvol": 146356,
         "CallAccBidTrdval": 9397987,
         "PutAccAskTrdvol": 14062,
         "PutAccAskTrdval": 5049965,
         "PutAccBidTrdvol": 13850,
         "PutAccBidTrdval": 3119705 
      },
      {
         "invstCd": "02",
         "CallAccAskTrdvol": 0,
         "CallAccAskTrdval": 0,
         "CallAccBidTrdvol": 190,
         "CallAccBidTrdval": 9500,
         "PutAccAskTrdvol": 0,
         "PutAccAskTrdval": 0,
         "PutAccBidTrdvol": 0,
         "PutAccBidTrdval": 0 
      },
       ...
      {
         "invstCd": "16",
         "CallAccAskTrdvol": 30748,
         "CallAccAskTrdval": 3782255,
         "CallAccBidTrdvol": 29008,
         "CallAccBidTrdval": 2070807,
         "PutAccAskTrdvol": 11255,
         "PutAccAskTrdval": 2857505,
         "PutAccBidTrdvol": 10955,
         "PutAccBidTrdval": 7402262 
      } 
    ] 
  } 
}

Response Parameters

Name

Type

Description

String(8)

장시간

HHMMSSmm

invstLists

Array(4)

투자자리스트

invstCd

String(4)

투자자코드

'투자자코드표' 참조

CallAccAskTrdvol

Number(11)

옵션콜누적매도체결수량

기초시장 기준

CallAccAskTrdval

Number(11)

옵션콜누적매도거래대금

기초시장 기준, 백만

CallAccBidTrdvol

Number(11)

옵션콜누적매수체결수량

기초시장 기준

CallAccBidTrdval

Number(11)

옵션콜누적매수거래대금

기초시장 기준, 백만

PutAccAskTrdvol

Number(11)

옵션풋누적매도체결수량

기초시장 기준

PutAccAskTrdval

Number(11)

옵션풋누적매도거래대금

기초시장 기준, 백만

PutAccBidTrdvol

Number(11)

옵션풋누적매수체결수량

기초시장 기준

PutAccBidTrdval

Number(11)

옵션풋누적매수거래대금

기초시장 기준, 백만

상품/지수옵션 일중

/v2/market/options/{marketcode}/{issuecode}/intraday

GET https://{APIGWAddr}/v2/market/options/{marketcode}/{issuecode}/intraday

상품/지수선물 종목 10초/분별 데이터 제공 (최대 100건까지 조회가능)

Path Parameters

Name	Type	Description
marketcode	string	시장코드
issuecode	string	종목코드

Name

Type

Description

marketcode

string

시장코드

issuecode

string

종목코드

Query Parameters

Name	Type	Description
inddCycleTpCd	string	일중전송주기구분코드 구분코드 (10:10초, 60:1분, 600:10분)
inqStrtDd	string	조회시작일자 (YYYYMMDD)
strtTm	string	시작시각 (HHMMSS)
endTm	string	종료시각 (HHMMSS)

Name

Type

Description

inddCycleTpCd

string

일중전송주기구분코드 구분코드 (10:10초, 60:1분, 600:10분)

inqStrtDd

string

조회시작일자 (YYYYMMDD)

strtTm

string

시작시각 (HHMMSS)

endTm

string

종료시각 (HHMMSS)

ddddd

Response Parameters

Name

Type

Description

isuSrtCd

String(9)

종목단축코드

예) KR7000660001 → 000660

isuNm

String(80)

종목명

hisLists

Array(4)

과거리스트

inddTm

string(8)

일중시간

HH:MM:SS

inddOpnprc

number(11)

일중시가

일중데이타(10초, 1분, 10분)

inddHgprc

number(11)

일중고가

일중데이타(10초, 1분, 10분)

inddLwprc

number(11)

일중저가

일중데이타(10초, 1분, 10분)

inddClsprc

number(11)

일중종가

일중데이타(10초, 1분, 10분)

inddTrdvol

number(11)

일중거래량

일중데이타(10초, 1분, 10분)

상품/지수옵션 종목 히스토리

/v2/market/options/{marketcode}/{issuecode}/history

GET https://sandbox-apigw.koscom.co.kr/v2/market/options/{marketcode}/{issuecode}/history

Path Parameters

Name	Type	Description
marketcode	string	시장코드
issuecode	string	종목코드

Name

Type

Description

marketcode

string

시장코드

issuecode

string

종목코드

Query Parameters

Name	Type	Description
trnsmCycleTpCd	string	전송주기구분코드 (D:일별, W:주별, M:월별)
inqStrtDd	string	조회시작일자 (YYYYMMDD)
inqEndDd	string	조회종료일자 (YYYYMMDD_)
reqCnt	string	요청건수 (최대 100건)

Name

Type

Description

trnsmCycleTpCd

string

전송주기구분코드 (D:일별, W:주별, M:월별)

inqStrtDd

string

조회시작일자 (YYYYMMDD)

inqEndDd

string

조회종료일자 (YYYYMMDD_)

reqCnt

string

요청건수 (최대 100건)

{
   "jsonrpc": "2.0",
   "result": 
  {
     "isuSrtCd": "201N6220",
     "hisLists": [ 
      {
         "BzDd": 20180330,
         "trdPrc": 94.6,
         "cmpprevddTpCd": "0",
         "opnprc": 94.6,
         "hgprc": 94.6,
         "lwprc": 94.6,
         "accTrdvol": 0,
         "accTrdval": 0,
         "opnintQty": 0,
         "cmpprevddPrc": 0 
      },
       
      {
         "BzDd": 20180329,
         "trdPrc": 92.3,
         "cmpprevddTpCd": "0",
         "opnprc": 92.3,
         "hgprc": 92.3,
         "lwprc": 92.3,
         "accTrdvol": 0,
         "accTrdval": 0,
         "opnintQty": 0,
         "cmpprevddPrc": 0 
      } 
    ] 
  } 
}

Response Parameters

Name

Type

Description

isuSrtCd

String(9)

종목단축코드

예) KR4201KC1756 → 201KC175

isuNm

String(80)

종목명

hisLists

Array(4)

과거리스트

trdDd

string(8)

체결일자,거래일자,매매일자

YYYYMMDD

trdPrc

number(11)

체결가격

cmpprevddTpCd

string(1)

전일대비부호

cmpprevddPrc

number(11)

전일대비가격

accTrdvol

number(12)

누적체결수량,누적거래량

accTrdval

number(22)

누적거래대금

opnprc

number(11)

시가

hgprc

number(11)

고가

lwprc

number(11)

저가

opnintQty

number(10)

미결제약정수량

Previous선물 시세 Next업종 지수

Last updated 1 year ago