파생실시간종가A

상품/지수 선물시장과 옵션시장에 상장된 종목 리스트, 종목 마스터 등 종가 정보를 제공한다.

Syntax

HTTP methods | GET

Authentication | API Key

상품/지수 선물 종목 리스트 API

제공시간 : AM 06:30

/v3/market/closed/derivative/futures/{marketcode}/lists

GET https://{APIGWAddr}/v3/market/closed/derivative/futures/{marketcode}/lists

종목리스트

Path Parameters

Name

Type

Description

marketcode*

String

ex) kospi200, kospi200night

{
    "trdDd": "20220602",
    "mktEndTm": "1550",
    "isuLists": [
        {
            "isuSrtCd": "101S6000",
            "isuCd": "KR4101S60008",
            "isuKorNm": "KOSPI200 선물 2206",
            "isuKorAbbr": "K200 선물 2206",
            "map_to": "101S6000*005"
        },
        {
            "isuSrtCd": "K2FA001",
            "isuCd": "KR4101S60008",
            "isuKorNm": "KOSPI200 선물 2206",
            "isuKorAbbr": "K200 선물 2206",
            "map_to": "K2FA001"
        }
    ]
}

{
    "mktEndTm": "0600",
    "trdDd": "20250707",
    "isuLists": [
        {
            "isuKorNm": "KOSPI200 선물 2509",
            "isuCd": "KR4101W90007",
            "isuKorAbbr": "K200 선물 2509",
            "map_to": "101W9000.N*236",
            "isuSrtCd": "101W9000.N"
        },
        {
            "isuKorNm": "KOSPI200 선물 2509",
            "isuCd": "KR4101W90007",
            "isuKorAbbr": "K200 선물 2509",
            "map_to": "K2FA001.N",
            "isuSrtCd": "K2FA001.N"
        },
        {
            "isuKorNm": "KOSPI200 선물 2512",
            "isuCd": "KR4101WC0003",
            "isuKorAbbr": "K200 선물 2512",
            "map_to": "101WC000.N*236",
            "isuSrtCd": "101WC000.N"
        },
        {
            "isuKorNm": "KOSPI200 선물 2603",
            "isuCd": "KR4A01630008",
            "isuKorAbbr": "K200 선물 2603",
            "map_to": "A0163000.N*236",
            "isuSrtCd": "A0163000.N"
        },
        {
            "isuKorNm": "KOSPI200 선물 2606",
            "isuCd": "KR4A01660005",
            "isuKorAbbr": "K200 선물 2606",
            "map_to": "A0166000.N*236",
            "isuSrtCd": "A0166000.N"
        },
        {
            "isuKorNm": "KOSPI200 선물 2612",
            "isuCd": "KR4A016C0004",
            "isuKorAbbr": "K200 선물 2612",
            "map_to": "A016C000.N*236",
            "isuSrtCd": "A016C000.N"
        },
        {
            "isuKorNm": "KOSPI200 선물 2706",
            "isuCd": "KR4A01760003",
            "isuKorAbbr": "K200 선물 2706",
            "map_to": "A0176000.N*236",
            "isuSrtCd": "A0176000.N"
        },
        {
            "isuKorNm": "KOSPI200 선물 2712",
            "isuCd": "KR4A017C0003",
            "isuKorAbbr": "K200 선물 2712",
            "map_to": "A017C000.N*236",
            "isuSrtCd": "A017C000.N"
        },
        {
            "isuKorNm": "K200 스프레드 W9WC",
            "isuCd": "KR4401W9WCS4",
            "isuKorAbbr": "K200 SP 2509-2512",
            "map_to": "401W9WCS.N*236",
            "isuSrtCd": "401W9WCS.N"
        },
        {
            "isuKorNm": "K200 스프레드 W963",
            "isuCd": "KR4401W963S4",
            "isuKorAbbr": "K200 SP 2509-2603",
            "map_to": "401W963S.N*236",
            "isuSrtCd": "401W963S.N"
        },
        {
            "isuKorNm": "K200 스프레드 W966",
            "isuCd": "KR4401W966S7",
            "isuKorAbbr": "K200 SP 2509-2606",
            "map_to": "401W966S.N*236",
            "isuSrtCd": "401W966S.N"
        },
        {
            "isuKorNm": "K200 스프레드 W96C",
            "isuCd": "KR4401W96CS4",
            "isuKorAbbr": "K200 SP 2509-2612",
            "map_to": "401W96CS.N*236",
            "isuSrtCd": "401W96CS.N"
        },
        {
            "isuKorNm": "K200 스프레드 W976",
            "isuCd": "KR4401W976S6",
            "isuKorAbbr": "K200 SP 2509-2706",
            "map_to": "401W976S.N*236",
            "isuSrtCd": "401W976S.N"
        },
        {
            "isuKorNm": "K200 스프레드 W97C",
            "isuCd": "KR4401W97CS2",
            "isuKorAbbr": "K200 SP 2509-2712",
            "map_to": "401W97CS.N*236",
            "isuSrtCd": "401W97CS.N"
        }
    ]
}

Response Parameters

Name

Type

Description

trdDd

String(8)

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

YYYYMMDD

isuLists

Array(4)

종목리스트

isuCd

String(12)

종목코드

표준코드

isuSrtCd

String(9)

종목단축코드

예) KR4101C90009 → K101C9000

isuKorNm

String(80)

종목한글명

isuKorAbbrv

String(40)

종목한글약명

가나다

Request Example

curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://testoap.k-mydata.org/v3/market/closed/derivative/futures/kospi200/lists'

Response Example

{
    "trdDd": "20220602",
    "mktEndTm": "1550",
    "isuLists": [
        {
            "isuSrtCd": "101S6000",
            "isuCd": "KR4101S60008",
            "isuKorNm": "KOSPI200 선물 2206",
            "isuKorAbbr": "K200 선물 2206",
            "map_to": "101S6000*005"
        },
        {
            "isuSrtCd": "K2FA001",
            "isuCd": "KR4101S60008",
            "isuKorNm": "KOSPI200 선물 2206",
            "isuKorAbbr": "K200 선물 2206",
            "map_to": "K2FA001"
        }
    ]
}

상품/지수 선물 종목 마스터 API

선물 종목에 대한 기초 자료 제공
제공시간 : AM 06:30

/v3/market/closed/derivative/futures/{marketcode}/{issuecode}/master

GET https://{APIGWAddr}/v3/market/closed/derivative/futures/{marketcode}/{issuecode}/master

종목리스트

Path Parameters

Name

Type

Description

marketcode*

String

ex) kospi200

issuecode*

String

ex) 101S6000

{
    "jsonrpc": "2.0",
    "result": {
        "isuSrtCd": "101S6000",
        "midyyHgstprc": 399.35,
        "midyyHgstprcDd": 20220103,
        "midyyLwstprc": 337.1,
        "midyyLwstprcDd": 20220512,
        "inlistHgstprc": 428.9,
        "inlistHgstprcDd": 20210614,
        "inlistLwstprc": 306.55,
        "inlistLwstprcDd": 20200826,
        "prevddClsprc": 354.15,
        "prevddOpnprc": 352.4,
        "prevddHgprc": 354.6,
        "prevddLwprc": 350.25,
        "prevddAccTrdvol": 240692,
        "prevddAccTrdval": 21215619325000,
        "prevddOpnintQty": 292368,
        "setlPrcTheoPrcDivrgRt": -0.19,
        "trdDd": 20220602,
        "basPrc": 354.15,
        "isuKorNm": "KOSPI200 선물 2206",
        "isuKorAbbrv": "K200 선물 2206",
        "isuCd": "KR4101S60008",
        "listDd": 20200612,
        "remainDys": 8,
        "cdInt": 1.96,
        "lsttrdDd": 20220609,
        "expDd": 202206,
        "ulyId": "KOSPI200",
        "prcLmtStep1Uplmtprc": 382.45,
        "prcLmtStep2Uplmtprc": 407.25,
        "prcLmtStep3Uplmtprc": 424.95,
        "prcLmtStep1Lwlmtprc": 325.85,
        "prcLmtStep2Lwlmtprc": 301.05,
        "prcLmtStep3Lwlmtprc": 283.35,
        "opnintLmtQty": null,
        "setlmult": 250000,
        "setlTheoPrc": null,
        "basTheoPrc": null
    }
}

Response Parameters

Name

Type

Description

trdDd

string(8)

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

YYYYMMDD

isuCd

string(12)

종목코드

isuSrtCd

string(9)

종목단축코드

예) KR4101C90009 → K101C9000

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)

만기년월

권리행사 가능한 만기년월

setlmult

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)

전일미결제약정수량

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

opnintLmtQty

number(15)

미결제한도수량

*적용일에 적용되는 상품의 계좌별 미결제 한도 계약수. 미결제 한도가 적용되지 않은 상품은 0 * 주식선물에만 해당

Request Example

curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://testoap.k-mydata.org/v3/market/closed/derivative/futures/kospi200/101S6000/master'

Response Example

{
    "jsonrpc": "2.0",
    "result": {
        "isuSrtCd": "101S6000",
        "midyyHgstprc": 399.35,
        "midyyHgstprcDd": 20220103,
        "midyyLwstprc": 337.1,
        "midyyLwstprcDd": 20220512,
        "inlistHgstprc": 428.9,
        "inlistHgstprcDd": 20210614,
        "inlistLwstprc": 306.55,
        "inlistLwstprcDd": 20200826,
        "prevddClsprc": 354.15,
        "prevddOpnprc": 352.4,
        "prevddHgprc": 354.6,
        "prevddLwprc": 350.25,
        "prevddAccTrdvol": 240692,
        "prevddAccTrdval": 21215619325000,
        "prevddOpnintQty": 292368,
        "setlPrcTheoPrcDivrgRt": -0.19,
        "trdDd": 20220602,
        "basPrc": 354.15,
        "isuKorNm": "KOSPI200 선물 2206",
        "isuKorAbbrv": "K200 선물 2206",
        "isuCd": "KR4101S60008",
        "listDd": 20200612,
        "remainDys": 8,
        "cdInt": 1.96,
        "lsttrdDd": 20220609,
        "expDd": 202206,
        "ulyId": "KOSPI200",
        "prcLmtStep1Uplmtprc": 382.45,
        "prcLmtStep2Uplmtprc": 407.25,
        "prcLmtStep3Uplmtprc": 424.95,
        "prcLmtStep1Lwlmtprc": 325.85,
        "prcLmtStep2Lwlmtprc": 301.05,
        "prcLmtStep3Lwlmtprc": 283.35,
        "opnintLmtQty": null,
        "setlmult": 250000,
        "setlTheoPrc": null,
        "basTheoPrc": null
    }
}

(야간)상품/지수 선물 종목 마스터 API

야간선물 종목에 대한 기초 자료 제공
제공시간 : AM 06:30

/v3/market/closed/derivative/futures/ night/{marketcode}/{issuecode}/master

GET https://{APIGWAddr}/v3/market/closed/derivative/futures/night/{marketcode}/{issuecode}/master

종목리스트

Path Parameters

Name

Type

Description

marketcode*

String

ex) kospi200

issuecode*

String

ex) 101W9000.N

{
    "jsonrpc": "2.0",
    "result": {
        "prevddAccTrdvol": 7987,
        "prevddAccTrdval": 844392200000,
        "prevddOpnintQty": 253908,
        "setlPrcTheoPrcDivrgRt": 0,
        "basPrc": 413.25,
        "isuKorNm": "KOSPI200 선물 2509",
        "isuKorAbbrv": "K200 선물 2509",
        "isuCd": "KR4101W90007",
        "midyyHgstprc": 425.1,
        "midyyHgstprcDd": 20250704,
        "midyyLwstprc": 384,
        "midyyLwstprcDd": 20250610,
        "inlistHgstprc": 425.1,
        "inlistHgstprcDd": 20250704,
        "ulyId": "KOSPI200",
        "inlistLwstprcDd": 20250610,
        "prcLmtStep1Uplmtprc": 446.3,
        "prcLmtStep2Uplmtprc": 0,
        "prcLmtStep3Uplmtprc": 0,
        "prcLmtStep1Lwlmtprc": 380.2,
        "prcLmtStep2Lwlmtprc": 0,
        "prcLmtStep3Lwlmtprc": 0,
        "opnintLmtQty": null,
        "setlmult": 250000,
        "setlTheoPrc": null,
        "basTheoPrc": null,
        "trdDd": 20250707,
        "isuSrtCd": "101W9000.N",
        "inlistLwstprc": 384,
        "prevddClsprc": 424.8,
        "expDd": 202509,
        "listDd": 20240913,
        "remainDys": 67,
        "cdInt": 2.52,
        "lsttrdDd": 20250911,
        "prevddOpnprc": 421.4,
        "prevddHgprc": 425.1,
        "prevddLwprc": 421.25
    }
}

Response Parameters

Name

Type

Description

trdDd

string(8)

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

YYYYMMDD

isuCd

string(12)

종목코드

isuSrtCd

string(9)

종목단축코드

예) KR4101C90009 → K101C9000

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)

만기년월

권리행사 가능한 만기년월

setlmult

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)

전일미결제약정수량

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

opnintLmtQty

number(15)

미결제한도수량

*적용일에 적용되는 상품의 계좌별 미결제 한도 계약수. 미결제 한도가 적용되지 않은 상품은 0 * 주식선물에만 해당

Request Example

curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://testoap.k-mydata.org/v3/market/closed/derivative/futures/night/kospi200/101W9000.N/master'

Response Example

{
    "jsonrpc": "2.0",
    "result": {
        "isuSrtCd": "101S6000",
        "midyyHgstprc": 399.35,
        "midyyHgstprcDd": 20220103,
        "midyyLwstprc": 337.1,
        "midyyLwstprcDd": 20220512,
        "inlistHgstprc": 428.9,
        "inlistHgstprcDd": 20210614,
        "inlistLwstprc": 306.55,
        "inlistLwstprcDd": 20200826,
        "prevddClsprc": 354.15,
        "prevddOpnprc": 352.4,
        "prevddHgprc": 354.6,
        "prevddLwprc": 350.25,
        "prevddAccTrdvol": 240692,
        "prevddAccTrdval": 21215619325000,
        "prevddOpnintQty": 292368,
        "setlPrcTheoPrcDivrgRt": -0.19,
        "trdDd": 20220602,
        "basPrc": 354.15,
        "isuKorNm": "KOSPI200 선물 2206",
        "isuKorAbbrv": "K200 선물 2206",
        "isuCd": "KR4101S60008",
        "listDd": 20200612,
        "remainDys": 8,
        "cdInt": 1.96,
        "lsttrdDd": 20220609,
        "expDd": 202206,
        "ulyId": "KOSPI200",
        "prcLmtStep1Uplmtprc": 382.45,
        "prcLmtStep2Uplmtprc": 407.25,
        "prcLmtStep3Uplmtprc": 424.95,
        "prcLmtStep1Lwlmtprc": 325.85,
        "prcLmtStep2Lwlmtprc": 301.05,
        "prcLmtStep3Lwlmtprc": 283.35,
        "opnintLmtQty": null,
        "setlmult": 250000,
        "setlTheoPrc": null,
        "basTheoPrc": null
    }
}

상품/지수 선물 종목 종가 API

선물 당일 종가제공
제공시간 : 15:30

/v3/market/closed/derivative/futures/{marketcode}/{issuecode}/closeprice

GET https://{APIGWAddr}/v3/market/closed/derivative/futures/{marketcode}/{issuecode}/closeprice

종목리스트

Path Parameters

Name

Type

Description

marketcode*

String

ex) kospi200

issuecode*

String

ex) 101S6000

{
    "jsonrpc": "2.0",
    "result": {
        "isuSrtCd": "101S6000",
        "trdPrc": 350,
        "cmpprevddTpCd": "5",
        "opnprc": 351.85,
        "hgprc": 352.35,
        "lwprc": 349.3,
        "accTrdvol": 219918,
        "accTrdval": 19266094350000,
        "cmpprevddPrc": -4.15
    }
}

Response Parameters

Name

Type

Description

isuSrtCd

String(9)

종목단축코드

예) KR7000660001 → 000660

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)

누적거래대금

단위:원

Request Example

curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://testoap.k-mydata.org/v3/market/closed/derivative/futures/kospi200/101S6000/closeprice'

Response Example

{
    "jsonrpc": "2.0",
    "result": {
        "isuSrtCd": "101S6000",
        "trdPrc": 350,
        "cmpprevddTpCd": "5",
        "opnprc": 351.85,
        "hgprc": 352.35,
        "lwprc": 349.3,
        "accTrdvol": 219918,
        "accTrdval": 19266094350000,
        "cmpprevddPrc": -4.15
    }
}

(야간)상품/지수 선물 종목 종가 API

야간선물 당일 종가제공
제공시간 : 15:30

/v3/market/closed/derivative/futures/ night/{marketcode}/{issuecode}/closeprice

GET https://{APIGWAddr}/v3/market/closed/derivative/futures/night/{marketcode}/{issuecode}/closeprice

종목리스트

Path Parameters

Name

Type

Description

marketcode*

String

ex) kospi200

issuecode*

String

ex) 101W9000.N

{
    "result": {
        "cmpprevddPrc": -0.8,
        "hgprc": 413.9,
        "accTrdvol": 7517,
        "accTrdval": 774907975000,
        "isuSrtCd": "101W9000.N",
        "trdPrc": 412.45,
        "opnprc": 412.1,
        "lwprc": 410.95,
        "cmpprevddTpCd": "5"
    },
    "jsonrpc": "2.0"
}

Response Parameters

Name

Type

Description

isuSrtCd

String(9)

종목단축코드

예) KR7000660001 → 000660

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)

누적거래대금

단위:원

Request Example

curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://testoap.k-mydata.org/v3/market/closed/derivative/futures/night/kospi200/101W9000.N/closeprice'

Response Example

{
    "result": {
        "cmpprevddPrc": -0.8,
        "hgprc": 413.9,
        "accTrdvol": 7517,
        "accTrdval": 774907975000,
        "isuSrtCd": "101W9000.N",
        "trdPrc": 412.45,
        "opnprc": 412.1,
        "lwprc": 410.95,
        "cmpprevddTpCd": "5"
    },
    "jsonrpc": "2.0"
}

상품/지수 선물 종목 히스토리 API

상품/지수선물 종목 일별 과거데이터 제공 (연결선물코드 지원-코드표1)
제공시간 : 06:30

/v3/market/closed/derivative/futures/{marketcode}/{issuecode}/history

GET https://{APIGWAddr}/v3/market/closed/derivative/futures/{marketcode}/{issuecode}/history

종목리스트

Path Parameters

Name

Type

Description

marketcode*

String

ex) kospi200

issuecode*

String

ex) 101S6000

Query Parameters

Name

Type

Description

trnsmCycleTpCd*

String

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

inqStrtDd*

String

조회시작일자 YYYYMMDD

inqEndDd*

String

조회종료일자 YYYYMMDD

reqCnt*

String

요청건수 (최대 100건)

{
    "jsonrpc": "2.0",
    "result": {
        "isuSrtCd": "101S6000",
        "hisLists": [
            {
                "trdDd": 20220503,
                "trdPrc": 352.85,
                "cmpprevddTpCd": "5",
                "opnprc": 353.3,
                "hgprc": 356.15,
                "lwprc": 352.5,
                "accTrdvol": 250067,
                "accTrdval": 22149554612500,
                "opnintQty": 275009,
                "cmpprevddPrc": -0.6
            },
            {
                "trdDd": 20220502,
                "trdPrc": 353.45,
                "cmpprevddTpCd": "5",
                "opnprc": 351.2,
                "hgprc": 354.05,
                "lwprc": 351.15,
                "accTrdvol": 218940,
                "accTrdval": 19298914775000,
                "opnintQty": 273444,
                "cmpprevddPrc": -2.15
            }
        ]
    }
}

Response Parameters

Name

Type

Description

isuSrtCd

String(9)

종목단축코드

예) KR7000660001 → 000660

isuKorNm

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)

미결제약정수량

Request Example

curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://testoap.k-mydata.org/v3/market/closed/derivative/futures/kospi200/101S6000/history?trnsmCycleTpCd=D&inqStrtDd=20220501&inqEndDd=20220503&reqCnt=2'

Response Example

{
    "jsonrpc": "2.0",
    "result": {
        "isuSrtCd": "101S6000",
        "hisLists": [
            {
                "trdDd": 20220503,
                "trdPrc": 352.85,
                "cmpprevddTpCd": "5",
                "opnprc": 353.3,
                "hgprc": 356.15,
                "lwprc": 352.5,
                "accTrdvol": 250067,
                "accTrdval": 22149554612500,
                "opnintQty": 275009,
                "cmpprevddPrc": -0.6
            },
            {
                "trdDd": 20220502,
                "trdPrc": 353.45,
                "cmpprevddTpCd": "5",
                "opnprc": 351.2,
                "hgprc": 354.05,
                "lwprc": 351.15,
                "accTrdvol": 218940,
                "accTrdval": 19298914775000,
                "opnintQty": 273444,
                "cmpprevddPrc": -2.15
            }
        ]
    }
}

(야간)상품/지수 선물 종목 히스토리 API

야간상품/지수 선물 종목 일별 과거데이터 제공 (연결선물코드 지원-코드표1)
제공시간 : 06:30

/v3/market/closed/derivative/futures/ night/{marketcode}/{issuecode}/history

GET https://{APIGWAddr}/v3/market/closed/derivative/futures/night/{marketcode}/{issuecode}/history

종목리스트

Path Parameters

Name

Type

Description

marketcode*

String

ex) kospi200

issuecode*

String

ex) 101WC000.N

Query Parameters

Name

Type

Description

trnsmCycleTpCd*

String

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

inqStrtDd*

String

조회시작일자 YYYYMMDD

inqEndDd*

String

조회종료일자 YYYYMMDD

reqCnt*

String

요청건수 (최대 100건)

{
    "jsonrpc": "2.0",
    "result": {
        "isuSrtCd": "101WC000.N",
        "hisLists": [
            {
                "accTrdvol": 3,
                "accTrdval": 312962500,
                "cmpprevddTpCd": "5",
                "cmpprevddPrc": -1.2,
                "opnprc": 417.25,
                "trdPrc": 416.5,
                "lwprc": 416.5,
                "opnintQty": 13978,
                "trdDd": 20250702,
                "hgprc": 418.1
            },
            {
                "accTrdvol": 11,
                "accTrdval": 1144437500,
                "cmpprevddTpCd": "5",
                "cmpprevddPrc": -0.7,
                "opnprc": 416.7,
                "trdPrc": 416.25,
                "lwprc": 415.75,
                "opnintQty": 13962,
                "trdDd": 20250701,
                "hgprc": 417
            }
        ]
    }
}

Response Parameters

Name

Type

Description

isuSrtCd

String(9)

종목단축코드

예) KR7000660001 → 000660

isuKorNm

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)

미결제약정수량

Request Example

curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://testoap.k-mydata.org/v3/market/closed/derivative/futures/night/kospi200/101WC000.N/history?trnsmCycleTpCd=D&inqStrtDd=20250701&inqEndDd=20250702&reqCnt=2'

Response Example

{
    "jsonrpc": "2.0",
    "result": {
        "isuSrtCd": "101WC000.N",
        "hisLists": [
            {
                "accTrdvol": 3,
                "accTrdval": 312962500,
                "cmpprevddTpCd": "5",
                "cmpprevddPrc": -1.2,
                "opnprc": 417.25,
                "trdPrc": 416.5,
                "lwprc": 416.5,
                "opnintQty": 13978,
                "trdDd": 20250702,
                "hgprc": 418.1
            },
            {
                "accTrdvol": 11,
                "accTrdval": 1144437500,
                "cmpprevddTpCd": "5",
                "cmpprevddPrc": -0.7,
                "opnprc": 416.7,
                "trdPrc": 416.25,
                "lwprc": 415.75,
                "opnintQty": 13962,
                "trdDd": 20250701,
                "hgprc": 417
            }
        ]
    }
}

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

제공시간 : AM 06:30

/v3/market/closed/derivative/options/{marketcode}/lists

GET https://{APIGWAddr}/v3/market/closed/derivative/options/{marketcode}/lists

종목리스트

Path Parameters

Name

Type

Description

marketcode*

String

ex) kospi200, mini_kospi200night

{
    "trdDd": "20220603",
    "mktEndTm": "1550",
    "isuLists": [
        {
            "isuSrtCd": "201S6210",
            "isuCd": "KR4201S62101",
            "isuKorNm": "KOSPI 200 콜옵션 2206 210.0",
            "isuKorAbbr": "K200 옵션 2206 C210.0",
            "map_to": "201S6210*006"
        },
        {
            "isuSrtCd": "201S6212",
            "isuCd": "KR4201S62127",
            "isuKorNm": "KOSPI 200 콜옵션 2206 212.5",
            "isuKorAbbr": "K200 옵션 2206 C212.5",
            "map_to": "201S6212*006"
        }
    ]
}

{
    "trdDd": "20250707",
    "mktEndTm": "0600",
    "isuLists": [
        {
            "isuSrtCd": "305WC435.N",
            "isuCd": "KR4305WC4355",
            "isuKorAbbr": "MINI K200 옵션 2512 P435.0",
            "map_to": "305WC435.N*235",
            "isuKorNm": "MINI K200 풋옵션 2512 435.0"
        },
        {
            "isuSrtCd": "305WC440.N",
            "isuCd": "KR4305WC4405",
            "isuKorAbbr": "MINI K200 옵션 2512 P440.0",
            "map_to": "305WC440.N*235",
            "isuKorNm": "MINI K200 풋옵션 2512 440.0"
        },
        {
            "isuSrtCd": "305WC445.N",
            "isuCd": "KR4305WC4454",
            "isuKorAbbr": "MINI K200 옵션 2512 P445.0",
            "map_to": "305WC445.N*235",
            "isuKorNm": "MINI K200 풋옵션 2512 445.0"
        },
        {
            "isuSrtCd": "305WC450.N",
            "isuCd": "KR4305WC4504",
            "isuKorAbbr": "MINI K200 옵션 2512 P450.0",
            "map_to": "305WC450.N*235",
            "isuKorNm": "MINI K200 풋옵션 2512 450.0"
        },
        {
            "isuSrtCd": "305WC455.N",
            "isuCd": "KR4305WC4553",
            "isuKorAbbr": "MINI K200 옵션 2512 P455.0",
            "map_to": "305WC455.N*235",
            "isuKorNm": "MINI K200 풋옵션 2512 455.0"
        },
        {
            "isuSrtCd": "305WC460.N",
            "isuCd": "KR4305WC4603",
            "isuKorAbbr": "MINI K200 옵션 2512 P460.0",
            "map_to": "305WC460.N*235",
            "isuKorNm": "MINI K200 풋옵션 2512 460.0"
        },
        {
            "isuSrtCd": "305WC465.N",
            "isuCd": "KR4305WC4652",
            "isuKorAbbr": "MINI K200 옵션 2512 P465.0",
            "map_to": "305WC465.N*235",
            "isuKorNm": "MINI K200 풋옵션 2512 465.0"
        },
        {
            "isuSrtCd": "305WC470.N",
            "isuCd": "KR4305WC4702",
            "isuKorAbbr": "MINI K200 옵션 2512 P470.0",
            "map_to": "305WC470.N*235",
            "isuKorNm": "MINI K200 풋옵션 2512 470.0"
        },
        {
            "isuSrtCd": "305WC475.N",
            "isuCd": "KR4305WC4751",
            "isuKorAbbr": "MINI K200 옵션 2512 P475.0",
            "map_to": "305WC475.N*235",
            "isuKorNm": "MINI K200 풋옵션 2512 475.0"
        },
        {
            "isuSrtCd": "305WC480.N",
            "isuCd": "KR4305WC4801",
            "isuKorAbbr": "MINI K200 옵션 2512 P480.0",
            "map_to": "305WC480.N*235",
            "isuKorNm": "MINI K200 풋옵션 2512 480.0"
        },
        {
            "isuSrtCd": "305WC485.N",
            "isuCd": "KR4305WC4850",
            "isuKorAbbr": "MINI K200 옵션 2512 P485.0",
            "map_to": "305WC485.N*235",
            "isuKorNm": "MINI K200 풋옵션 2512 485.0"
        },
        {
            "isuSrtCd": "305WC490.N",
            "isuCd": "KR4305WC4900",
            "isuKorAbbr": "MINI K200 옵션 2512 P490.0",
            "map_to": "305WC490.N*235",
            "isuKorNm": "MINI K200 풋옵션 2512 490.0"
        },
        {
            "isuSrtCd": "305WC495.N",
            "isuCd": "KR4305WC4959",
            "isuKorAbbr": "MINI K200 옵션 2512 P495.0",
            "map_to": "305WC495.N*235",
            "isuKorNm": "MINI K200 풋옵션 2512 495.0"
        }
    ]
}

Response Parameters

Name

Type

Description

trdDd

String(8)

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

YYYYMMDD

isuLists

Array(4)

종목리스트

isuCd

String(12)

종목코드

표준코드

isuSrtCd

String(9)

종목단축코드

예) KR4101C90009 → K101C9000

isuKorNm

String(80)

종목한글명

isuKorAbbrv

String(40)

종목한글약명

가나다

Request Example

curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://testoap.k-mydata.org/v3/market/closed/derivative/options/kospi200/lists'

Response Example

{
    "trdDd": "20220603",
    "mktEndTm": "1550",
    "isuLists": [
        {
            "isuSrtCd": "201S6210",
            "isuCd": "KR4201S62101",
            "isuKorNm": "KOSPI 200 콜옵션 2206 210.0",
            "isuKorAbbr": "K200 옵션 2206 C210.0",
            "map_to": "201S6210*006"
        },
        {
            "isuSrtCd": "201S6212",
            "isuCd": "KR4201S62127",
            "isuKorNm": "KOSPI 200 콜옵션 2206 212.5",
            "isuKorAbbr": "K200 옵션 2206 C212.5",
            "map_to": "201S6212*006"
        }
    ]
}

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

선물 종목에 대한 기초 자료 제공
제공시간 : AM 06:30

/v3/market/closed/derivative/options/{marketcode}/{issuecode}/master

GET https://{APIGWAddr}/v3/market/closed/derivative/options/{marketcode}/{issuecode}/master

종목리스트

Path Parameters

Name

Type

Description

marketcode*

String

ex) kospi200

issuecode*

String

ex) 201S6210

{
    "jsonrpc": "2.0",
    "result": {
        "isuSrtCd": "201S6210",
        "midyyHgstprc": 169.25,
        "midyyHgstprcDd": 20220120,
        "midyyLwstprc": 127.5,
        "midyyLwstprcDd": 20220512,
        "inlistHgstprc": 224.1,
        "inlistHgstprcDd": 20210630,
        "inlistLwstprc": 127.5,
        "inlistLwstprcDd": 20220512,
        "prevddClsprc": 144.4,
        "prevddOpnprc": 144.4,
        "prevddHgprc": 144.4,
        "prevddLwprc": 144.4,
        "prevddAccTrdvol": 0,
        "prevddAccTrdval": 0,
        "prevddOpnintQty": 596,
        "setlPrcTheoPrcDivrgRt": 0,
        "impVolt": 2.8,
        "trdDd": 20220603,
        "basPrc": 140.6,
        "isuKorNm": "KOSPI 200 콜옵션 2206 210.0",
        "isuKorAbbrv": "K200 옵션 2206 C210.0",
        "isuCd": "KR4201S62101",
        "listDd": 20200616,
        "remainDys": 7,
        "cdInt": 1.96,
        "lsttrdDd": 20220609,
        "expDd": 202206,
        "exerPrc": 210,
        "ulyId": "KOSPI200",
        "prcLmtStep1Uplmtprc": 168.6,
        "prcLmtStep2Uplmtprc": 193.15,
        "prcLmtStep3Uplmtprc": 210.65,
        "prcLmtStep1Lwlmtprc": 112.55,
        "prcLmtStep2Lwlmtprc": 88.05,
        "prcLmtStep3Lwlmtprc": 70.5,
        "setlmult": 250000,
        "setlTheoPrc": 0,
        "basTheoPrc": 140.59
    }
}

Response Parameters

Name

Type

Description

trdDd

string(8)

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

YYYYMMDD

isuCd

string(12)

종목코드

isuSrtCd

string(9)

종목단축코드

예) KR4101C90009 → K101C9000

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)

만기년월

권리행사 가능한 만기년월

exerPrc

number(18)

행사가격

setlmult

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)

전일미결제약정수량

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

Request Example

curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://testoap.k-mydata.org/v3/market/closed/derivative/options/kospi200/201S6210/master'

Response Example

{
    "jsonrpc": "2.0",
    "result": {
        "isuSrtCd": "201S6210",
        "midyyHgstprc": 169.25,
        "midyyHgstprcDd": 20220120,
        "midyyLwstprc": 127.5,
        "midyyLwstprcDd": 20220512,
        "inlistHgstprc": 224.1,
        "inlistHgstprcDd": 20210630,
        "inlistLwstprc": 127.5,
        "inlistLwstprcDd": 20220512,
        "prevddClsprc": 144.4,
        "prevddOpnprc": 144.4,
        "prevddHgprc": 144.4,
        "prevddLwprc": 144.4,
        "prevddAccTrdvol": 0,
        "prevddAccTrdval": 0,
        "prevddOpnintQty": 596,
        "setlPrcTheoPrcDivrgRt": 0,
        "impVolt": 2.8,
        "trdDd": 20220603,
        "basPrc": 140.6,
        "isuKorNm": "KOSPI 200 콜옵션 2206 210.0",
        "isuKorAbbrv": "K200 옵션 2206 C210.0",
        "isuCd": "KR4201S62101",
        "listDd": 20200616,
        "remainDys": 7,
        "cdInt": 1.96,
        "lsttrdDd": 20220609,
        "expDd": 202206,
        "exerPrc": 210,
        "ulyId": "KOSPI200",
        "prcLmtStep1Uplmtprc": 168.6,
        "prcLmtStep2Uplmtprc": 193.15,
        "prcLmtStep3Uplmtprc": 210.65,
        "prcLmtStep1Lwlmtprc": 112.55,
        "prcLmtStep2Lwlmtprc": 88.05,
        "prcLmtStep3Lwlmtprc": 70.5,
        "setlmult": 250000,
        "setlTheoPrc": 0,
        "basTheoPrc": 140.59
    }
}

(야간)상품/지수 옵션 종목 마스터 API

야간 옵션 종목에 대한 기초 자료 제공
제공시간 : AM 06:30

/v3/market/closed/derivative/options/nignth/{marketcode}/{issuecode}/master

GET https://{APIGWAddr}/v3/market/closed/derivative/options/{marketcode}/{issuecode}/master

종목리스트

Path Parameters

Name

Type

Description

marketcode*

String

ex) mini_kospi200

issuecode*

String

ex) 205W7225.N

{
    "jsonrpc": "2.0",
    "result": {
        "isuSrtCd": "205W7225.N",
        "midyyHgstprc": 0,
        "midyyHgstprcDd": 0,
        "midyyLwstprc": 0,
        "midyyLwstprcDd": 0,
        "inlistHgstprc": 0,
        "inlistHgstprcDd": 0,
        "inlistLwstprc": 0,
        "inlistLwstprcDd": 0,
        "prevddClsprc": 196.05,
        "prevddOpnprc": 196.05,
        "prevddHgprc": 196.05,
        "prevddLwprc": 196.05,
        "prevddAccTrdvol": 0,
        "prevddAccTrdval": 0,
        "prevddOpnintQty": 1,
        "setlPrcTheoPrcDivrgRt": 0,
        "impVolt": 67.3,
        "basPrc": 187.8,
        "isuKorNm": "MINI K200 콜옵션 2507 225.0",
        "isuKorAbbrv": "MINI K200 옵션 2507 C225.0",
        "isuCd": "KR4205W72251",
        "listDd": 20250410,
        "remainDys": 4,
        "cdInt": 2.56,
        "lsttrdDd": 20250710,
        "expDd": 202507,
        "exerPrc": 225,
        "ulyId": "KOSPI200",
        "prcLmtStep1Uplmtprc": 220.8,
        "prcLmtStep2Uplmtprc": 0,
        "prcLmtStep3Uplmtprc": 0,
        "prcLmtStep1Lwlmtprc": 154.8,
        "prcLmtStep2Lwlmtprc": 0,
        "prcLmtStep3Lwlmtprc": 0,
        "setlmult": 50000,
        "setlTheoPrc": 0,
        "basTheoPrc": 187.8,
        "trdDd": 20250707
    }
}

Response Parameters

Name

Type

Description

trdDd

string(8)

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

YYYYMMDD

isuCd

string(12)

종목코드

isuSrtCd

string(9)

종목단축코드

예) KR4101C90009 → K101C9000

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)

만기년월

권리행사 가능한 만기년월

exerPrc

number(18)

행사가격

setlmult

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)

전일미결제약정수량

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

Request Example

curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://testoap.k-mydata.org/v3/market/closed/derivative/options/night/mini_kospi200/205W7225.N/master'

Response Example

{
    "jsonrpc": "2.0",
    "result": {
        "isuSrtCd": "205W7225.N",
        "midyyHgstprc": 0,
        "midyyHgstprcDd": 0,
        "midyyLwstprc": 0,
        "midyyLwstprcDd": 0,
        "inlistHgstprc": 0,
        "inlistHgstprcDd": 0,
        "inlistLwstprc": 0,
        "inlistLwstprcDd": 0,
        "prevddClsprc": 196.05,
        "prevddOpnprc": 196.05,
        "prevddHgprc": 196.05,
        "prevddLwprc": 196.05,
        "prevddAccTrdvol": 0,
        "prevddAccTrdval": 0,
        "prevddOpnintQty": 1,
        "setlPrcTheoPrcDivrgRt": 0,
        "impVolt": 67.3,
        "basPrc": 187.8,
        "isuKorNm": "MINI K200 콜옵션 2507 225.0",
        "isuKorAbbrv": "MINI K200 옵션 2507 C225.0",
        "isuCd": "KR4205W72251",
        "listDd": 20250410,
        "remainDys": 4,
        "cdInt": 2.56,
        "lsttrdDd": 20250710,
        "expDd": 202507,
        "exerPrc": 225,
        "ulyId": "KOSPI200",
        "prcLmtStep1Uplmtprc": 220.8,
        "prcLmtStep2Uplmtprc": 0,
        "prcLmtStep3Uplmtprc": 0,
        "prcLmtStep1Lwlmtprc": 154.8,
        "prcLmtStep2Lwlmtprc": 0,
        "prcLmtStep3Lwlmtprc": 0,
        "setlmult": 50000,
        "setlTheoPrc": 0,
        "basTheoPrc": 187.8,
        "trdDd": 20250707
    }
}

상품/지수 옵션 종목 종가 API

옵션 당일 종가제공
제공시간 : 15:30

/v3/market/closed/derivative/options/{marketcode}/{issuecode}/closeprice

GET https://{APIGWAddr}/v3/market/closed/derivative/options/{marketcode}/{issuecode}/closeprice

종목리스트

Path Parameters

Name

Type

Description

marketcode*

String

ex) kospi200

issuecode*

String

ex) 201S6210

{
    "jsonrpc": "2.0",
    "result": {
        "isuSrtCd": "201S6210",
        "trdPrc": 350,
        "cmpprevddTpCd": "5",
        "opnprc": 351.85,
        "hgprc": 352.35,
        "lwprc": 349.3,
        "accTrdvol": 219918,
        "accTrdval": 19266094350000,
        "cmpprevddPrc": -4.15
    }
}

Response Parameters

Name

Type

Description

isuSrtCd

String(9)

종목단축코드

예) KR7000660001 → 000660

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)

누적거래대금

단위:원

Request Example

curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://testoap.k-mydata.org/v3/market/closed/derivative/options/kospi200/201S6210/closeprice'

Response Example

{
    "jsonrpc": "2.0",
    "result": {
        "isuSrtCd": "201S6210",
        "trdPrc": 350,
        "cmpprevddTpCd": "5",
        "opnprc": 351.85,
        "hgprc": 352.35,
        "lwprc": 349.3,
        "accTrdvol": 219918,
        "accTrdval": 19266094350000,
        "cmpprevddPrc": -4.15
    }
}

(야간)상품/지수 옵션 종목 종가 API

야간옵션 당일 종가제공
제공시간 : 15:30

/v3/market/closed/derivative/options/ night/{marketcode}/{issuecode}/closeprice

GET https://{APIGWAddr}/v3/market/closed/derivative/options/night/{marketcode}/{issuecode}/closeprice

종목리스트

Path Parameters

Name

Type

Description

marketcode*

String

ex) mini_kospi200

issuecode*

String

ex) 205W7225.N

{
    "jsonrpc": "2.0",
    "result": {
        "cmpprevddTpCd": "0",
        "opnprc": 187.8,
        "hgprc": 187.8,
        "lwprc": 187.8,
        "accTrdvol": 0,
        "accTrdval": 0,
        "isuSrtCd": "205W7225.N",
        "cmpprevddPrc": 0,
        "trdPrc": 187.8
    }
}

Response Parameters

Name

Type

Description

isuSrtCd

String(9)

종목단축코드

예) KR7000660001 → 000660

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)

누적거래대금

단위:원

Request Example

curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://testoap.k-mydata.org/v3/market/closed/derivative/options/night/mini_kospi200/205W7225.N/closeprice'

Response Example

{
    "jsonrpc": "2.0",
    "result": {
        "cmpprevddTpCd": "0",
        "opnprc": 187.8,
        "hgprc": 187.8,
        "lwprc": 187.8,
        "accTrdvol": 0,
        "accTrdval": 0,
        "isuSrtCd": "205W7225.N",
        "cmpprevddPrc": 0,
        "trdPrc": 187.8
    }
}

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

상품/지수 옵션 종목 일별 과거데이터 제공
제공시간 : 06:30

/v3/market/closed/derivative/options/{marketcode}/{issuecode}/history

GET https://{APIGWAddr}/v3/market/closed/derivative/options/{marketcode}/{issuecode}/history

종목리스트

Path Parameters

Name

Type

Description

marketcode*

String

ex) kospi200

issuecode*

String

ex) 201S6210

Query Parameters

Name

Type

Description

trnsmCycleTpCd*

String

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

inqStrtDd*

String

조회시작일자 YYYYMMDD

inqEndDd*

String

조회종료일자 YYYYMMDD

reqCnt*

String

요청건수 (최대 100건)

{
    "jsonrpc": "2.0",
    "result": {
        "isuSrtCd": "201S6210",
        "hisLists": [
            {
                "trdDd": 20220503,
                "trdPrc": 144.4,
                "cmpprevddTpCd": "0",
                "opnprc": 144.4,
                "hgprc": 144.4,
                "lwprc": 144.4,
                "accTrdvol": 0,
                "accTrdval": 0,
                "opnintQty": 587,
                "cmpprevddPrc": 0
            },
            {
                "trdDd": 20220502,
                "trdPrc": 145.45,
                "cmpprevddTpCd": "0",
                "opnprc": 145.45,
                "hgprc": 145.45,
                "lwprc": 145.45,
                "accTrdvol": 0,
                "accTrdval": 0,
                "opnintQty": 587,
                "cmpprevddPrc": 0
            }
        ]
    }
}

Response Parameters

Name

Type

Description

isuSrtCd

String(9)

종목단축코드

예) KR7000660001 → 000660

isuKorNm

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)

미결제약정수량

Request Example

curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://testoap.k-mydata.org/v3/market/closed/derivative/options/kospi200/201S6210/history?trnsmCycleTpCd=D&inqStrtDd=20220501&inqEndDd=20220503&reqCnt=2'

Response Example

{
    "jsonrpc": "2.0",
    "result": {
        "isuSrtCd": "201S6210",
        "hisLists": [
            {
                "trdDd": 20220503,
                "trdPrc": 144.4,
                "cmpprevddTpCd": "0",
                "opnprc": 144.4,
                "hgprc": 144.4,
                "lwprc": 144.4,
                "accTrdvol": 0,
                "accTrdval": 0,
                "opnintQty": 587,
                "cmpprevddPrc": 0
            },
            {
                "trdDd": 20220502,
                "trdPrc": 145.45,
                "cmpprevddTpCd": "0",
                "opnprc": 145.45,
                "hgprc": 145.45,
                "lwprc": 145.45,
                "accTrdvol": 0,
                "accTrdval": 0,
                "opnintQty": 587,
                "cmpprevddPrc": 0
            }
        ]
    }
}

(야간)상품/지수 옵션 종목 히스토리 API

야간상품/지수 옵션 종목 일별 과거데이터 제공
제공시간 : 06:30

/v3/market/closed/derivative/options/ night/{marketcode}/{issuecode}/history

GET https://{APIGWAddr}/v3/market/closed/derivative/options/night/{marketcode}/{issuecode}/history

종목리스트

Path Parameters

Name

Type

Description

marketcode*

String

ex) mini_kospi200

issuecode*

String

ex) 205W7225.N

Query Parameters

Name

Type

Description

trnsmCycleTpCd*

String

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

inqStrtDd*

String

조회시작일자 YYYYMMDD

inqEndDd*

String

조회종료일자 YYYYMMDD

reqCnt*

String

요청건수 (최대 100건)

{
    "result": {
        "isuSrtCd": "205W7225.N",
        "hisLists": [
            {
                "accTrdvol": 0,
                "accTrdval": 0,
                "opnprc": 191.4,
                "hgprc": 191.4,
                "lwprc": 191.4,
                "trdDd": 20250702,
                "opnintQty": 1,
                "cmpprevddPrc": 0,
                "trdPrc": 191.4,
                "cmpprevddTpCd": "0"
            },
            {
                "accTrdvol": 0,
                "accTrdval": 0,
                "opnprc": 189.75,
                "hgprc": 189.75,
                "lwprc": 189.75,
                "trdDd": 20250701,
                "opnintQty": 1,
                "cmpprevddPrc": 0,
                "trdPrc": 189.75,
                "cmpprevddTpCd": "0"
            }
        ]
    },
    "jsonrpc": "2.0"
}

Response Parameters

Name

Type

Description

isuSrtCd

String(9)

종목단축코드

예) KR7000660001 → 000660

isuKorNm

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)

미결제약정수량

Request Example

curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://testoap.k-mydata.org/v3/market/closed/derivative/options/night/mini_kospi200/205W7225.N/history?trnsmCycleTpCd=D&inqStrtDd=20250701&inqEndDd=20250702&reqCnt=2'

Response Example

{
    "result": {
        "isuSrtCd": "205W7225.N",
        "hisLists": [
            {
                "accTrdvol": 0,
                "accTrdval": 0,
                "opnprc": 191.4,
                "hgprc": 191.4,
                "lwprc": 191.4,
                "trdDd": 20250702,
                "opnintQty": 1,
                "cmpprevddPrc": 0,
                "trdPrc": 191.4,
                "cmpprevddTpCd": "0"
            },
            {
                "accTrdvol": 0,
                "accTrdval": 0,
                "opnprc": 189.75,
                "hgprc": 189.75,
                "lwprc": 189.75,
                "trdDd": 20250701,
                "opnintQty": 1,
                "cmpprevddPrc": 0,
                "trdPrc": 189.75,
                "cmpprevddTpCd": "0"
            }
        ]
    },
    "jsonrpc": "2.0"
}

Previous파생 Next파생실시간A

Last updated 8 months ago

hashtagSyntax

hashtag상품/지수 선물 종목 리스트 API

hashtag/v3/market/closed/derivative/futures/{marketcode}/lists

hashtagPath Parameters

hashtagResponse Parameters

hashtagRequest Example

hashtagResponse Example

hashtag상품/지수 선물 종목 마스터 API

hashtag/v3/market/closed/derivative/futures/{marketcode}/{issuecode}/master

hashtagPath Parameters

hashtagResponse Parameters

hashtagRequest Example

hashtagResponse Example

hashtag(야간)상품/지수 선물 종목 마스터 API

hashtag/v3/market/closed/derivative/futures/ night/{marketcode}/{issuecode}/master

hashtagPath Parameters

hashtagResponse Parameters

hashtagRequest Example

hashtagResponse Example

hashtag상품/지수 선물 종목 종가 API

hashtag/v3/market/closed/derivative/futures/{marketcode}/{issuecode}/closeprice

hashtagPath Parameters

hashtagResponse Parameters

hashtagRequest Example

hashtagResponse Example

hashtag(야간)상품/지수 선물 종목 종가 API

hashtag/v3/market/closed/derivative/futures/ night/{marketcode}/{issuecode}/closeprice

hashtagPath Parameters

hashtagResponse Parameters

hashtagRequest Example

hashtagResponse Example

hashtag상품/지수 선물 종목 히스토리 API

hashtag/v3/market/closed/derivative/futures/{marketcode}/{issuecode}/history

hashtagPath Parameters

hashtagQuery Parameters

hashtagResponse Parameters

hashtagRequest Example

hashtagResponse Example

hashtag(야간)상품/지수 선물 종목 히스토리 API

hashtag/v3/market/closed/derivative/futures/ night/{marketcode}/{issuecode}/history

hashtagPath Parameters

hashtagQuery Parameters

hashtagResponse Parameters

hashtagRequest Example

hashtagResponse Example

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

hashtag/v3/market/closed/derivative/options/{marketcode}/lists

hashtagPath Parameters

hashtagResponse Parameters

hashtagRequest Example

hashtagResponse Example

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

hashtag/v3/market/closed/derivative/options/{marketcode}/{issuecode}/master

hashtagPath Parameters

hashtagResponse Parameters

hashtagRequest Example

hashtagResponse Example

hashtag(야간)상품/지수 옵션 종목 마스터 API

hashtag/v3/market/closed/derivative/options/nignth/{marketcode}/{issuecode}/master

hashtagPath Parameters

hashtagResponse Parameters

hashtagRequest Example

hashtagResponse Example

hashtag상품/지수 옵션 종목 종가 API

hashtag/v3/market/closed/derivative/options/{marketcode}/{issuecode}/closeprice

hashtagPath Parameters

hashtagResponse Parameters

hashtagRequest Example

hashtagResponse Example

hashtag(야간)상품/지수 옵션 종목 종가 API

hashtag/v3/market/closed/derivative/options/ night/{marketcode}/{issuecode}/closeprice

hashtagPath Parameters

hashtagResponse Parameters

hashtagRequest Example

hashtagResponse Example

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

hashtag/v3/market/closed/derivative/options/{marketcode}/{issuecode}/history

hashtagPath Parameters

hashtagQuery Parameters

hashtagResponse Parameters

Syntax

상품/지수 선물 종목 리스트 API

/v3/market/closed/derivative/futures/{marketcode}/lists

Path Parameters

Response Parameters

Request Example

Response Example

상품/지수 선물 종목 마스터 API

/v3/market/closed/derivative/futures/{marketcode}/{issuecode}/master

Path Parameters

Response Parameters

Request Example

Response Example

(야간)상품/지수 선물 종목 마스터 API

/v3/market/closed/derivative/futures/ night/{marketcode}/{issuecode}/master

Path Parameters

Response Parameters

Request Example

Response Example

상품/지수 선물 종목 종가 API

/v3/market/closed/derivative/futures/{marketcode}/{issuecode}/closeprice

Path Parameters

Response Parameters

Request Example

Response Example

(야간)상품/지수 선물 종목 종가 API

/v3/market/closed/derivative/futures/ night/{marketcode}/{issuecode}/closeprice

Path Parameters

Response Parameters

Request Example

Response Example

상품/지수 선물 종목 히스토리 API

/v3/market/closed/derivative/futures/{marketcode}/{issuecode}/history

Path Parameters

Query Parameters

Response Parameters

Request Example

Response Example

(야간)상품/지수 선물 종목 히스토리 API

/v3/market/closed/derivative/futures/ night/{marketcode}/{issuecode}/history

Path Parameters

Query Parameters

Response Parameters

Request Example

Response Example

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

/v3/market/closed/derivative/options/{marketcode}/lists

Path Parameters

Response Parameters

Request Example

Response Example

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

/v3/market/closed/derivative/options/{marketcode}/{issuecode}/master

Path Parameters

Response Parameters

Request Example

Response Example

(야간)상품/지수 옵션 종목 마스터 API

/v3/market/closed/derivative/options/nignth/{marketcode}/{issuecode}/master

Path Parameters

Response Parameters

Request Example

Response Example

상품/지수 옵션 종목 종가 API

/v3/market/closed/derivative/options/{marketcode}/{issuecode}/closeprice

Path Parameters

Response Parameters

Request Example

Response Example

(야간)상품/지수 옵션 종목 종가 API

/v3/market/closed/derivative/options/ night/{marketcode}/{issuecode}/closeprice

Path Parameters

Response Parameters

Request Example

Response Example

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

/v3/market/closed/derivative/options/{marketcode}/{issuecode}/history

Path Parameters

Query Parameters

Response Parameters