{ "title" : "메리츠증권 Open API 명세", "generatedAt" : "2026-10-26 18:37:47", "groups" : [ { "name" : "OAuth 인증", "apis" : [ { "name" : "접근토큰 발급", "protocol" : "REST", "method" : "POST", "domain" : "", "url" : "/oauth2/token", "format" : "", "contentType" : "application/x-www-form-urlencoded", "description" : "본인을 인증하는 확인 절차로, 접근토큰을 부여받아 오픈 API 활용이 가능합니다.", "trs" : [ { "name" : "접근토큰 발급", "code" : "token", "request" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "OAuth2 호출 Request Body 데이터 포맷으로 \"application/x-www-form-urlencoded\" 설정", "depth" : 0 } ], "body" : [ { "element" : "grant_type", "name" : "권한부여 Type", "type" : "String", "required" : "Y", "length" : "100", "description" : "\"client_credentials\" 고정", "depth" : 0 }, { "element" : "client_id", "name" : "고객 앱 Key", "type" : "String", "required" : "Y", "length" : "36", "description" : "포탈에서 발급된 고객의 앱 Key", "depth" : 0 }, { "element" : "client_secret", "name" : "고객 앱 비밀 Key", "type" : "String", "required" : "Y", "length" : "36", "description" : "포탈에서 발급된 고객의 앱 비밀 Key", "depth" : 0 }, { "element" : "scope", "name" : "scope", "type" : "String", "required" : "Y", "length" : "256", "description" : "\"login\" 고정", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "응답 본문의 데이터 형식(Content-Type)입니다.", "depth" : 0 } ], "body" : [ { "element" : "access_token", "name" : "접근토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "발급된 접근토큰입니다. 이후 API 호출의 authorization 헤더에 \"Bearer {access_token}\" 형식으로 넣습니다.", "depth" : 0 }, { "element" : "expires_in", "name" : "접근토큰 유효기간", "type" : "String", "required" : "Y", "length" : "10", "description" : "유효기간 (초)", "depth" : 0 }, { "element" : "scope", "name" : "scope", "type" : "String", "required" : "Y", "length" : "256", "description" : "\"login\" 고정", "depth" : 0 }, { "element" : "token_type", "name" : "토큰 유형", "type" : "String", "required" : "Y", "length" : "256", "description" : "Bearer", "depth" : 0 } ] }, "requestExample" : "grant_type=client_credentials&client_id=PSVyPMmyb2CphzTEI3mE3f0jEqVn1hOOPsFy&client_secret=oUAIFPHo6ZsuZhEKfFsiIoMDb4yWyFAQ&scope=login", "responseExample" : "{\n\t\"access_token\": \"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJ0b2tlbiIsImF1ZCI6ImExZTBjNDI5LTg1OWMtNDBlYy04NjNhLWE1NjdjNTY3MzgyNyIsIm5iZiI6MTY5NDU2ODI4OSwiaXNzIjoidW5vZ3ciLCJleHAiOjE2OTUxNzMwODksImlhdCI6MTY5NDU2ODI4OSwianRpIjoiUFNWeVBNbXliMkNwaHpURUkzbUUzZjBqRXFWbjFoT09Qc0Z5Iiwic2lkIjoiOTU4MmFjZTktN2E0MS00MDZlLTg0MTktNWIwM2Y0MjZmYTcyIn0.Xy4_coRkkAM1_AtcMwduLeY46914dJm5gsWkLb4pqAnVZzg7B9gY4c6gGPOKvlU1dwuowJBAytZ326r7mtHrMA\",\n\t\"scope\": \"login\",\n\t\"token_type\": \"Bearer\",\n\t\"expires_in\": 604800\n}" } ] }, { "name" : "접근토큰 폐기", "protocol" : "REST", "method" : "POST", "domain" : "", "url" : "/oauth2/revoke", "format" : "", "contentType" : "application/x-www-form-urlencoded", "description" : "발급 받은 접근토큰을 더이상 활용하지 않을 때 사용합니다", "trs" : [ { "name" : "접근토큰 폐기", "code" : "revoke", "request" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "OAuth2 호출 Request Body 데이터 포맷으로 \"application/x-www-form-urlencoded\" 설정", "depth" : 0 } ], "body" : [ { "element" : "client_id", "name" : "고객 앱 Key", "type" : "String", "required" : "Y", "length" : "100", "description" : "포털에서 발급받은 고객의 앱 Key 입니다.", "depth" : 0 }, { "element" : "client_secret", "name" : "고객 앱 비밀 Key", "type" : "String", "required" : "Y", "length" : "36", "description" : "포탈에서 발급된 고객의 앱 비밀 Key", "depth" : 0 }, { "element" : "token_type_hint", "name" : "토큰 유형 hint", "type" : "String", "required" : "Y", "length" : "36", "description" : "폐기할 토큰의 종류입니다. \"access_token\" 을 넣으십시오.", "depth" : 0 }, { "element" : "token", "name" : "접근토큰", "type" : "String", "required" : "Y", "length" : "256", "description" : "폐기할 접근토큰입니다.", "depth" : 0 } ] }, "response" : { "header" : [ ], "body" : [ { "element" : "code", "name" : "응답 코드", "type" : "String", "required" : "Y", "length" : "3", "description" : "응답 코드", "depth" : 0 }, { "element" : "message", "name" : "응답 메세지", "type" : "String", "required" : "Y", "length" : "100", "description" : "응답 메세지", "depth" : 0 } ] }, "requestExample" : "token=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJ0b2tlbiIsImF1ZCI6IjczY2YwMzM0LTFjMTktNGZjMC04N2Y0LTVjNzdhNjljNGU4NCIsIm5iZiI6MTY5MjM0NjA2MCwiaXNzIjoidW5vZ3ciLCJleHAiOjE2OTQ5MzgwNjAsImlhdCI6MTY5MjM0NjA2MCwianRpIjoibXR6MTIzNCJ9.DAR4ZGG3ylXgCB8o64Po0130p6x2EJS3s5jXr-clSz8i9kKhk-DuH92xN4iPuL4cAq8OPI4eN4CjhUquxZILvg&client_id=mtz1234&client_secret=mtz4321&token_type_hint=access_token", "responseExample" : "{\n\t\"code\": 200,\n\t\"message\": \"success\"\n}" } ] } ] }, { "name" : "계좌·잔고·자산", "apis" : [ { "name" : "내 계좌 담보 현황 조회", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/accounts/v1/me/collateral", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "계좌의 담보 현황과 종목별 대출 내역을 조회합니다.", "trs" : [ { "name" : "내 계좌 담보 현황 조회", "code" : "oblon_mntn_020r", "request" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "N", "length" : "100", "description" : "메리츠증권 제공 API를 호출하기 위한 Request Body 데이터 포맷으로 \"application/json; charset=utf-8\" 설정", "depth" : 0 }, { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "base_dt", "name" : "기준일자", "type" : "String", "required" : "N", "length" : "8", "description" : "조회 기준일자(YYYYMMDD)입니다. 선택 항목이며, 넣지 않거나 20200101·20991231 을 넣어도 같은 결과가 내려옵니다. (query string)", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "DATA", "type" : "Object", "required" : "Y", "length" : "-", "description" : "계좌 담보 현황입니다. 계좌 단위 합계 한 건으로 내려옵니다.", "depth" : 0 }, { "element" : "cntg_rflc_tfam", "name" : "체결반영예수금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "당일 체결분까지 반영한 예수금입니다.", "depth" : 0 }, { "element" : "cntg_rflc_ovfe", "name" : "체결반영연체료", "type" : "Number", "required" : "Y", "length" : "19", "description" : "당일 체결분까지 반영한 연체료입니다.", "depth" : 0 }, { "element" : "cntg_rflc_mksc_sbsn_amt", "name" : "체결반영유가증권대용금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "보유 유가증권을 담보로 인정한 대용금액입니다.", "depth" : 0 }, { "element" : "cntg_rflc_rght_sbsn_amt", "name" : "체결반영권리대용금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "당일 체결분까지 반영한 권리 대용 금액입니다.", "depth" : 0 }, { "element" : "cntg_rflc_crdt_loan_vltn_amt", "name" : "체결반영신용대출평가금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "당일 체결분까지 반영한 신용대출 평가금액입니다.", "depth" : 0 }, { "element" : "cntg_rflc_deps_ascr_amt", "name" : "체결반영예탁담보대출금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "당일 체결분까지 반영한 예탁담보대출 금액입니다.", "depth" : 0 }, { "element" : "cntg_rflc_deps_morg_vlam", "name" : "체결반영예탁담보평가금", "type" : "String", "required" : "Y", "length" : "20.6", "description" : "체결반영예탁담보평가금. 소수 6자리 문자열", "depth" : 0 }, { "element" : "cntg_rflc_stln_morg_amt", "name" : "체결반영대주담보금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "당일 체결분까지 반영한 대주 담보금액입니다.", "depth" : 0 }, { "element" : "cntg_rflc_unam_smtn", "name" : "체결반영미수금합계", "type" : "Number", "required" : "Y", "length" : "19", "description" : "당일 체결분까지 반영한 미수금 합계입니다.", "depth" : 0 }, { "element" : "cntg_rflc_loan_amt", "name" : "체결반영대출금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "당일 체결분까지 반영한 대출 금액입니다.", "depth" : 0 }, { "element" : "cntg_rflc_stln_vltn_amt", "name" : "체결반영대주평가금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "당일 체결분까지 반영한 대주 평가금액입니다.", "depth" : 0 }, { "element" : "cntg_rflc_morg_rate", "name" : "체결반영담보비율", "type" : "String", "required" : "Y", "length" : "10.5", "description" : "체결을 반영한 실담보비율입니다. 소수 5자리 문자열입니다.", "depth" : 0 }, { "element" : "cntg_rflc_morg_dfcn_amt", "name" : "체결 반영 담보 부족 금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "당일 체결분까지 반영했을 때 모자라는 담보 금액입니다.", "depth" : 0 }, { "element" : "cntg_rflc_total_morg_amt", "name" : "체결반영총담보금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "총담보금액입니다. 체결반영예수금과 유가증권대용금액의 합계입니다.", "depth" : 0 }, { "element" : "cntg_rflc_total_loan_amt", "name" : "체결반영총대출금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "체결반영 총대출금액입니다.", "depth" : 0 }, { "element" : "stck_seln_stlm_amt", "name" : "주식매도결제금액", "type" : "String", "required" : "Y", "length" : "22.2", "description" : "주식매도결제금액입니다. 소수 2자리 문자열입니다.", "depth" : 0 }, { "element" : "stck_loan_seln_stlm_amt", "name" : "주식대출매도결제금액", "type" : "String", "required" : "Y", "length" : "22.2", "description" : "주식대출매도결제금액. 소수 2자리 문자열", "depth" : 0 }, { "element" : "bond_seln_stlm_amt", "name" : "채권매도결제금액", "type" : "String", "required" : "Y", "length" : "22.2", "description" : "채권매도결제금액. 소수 2자리 문자열", "depth" : 0 }, { "element" : "bond_loan_seln_stlm_amt", "name" : "채권대출매도결제금액", "type" : "String", "required" : "Y", "length" : "22.2", "description" : "채권대출매도결제금액. 소수 2자리 문자열", "depth" : 0 }, { "element" : "els_seln_stlm_amt", "name" : "ELS매도결제금액", "type" : "String", "required" : "Y", "length" : "22.2", "description" : "ELS매도결제금액. 소수 2자리 문자열", "depth" : 0 }, { "element" : "els_loan_seln_stlm_amt", "name" : "ELS대출매도결제금액", "type" : "String", "required" : "Y", "length" : "22.2", "description" : "ELS대출매도결제금액. 소수 2자리 문자열", "depth" : 0 }, { "element" : "iisc_seln_stlm_amt", "name" : "집합투자증권매도결제금액", "type" : "String", "required" : "Y", "length" : "22.2", "description" : "집합투자증권매도결제금액. 소수 2자리 문자열", "depth" : 0 }, { "element" : "iisc_loan_seln_stlm_amt", "name" : "집합투자증권대출매도결제금액", "type" : "String", "required" : "Y", "length" : "22.2", "description" : "집합투자증권대출매도결제금액. 소수 2자리 문자열", "depth" : 0 }, { "element" : "stln_seln_stlm_amt", "name" : "대주매도결제금액", "type" : "String", "required" : "Y", "length" : "22.2", "description" : "대주 매도분의 결제금액입니다. 소수 2자리 문자열입니다.", "depth" : 0 }, { "element" : "stck_byov_stlm_amt", "name" : "주식매수결제금액", "type" : "String", "required" : "Y", "length" : "22.2", "description" : "주식매수결제금액입니다. 소수 2자리 문자열입니다.", "depth" : 0 }, { "element" : "stck_loan_byov_stlm_amt", "name" : "주식대출매수결제금액", "type" : "String", "required" : "Y", "length" : "22.2", "description" : "주식대출매수결제금액. 소수 2자리 문자열", "depth" : 0 }, { "element" : "bond_byov_stlm_amt", "name" : "채권매수결제금액", "type" : "String", "required" : "Y", "length" : "22.2", "description" : "채권매수결제금액. 소수 2자리 문자열", "depth" : 0 }, { "element" : "bond_loan_byov_stlm_amt", "name" : "채권대출매수결제금액", "type" : "String", "required" : "Y", "length" : "22.2", "description" : "채권대출매수결제금액. 소수 2자리 문자열", "depth" : 0 }, { "element" : "els_byov_stlm_amt", "name" : "ELS매수결제금액", "type" : "String", "required" : "Y", "length" : "22.2", "description" : "ELS매수결제금액. 소수 2자리 문자열", "depth" : 0 }, { "element" : "els_loan_byov_stlm_amt", "name" : "ELS대출매수결제금액", "type" : "String", "required" : "Y", "length" : "22.2", "description" : "ELS대출매수결제금액. 소수 2자리 문자열", "depth" : 0 }, { "element" : "iisc_byov_stlm_amt", "name" : "집합투자증권매수결제금액", "type" : "String", "required" : "Y", "length" : "22.2", "description" : "집합투자증권매수결제금액. 소수 2자리 문자열", "depth" : 0 }, { "element" : "stln_byov_stlm_amt", "name" : "대주매수결제금액", "type" : "String", "required" : "Y", "length" : "22.2", "description" : "대주매수결제금액. 소수 2자리 문자열", "depth" : 0 }, { "element" : "seln_stlm_amt_smtn", "name" : "매도결제금액합계", "type" : "Number", "required" : "Y", "length" : "20", "description" : "매도결제금액 합계입니다.", "depth" : 0 }, { "element" : "loan_seln_stlm_amt_smtn", "name" : "대출매도결제금액합계", "type" : "Number", "required" : "Y", "length" : "20", "description" : "대출매도결제금액 합계입니다.", "depth" : 0 }, { "element" : "byov_stlm_amt_smtn", "name" : "매수결제금액합계", "type" : "Number", "required" : "Y", "length" : "20", "description" : "매수결제금액 합계입니다.", "depth" : 0 }, { "element" : "loan_byov_stlm_amt_smtn", "name" : "대출매수결제금액합계", "type" : "Number", "required" : "Y", "length" : "20", "description" : "대출매수결제금액 합계입니다.", "depth" : 0 }, { "element" : "loan_vltn_dfcn_amt", "name" : "대출평가부족금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "대출평가부족금액입니다.", "depth" : 0 }, { "element" : "sub_morg_smtn_amt", "name" : "부담보합계금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "부담보합계금액입니다.", "depth" : 0 }, { "element" : "splm_morg_amt", "name" : "추가담보금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "추가담보금액입니다.", "depth" : 0 }, { "element" : "orgl_morg_amt", "name" : "원담보금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "원담보금액입니다.", "depth" : 0 }, { "element" : "crdt_loan_smtn", "name" : "신용대출합계", "type" : "Number", "required" : "Y", "length" : "19", "description" : "신용대출 합계입니다.", "depth" : 0 }, { "element" : "mntn_morg_amt", "name" : "유지담보금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "유지담보금액입니다.", "depth" : 0 }, { "element" : "mntn_morg_rate", "name" : "유지담보비율", "type" : "String", "required" : "Y", "length" : "9.4", "description" : "담보유지비율입니다.", "depth" : 0 }, { "element" : "morg_dfcn_prd", "name" : "담보부족기간", "type" : "Number", "required" : "Y", "length" : "4", "description" : "담보부족기간입니다.", "depth" : 0 }, { "element" : "loan_vltn_dfcn_tims", "name" : "대출평가부족회차", "type" : "Number", "required" : "Y", "length" : "4", "description" : "대출평가부족회차입니다.", "depth" : 0 }, { "element" : "morg_dfcn_amt", "name" : "담보부족금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "담보부족금액. cntg_rflc_morg_dfcn_amt(체결반영)와 별도 항목", "depth" : 0 }, { "element" : "ib_morg_rate", "name" : "IB담보비율", "type" : "String", "required" : "Y", "length" : "12.5", "description" : "IB담보비율입니다.", "depth" : 0 }, { "element" : "sub_morg_sbsn_amt", "name" : "부담보대용금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "부담보대용금액입니다. 원 단위 정수입니다.", "depth" : 0 }, { "element" : "splm_morg_cash_amt", "name" : "추가담보현금금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "추가담보현금금액입니다.", "depth" : 0 }, { "element" : "splm_morg_sbsn_amt", "name" : "추가담보대용금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "추가담보대용금액입니다.", "depth" : 0 }, { "element" : "splm_morg_vltn_amt", "name" : "추가담보평가금액", "type" : "String", "required" : "Y", "length" : "20.3", "description" : "추가담보평가금액. 소수 3자리 문자열", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "\"0\" 으로 내려오며 계좌 담보 현황 한 건이 내려옵니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 응답 코드입니다.\n\"5766\": 조회 완료 · \"5820\": 조회할 자료 없음\n\"5820\" 이어도 data 가 담겨 내려올 수 있습니다. 응답코드로 자료 유무를 판정하지 말고 data 의 값을 쓰십시오. \"0000\" 만으로 성공을 판정하지 마십시오. API 마다 성공 코드가 다릅니다.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 이 값에 담깁니다.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "응답에 덧붙는 상세 사유입니다. 값이 없으면 응답에서 이 항목 자체가 빠집니다.", "depth" : 0 } ] }, "requestExample" : "GET /accounts/v1/me/collateral?base_dt=20260911\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": {\n \"cntg_rflc_tfam\": 901251269,\n \"cntg_rflc_ovfe\": 0,\n \"cntg_rflc_mksc_sbsn_amt\": 777194971,\n \"cntg_rflc_rght_sbsn_amt\": 0,\n \"cntg_rflc_crdt_loan_vltn_amt\": 0,\n \"cntg_rflc_deps_ascr_amt\": 0,\n \"cntg_rflc_deps_morg_vlam\": \"0.000000\",\n \"cntg_rflc_stln_morg_amt\": 0,\n \"cntg_rflc_unam_smtn\": 0,\n \"cntg_rflc_loan_amt\": 0,\n \"cntg_rflc_stln_vltn_amt\": 0,\n \"cntg_rflc_morg_rate\": \"0.00000\",\n \"cntg_rflc_morg_dfcn_amt\": 0,\n \"cntg_rflc_total_morg_amt\": 1678446240,\n \"cntg_rflc_total_loan_amt\": 0,\n \"stck_seln_stlm_amt\": \"0.00\",\n \"stck_loan_seln_stlm_amt\": \"0.00\",\n \"bond_seln_stlm_amt\": \"0.00\",\n \"bond_loan_seln_stlm_amt\": \"0.00\",\n \"els_seln_stlm_amt\": \"0.00\",\n \"els_loan_seln_stlm_amt\": \"0.00\",\n \"iisc_seln_stlm_amt\": \"0.00\",\n \"iisc_loan_seln_stlm_amt\": \"0.00\",\n \"stln_seln_stlm_amt\": \"0.00\",\n \"stck_byov_stlm_amt\": \"0.00\",\n \"stck_loan_byov_stlm_amt\": \"0.00\",\n \"bond_byov_stlm_amt\": \"0.00\",\n \"bond_loan_byov_stlm_amt\": \"0.00\",\n \"els_byov_stlm_amt\": \"0.00\",\n \"els_loan_byov_stlm_amt\": \"0.00\",\n \"iisc_byov_stlm_amt\": \"0.00\",\n \"stln_byov_stlm_amt\": \"0.00\",\n \"seln_stlm_amt_smtn\": 0,\n \"loan_seln_stlm_amt_smtn\": 0,\n \"byov_stlm_amt_smtn\": 0,\n \"loan_byov_stlm_amt_smtn\": 0,\n \"loan_vltn_dfcn_amt\": 0,\n \"sub_morg_smtn_amt\": 777194971,\n \"splm_morg_amt\": 0,\n \"orgl_morg_amt\": 0,\n \"crdt_loan_smtn\": 0,\n \"mntn_morg_amt\": 0,\n \"mntn_morg_rate\": \"0.0000\",\n \"morg_dfcn_prd\": 0,\n \"loan_vltn_dfcn_tims\": 0,\n \"morg_dfcn_amt\": 0,\n \"ib_morg_rate\": \"0.00000\",\n \"sub_morg_sbsn_amt\": 171805870,\n \"splm_morg_cash_amt\": 0,\n \"splm_morg_sbsn_amt\": 0,\n \"splm_morg_vltn_amt\": \"0.000\"\n },\n \"rsp_cd\": \"5766\",\n \"rsp_msg\": \"조회가 완료되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "내 계좌 예수금 상세 조회", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/accounts/v1/me/deposit", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "접근토큰에 매핑된 계좌의 예수금·출금가능금액·주문가능금액과 대출·미수 현황을 한 번에 조회합니다.", "trs" : [ { "name" : "내 계좌 예수금 상세 조회", "code" : "obacb_balc_024r", "request" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "N", "length" : "100", "description" : "메리츠증권 제공 API를 호출하기 위한 Request Body 데이터 포맷으로 \"application/json; charset=utf-8\" 설정", "depth" : 0 }, { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "DATA", "type" : "Object", "required" : "Y", "length" : "-", "description" : "계좌 예수금 상세 정보입니다.", "depth" : 0 }, { "element" : "tfam", "name" : "예수금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "계좌의 원화 현금 잔액입니다. 원 단위 정수로 내려옵니다.\n\n출금 가능 금액은 출금 가능 금액(drng_able_amt), 현금 주문 가능 금액은 주문 가능 현금 금액(oder_able_cash_amt)으로 따로 내려옵니다.", "depth" : 0 }, { "element" : "d1_aft_tfam", "name" : "1일 후 예수금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "1일 후(D+1) 예수금입니다.", "depth" : 0 }, { "element" : "d2_aft_tfam", "name" : "2일 후 예수금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "2일 후(D+2) 예수금입니다.", "depth" : 0 }, { "element" : "drng_able_amt", "name" : "출금 가능 금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "출금 가능 금액입니다. 원 단위 정수입니다.", "depth" : 0 }, { "element" : "prdy_seln_byov_excl_amt", "name" : "전일매도매수정산금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "전일 매도매수 정산금액입니다.", "depth" : 0 }, { "element" : "tday_seln_byov_excl_amt", "name" : "당일매도매수정산금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "당일 매도매수 정산금액입니다.", "depth" : 0 }, { "element" : "check_amt", "name" : "수표 금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "수표 금액입니다.", "depth" : 0 }, { "element" : "oder_able_cash_amt", "name" : "주문 가능 현금 금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "주문 가능 현금 금액입니다. 현금만을 기준으로 하는 주문 가능 금액입니다. 대용을 포함한 금액은 주문 가능 대용 금액(oder_able_sbsn_amt)으로 따로 내려옵니다.", "depth" : 0 }, { "element" : "oder_able_sbsn_amt", "name" : "주문 가능 대용 금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "주문 가능 대용 금액입니다. 주문 가능 현금 금액(oder_able_cash_amt)과는 별개 항목입니다.", "depth" : 0 }, { "element" : "oder_able_intg_amt", "name" : "주문가능통합금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "통합증거금 기준 주문 가능 금액입니다.", "depth" : 0 }, { "element" : "dmst_othr_crnc_marg", "name" : "국내타통화증거금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "국내 주문에 잡힌 타통화 증거금입니다.", "depth" : 0 }, { "element" : "ovrs_othr_crnc_marg", "name" : "해외타통화증거금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "해외 주문에 잡힌 타통화 증거금입니다.", "depth" : 0 }, { "element" : "crdt_loan_amt", "name" : "신용대출금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "신용대출금액입니다.", "depth" : 0 }, { "element" : "crdt_stln_amt", "name" : "신용 대주 금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "신용 대주 금액입니다.", "depth" : 0 }, { "element" : "deps_ascr_amt", "name" : "예탁 담보대출 금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "예탁 담보대출 금액입니다.", "depth" : 0 }, { "element" : "seln_ascr_amt", "name" : "매도 담보대출 금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "매도 담보대출 금액입니다.", "depth" : 0 }, { "element" : "cash_unam", "name" : "현금 미수금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "현금 미수금입니다.", "depth" : 0 }, { "element" : "cash_unam_ovfe", "name" : "현금 미수금 연체료", "type" : "Number", "required" : "Y", "length" : "19", "description" : "현금 미수금 연체료입니다.", "depth" : 0 }, { "element" : "loan_int_ntpd_amt", "name" : "대출 이자 미납 금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "대출 이자 미납 금액입니다.", "depth" : 0 }, { "element" : "uncl_crdt_int_ovfe", "name" : "미수 신용 이자 연체료", "type" : "Number", "required" : "Y", "length" : "19", "description" : "미수 신용 이자 연체료입니다.", "depth" : 0 }, { "element" : "etc_lndn_amt", "name" : "기타 대여 금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "기타 대여 금액입니다.", "depth" : 0 }, { "element" : "etc_lndn_amt_ovfe", "name" : "기타 대여 금액 연체료", "type" : "Number", "required" : "Y", "length" : "19", "description" : "기타 대여 금액 연체료입니다.", "depth" : 0 }, { "element" : "etc_unam", "name" : "기타 미수금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "기타 미수금입니다.", "depth" : 0 }, { "element" : "etc_uncl_amt_ovfe", "name" : "기타 미수 금액 연체료", "type" : "Number", "required" : "Y", "length" : "19", "description" : "기타 미수 금액 연체료입니다.", "depth" : 0 }, { "element" : "uncl_scrt_rsrv_amt", "name" : "미수 증권 확보 금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "미수 증권 확보 금액입니다.", "depth" : 0 }, { "element" : "fee_unam", "name" : "수수료미수금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "수수료미수금입니다.", "depth" : 0 }, { "element" : "nnrd_loan_amt", "name" : "미상환대출금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "미상환대출금액입니다.", "depth" : 0 }, { "element" : "cntg_rflc_morg_dfcn_amt", "name" : "체결 반영 담보 부족 금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "당일 체결 반영 기준으로 부족한 담보 금액입니다.", "depth" : 0 }, { "element" : "cntg_rflc_morg_rate", "name" : "체결반영담보비율", "type" : "String", "required" : "Y", "length" : "10.5", "description" : "체결 반영 담보비율. 소수 5자리 문자열", "depth" : 0 }, { "element" : "smam_loan_amt", "name" : "소액대출금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "소액대출금액입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 성공 응답 코드입니다.\n\"5766\": 조회 완료", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 이 값에 담깁니다.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "응답에 덧붙는 상세 사유입니다. 값이 없으면 응답에서 이 항목 자체가 빠집니다.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "항상 \"0\"으로 내려옵니다. 이 API는 연속조회를 지원하지 않습니다.", "depth" : 0 } ] }, "requestExample" : "GET /accounts/v1/me/deposit\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": {\n \"tfam\": 885313480,\n \"d1_aft_tfam\": 885313480,\n \"d2_aft_tfam\": 885313480,\n \"drng_able_amt\": 885313480,\n \"prdy_seln_byov_excl_amt\": 0,\n \"tday_seln_byov_excl_amt\": 0,\n \"check_amt\": 0,\n \"oder_able_cash_amt\": 885313480,\n \"oder_able_sbsn_amt\": 171805870,\n \"oder_able_intg_amt\": 0,\n \"dmst_othr_crnc_marg\": 0,\n \"ovrs_othr_crnc_marg\": 0,\n \"crdt_loan_amt\": 0,\n \"crdt_stln_amt\": 0,\n \"deps_ascr_amt\": 0,\n \"seln_ascr_amt\": 0,\n \"cash_unam\": 0,\n \"cash_unam_ovfe\": 0,\n \"loan_int_ntpd_amt\": 0,\n \"uncl_crdt_int_ovfe\": 0,\n \"etc_lndn_amt\": 0,\n \"etc_lndn_amt_ovfe\": 0,\n \"etc_unam\": 0,\n \"etc_uncl_amt_ovfe\": 0,\n \"uncl_scrt_rsrv_amt\": 0,\n \"fee_unam\": 0,\n \"nnrd_loan_amt\": 0,\n \"cntg_rflc_morg_dfcn_amt\": 0,\n \"cntg_rflc_morg_rate\": \"0.00000\",\n \"smam_loan_amt\": 0\n },\n \"rsp_cd\": \"5766\",\n \"rsp_msg\": \"조회가 완료되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "내 계좌 입출금 내역 조회", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/accounts/v1/me/transactions", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "계좌의 입출금·거래 내역을 기간으로 조회합니다.", "trs" : [ { "name" : "내 계좌 거래내역 조회", "code" : "obrtp_tran_001r", "request" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "N", "length" : "100", "description" : "메리츠증권 제공 API를 호출하기 위한 Request Body 데이터 포맷으로 \"application/json; charset=utf-8\" 설정", "depth" : 0 }, { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "from", "name" : "조회 시작일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "조회 시작일자(YYYYMMDD 여덟 자리)입니다. 필수 항목입니다. 기간 앞을 열어 두려면 \"00000000\" 을 넣으십시오. 계좌의 처음부터 조회됩니다. (query string)", "depth" : 0 }, { "element" : "to", "name" : "조회 종료일자", "type" : "String", "required" : "N", "length" : "8", "description" : "조회 종료일자(YYYYMMDD 여덟 자리)입니다. 선택 항목입니다. (query string)", "depth" : 0 }, { "element" : "sort", "name" : "정렬 구분", "type" : "String", "required" : "N", "length" : "3", "description" : "정렬 순서입니다.\n\"DES\": 최신순\n\"ASC\": 과거순\n\n대문자로 입력하십시오. 소문자를 넣으시면 오류 없이 과거순으로 조회됩니다. 미지정 시에도 과거순입니다. (query string)", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "N", "length" : "1", "description" : "다음 페이지를 요청할 때 \"1\"을 넣습니다. 첫 조회에는 넣지 않습니다.\n\n연속조회 키(tr_cont_key)와 함께 보내십시오. (query string)", "depth" : 0 }, { "element" : "tr_cont_key", "name" : "연속조회 키", "type" : "String", "required" : "N", "length" : "20", "description" : "직전 응답의 tr_cont_key 를 그대로 넣습니다. 첫 조회에는 넣지 않으며 tr_cont 에 \"1\" 을 함께 보냅니다. 값 오른쪽에 공백이 붙어 내려오므로 잘라내지 말고 받은 그대로 URL 인코딩하여 보내십시오.", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "거래내역 목록", "type" : "Object Array", "required" : "Y", "length" : "-", "description" : "거래 내역 배열입니다.\n\n한 페이지에 10건이 내려오며, 다음 페이지가 있으면 응답코드 5762, tr_cont \"1\" 로 내려옵니다. 다음 페이지는 tr_cont_key 로 이어서 받으십시오.", "depth" : 0 }, { "element" : "issu_type_code", "name" : "종목유형코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "종목 유형 코드입니다.", "depth" : 0 }, { "element" : "tran_srno", "name" : "거래내역일련번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "거래내역 일련번호입니다.", "depth" : 0 }, { "element" : "smcd", "name" : "적요코드", "type" : "String", "required" : "Y", "length" : "6", "description" : "적요코드 6자리입니다.", "depth" : 0 }, { "element" : "smcd_name", "name" : "적요코드명", "type" : "String", "required" : "Y", "length" : "100", "description" : "거래 내용을 나타내는 적요명입니다.", "depth" : 0 }, { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "종목 코드입니다. 국내 주식은 \"A\" + 여섯 자리(예: \"A005930\"), 해외 주식은 심볼 + 거래소 접미어(예: \"AAPL.OQ\")입니다. 종목과 무관한 거래는 빈 값입니다.", "depth" : 0 }, { "element" : "kor_isnm", "name" : "한글종목명", "type" : "String", "required" : "Y", "length" : "100", "description" : "종목명입니다. 종목과 무관한 거래는 빈 값입니다.", "depth" : 0 }, { "element" : "deal_fee", "name" : "매매수수료", "type" : "Number", "required" : "Y", "length" : "19", "description" : "매매 수수료입니다.", "depth" : 0 }, { "element" : "fee", "name" : "수수료", "type" : "Number", "required" : "Y", "length" : "19", "description" : "매매 수수료 외의 기타 수수료입니다.", "depth" : 0 }, { "element" : "tfam_nwrm", "name" : "예수금 잔액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "거래 직후의 원화 예수금 잔액입니다.\n\n해외주식 매수 행은 이 값이 0 으로 내려오고, 외화 예수금 잔액은 같은 행의 frcr_tfam_nwrm 에 있습니다.", "depth" : 0 }, { "element" : "cncl_yn", "name" : "취소여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "취소 여부입니다. \"Y\" 또는 \"N\" 이 내려옵니다.", "depth" : 0 }, { "element" : "bank_code", "name" : "은행코드", "type" : "String", "required" : "Y", "length" : "3", "description" : "은행 코드입니다. 빈 문자열로 내려오는 경우가 있습니다.", "depth" : 0 }, { "element" : "byng_unpr", "name" : "매입단가", "type" : "String", "required" : "Y", "length" : "18", "description" : "그 거래의 체결 단가이며 문자열입니다. 매수·매도는 거래유형코드(tr_type_code)나 적요코드명(smcd_name)으로 구분하십시오.\n통화가 행마다 다릅니다. 국내 거래는 원화, 해외주식 거래는 그 종목의 거래 통화 단가이므로 한 열에 더하지 마십시오.", "depth" : 0 }, { "element" : "intx", "name" : "소득세", "type" : "Number", "required" : "Y", "length" : "19", "description" : "소득세입니다.", "depth" : 0 }, { "element" : "rstx", "name" : "주민세", "type" : "Number", "required" : "Y", "length" : "19", "description" : "주민세입니다.", "depth" : 0 }, { "element" : "srtx", "name" : "농특세", "type" : "Number", "required" : "Y", "length" : "19", "description" : "농어촌특별세입니다.", "depth" : 0 }, { "element" : "trtx", "name" : "거래세", "type" : "Number", "required" : "Y", "length" : "19", "description" : "증권거래세입니다.", "depth" : 0 }, { "element" : "frcr_tr_amt", "name" : "외화 거래금액", "type" : "String", "required" : "Y", "length" : "20", "description" : "외화 거래금액. 국내 거래는 0.000", "depth" : 0 }, { "element" : "frcr_tfam_nwrm", "name" : "외화 예수금 잔액", "type" : "String", "required" : "Y", "length" : "20", "description" : "거래 직후의 외화 예수금 잔액입니다. 소수 3자리 문자열입니다.", "depth" : 0 }, { "element" : "ovsc_deal_fee", "name" : "해외증권 매매수수료", "type" : "String", "required" : "Y", "length" : "20", "description" : "해외증권 매매수수료입니다.", "depth" : 0 }, { "element" : "io_cls_code", "name" : "입출구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "입출 구분 코드입니다.", "depth" : 0 }, { "element" : "rcpy_srno", "name" : "출납일련번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "출납 일련번호입니다.", "depth" : 0 }, { "element" : "tr_type_code", "name" : "거래유형코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "거래 유형 코드입니다.", "depth" : 0 }, { "element" : "cnft_acnm", "name" : "상대계좌명", "type" : "String", "required" : "Y", "length" : "40", "description" : "상대 계좌명입니다.", "depth" : 0 }, { "element" : "if_fee_excl_amt", "name" : "수수료 정산금액", "type" : "String", "required" : "Y", "length" : "13", "description" : "정산 금액입니다. 문자열로 내려옵니다.\n거래 수량이 아닙니다. 수량은 같은 행의 거래수량(if_tr_qty)을 쓰십시오.", "depth" : 0 }, { "element" : "prnc_bal", "name" : "원금잔액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "대출 원금 잔액입니다.", "depth" : 0 }, { "element" : "frcr_int_amt", "name" : "외화 이자금액", "type" : "String", "required" : "Y", "length" : "20", "description" : "외화 이자금액입니다.", "depth" : 0 }, { "element" : "if_tr_qty", "name" : "거래수량", "type" : "String", "required" : "Y", "length" : "23", "description" : "그 거래의 체결 수량입니다. 문자열로 내려옵니다.\n이 값은 금액이 아닙니다. 정산 금액이 필요하시면 같은 행의 수수료 정산금액(if_fee_excl_amt)을 쓰십시오.", "depth" : 0 }, { "element" : "tr_date", "name" : "거래일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "거래가 발생한 일자 입니다.", "depth" : 0 }, { "element" : "tr_amt", "name" : "거래금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "거래의 거래금액입니다. (콤마없음)", "depth" : 0 }, { "element" : "tr_qty", "name" : "거래수량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "거래의 체결 수량입니다. 수량이 없는 거래는 0으로 내려 옵니다. (콤마없음)", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "다음 페이지가 남아 있으면 \"1\", 마지막이면 \"0\"입니다.", "depth" : 0 }, { "element" : "tr_cont_key", "name" : "연속조회 키", "type" : "String", "required" : "N", "length" : "20", "description" : "tr_cont 가 \"1\"일 때만 응답에 담깁니다. 마지막 페이지(tr_cont 가 \"0\")와 오류 응답에는 이 항목 자체가 없습니다. 항목이 늘 있다고 보고 값을 꺼내면 마지막 페이지에서 오류가 납니다.\n\n다음 페이지를 요청하실 때는 직전 응답의 값을 그대로 넣으십시오. 값 오른쪽에 공백이 붙어 내려오는 경우가 있으니 잘라내지 마십시오.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 응답 코드입니다.\n\"5762\": 조회 결과가 더 있음 (연속조회)\n\"5766\": 조회 완료\n\"5820\": 조회할 자료 없음\n\"5822\": 조회할 자료 없음\n\n\"5820\"·\"5822\" 는 조회 조건에 해당하는 자료가 없을 때 내려옵니다.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 이 값에 담깁니다.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "응답에 덧붙는 상세 사유입니다. 값이 없으면 응답에서 이 항목 자체가 빠집니다.", "depth" : 0 } ] }, "requestExample" : "GET /accounts/v1/me/transactions?from=20260801&to=20260911\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": [\n {\n \"issu_type_code\": \"02\",\n \"tran_srno\": 55,\n \"smcd\": \"055050\",\n \"smcd_name\": \"주식매수\",\n \"iscd\": \"A005930\",\n \"kor_isnm\": \"삼성전자\",\n \"deal_fee\": 0,\n \"fee\": 0,\n \"tfam_nwrm\": 962702367,\n \"cncl_yn\": \"N\",\n \"bank_code\": \"\",\n \"byng_unpr\": \"207,500\",\n \"intx\": 0,\n \"rstx\": 0,\n \"srtx\": 0,\n \"trtx\": 0,\n \"frcr_tr_amt\": \"0.000\",\n \"frcr_tfam_nwrm\": \"0.000\",\n \"ovsc_deal_fee\": \"0.000\",\n \"io_cls_code\": \"2\",\n \"rcpy_srno\": 0,\n \"tr_type_code\": \"05\",\n \"cnft_acnm\": \"\",\n \"if_fee_excl_amt\": \"0\",\n \"prnc_bal\": 0,\n \"frcr_int_amt\": \"0.000\",\n \"if_tr_qty\": \"410\"\n },\n {\n \"issu_type_code\": \"02\",\n \"tran_srno\": 56,\n \"smcd\": \"055050\",\n \"smcd_name\": \"주식매수\",\n \"iscd\": \"A005930\",\n \"kor_isnm\": \"삼성전자\",\n \"deal_fee\": 10161,\n \"fee\": 0,\n \"tfam_nwrm\": 960652206,\n \"cncl_yn\": \"N\",\n \"bank_code\": \"\",\n \"byng_unpr\": \"204,000\",\n \"intx\": 0,\n \"rstx\": 0,\n \"srtx\": 0,\n \"trtx\": 0,\n \"frcr_tr_amt\": \"0.000\",\n \"frcr_tfam_nwrm\": \"0.000\",\n \"ovsc_deal_fee\": \"0.000\",\n \"io_cls_code\": \"2\",\n \"rcpy_srno\": 0,\n \"tr_type_code\": \"05\",\n \"cnft_acnm\": \"\",\n \"if_fee_excl_amt\": \"0\",\n \"prnc_bal\": 0,\n \"frcr_int_amt\": \"0.000\",\n \"if_tr_qty\": \"10\"\n }\n ],\n \"rsp_cd\": \"5762\",\n \"rsp_msg\": \"조회가 계속 됩니다. 다음 또는 PgDn을 누르십시오.\",\n \"tr_cont\": \"1\",\n \"tr_cont_key\": \"2026082000000000065\"\n}" } ] }, { "name" : "내 계좌 자산평가 조회", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/accounts/v1/me/valuation", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "접근토큰에 매핑된 계좌의 자산을 한 줄로 요약해 조회합니다.", "trs" : [ { "name" : "내 계좌 자산평가 조회", "code" : "obacb_balc_105r", "request" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "N", "length" : "100", "description" : "메리츠증권 제공 API를 호출하기 위한 Request Body 데이터 포맷으로 \"application/json; charset=utf-8\" 설정", "depth" : 0 }, { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "DATA", "type" : "Object", "required" : "Y", "length" : "-", "description" : "계좌 자산평가 정보입니다.", "depth" : 0 }, { "element" : "tfam", "name" : "예수금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "계좌의 원화 현금 잔액입니다. 원 단위 정수로 내려옵니다.", "depth" : 0 }, { "element" : "d2_aft_tfam", "name" : "2일 후 예수금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "2일 후(D+2) 예수금입니다.", "depth" : 0 }, { "element" : "mksc_vltn_amt", "name" : "유가증권 평가금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "보유한 유가증권을 현재가로 평가한 금액입니다. 예수금은 포함하지 않습니다.\n종목별 내역은 내 계좌 보유종목 평가 조회(/accounts/v1/me/holdings)를 쓰십시오.", "depth" : 0 }, { "element" : "loan_amt", "name" : "대출금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "대출금액입니다.", "depth" : 0 }, { "element" : "vltn_amt", "name" : "평가금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "평가금액입니다.", "depth" : 0 }, { "element" : "wtmn_able_cash_amt", "name" : "인출가능 현금금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "인출가능 현금금액입니다.", "depth" : 0 }, { "element" : "wtmn_able_atmt_invt_amt", "name" : "인출가능 자동투자금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "인출가능 자동투자금액입니다.", "depth" : 0 }, { "element" : "byng_amt", "name" : "매입금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "보유 유가증권의 매입금액 합계입니다. 원 단위 정수입니다.", "depth" : 0 }, { "element" : "aset_vltn_amt", "name" : "자산평가금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "총자산 평가금액입니다.", "depth" : 0 }, { "element" : "frcr_tfam", "name" : "외화예수금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "외화 예수금을 원화로 환산한 금액입니다. aset_vltn_amt 에 이 값이 포함됩니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 응답 코드입니다.\n\"5766\": 조회 완료\n오류 응답 본문에는 data 와 tr_cont 가 없으므로 rsp_cd 를 먼저 확인한 뒤 data 를 읽으십시오.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 이 값에 담깁니다.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "응답에 덧붙는 상세 사유입니다. 값이 없으면 응답에서 이 항목 자체가 빠집니다.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "항상 \"0\"으로 내려옵니다. 이 API는 연속조회를 지원하지 않습니다.", "depth" : 0 } ] }, "requestExample" : "GET /accounts/v1/me/valuation\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": {\n \"tfam\": 885313480,\n \"d2_aft_tfam\": 885313480,\n \"mksc_vltn_amt\": 1001438781,\n \"loan_amt\": 0,\n \"vltn_amt\": 1904460915,\n \"wtmn_able_cash_amt\": 885313480,\n \"wtmn_able_atmt_invt_amt\": 0,\n \"byng_amt\": 211968435,\n \"aset_vltn_amt\": 1904460915,\n \"frcr_tfam\": 17708654\n },\n \"rsp_cd\": \"5766\",\n \"rsp_msg\": \"조회가 완료되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "내 계좌 종목별 평가 조회", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/accounts/v1/me/holdings", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "내 계좌 종목별 평가 조회", "trs" : [ { "name" : "내 계좌 보유종목 평가 조회", "code" : "obacb_balc_114r", "request" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "N", "length" : "100", "description" : "메리츠증권 제공 API를 호출하기 위한 Request Body 데이터 포맷으로 \"application/json; charset=utf-8\" 설정", "depth" : 0 }, { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "nthn_rmnd_incu_yn", "name" : "무잔고포함여부", "type" : "String", "required" : "N", "length" : "1", "description" : "무잔고포함여부입니다. \"Y\" 또는 \"N\" 을 넣습니다. (query string)", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "N", "length" : "1", "description" : "다음 페이지를 요청할 때 정확히 \"1\" 을 넣습니다. 첫 조회에는 넣지 않습니다. 연속조회 키(tr_cont_key)와 반드시 함께 보내십시오. (query string)", "depth" : 0 }, { "element" : "tr_cont_key", "name" : "연속조회 키", "type" : "String", "required" : "N", "length" : "200", "description" : "직전 응답의 tr_cont_key 를 한 글자도 바꾸지 말고 그대로 URL 인코딩하여 넣습니다. 첫 조회에는 넣지 않습니다. tr_cont 에 \"1\" 을 함께 보내십시오. 키를 바꾸면 오류 없이 첫 페이지가 다시 내려옵니다. (query string)", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "보유종목 목록", "type" : "Object Array", "required" : "Y", "length" : "-", "description" : "보유 내역 배열입니다.", "depth" : 0 }, { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "100", "description" : "보유 종목의 종목 코드입니다.\n국내주식 행: \"A\" + 단축코드 6자리 (예: \"A005930\")\n해외주식 행: 심볼 + \".\" + 거래소 코드 (예: \"AAPL.OQ\")\n어느 쪽인지는 유가증권구분명(mksc_cls_name)으로 판단하십시오. 해외 행의 순수 심볼은 해외주식 잔고 조회의 ovrs_stck_symb_iscd 를 쓰십시오.", "depth" : 0 }, { "element" : "isnm", "name" : "종목명", "type" : "String", "required" : "Y", "length" : "100", "description" : "종목명입니다. (예: \"동화약품\")", "depth" : 0 }, { "element" : "rmnd_srno", "name" : "잔고일련번호", "type" : "String", "required" : "Y", "length" : "100", "description" : "잔고일련번호. 현재 빈 값", "depth" : 0 }, { "element" : "pros_trgt_cls_code", "name" : "처리대상구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "보유 종목이 어느 자산에 속하는지 구분합니다. \"1\": 국내주식 \"J\": 해외주식 국내주식과 해외주식이 한 목록에 섞여 내려오며, 국내분만 쓰시려면 이 값으로 거르십시오. 해외 종목은 iscd 가 \"MU.OQ\" 처럼 심볼에 거래소 접미사가 붙은 형태입니다.", "depth" : 0 }, { "element" : "mksc_cls_name", "name" : "유가증권구분명", "type" : "String", "required" : "Y", "length" : "40", "description" : "잔고 유형입니다. \"주식일반\" · \"신용\" · \"해외주식\" · \"해외주식(소수점)\" 이 내려옵니다.\n해외주식 행도 이 목록에 함께 내려옵니다. \"해외주식\" 행의 단가(byng_unpr·psnt_prc)는 그 종목의 거래 통화이고, 금액 항목은 원화 환산입니다.", "depth" : 0 }, { "element" : "mksc_cls_code", "name" : "유가증권구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "유가증권 구분 코드 자리이며 빈 값으로 내려오므로 이 항목으로 분기하지 마십시오. 잔고 유형은 유가증권구분명(mksc_cls_name)으로 판단하십시오.", "depth" : 0 }, { "element" : "rmnd_qty", "name" : "잔고수량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "현재 보유한 정수 수량입니다. 소수점 해외주식 행은 0 이 내려오며, 이때 실제 수량은 hldn_issu_rmnd_qty 에 담깁니다.", "depth" : 0 }, { "element" : "byng_unpr", "name" : "매입단가", "type" : "String", "required" : "Y", "length" : "100", "description" : "매입 평균 단가입니다. 잔고 유형(mksc_cls_name)이 \"주식일반\"·\"신용\" 인 행은 원화, \"해외주식\" 인 행은 그 종목의 거래 통화입니다. \"해외주식(소수점)\" 행의 통화는 이 항목으로 단정하지 마십시오.", "depth" : 0 }, { "element" : "psnt_prc", "name" : "현재가격", "type" : "String", "required" : "Y", "length" : "19", "description" : "현재 평가에 쓰인 시세입니다. 잔고 유형(mksc_cls_name)이 \"주식일반\"·\"신용\" 인 행은 원화, \"해외주식\" 인 행은 그 종목의 거래 통화입니다. \"해외주식(소수점)\" 행의 통화는 이 항목으로 단정하지 마십시오.", "depth" : 0 }, { "element" : "prdy_last_prc", "name" : "전일최종가격", "type" : "String", "required" : "Y", "length" : "19", "description" : "전일 최종가. 소수 8자리 문자열", "depth" : 0 }, { "element" : "prdy_clpr_vrss", "name" : "전일종가대비", "type" : "String", "required" : "Y", "length" : "100", "description" : "전일 종가 대비. 부호 포함 문자열", "depth" : 0 }, { "element" : "vltn_amt", "name" : "평가금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "평가금액입니다. 국내주식 행은 같은 응답의 현재가격(psnt_prc)에 잔고수량을 곱한 값입니다.", "depth" : 0 }, { "element" : "vltn_prls_amt", "name" : "평가손익금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "평가손익 금액입니다. 평가금액(vltn_amt)에서 매입금액(byng_amt)을 뺀 값이며, 손실이면 음수로 내려옵니다.", "depth" : 0 }, { "element" : "ert", "name" : "수익률", "type" : "String", "required" : "Y", "length" : "100", "description" : "수익률(%)입니다. 소수 5자리 문자열입니다.", "depth" : 0 }, { "element" : "byov_date", "name" : "매수일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "매수일자. 현재 빈 값", "depth" : 0 }, { "element" : "loan_amt", "name" : "대출금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "그 행의 보유분에 걸려 있는 대출 금액입니다.", "depth" : 0 }, { "element" : "loan_date", "name" : "대출일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "대출일자 YYYYMMDD. 신용 잔고만 채워진다", "depth" : 0 }, { "element" : "loan_mtrt_date", "name" : "대출만기일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "대출만기일자 YYYYMMDD. 신용 잔고만 채워진다", "depth" : 0 }, { "element" : "byng_amt", "name" : "매입금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "보유분의 매입금액 합계입니다.", "depth" : 0 }, { "element" : "pstn_cls_code", "name" : "포지션구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "포지션 구분입니다. 주식은 빈 값입니다.", "depth" : 0 }, { "element" : "ftop_type_code", "name" : "장내파생유형코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "장내파생 유형입니다. 주식 잔고에서는 빈 값입니다.", "depth" : 0 }, { "element" : "tr_mltl", "name" : "거래승수", "type" : "String", "required" : "Y", "length" : "100", "description" : "거래승수입니다.", "depth" : 0 }, { "element" : "loan_dtl_type_code", "name" : "대출상세유형코드", "type" : "String", "required" : "Y", "length" : "4", "description" : "대출 상세 유형입니다. 신용 잔고에만 채워집니다.\n\"0101\": 자기융자\n\"0102\": 유통융자\n\"0201\": 예탁주식(대출)", "depth" : 0 }, { "element" : "txat_vltn_amt", "name" : "세후평가금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "세후 평가금액입니다. 주식은 0 입니다.", "depth" : 0 }, { "element" : "rltm_prdy_vrss_sign", "name" : "실시간전일대비부호", "type" : "String", "required" : "Y", "length" : "100", "description" : "전일 종가 대비 방향 코드입니다. 값에 대응하는 이름은 응답에 함께 오지 않습니다.", "depth" : 0 }, { "element" : "pris_cpld_cfcn", "name" : "물가연동계수", "type" : "String", "required" : "Y", "length" : "100", "description" : "물가연동계수입니다.", "depth" : 0 }, { "element" : "byov_ert", "name" : "매수수익률", "type" : "String", "required" : "Y", "length" : "100", "description" : "매수수익률. 현재 0", "depth" : 0 }, { "element" : "tax_paym_cls_code", "name" : "세금납입구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "세금 납입 구분입니다. 주식은 빈 값입니다.", "depth" : 0 }, { "element" : "if_tr_amt", "name" : "IF거래금액", "type" : "String", "required" : "Y", "length" : "19", "description" : "이름과 달리 금액이 아니라 수량 계열 값입니다. 일반·신용·해외주식 행은 잔고수량(rmnd_qty)과 같은 값이, 소수점 해외주식 행은 소수 문자열이 내려옵니다. 계산에는 쓰지 마십시오. 수량은 rmnd_qty·hldn_issu_rmnd_qty 를, 금액은 매입금액(byng_amt)·평가금액(vltn_amt)을 쓰십시오.", "depth" : 0 }, { "element" : "hldn_issu_rmnd_qty", "name" : "보유종목잔고수량", "type" : "String", "required" : "Y", "length" : "19", "description" : "문자열로 내려옵니다. 소수점 해외주식 행은 잔고수량(rmnd_qty)이 0 이고 실제 보유 수량이 이 항목에 담깁니다. 그 밖의 행의 수량은 rmnd_qty 를 쓰십시오.", "depth" : 0 }, { "element" : "mtrt_date", "name" : "만기일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "만기일자입니다. 주식은 빈 값입니다.", "depth" : 0 }, { "element" : "rmnd_dqty", "name" : "잔고소수점수량", "type" : "String", "required" : "Y", "length" : "19", "description" : "소수 10자리 문자열입니다. (예: \"0.0000000000\") 소수점 해외주식 행의 실제 보유 수량은 hldn_issu_rmnd_qty 를 쓰십시오.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 응답 코드입니다.\n\"5766\": 조회 완료\n오류 응답 본문에는 data 와 tr_cont 가 없으므로 rsp_cd 를 먼저 확인한 뒤 data 를 읽으십시오.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 이 값에 담깁니다.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "응답에 덧붙는 상세 사유입니다. 값이 없으면 응답에서 이 항목 자체가 빠집니다.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "다음 페이지가 남아 있으면 \"1\", 마지막이면 \"0\" 입니다.\n한 번에 30건씩 내려오며, 다음 페이지는 tr_cont 와 tr_cont_key 를 요청에 함께 보내 이어서 받으십시오. 키는 쿼리스트링으로 보냅니다.", "depth" : 0 }, { "element" : "tr_cont_key", "name" : "연속조회 키", "type" : "String", "required" : "N", "length" : "200", "description" : "tr_cont 가 \"1\" 일 때만 응답에 담깁니다. 마지막 페이지(tr_cont \"0\")와 오류 응답에는 이 항목이 없습니다. 값 안에 공백이 길게 이어지므로 잘라내거나 줄이지 말고 URL 인코딩하여 쿼리스트링으로 보내십시오.", "depth" : 0 } ] }, "requestExample" : "GET /accounts/v1/me/holdings?nthn_rmnd_incu_yn=N\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": [\n {\n \"iscd\": \"A000020\",\n \"isnm\": \"동화약품\",\n \"rmnd_srno\": \"\",\n \"pros_trgt_cls_code\": \"1\",\n \"mksc_cls_name\": \"주식일반\",\n \"mksc_cls_code\": \"\",\n \"rmnd_qty\": 22,\n \"byng_unpr\": \"23340.00\",\n \"psnt_prc\": \"6490.000000\",\n \"prdy_last_prc\": \"5200.00000000\",\n \"prdy_clpr_vrss\": \"1290.00\",\n \"vltn_amt\": 142780,\n \"vltn_prls_amt\": -370700,\n \"ert\": \"-72.19000\",\n \"byov_date\": \"\",\n \"loan_amt\": 0,\n \"loan_date\": \"\",\n \"loan_mtrt_date\": \"\",\n \"byng_amt\": 513480,\n \"pstn_cls_code\": \"\",\n \"ftop_type_code\": \"\",\n \"tr_mltl\": \"0.00000000\",\n \"loan_dtl_type_code\": \"\",\n \"txat_vltn_amt\": 0,\n \"rltm_prdy_vrss_sign\": \"2\",\n \"pris_cpld_cfcn\": \"0.00000\",\n \"byov_ert\": \"0.0000\",\n \"tax_paym_cls_code\": \"\",\n \"if_tr_amt\": \"22\",\n \"hldn_issu_rmnd_qty\": \"0.00000\",\n \"mtrt_date\": \"\",\n \"rmnd_dqty\": \"0.0000000000\"\n },\n {\n \"iscd\": \"A000120\",\n \"isnm\": \"CJ대한통운\",\n \"rmnd_srno\": \"\",\n \"pros_trgt_cls_code\": \"1\",\n \"mksc_cls_name\": \"주식일반\",\n \"mksc_cls_code\": \"\",\n \"rmnd_qty\": 102,\n \"byng_unpr\": \"96724.00\",\n \"psnt_prc\": \"95800.000000\",\n \"prdy_last_prc\": \"72400.00000000\",\n \"prdy_clpr_vrss\": \"23400.00\",\n \"vltn_amt\": 9771600,\n \"vltn_prls_amt\": -94197,\n \"ert\": \"-0.95000\",\n \"byov_date\": \"\",\n \"loan_amt\": 0,\n \"loan_date\": \"\",\n \"loan_mtrt_date\": \"\",\n \"byng_amt\": 9865797,\n \"pstn_cls_code\": \"\",\n \"ftop_type_code\": \"\",\n \"tr_mltl\": \"0.00000000\",\n \"loan_dtl_type_code\": \"\",\n \"txat_vltn_amt\": 0,\n \"rltm_prdy_vrss_sign\": \"2\",\n \"pris_cpld_cfcn\": \"0.00000\",\n \"byov_ert\": \"0.0000\",\n \"tax_paym_cls_code\": \"\",\n \"if_tr_amt\": \"102\",\n \"hldn_issu_rmnd_qty\": \"0.00000\",\n \"mtrt_date\": \"\",\n \"rmnd_dqty\": \"0.0000000000\"\n }\n ],\n \"rsp_cd\": \"5766\",\n \"rsp_msg\": \"조회가 완료되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "내 계좌 자산별 평가금액 조회", "protocol" : "", "method" : "GET", "domain" : "", "url" : "/accounts/v1/me/valuation/by-asset", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "개별계좌별 자산별 평가금액 조회", "trs" : [ { "name" : "개별계좌별 자산별 평가금액 조회", "code" : "obacb_balc_154r", "request" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출하기 위한 Request Body 데이터 포맷으로 \"application/json; charset=utf-8\" 설정", "depth" : 0 }, { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "aset_cls_code", "name" : "자산구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "조회할 자산군입니다. 2자리로 입력합니다.\n\"00\" 총자산 · \"01\" 국내주식 · \"02\" 해외주식 · \"03\" 국내CFD · \"04\" 해외CFD · \"05\" 채권 · \"06\" CMA · \"07\" 펀드 · \"08\" ELS/DLS · \"09\" 국내파생 · \"10\" 외화 및 기타상품 · \"11\" 원화예수금 · \"12\" 신용 및 대출 (query string)", "depth" : 0 }, { "element" : "exch_kind_code", "name" : "거래소종류코드", "type" : "String", "required" : "N", "length" : "2", "description" : "거래소 구분 코드입니다. 2자리로 입력합니다. (query string)", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "DATA", "type" : "Object", "required" : "Y", "length" : "-", "description" : "자산군별 평가 정보입니다.", "depth" : 0 }, { "element" : "vltn_amt", "name" : "평가금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "해당 자산군의 평가금액", "depth" : 0 }, { "element" : "vltn_prls_amt", "name" : "평가손익금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "해당 자산군의 평가손익금액", "depth" : 0 }, { "element" : "loan_amt", "name" : "대출금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "대출 잔액입니다.\n대출 종류별 금액은 내 계좌 예수금 상세 조회(/accounts/v1/me/deposit)에 나뉘어 있습니다.", "depth" : 0 }, { "element" : "plrt", "name" : "손익률", "type" : "Number", "required" : "Y", "length" : "23", "description" : "해당 자산군의 손익률(%)", "depth" : 0 }, { "element" : "byng_amt", "name" : "매입금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "해당 자산군의 매입원가", "depth" : 0 }, { "element" : "tfam", "name" : "예수금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "계좌의 예수금(현금 잔액)입니다.\n출금 가능액은 drng_able_amt, 주문 가능액은 oder_able_cash_amt 로, 둘 다 내 계좌 예수금 상세 조회(/accounts/v1/me/deposit)에 있습니다.", "depth" : 0 }, { "element" : "unam", "name" : "미수금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "해당 자산군의 미수금", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "4", "description" : "응답 코드입니다.\n이 API 는 data 에 값이 담긴 응답에도 \"5820\" 이 내려올 수 있습니다.\n오류는 종류와 무관하게 HTTP 500 으로 반환됩니다.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 이 값에 담깁니다.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "오류일 때 조치 정보가 담기는 항목입니다.", "depth" : 0 } ] }, "requestExample" : "GET /accounts/v1/me/valuation/by-asset?aset_cls_code=05\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": {\n \"vltn_amt\": 8272200,\n \"vltn_prls_amt\": -1593597,\n \"loan_amt\": 0,\n \"plrt\": -16.15,\n \"byng_amt\": 9865797,\n \"tfam\": 0,\n \"unam\": 0\n },\n \"rsp_cd\": \"5766\",\n \"rsp_msg\": \"조회가 완료되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] } ] }, { "name" : "국내주식", "apis" : [ { "name" : "일반주문 매수", "protocol" : "REST", "method" : "POST", "domain" : "", "url" : "/trading/v1/orders/buy", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "국내주식 일반 주문 매수", "trs" : [ { "name" : "주식 매수 주문", "code" : "obtrs_oder_101a", "request" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출하기 위한 Request Body 데이터 포맷으로 \"application/json; charset=utf-8\" 설정", "depth" : 0 }, { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "종목 코드\n주식은 \"A\" + 6자리 숫자입니다. (예: A005930)", "depth" : 0 }, { "element" : "oder_unpr", "name" : "주문단가", "type" : "Number", "required" : "Y", "length" : "19", "description" : "주문 단가\n시장가 주문(oder_cls_code \"05\")은 0을 입력합니다.", "depth" : 0 }, { "element" : "odqt", "name" : "주문수량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "주문 수량입니다.", "depth" : 0 }, { "element" : "oder_cls_code", "name" : "주문구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "주문 구분 코드\n\"01\": 보통(지정가)\n\"05\": 시장가\n\"06\": 조건부지정가\n\"12\": 최유리지정가\n\"13\": 최우선지정가\n\"61\": 장전시간외\n\"71\": 장후시간외\n\"83\": 스톱지정가\n\"84\": 중간가", "depth" : 0 }, { "element" : "oder_cond_cls_code", "name" : "주문조건구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "주문 조건 구분 코드\n\"0\": 일반\n\"3\": IOC\n\"4\": FOK", "depth" : 0 }, { "element" : "orgl_oder_no", "name" : "원주문번호", "type" : "Number", "required" : "N", "length" : "11", "description" : "신규 주문에는 원주문이 없으므로 0을 넣습니다.", "depth" : 0 }, { "element" : "whol_rctf_cncl_yn", "name" : "전체정정취소여부", "type" : "String", "required" : "N", "length" : "1", "description" : "신규 주문에는 해당하지 않으므로 \"N\"을 넣습니다.", "depth" : 0 }, { "element" : "warn_cnfr_yn", "name" : "경고확인여부", "type" : "String", "required" : "N", "length" : "1", "description" : "경고 확인 여부\n\"N\": 미확인\n\"Y\": 확인\n최초 요청은 \"N\"으로 보내거나 넣지 않습니다. 응답의 warn_cls_code가 경고 값(\"1\" \"3\" \"4\" \"6\" \"7\" \"9\" \"a\" \"c\" \"d\" \"f\" \"g\")이면 warn_msg 내용을 확인한 뒤 같은 요청에 이 항목을 \"Y\"로 바꿔 재전송합니다.", "depth" : 0 }, { "element" : "exch_kind_code", "name" : "거래소종류코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "거래소 종류 코드\n\"01\": KRX\n\"02\": NXT\n\"03\": SOR", "depth" : 0 }, { "element" : "aspr_cond_prc", "name" : "호가조건가격", "type" : "Number", "required" : "N", "length" : "11", "description" : "스톱지정가 주문(oder_cls_code \"83\")에서 감시할 가격을 입력합니다.", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "DATA", "type" : "Object", "required" : "Y", "length" : "-", "description" : "주문 접수 결과입니다. 접수된 주문 번호와 경고 여부가 내려옵니다.", "depth" : 0 }, { "element" : "oder_no", "name" : "주문번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "이번 요청으로 채번된 주문 번호입니다. 주식 주문 정정(/trading/v1/orders/modify)·취소(/trading/v1/orders/cancel) 시 orgl_oder_no 에 이 값을 넣습니다.", "depth" : 0 }, { "element" : "warn_cls_code", "name" : "경고구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "경고 구분 코드\n\"0\": 정상 접수\n\n경고 ― \"1\" \"3\" \"4\" \"6\" \"7\" \"9\" \"a\" \"c\" \"d\" \"f\" \"g\"\nwarn_msg 내용을 확인한 뒤 같은 요청을 warn_cnfr_yn 으로 재전송합니다.\n\n보류 ― \"2\" \"5\" \"8\" \"b\" \"e\" \"h\"\n\n경고 값은 \"1\" 하나가 아니므로 위 집합으로 판정하십시오.", "depth" : 0 }, { "element" : "warn_msg", "name" : "메시지내용", "type" : "String", "required" : "Y", "length" : "100", "description" : "경고 또는 안내 문구입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "응답 코드\n\"0001\": 주문 접수 성공\n오류는 종류와 무관하게 HTTP 500 으로 반환되며 사유는 rsp_msg 에 담깁니다.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 이 값에 담깁니다.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "항상 \"0\"으로 내려옵니다. 이 API는 연속조회를 지원하지 않습니다.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "오류일 때만 내려오며 조치 정보가 담깁니다.\n정상 응답에는 포함되지 않습니다.", "depth" : 0 } ] }, "requestExample" : "POST /trading/v1/orders/buy\nContent-Type: application/json; charset=utf-8\nauthorization: Bearer {access_token}\n\n{\n \"iscd\": \"A005930\",\n \"oder_unpr\": 273000,\n \"odqt\": 5,\n \"oder_cls_code\": \"01\",\n \"oder_cond_cls_code\": \"0\",\n \"orgl_oder_no\": 0,\n \"whol_rctf_cncl_yn\": \"N\",\n \"warn_cnfr_yn\": \"N\",\n \"exch_kind_code\": \"01\"\n}", "responseExample" : "{\n \"data\": {\n \"oder_no\": 140,\n \"warn_cls_code\": \"0\",\n \"warn_msg\": \"\"\n },\n \"rsp_cd\": \"0001\",\n \"rsp_msg\": \"주문이 완료되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "일반주문 매도", "protocol" : "REST", "method" : "POST", "domain" : "", "url" : "/trading/v1/orders/sell", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "국내주식 일반 주문 매도", "trs" : [ { "name" : "주식 매도 주문", "code" : "obtrs_oder_101a", "request" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출하기 위한 Request Body 데이터 포맷으로 \"application/json; charset=utf-8\" 설정", "depth" : 0 }, { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "종목 코드\n주식은 \"A\" + 6자리 숫자입니다. (예: A005930)", "depth" : 0 }, { "element" : "oder_unpr", "name" : "주문단가", "type" : "Number", "required" : "Y", "length" : "19", "description" : "주문 단가\n시장가 주문(oder_cls_code \"05\")은 0을 입력합니다.", "depth" : 0 }, { "element" : "odqt", "name" : "주문수량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "주문 수량입니다.", "depth" : 0 }, { "element" : "oder_cls_code", "name" : "주문구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "주문 구분 코드\n\"01\": 보통(지정가)\n\"05\": 시장가\n\"06\": 조건부지정가\n\"12\": 최유리지정가\n\"13\": 최우선지정가\n\"61\": 장전시간외\n\"71\": 장후시간외\n\"83\": 스톱지정가\n\"84\": 중간가", "depth" : 0 }, { "element" : "oder_cond_cls_code", "name" : "주문조건구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "주문 조건 구분 코드\n\"0\": 일반\n\"3\": IOC\n\"4\": FOK", "depth" : 0 }, { "element" : "orgl_oder_no", "name" : "원주문번호", "type" : "Number", "required" : "N", "length" : "11", "description" : "신규 주문에는 원주문이 없으므로 0을 넣습니다.", "depth" : 0 }, { "element" : "whol_rctf_cncl_yn", "name" : "전체정정취소여부", "type" : "String", "required" : "N", "length" : "1", "description" : "신규 주문에는 해당하지 않으므로 \"N\"을 넣습니다.", "depth" : 0 }, { "element" : "warn_cnfr_yn", "name" : "경고확인여부", "type" : "String", "required" : "N", "length" : "1", "description" : "경고 확인 여부\n\"N\": 미확인\n\"Y\": 확인\n최초 요청은 \"N\"으로 보내거나 넣지 않습니다. 응답의 warn_cls_code가 경고 값(\"1\" \"3\" \"4\" \"6\" \"7\" \"9\" \"a\" \"c\" \"d\" \"f\" \"g\")이면 warn_msg 내용을 확인한 뒤 같은 요청을 \"Y\"로 재전송합니다.", "depth" : 0 }, { "element" : "exch_kind_code", "name" : "거래소종류코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "거래소 종류 코드\n\"01\": KRX\n\"02\": NXT\n\"03\": SOR", "depth" : 0 }, { "element" : "aspr_cond_prc", "name" : "호가조건가격", "type" : "Number", "required" : "N", "length" : "11", "description" : "스톱지정가 주문(oder_cls_code \"83\")에서 감시할 가격을 입력합니다.", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "DATA", "type" : "Object", "required" : "Y", "length" : "-", "description" : "주문 접수 결과입니다. 접수된 주문 번호와 경고 여부가 내려옵니다.", "depth" : 0 }, { "element" : "oder_no", "name" : "주문번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "이번 요청으로 채번된 주문 번호입니다. 주식 주문 정정(/trading/v1/orders/modify)·취소(/trading/v1/orders/cancel) 시 orgl_oder_no 에 이 값을 넣습니다.", "depth" : 0 }, { "element" : "warn_cls_code", "name" : "경고구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "경고 구분 코드\n\"0\": 정상 접수\n\n경고 ― \"1\" \"3\" \"4\" \"6\" \"7\" \"9\" \"a\" \"c\" \"d\" \"f\" \"g\"\nwarn_msg 내용을 확인한 뒤 같은 요청을 warn_cnfr_yn 으로 재전송합니다.\n\n보류 ― \"2\" \"5\" \"8\" \"b\" \"e\" \"h\"\n\n경고 값은 \"1\" 하나가 아니므로 위 집합으로 판정하십시오.", "depth" : 0 }, { "element" : "warn_msg", "name" : "메시지내용", "type" : "String", "required" : "Y", "length" : "100", "description" : "경고 또는 안내 문구입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "응답 코드\n\"0001\": 주문 접수 성공\n오류는 종류와 무관하게 HTTP 500 으로 반환되며 사유는 rsp_msg 에 담깁니다.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 이 값에 담깁니다.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "항상 \"0\"으로 내려옵니다. 이 API는 연속조회를 지원하지 않습니다.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "오류일 때만 내려오며 조치 정보가 담깁니다.\n정상 응답에는 포함되지 않습니다.", "depth" : 0 } ] }, "requestExample" : "POST /trading/v1/orders/sell\nContent-Type: application/json; charset=utf-8\nauthorization: Bearer {access_token}\n\n{\n \"iscd\": \"A005930\",\n \"oder_unpr\": 273000,\n \"odqt\": 5,\n \"oder_cls_code\": \"01\",\n \"oder_cond_cls_code\": \"0\",\n \"orgl_oder_no\": 0,\n \"whol_rctf_cncl_yn\": \"N\",\n \"warn_cnfr_yn\": \"N\",\n \"exch_kind_code\": \"01\"\n}", "responseExample" : "{\n \"data\": {\n \"oder_no\": 140,\n \"warn_cls_code\": \"0\",\n \"warn_msg\": \"\"\n },\n \"rsp_cd\": \"0001\",\n \"rsp_msg\": \"주문이 완료되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "신용매수 주문", "protocol" : "REST", "method" : "POST", "domain" : "", "url" : "/trading/v1/credit-orders/buy", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "신용융자 또는 예탁담보를 재원으로 매수 주문을 접수합니다.", "trs" : [ { "name" : "주식 신용 매수 주문", "code" : "obtrs_oder_201a", "request" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출하기 위한 Request Body 데이터 포맷으로 \"application/json; charset=utf-8\" 설정", "depth" : 0 }, { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "loan_oder_cls_code", "name" : "대출주문구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "대출 재원 구분\n\"01\": 신용융자\n\"03\": 예탁담보", "depth" : 0 }, { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "종목 코드\n주식은 \"A\" + 6자리 숫자입니다. (예: A005930)", "depth" : 0 }, { "element" : "oder_unpr", "name" : "주문단가", "type" : "Number", "required" : "Y", "length" : "19", "description" : "주문 단가\n시장가 주문(oder_cls_code \"05\")은 0을 입력합니다.", "depth" : 0 }, { "element" : "odqt", "name" : "주문수량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "주문 수량입니다.", "depth" : 0 }, { "element" : "loan_date", "name" : "대출일자", "type" : "String", "required" : "N", "length" : "8", "description" : "매수는 상환할 대출 건이 없으므로 빈 문자열을 넣습니다.", "depth" : 0 }, { "element" : "loan_srno", "name" : "대출일련번호", "type" : "Number", "required" : "N", "length" : "11", "description" : "매수는 1을 넣습니다.", "depth" : 0 }, { "element" : "oder_cls_code", "name" : "주문구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "주문 구분 코드\n\"01\": 보통(지정가)\n\"05\": 시장가\n\"06\": 조건부지정가\n\"12\": 최유리지정가\n\"13\": 최우선지정가\n\"61\": 장전시간외\n\"71\": 장후시간외\n\"83\": 스톱지정가\n\"84\": 중간가\n\"83\"(스톱지정가)은 aspr_cond_prc 에 감시 가격을 함께 입력합니다.", "depth" : 0 }, { "element" : "oder_cond_cls_code", "name" : "주문조건구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "주문 조건 구분 코드\n\"0\": 일반\n\"3\": IOC\n\"4\": FOK", "depth" : 0 }, { "element" : "warn_cnfr_yn", "name" : "경고확인여부", "type" : "String", "required" : "N", "length" : "1", "description" : "경고 확인 여부\n\"N\": 미확인\n\"Y\": 확인\n최초 요청은 \"N\"으로 보내거나 넣지 않습니다. 응답의 warn_cls_code가 경고 값(\"1\" \"3\" \"4\" \"6\" \"7\" \"9\" \"a\" \"c\" \"d\" \"f\" \"g\")이면 warn_msg 내용을 확인한 뒤 같은 요청에 이 항목을 바꿔 재전송합니다.", "depth" : 0 }, { "element" : "whol_amt_rdmp_yn", "name" : "전체금액상환여부", "type" : "String", "required" : "N", "length" : "1", "description" : "매수는 상환이 아니므로 \"N\"을 넣습니다.", "depth" : 0 }, { "element" : "exch_kind_code", "name" : "거래소종류코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "거래소 종류 코드\n\"01\": KRX\n\"02\": NXT\n\"03\": SOR", "depth" : 0 }, { "element" : "aspr_cond_prc", "name" : "호가조건가격", "type" : "Number", "required" : "N", "length" : "11", "description" : "스톱 주문(oder_cls_code \"83\")에서 감시할 가격을 입력합니다.", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "DATA", "type" : "Object", "required" : "Y", "length" : "-", "description" : "주문 접수 결과입니다. 접수된 주문 번호와 경고 여부가 내려옵니다.", "depth" : 0 }, { "element" : "oder_no", "name" : "주문번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "이번 요청으로 채번된 주문 번호입니다. 주식 주문 정정(/trading/v1/orders/modify)·취소(/trading/v1/orders/cancel) 시 orgl_oder_no 에 이 값을 넣습니다.", "depth" : 0 }, { "element" : "warn_cls_code", "name" : "경고구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "경고 구분 코드\n\"0\": 정상 접수\n\n경고 ― \"1\" \"3\" \"4\" \"6\" \"7\" \"9\" \"a\" \"c\" \"d\" \"f\" \"g\"\nwarn_msg 내용을 확인한 뒤 같은 요청을 warn_cnfr_yn 으로 재전송합니다.\n\n보류 ― \"2\" \"5\" \"8\" \"b\" \"e\" \"h\"\n\n경고 값은 \"1\" 하나가 아니므로 위 집합으로 판정하십시오.", "depth" : 0 }, { "element" : "warn_msg", "name" : "메시지내용", "type" : "String", "required" : "Y", "length" : "100", "description" : "경고 또는 안내 문구입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "응답 코드\n\"0001\": 주문 접수 성공\n오류는 종류와 무관하게 HTTP 500 으로 반환되며 사유는 rsp_msg 에 담깁니다.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 이 값에 담깁니다.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "항상 \"0\"으로 내려옵니다. 이 API는 연속조회를 지원하지 않습니다.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "오류일 때만 내려오며 조치 정보가 담깁니다.\n정상 응답에는 포함되지 않습니다.", "depth" : 0 } ] }, "requestExample" : "POST /trading/v1/credit-orders/buy\nContent-Type: application/json; charset=utf-8\nauthorization: Bearer {access_token}\n\n{\n \"loan_oder_cls_code\": \"01\",\n \"iscd\": \"A005930\",\n \"oder_unpr\": 187000,\n \"odqt\": 1,\n \"loan_date\": \"\",\n \"loan_srno\": 1,\n \"oder_cls_code\": \"01\",\n \"oder_cond_cls_code\": \"0\",\n \"warn_cnfr_yn\": \"N\",\n \"whol_amt_rdmp_yn\": \"N\",\n \"exch_kind_code\": \"01\",\n \"aspr_cond_prc\": 0\n}", "responseExample" : "{\n \"data\": {\n \"oder_no\": 146,\n \"warn_cls_code\": \"0\",\n \"warn_msg\": \"\"\n },\n \"rsp_cd\": \"0001\",\n \"rsp_msg\": \"주문이 완료되었습니다.\",\n \"tr_cont\": \"0\"\n}\n\n# 접수되지 않은 경우 ― data 없이 응답 코드만 돌아옵니다\n{\n \"rsp_cd\": \"3288\",\n \"rsp_msg\": \"신용구분을 잘못 입력하셨습니다.\"\n}" } ] }, { "name" : "신용매도 주문", "protocol" : "REST", "method" : "POST", "domain" : "", "url" : "/trading/v1/credit-orders/sell", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "신용융자 또는 예탁담보 보유분을 매도해 상환합니다.", "trs" : [ { "name" : "주식 신용 매도 주문", "code" : "obtrs_oder_201a", "request" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출하기 위한 Request Body 데이터 포맷으로 \"application/json; charset=utf-8\" 설정", "depth" : 0 }, { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "loan_oder_cls_code", "name" : "대출주문구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "대출 재원 구분입니다.\n\"01\": 신용융자\n\"03\": 예탁담보", "depth" : 0 }, { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "종목 코드\n주식은 \"A\" + 6자리 숫자입니다. (예: A005930)", "depth" : 0 }, { "element" : "oder_unpr", "name" : "주문단가", "type" : "Number", "required" : "Y", "length" : "19", "description" : "주문 단가\n시장가 주문(oder_cls_code \"05\")은 0을 입력합니다.", "depth" : 0 }, { "element" : "odqt", "name" : "주문수량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "주문 수량입니다.", "depth" : 0 }, { "element" : "loan_date", "name" : "대출일자", "type" : "String", "required" : "N", "length" : "8", "description" : "상환할 대출 건의 대출 일자를 YYYYMMDD 형식으로 넣습니다.", "depth" : 0 }, { "element" : "loan_srno", "name" : "대출일련번호", "type" : "Number", "required" : "N", "length" : "11", "description" : "상환할 대출 건의 일련번호입니다.", "depth" : 0 }, { "element" : "oder_cls_code", "name" : "주문구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "주문 구분 코드\n\"01\": 보통(지정가)\n\"05\": 시장가\n\"06\": 조건부지정가\n\"12\": 최유리지정가\n\"13\": 최우선지정가\n\"61\": 장전시간외\n\"71\": 장후시간외\n\"83\": 스톱지정가\n\"84\": 중간가\n\"83\"(스톱지정가)은 aspr_cond_prc 에 감시 가격을 함께 입력합니다.", "depth" : 0 }, { "element" : "oder_cond_cls_code", "name" : "주문조건구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "주문 조건 구분 코드\n\"0\": 일반\n\"3\": IOC\n\"4\": FOK", "depth" : 0 }, { "element" : "warn_cnfr_yn", "name" : "경고확인여부", "type" : "String", "required" : "N", "length" : "1", "description" : "경고 확인 여부\n\"N\": 미확인\n\"Y\": 확인\n최초 요청은 \"N\"으로 보내거나 넣지 않습니다. 응답의 warn_cls_code가 경고 값(\"1\" \"3\" \"4\" \"6\" \"7\" \"9\" \"a\" \"c\" \"d\" \"f\" \"g\")이면 warn_msg 내용을 확인한 뒤 같은 요청을 \"Y\"로 재전송합니다.", "depth" : 0 }, { "element" : "whol_amt_rdmp_yn", "name" : "전체금액상환여부", "type" : "String", "required" : "N", "length" : "1", "description" : "전체 금액 상환 여부\n\"Y\": 대출 전액을 상환하도록 매도\n\"N\": 입력한 수량만 매도", "depth" : 0 }, { "element" : "exch_kind_code", "name" : "거래소종류코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "거래소 종류 코드\n\"01\": KRX\n\"02\": NXT\n\"03\": SOR", "depth" : 0 }, { "element" : "aspr_cond_prc", "name" : "호가조건가격", "type" : "Number", "required" : "N", "length" : "11", "description" : "스톱 주문(oder_cls_code \"83\")에서 감시할 가격을 입력합니다.", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "DATA", "type" : "Object", "required" : "Y", "length" : "-", "description" : "주문 접수 결과입니다. 접수된 주문 번호와 경고 여부가 내려옵니다.", "depth" : 0 }, { "element" : "oder_no", "name" : "주문번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "이번 요청으로 채번된 주문 번호입니다. 주식 주문 정정(/trading/v1/orders/modify)·취소(/trading/v1/orders/cancel) 시 orgl_oder_no 에 이 값을 넣습니다.", "depth" : 0 }, { "element" : "warn_cls_code", "name" : "경고구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "경고 구분 코드\n\"0\": 정상 접수\n\n경고 ― \"1\" \"3\" \"4\" \"6\" \"7\" \"9\" \"a\" \"c\" \"d\" \"f\" \"g\"\nwarn_msg 내용을 확인한 뒤 같은 요청을 warn_cnfr_yn 으로 재전송합니다.\n\n보류 ― \"2\" \"5\" \"8\" \"b\" \"e\" \"h\"\n\n경고 값은 \"1\" 하나가 아니므로 위 집합으로 판정하십시오.", "depth" : 0 }, { "element" : "warn_msg", "name" : "메시지내용", "type" : "String", "required" : "Y", "length" : "100", "description" : "경고 또는 안내 문구입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "응답 코드\n\"0001\": 주문 접수 성공\n오류는 종류와 무관하게 HTTP 500 으로 반환되며 사유는 rsp_msg 에 담깁니다.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 이 값에 담깁니다.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "항상 \"0\"으로 내려옵니다. 이 API는 연속조회를 지원하지 않습니다.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "오류일 때만 내려오며 조치 정보가 담깁니다.\n정상 응답에는 포함되지 않습니다.", "depth" : 0 } ] }, "requestExample" : "POST /trading/v1/credit-orders/sell\nContent-Type: application/json; charset=utf-8\nauthorization: Bearer {access_token}\n\n{\n \"loan_oder_cls_code\": \"01\",\n \"iscd\": \"A000020\",\n \"oder_unpr\": 5280,\n \"odqt\": 1,\n \"loan_date\": \"20260812\",\n \"loan_srno\": 1,\n \"oder_cls_code\": \"01\",\n \"oder_cond_cls_code\": \"0\",\n \"warn_cnfr_yn\": \"N\",\n \"whol_amt_rdmp_yn\": \"N\",\n \"exch_kind_code\": \"01\"\n}", "responseExample" : "{\n \"data\": {\n \"oder_no\": 146,\n \"warn_cls_code\": \"0\",\n \"warn_msg\": \"\"\n },\n \"rsp_cd\": \"0001\",\n \"rsp_msg\": \"주문이 완료되었습니다.\",\n \"tr_cont\": \"0\"\n}\n\n# 접수되지 않은 경우 ― data 없이 응답 코드만 돌아옵니다\n{\n \"rsp_cd\": \"3288\",\n \"rsp_msg\": \"신용구분을 잘못 입력하셨습니다.\"\n}" } ] }, { "name" : "국내주식 주문 정정", "protocol" : "REST", "method" : "POST", "domain" : "", "url" : "/trading/v1/orders/modify", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "국내주식 주문 정정", "trs" : [ { "name" : "주식 주문 정정", "code" : "obtrs_oder_101a", "request" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출하기 위한 Request Body 데이터 포맷으로 \"application/json; charset=utf-8\" 설정", "depth" : 0 }, { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "종목 코드\n주식은 \"A\" + 6자리 숫자입니다. (예: A005930)", "depth" : 0 }, { "element" : "oder_unpr", "name" : "주문단가", "type" : "Number", "required" : "Y", "length" : "19", "description" : "정정 후 단가를 입력합니다.", "depth" : 0 }, { "element" : "odqt", "name" : "주문수량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "정정할 수량을 입력합니다.", "depth" : 0 }, { "element" : "oder_cls_code", "name" : "주문구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "주문 구분 코드\n\"01\": 보통(지정가)\n\"05\": 시장가\n\"06\": 조건부지정가\n\"12\": 최유리지정가\n\"13\": 최우선지정가\n\"61\": 장전시간외\n\"71\": 장후시간외\n\"83\": 스톱지정가\n\"84\": 중간가", "depth" : 0 }, { "element" : "oder_cond_cls_code", "name" : "주문조건구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "주문 조건 구분 코드\n\"0\": 일반\n\"3\": IOC\n\"4\": FOK", "depth" : 0 }, { "element" : "orgl_oder_no", "name" : "원주문번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "정정할 주문의 번호를 입력합니다. 주문 접수 응답 또는 주문내역 조회의 oder_no 입니다.", "depth" : 0 }, { "element" : "whol_rctf_cncl_yn", "name" : "전체정정취소여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "전체 정정 여부\n\"Y\": 전체\n\"N\": 부분", "depth" : 0 }, { "element" : "warn_cnfr_yn", "name" : "경고확인여부", "type" : "String", "required" : "N", "length" : "1", "description" : "경고 확인 여부\n\"N\": 미확인\n\"Y\": 확인\n최초 요청은 \"N\"으로 보내거나 넣지 않습니다. 응답의 warn_cls_code가 경고 값(\"1\" \"3\" \"4\" \"6\" \"7\" \"9\" \"a\" \"c\" \"d\" \"f\" \"g\")이면 warn_msg 내용을 확인한 뒤 같은 요청을 \"Y\"로 재전송합니다.", "depth" : 0 }, { "element" : "exch_kind_code", "name" : "거래소종류코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "거래소 종류 코드\n\"01\": KRX\n\"02\": NXT\n\"03\": SOR", "depth" : 0 }, { "element" : "aspr_cond_prc", "name" : "호가조건가격", "type" : "Number", "required" : "N", "length" : "11", "description" : "스톱지정가 주문(oder_cls_code \"83\")에서 감시할 가격을 입력합니다.", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "DATA", "type" : "Object", "required" : "Y", "length" : "-", "description" : "주문 접수 결과입니다. 접수된 주문 번호와 경고 여부가 내려옵니다.", "depth" : 0 }, { "element" : "oder_no", "name" : "주문번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "이번 요청으로 채번된 주문 번호입니다. 주식 주문 정정(/trading/v1/orders/modify)·취소(/trading/v1/orders/cancel) 시 orgl_oder_no 에 이 값을 넣습니다.", "depth" : 0 }, { "element" : "warn_cls_code", "name" : "경고구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "경고 구분 코드\n\"0\": 정상 접수\n\n경고 ― \"1\" \"3\" \"4\" \"6\" \"7\" \"9\" \"a\" \"c\" \"d\" \"f\" \"g\"\nwarn_msg 내용을 확인한 뒤 같은 요청을 warn_cnfr_yn 으로 재전송합니다.\n\n보류 ― \"2\" \"5\" \"8\" \"b\" \"e\" \"h\"\n\n경고 값은 \"1\" 하나가 아니므로 위 집합으로 판정하십시오.", "depth" : 0 }, { "element" : "warn_msg", "name" : "메시지내용", "type" : "String", "required" : "Y", "length" : "100", "description" : "경고 또는 안내 문구입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "응답 코드\n\"0001\": 주문 접수 성공\n오류는 종류와 무관하게 HTTP 500 으로 반환되며 사유는 rsp_msg 에 담깁니다.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 이 값에 담깁니다.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "항상 \"0\"으로 내려옵니다. 이 API는 연속조회를 지원하지 않습니다.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "오류일 때만 내려오며 조치 정보가 담깁니다.\n정상 응답에는 포함되지 않습니다.", "depth" : 0 } ] }, "requestExample" : "POST /trading/v1/orders/modify\nContent-Type: application/json; charset=utf-8\nauthorization: Bearer {access_token}\n\n{\n \"iscd\": \"A005930\",\n \"oder_unpr\": 188000,\n \"odqt\": 1,\n \"oder_cls_code\": \"01\",\n \"oder_cond_cls_code\": \"0\",\n \"orgl_oder_no\": 135,\n \"whol_rctf_cncl_yn\": \"Y\",\n \"warn_cnfr_yn\": \"N\",\n \"exch_kind_code\": \"01\"\n}", "responseExample" : "{\n \"data\": {\n \"oder_no\": 140,\n \"warn_cls_code\": \"0\",\n \"warn_msg\": \"\"\n },\n \"rsp_cd\": \"0001\",\n \"rsp_msg\": \"주문이 완료되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "국내주식 주문 취소", "protocol" : "REST", "method" : "POST", "domain" : "", "url" : "/trading/v1/orders/cancel", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "국내주식 주문 취소", "trs" : [ { "name" : "주식 주문 취소", "code" : "obtrs_oder_101a", "request" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출하기 위한 Request Body 데이터 포맷으로 \"application/json; charset=utf-8\" 설정", "depth" : 0 }, { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "종목 코드\n주식은 \"A\" + 6자리 숫자입니다. (예: A005930)", "depth" : 0 }, { "element" : "oder_unpr", "name" : "주문단가", "type" : "Number", "required" : "N", "length" : "19", "description" : "주문 단가입니다.", "depth" : 0 }, { "element" : "odqt", "name" : "주문수량", "type" : "Number", "required" : "N", "length" : "19", "description" : "취소할 수량을 입력합니다.", "depth" : 0 }, { "element" : "oder_cls_code", "name" : "주문구분코드", "type" : "String", "required" : "N", "length" : "2", "description" : "취소 시에는 생략할 수 있습니다. 넣을 때는 원주문의 주문구분코드를 그대로 넣으십시오.\n\"01\" 보통 · \"05\" 시장가 · \"06\" 조건부지정가 · \"12\" 최유리지정가 · \"13\" 최우선지정가 · \"61\" 장전시간외 · \"71\" 장후시간외 · \"83\" 스톱지정가 · \"84\" 중간가", "depth" : 0 }, { "element" : "oder_cond_cls_code", "name" : "주문조건구분코드", "type" : "String", "required" : "N", "length" : "1", "description" : "주문 조건 구분 코드\n\"0\": 일반\n\"3\": IOC\n\"4\": FOK", "depth" : 0 }, { "element" : "orgl_oder_no", "name" : "원주문번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "취소할 주문의 번호를 입력합니다. 주문 접수 응답 또는 주문내역 조회의 oder_no 입니다.", "depth" : 0 }, { "element" : "whol_rctf_cncl_yn", "name" : "전체정정취소여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "전체 취소 여부\n\"Y\": 전체\n\"N\": 부분", "depth" : 0 }, { "element" : "warn_cnfr_yn", "name" : "경고확인여부", "type" : "String", "required" : "N", "length" : "1", "description" : "경고 확인 여부\n\"N\": 미확인\n\"Y\": 확인\n최초 요청은 \"N\"으로 보내거나 넣지 않습니다. 응답의 warn_cls_code가 경고 값(\"1\" \"3\" \"4\" \"6\" \"7\" \"9\" \"a\" \"c\" \"d\" \"f\" \"g\")이면 warn_msg 내용을 확인한 뒤 같은 요청을 \"Y\"로 재전송합니다.", "depth" : 0 }, { "element" : "exch_kind_code", "name" : "거래소종류코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "거래소 종류 코드\n\"01\": KRX\n\"02\": NXT\n\"03\": SOR", "depth" : 0 }, { "element" : "aspr_cond_prc", "name" : "호가조건가격", "type" : "Number", "required" : "N", "length" : "11", "description" : "스톱지정가 주문(oder_cls_code \"83\")에서 감시할 가격을 입력합니다.", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "DATA", "type" : "Object", "required" : "Y", "length" : "-", "description" : "주문 접수 결과입니다. 접수된 주문 번호와 경고 여부가 내려옵니다.", "depth" : 0 }, { "element" : "oder_no", "name" : "주문번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "이번 요청으로 채번된 주문 번호입니다. 주식 주문 정정(/trading/v1/orders/modify)·취소(/trading/v1/orders/cancel) 시 orgl_oder_no 에 이 값을 넣습니다.", "depth" : 0 }, { "element" : "warn_cls_code", "name" : "경고구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "경고 구분 코드\n\"0\": 정상 접수\n\n경고 ― \"1\" \"3\" \"4\" \"6\" \"7\" \"9\" \"a\" \"c\" \"d\" \"f\" \"g\"\nwarn_msg 내용을 확인한 뒤 같은 요청을 warn_cnfr_yn 으로 재전송합니다.\n\n보류 ― \"2\" \"5\" \"8\" \"b\" \"e\" \"h\"\n\n경고 값은 \"1\" 하나가 아니므로 위 집합으로 판정하십시오.", "depth" : 0 }, { "element" : "warn_msg", "name" : "메시지내용", "type" : "String", "required" : "Y", "length" : "100", "description" : "경고 또는 안내 문구입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "응답 코드\n\"0001\": 주문 접수 성공\n오류는 종류와 무관하게 HTTP 500 으로 반환되며 사유는 rsp_msg 에 담깁니다.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 이 값에 담깁니다.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "항상 \"0\"으로 내려옵니다. 이 API는 연속조회를 지원하지 않습니다.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "오류일 때만 내려오며 조치 정보가 담깁니다.\n정상 응답에는 포함되지 않습니다.", "depth" : 0 } ] }, "requestExample" : "POST /trading/v1/orders/cancel\nContent-Type: application/json; charset=utf-8\nauthorization: Bearer {access_token}\n\n{\n \"iscd\": \"A005930\",\n \"oder_unpr\": 187000,\n \"odqt\": 1,\n \"oder_cls_code\": \"01\",\n \"oder_cond_cls_code\": \"0\",\n \"orgl_oder_no\": 135,\n \"whol_rctf_cncl_yn\": \"Y\",\n \"warn_cnfr_yn\": \"N\",\n \"exch_kind_code\": \"01\"\n}", "responseExample" : "{\n \"data\": {\n \"oder_no\": 140,\n \"warn_cls_code\": \"0\",\n \"warn_msg\": \"\"\n },\n \"rsp_cd\": \"0001\",\n \"rsp_msg\": \"주문이 완료되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "주문가능금액·수량 조회", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/trading/v1/orders/estimate", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "국내주식 주문을 내기 전에 그 종목과 단가로 얼마나 주문할 수 있는지를 조회합니다.", "trs" : [ { "name" : "주식 주문가능금액·수량 조회", "code" : "obtrs_comn_413r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "종목 코드\n주식은 \"A\" + 단축코드 6자리 입니다. (예: A005930)", "depth" : 0 }, { "element" : "oder_unpr", "name" : "주문단가", "type" : "Number", "required" : "Y", "length" : "19", "description" : "주문 단가를 입력합니다. 주문구분코드에 따라 넣을 값이 정해져 있습니다.\n시장가 계열(\"05\" \"12\" \"13\" \"61\" \"71\" \"84\") ― 반드시 0 을 넣으십시오. 0 이 아니면 \"3180\" 으로 거부됩니다.\n지정가 계열(\"01\" \"81\" \"83\") ― 0 보다 큰 단가를 넣으십시오. 0 이나 음수는 \"5980\" 으로 거부됩니다.\n\"06\" 조건부지정가 ― 어느 값을 넣어도 오류가 없고 결과도 같습니다.", "depth" : 0 }, { "element" : "oder_cls_code", "name" : "주문구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "주문 구분입니다.\n\"01\": 보통(지정가)\n\"05\": 시장가\n\"06\": 조건부지정가\n\"12\": 최유리지정가\n\"13\": 최우선지정가\n\"61\": 장전시간외\n\"71\": 장후시간외\n\"81\": 시간외단일가\n\"83\": 스톱지정가\n\"84\": 중간가\n위 목록에 없는 두 자리 값은 오류 없이 \"01\"(지정가)로 처리되므로 값을 임의로 만들어 넣지 마십시오.", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "주문가능 정보", "type" : "Object", "required" : "Y", "length" : "-", "description" : "결제 방식별 주문 가능 금액·수량", "depth" : 0 }, { "element" : "cash_oder_able_qty", "name" : "현금주문가능수량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "현금 기준 주문 가능 수량입니다.\n지정가 계열(\"01\" \"81\" \"83\")에서는 같은 응답의 cash_oder_able_amt 를 보낸 주문단가(oder_unpr)로 나눈 뒤 버림한 값과 같습니다.\n시장가 계열과 \"06\" 조건부지정가는 해당 종목의 시세 기준으로 계산된 값이 내려오므로, 보낸 단가로 다시 계산하지 말고 받은 값을 그대로 쓰십시오.", "depth" : 0 }, { "element" : "cash_oder_able_amt", "name" : "현금주문가능금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "현금으로 주문 가능한 금액입니다. 원 단위 정수입니다.", "depth" : 0 }, { "element" : "credit_oder_able_qty", "name" : "신용주문가능수량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "신용(융자) 기준 주문 가능 수량입니다.", "depth" : 0 }, { "element" : "credit_oder_able_amt", "name" : "신용주문가능금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "신용(융자)으로 주문 가능한 금액입니다.", "depth" : 0 }, { "element" : "intg_marg_oder_able_qty", "name" : "통합증거금주문가능수량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "통합증거금 기준 주문 가능 수량입니다.", "depth" : 0 }, { "element" : "intg_marg_oder_able_amt", "name" : "통합증거금주문가능금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "통합증거금 기준 주문 가능 금액입니다.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "항상 \"0\"으로 내려옵니다. 이 API는 연속조회를 지원하지 않습니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 응답 코드입니다.\n\"5766\": 조회 완료\n\"3180\": 시장가 계열에 주문단가를 0 이 아닌 값으로 넣음\n\"5980\": 지정가 계열에 주문단가를 0 이하로 넣음\n오류는 종류와 무관하게 HTTP 500 으로 반환되므로 성공·실패는 HTTP 상태가 아니라 이 값으로 판정하십시오.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 이 값에 담깁니다.\n오류 응답에는 data 와 tr_cont 가 없으므로, rsp_cd 를 먼저 확인한 뒤 data 를 읽으십시오.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "오류일 때만 내려오며 조치 정보가 담깁니다.\n정상 응답에는 포함되지 않습니다.", "depth" : 0 } ] }, "requestExample" : "GET /trading/v1/orders/estimate?iscd=A005930&oder_unpr=259000&oder_cls_code=01\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": {\n \"cash_oder_able_qty\": 3403,\n \"cash_oder_able_amt\": 881454437,\n \"credit_oder_able_qty\": 0,\n \"credit_oder_able_amt\": 0,\n \"intg_marg_oder_able_qty\": 0,\n \"intg_marg_oder_able_amt\": 0\n },\n \"rsp_cd\": \"5766\",\n \"rsp_msg\": \"조회가 완료되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "주문내역 조회", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/trading/v1/orders/history", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "주문 내역을 조회합니다. 체결·미체결 여부와 정정·취소 이력을 함께 반환합니다.", "trs" : [ { "name" : "주식 주문내역 조회", "code" : "obtrs_comn_615r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "oder_date", "name" : "주문일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "조회할 주문 일자를 YYYYMMDD 8자리로 입력합니다. (예: 20260818)\n달력에 없는 날짜(예: \"20260231\")는 rsp_cd \"6102\" 오류로 거부됩니다. 휴장일은 오류가 아니라 \"5820\" 과 0건이 내려옵니다.\n하루 단위로만 조회되므로 기간으로 보려면 영업일마다 나누어 호출하십시오.", "depth" : 0 }, { "element" : "deal_cls_code", "name" : "매매구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "매매 구분입니다.\n\"0\": 전체\n\"1\": 매도\n\"2\": 매수\n위 세 값만 받으며, 그 밖의 값(예: \"3\")은 \"5018\" 오류입니다. (query string)", "depth" : 0 }, { "element" : "cntg_cls_code", "name" : "체결구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "체결 여부로 걸러냅니다.\n\"0\": 전체\n\"1\": 체결된 수량이 있는 주문\n\"2\": 남은 수량이 있는 주문\n목록 밖의 값(예: \"9\")은 \"5018\" 오류입니다. (query string)", "depth" : 0 }, { "element" : "sort_stnd_code", "name" : "정렬기준코드", "type" : "String", "required" : "N", "length" : "1", "description" : "정렬 기준입니다.\n\"1\": 역순(최근 주문 먼저)\n\"2\": 주문순(접수 순서)\n(query string)", "depth" : 0 }, { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "N", "length" : "12", "description" : "특정 종목만 조회할 때 종목코드를 입력합니다. \"A005930\" 과 \"005930\" 모두 같은 결과로 조회되며 값 뒤에 공백이 붙어도 같습니다.\n접두어 \"A\" 는 대문자만 인정되며, 소문자(\"a005930\")나 없는 종목코드는 오류 없이 \"5820\"(조회 결과 없음)이 내려옵니다.\n입력하지 않으면 전체 종목을 조회합니다.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "N", "length" : "1", "description" : "다음 페이지를 요청하실 때 \"1\" 을 넣습니다. 첫 조회에는 넣지 않습니다. tr_cont_key 와 함께 쿼리 스트링으로 보내십시오.", "depth" : 0 }, { "element" : "tr_cont_key", "name" : "연속조회 키", "type" : "String", "required" : "N", "length" : "20", "description" : "직전 응답의 tr_cont_key 를 그대로 넣습니다. 첫 조회에는 넣지 않습니다. 쿼리 스트링으로 보냅니다.\n값 오른쪽에 공백이 붙어 내려오므로 잘라내지 말고 URL 인코딩하여 원본 그대로 보내십시오.", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "주문내역 목록", "type" : "Object Array", "required" : "Y", "length" : "-", "description" : "주문 내역 배열입니다. 한 페이지에 30건까지 담기며, 0건은 배열 길이로 판정하십시오.\n오류일 때는 이 항목 자체가 없으므로 rsp_cd 를 먼저 확인한 뒤 data 를 읽으십시오.", "depth" : 0 }, { "element" : "oder_no", "name" : "주문번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "주문 번호입니다. 정정·취소 주문에도 새 번호가 부여됩니다. 정정·취소를 낼 때 이 값을 원주문번호(orgl_oder_no)에 넣으십시오.\n정정(/trading/v1/orders/modify)·취소(/trading/v1/orders/cancel)는 거래소종류코드(exch_kind_code)를 받는데 이 조회 응답에는 그 항목이 없으므로 주문 시 사용한 값을 보관해 두십시오.", "depth" : 0 }, { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "종목 코드입니다. 주식은 \"A\" + 6자리 숫자입니다. (예: A005930)", "depth" : 0 }, { "element" : "kor_issu_abwr_name", "name" : "한글종목약어명", "type" : "String", "required" : "Y", "length" : "40", "description" : "한글 종목명입니다. 별도 가공 없이 그대로 사용하실 수 있습니다. (예: 삼성전자)", "depth" : 0 }, { "element" : "deal_cls_code", "name" : "매매구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "매매 구분\n\"1\": 매도\n\"2\": 매수", "depth" : 0 }, { "element" : "odqt", "name" : "주문수량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "주문 수량입니다.", "depth" : 0 }, { "element" : "oder_unpr", "name" : "주문단가", "type" : "Number", "required" : "Y", "length" : "19", "description" : "주문 단가입니다.", "depth" : 0 }, { "element" : "total_cntg_qty", "name" : "총체결수량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "이 주문에서 체결된 수량의 합계입니다. 0이면 아직 한 건도 체결되지 않은 것입니다.", "depth" : 0 }, { "element" : "cntg_unpr", "name" : "체결단가", "type" : "Number", "required" : "Y", "length" : "19", "description" : "실제 체결된 단가입니다. 체결 내역이 없으면 0입니다.", "depth" : 0 }, { "element" : "ncnt_qty", "name" : "미체결수량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "아직 체결되지 않고 남아 있는 수량입니다.\n미체결 주문만 보려면 요청의 cntg_cls_code 에 \"2\" 를 넣으십시오.", "depth" : 0 }, { "element" : "oder_pros_sta_time", "name" : "주문처리시작시각", "type" : "String", "required" : "Y", "length" : "14", "description" : "주문 접수 시각입니다. 14자리이며 앞 6자리가 HHMMSS입니다. (예: \"15465523153500\" → 15시 46분 55초)", "depth" : 0 }, { "element" : "oder_pros_stat_cls_code", "name" : "주문처리상태구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "주문의 접수 단계입니다.\n\"0\": 미접수\n\"1\": 접수\n\"2\": 확인\n\"3\": 거부", "depth" : 0 }, { "element" : "orgl_oder_no", "name" : "원주문번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "정정·취소 주문이 대상으로 삼은 주문의 번호입니다. 신규 주문은 0 입니다.\n국내 주문내역에서는 이 값이 최초 신규 주문(rctf_cncl_cls_code \"1\" 인 행)을 가리키며, 여러 번 나누어 정정·취소한 경우에도 중간 정정 행이 아닌 최초 주문을 가리킵니다. 따라서 이 값으로 묶으면 한 주문의 이력이 최초 주문 하나에 모입니다.", "depth" : 0 }, { "element" : "chan_type_cls_code", "name" : "채널유형구분코드", "type" : "String", "required" : "Y", "length" : "3", "description" : "주문이 접수된 채널입니다.\n\"120\": Open API\n\"010\", \"020\": 영업점·홈페이지\n\"060\": HTS\n\"156\", \"157\": MTS\n\"600\", \"601\": 그 밖의 접수 경로", "depth" : 0 }, { "element" : "rctf_cncl_cls_code", "name" : "정정취소구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "이 행이 원주문인지 정정·취소 요청인지 구분합니다.\n\"1\": 신규(원주문)\n\"2\": 정정\n\"3\": 취소\n\"2\"·\"3\" 인 행은 orgl_oder_no 로 원주문과 이어집니다.", "depth" : 0 }, { "element" : "oder_type_cls_code", "name" : "주문유형구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "주문이 접수된 경로를 구분하는 코드입니다. 값에 대응하는 이름은 응답에 함께 오지 않습니다.", "depth" : 0 }, { "element" : "rctf_qty", "name" : "정정수량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "이 주문에 대해 정정된 수량입니다.", "depth" : 0 }, { "element" : "cncl_qty", "name" : "취소수량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "이 주문에 대해 취소된 수량입니다.", "depth" : 0 }, { "element" : "cnfr_qty", "name" : "확인수량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "취소가 확인 처리된 수량입니다. 같은 행의 cncl_qty 와 같은 값으로 내려옵니다.", "depth" : 0 }, { "element" : "oder_able_qty", "name" : "주문가능수량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "정정·취소하실 수 있는 잔여 수량입니다.", "depth" : 0 }, { "element" : "loan_date", "name" : "대출일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "대출 일자(YYYYMMDD)입니다. 현금 주문은 \"00000000\"입니다.", "depth" : 0 }, { "element" : "oder_rfus_reas_code", "name" : "주문거부사유코드", "type" : "String", "required" : "Y", "length" : "4", "description" : "주문이 거부된 사유 코드입니다. 정상 접수 건은 \"0000\" 입니다.\n숫자 네 자리와 영문이 섞인 네 자리가 함께 쓰이므로(예: \"S607\") 문자열로 다루십시오. 코드에 대응하는 한글 사유는 응답에 함께 오지 않습니다.\noder_pros_stat_cls_code 가 \"1\"(접수)인데도 이 값이 \"0000\" 이 아닌 건이 있습니다.", "depth" : 0 }, { "element" : "oder_cond_cls_code", "name" : "주문조건구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "주문 조건\n\"0\": 일반\n\"3\": IOC\n\"4\": FOK", "depth" : 0 }, { "element" : "oder_cls_code", "name" : "주문구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "주문 구분\n\"01\": 보통(지정가)\n\"05\": 시장가\n\"06\": 조건부지정가\n\"12\": 최유리지정가\n\"13\": 최우선지정가\n\"61\": 장전시간외\n\"71\": 장후시간외\n\"81\": 시간외단일가", "depth" : 0 }, { "element" : "crdt_oder_cls_code", "name" : "신용주문구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "결제 재원 구분입니다.\n\"10\": 현금\n\"21\": 신용 매수(자기융자)\n\"31\": 신용 매수(유통융자)\n\"32\": 신용 상환 매도\n\"33\": 대주", "depth" : 0 }, { "element" : "loan_dtl_type_code", "name" : "대출상세유형코드", "type" : "String", "required" : "Y", "length" : "4", "description" : "대출 상세 유형\n\"0000\": 해당 없음(현금 주문)\n\"0101\": 자기융자\n\"0102\": 유통융자\n\"0201\": 예탁주식(대출)", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 응답 코드입니다.\n\"5762\": 조회 결과가 더 있음(연속조회)\n\"5766\": 조회 완료\n\"5820\": 조회할 자료 없음\n\"5018\": 입력값이 잘못됨\n\"6102\": 주문일자(oder_date)가 잘못됨(예: 달력에 없는 날짜)\n오류는 종류와 무관하게 HTTP 500 으로 반환되므로 성공·실패는 HTTP 상태가 아니라 이 값으로 판정하십시오.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 이 값에 담깁니다.\n오류 응답에는 data 와 tr_cont 가 없으므로, rsp_cd 를 먼저 확인한 뒤 data 를 읽으십시오.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "다음 페이지가 남아 있으면 \"1\", 마지막이면 \"0\"입니다.", "depth" : 0 }, { "element" : "tr_cont_key", "name" : "연속조회 키", "type" : "String", "required" : "N", "length" : "20", "description" : "다음 페이지가 있을 때(tr_cont \"1\")만 담깁니다. 마지막 페이지(tr_cont \"0\")와 오류 응답에는 이 항목이 없습니다.\n다음 페이지를 요청할 때는 값을 잘라내지 말고 그대로 넣으십시오(오른쪽에 공백이 붙어 내려옵니다).", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "오류 응답에 담길 수 있는 보조 메시지입니다. 모든 오류에 내려오는 것은 아닙니다.\n정상 응답에는 포함되지 않습니다.", "depth" : 0 } ] }, "requestExample" : "GET /trading/v1/orders/history?oder_date=20260818&deal_cls_code=0&cntg_cls_code=0\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": [\n {\n \"oder_no\": 22,\n \"iscd\": \"A005930\",\n \"kor_issu_abwr_name\": \"삼성전자\",\n \"deal_cls_code\": \"2\",\n \"odqt\": 100,\n \"oder_unpr\": 279500,\n \"total_cntg_qty\": 2,\n \"cntg_unpr\": 279500,\n \"ncnt_qty\": 0,\n \"oder_pros_sta_time\": \"11031513535500\",\n \"oder_pros_stat_cls_code\": \"1\",\n \"orgl_oder_no\": 0,\n \"chan_type_cls_code\": \"120\",\n \"rctf_cncl_cls_code\": \"1\",\n \"oder_type_cls_code\": \"01\",\n \"rctf_qty\": 0,\n \"cncl_qty\": 0,\n \"cnfr_qty\": 0,\n \"oder_able_qty\": 0,\n \"loan_date\": \"00000000\",\n \"oder_rfus_reas_code\": \"0000\",\n \"oder_cond_cls_code\": \"0\",\n \"oder_cls_code\": \"01\",\n \"crdt_oder_cls_code\": \"10\",\n \"loan_dtl_type_code\": \"0000\"\n },\n {\n \"oder_no\": 42,\n \"iscd\": \"A005930\",\n \"kor_issu_abwr_name\": \"삼성전자\",\n \"deal_cls_code\": \"1\",\n \"odqt\": 100,\n \"oder_unpr\": 276000,\n \"total_cntg_qty\": 0,\n \"cntg_unpr\": 0,\n \"ncnt_qty\": 0,\n \"oder_pros_sta_time\": \"11154085869100\",\n \"oder_pros_stat_cls_code\": \"1\",\n \"orgl_oder_no\": 0,\n \"chan_type_cls_code\": \"120\",\n \"rctf_cncl_cls_code\": \"1\",\n \"oder_type_cls_code\": \"01\",\n \"rctf_qty\": 0,\n \"cncl_qty\": 0,\n \"cnfr_qty\": 0,\n \"oder_able_qty\": 0,\n \"loan_date\": \"00000000\",\n \"oder_rfus_reas_code\": \"S607\",\n \"oder_cond_cls_code\": \"0\",\n \"oder_cls_code\": \"01\",\n \"crdt_oder_cls_code\": \"10\",\n \"loan_dtl_type_code\": \"0000\"\n }\n ],\n \"rsp_cd\": \"5762\",\n \"rsp_msg\": \"조회가 계속 됩니다. 다음 또는 PgDn을 누르십시오.\",\n \"tr_cont\": \"1\",\n \"tr_cont_key\": \"106500000000113\"\n}" } ] }, { "name" : "국내주식 예약주문 매수", "protocol" : "REST", "method" : "POST", "domain" : "", "url" : "/trading/v1/reserved-orders/buy", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "장이 열리지 않은 시간에 국내주식 매수 주문을 미리 걸어 두는 예약주문을 접수합니다.", "trs" : [ { "name" : "국내주식 예약주문 매수", "code" : "obtrs_oder_510a", "request" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출하기 위한 Request Body 데이터 포맷으로 \"application/json; charset=utf-8\" 설정", "depth" : 0 }, { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "종목 코드 6자리입니다. (예: \"005930\")", "depth" : 0 }, { "element" : "adod_type_code", "name" : "예약주문유형코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "예약주문 유형입니다.\n\"02\": 현금 매수\n\"04\": 신용융자 매수\n\"05\": 대주 매수\n\n\"04\" \"05\" 는 loan_date 와 loan_srno 를 함께 넣으십시오. 이 API 는 매수 유형만 받습니다.", "depth" : 0 }, { "element" : "odqt", "name" : "주문수량", "type" : "String", "required" : "Y", "length" : "19", "description" : "주문 수량입니다.", "depth" : 0 }, { "element" : "oder_unpr", "name" : "주문단가", "type" : "String", "required" : "Y", "length" : "19", "description" : "주문 단가입니다. 시장가 계열은 0 을 넣습니다.", "depth" : 0 }, { "element" : "oder_cls_code", "name" : "주문구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "주문 구분 코드\n\"01\": 지정가\n\"05\": 시장가\n\"06\": 조건부지정가\n\"12\": 최유리지정가\n\"13\": 최우선지정가\n\n시장가 계열은 oder_unpr 에 0 을 넣습니다.", "depth" : 0 }, { "element" : "loan_date", "name" : "대출일자", "type" : "String", "required" : "N", "length" : "8", "description" : "신용 거래일 때 대출일자입니다. YYYYMMDD 8자리.", "depth" : 0 }, { "element" : "loan_srno", "name" : "대출일련번호", "type" : "String", "required" : "N", "length" : "11", "description" : "신용 거래일 때 대출일련번호입니다.", "depth" : 0 }, { "element" : "warn_cnfr_yn", "name" : "경고확인여부", "type" : "String", "required" : "N", "length" : "1", "description" : "착오매매 경고를 확인했는지 여부입니다. 기본은 \"N\" 입니다.", "depth" : 0 }, { "element" : "oder_rsev_cls_code", "name" : "주문예약구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "예약 방식입니다. \"1\": 일반예약, \"2\": 기간잔량, \"3\": 기간예약.\n\"2\" \"3\" 은 oder_sta_date · oder_fin_date 를 함께 넣으십시오.", "depth" : 0 }, { "element" : "oder_sta_date", "name" : "주문시작일자", "type" : "String", "required" : "N", "length" : "8", "description" : "기간잔량(\"2\")·기간예약(\"3\")으로 예약하실 때 주문이 나가기 시작하는 일자입니다. YYYYMMDD 8자리로 넣으십시오.", "depth" : 0 }, { "element" : "oder_fin_date", "name" : "주문종료일자", "type" : "String", "required" : "N", "length" : "8", "description" : "기간잔량(\"2\")·기간예약(\"3\")으로 예약하실 때 주문이 나가는 마지막 일자입니다. YYYYMMDD 8자리로 넣으십시오.", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "예약주문 접수 결과", "type" : "Object", "required" : "Y", "length" : "-", "description" : "예약 매수 주문의 접수 결과입니다. 접수된 예약의 일자와 일련번호가 들어 있으며, 예약주문 취소에 이 값을 그대로 넣으십시오.", "depth" : 0 }, { "element" : "warn_cls_code", "name" : "경고구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "주문 처리 결과입니다. 한 자리 코드입니다.\n\"0\": 정상 접수\n\"1\": 경고\n\"2\": 보류\n\"3\": 투자유의\n\"4\": 경고 + 투자유의\n\"5\": 보류 + 투자유의\n\"6\": 단기과열\n\"7\": 경고 + 단기과열\n\"8\": 보류 + 단기과열\n\"9\": 투자경고\n\"a\": 경고 + 투자경고\n\"b\": 보류 + 투자경고\n\"c\": 투자위험\n\"d\": 경고 + 투자위험\n\"e\": 보류 + 투자위험\n\"f\": 정리매매\n\"g\": 경고 + 정리매매\n\"h\": 보류 + 정리매매\n\n\"0\" 이 아닌 값은 msg_cntt 를 사용자에게 보여 주십시오. 목록에 없는 값도 msg_cntt 를 확인하십시오.", "depth" : 0 }, { "element" : "msg_cntt", "name" : "메시지내용", "type" : "String", "required" : "Y", "length" : "100", "description" : "경고·안내 메시지입니다. 정상 접수 시에는 빈 문자열입니다.", "depth" : 0 }, { "element" : "oder_rsev_mst_date", "name" : "주문예약마스터일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "예약이 등록된 일자입니다. 취소하실 때 이 값을 그대로 넣으십시오.", "depth" : 0 }, { "element" : "oder_rsev_mst_no", "name" : "주문예약마스터번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "예약 번호입니다. 취소하실 때 이 값을 그대로 넣으십시오.", "depth" : 0 }, { "element" : "pros_srno", "name" : "처리일련번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "처리 일련번호입니다.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "연속조회 여부입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "처리 결과 코드입니다. 성공 코드는 API 마다 다르므로 rsp_msg 와 함께 확인하십시오.\n\n오류는 종류와 무관하게 HTTP 500 으로 반환되며 이 필드에 사유 코드가 담깁니다.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "처리 결과 메시지입니다. 오류일 때 사유가 담기며, 더 자세한 사유는 rsp_sub_msg 에 담깁니다.", "depth" : 0 } ] }, "requestExample" : "POST /trading/v1/reserved-orders/buy\ncontent-type: application/json; charset=utf-8\nauthorization: Bearer {access_token}\nmac_address: {mac_address}\n\n{\n \"iscd\": \"005930\",\n \"adod_type_code\": \"02\",\n \"odqt\": \"1\",\n \"oder_unpr\": \"70000\",\n \"oder_cls_code\": \"01\",\n \"oder_rsev_cls_code\": \"1\",\n \"warn_cnfr_yn\": \"N\"\n}", "responseExample" : "{\n \"data\": {\n \"warn_cls_code\": \"0\",\n \"msg_cntt\": \"\",\n \"oder_rsev_mst_date\": \"20260908\",\n \"oder_rsev_mst_no\": 16,\n \"pros_srno\": 0\n },\n \"rsp_cd\": \"5620\",\n \"rsp_msg\": \"정상처리 되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "국내주식 예약주문 매도", "protocol" : "REST", "method" : "POST", "domain" : "", "url" : "/trading/v1/reserved-orders/sell", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "장이 열리지 않은 시간에 국내주식 매도 주문을 미리 걸어 두는 예약주문을 접수합니다.", "trs" : [ { "name" : "국내주식 예약주문 매도", "code" : "obtrs_oder_510a", "request" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출하기 위한 Request Body 데이터 포맷으로 \"application/json; charset=utf-8\" 설정", "depth" : 0 }, { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "종목 코드 6자리입니다. (예: \"005930\")", "depth" : 0 }, { "element" : "adod_type_code", "name" : "예약주문유형코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "예약주문 유형입니다.\n\"01\": 현금 매도\n\"03\": 신용융자 매도\n\"11\": 예탁담보 매도\n\"12\": 소액담보 매도\n\"13\": 대용 매도\n\n\"03\" 은 loan_date · loan_srno 를 함께 넣으십시오.", "depth" : 0 }, { "element" : "odqt", "name" : "주문수량", "type" : "String", "required" : "Y", "length" : "19", "description" : "주문 수량입니다.", "depth" : 0 }, { "element" : "oder_unpr", "name" : "주문단가", "type" : "String", "required" : "Y", "length" : "19", "description" : "주문 단가입니다. 시장가 계열은 0 을 넣습니다.", "depth" : 0 }, { "element" : "oder_cls_code", "name" : "주문구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "주문 구분 코드\n\"01\": 지정가\n\"05\": 시장가\n\"06\": 조건부지정가\n\"12\": 최유리지정가\n\"13\": 최우선지정가\n\n시장가 계열은 oder_unpr 에 0 을 넣습니다.", "depth" : 0 }, { "element" : "loan_date", "name" : "대출일자", "type" : "String", "required" : "N", "length" : "8", "description" : "신용 거래일 때 대출일자입니다. YYYYMMDD 8자리.", "depth" : 0 }, { "element" : "loan_srno", "name" : "대출일련번호", "type" : "String", "required" : "N", "length" : "11", "description" : "신용 거래일 때 대출일련번호입니다.", "depth" : 0 }, { "element" : "warn_cnfr_yn", "name" : "경고확인여부", "type" : "String", "required" : "N", "length" : "1", "description" : "착오매매 경고를 확인했는지 여부입니다. 기본은 \"N\" 입니다.", "depth" : 0 }, { "element" : "oder_rsev_cls_code", "name" : "주문예약구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "예약 방식입니다. \"1\": 일반예약, \"2\": 기간잔량, \"3\": 기간예약.\n\"2\" \"3\" 은 oder_sta_date · oder_fin_date 를 함께 넣으십시오.", "depth" : 0 }, { "element" : "oder_sta_date", "name" : "주문시작일자", "type" : "String", "required" : "N", "length" : "8", "description" : "기간잔량(\"2\")·기간예약(\"3\")으로 예약하실 때 주문이 나가기 시작하는 일자입니다. YYYYMMDD 8자리로 넣으십시오.", "depth" : 0 }, { "element" : "oder_fin_date", "name" : "주문종료일자", "type" : "String", "required" : "N", "length" : "8", "description" : "기간잔량(\"2\")·기간예약(\"3\")으로 예약하실 때 주문이 나가는 마지막 일자입니다. YYYYMMDD 8자리로 넣으십시오.", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "예약주문 접수 결과", "type" : "Object", "required" : "Y", "length" : "-", "description" : "예약 매도 주문의 접수 결과입니다. 접수된 예약의 일자와 일련번호가 들어 있으며, 예약주문 취소에 이 값을 그대로 넣으십시오.", "depth" : 0 }, { "element" : "warn_cls_code", "name" : "경고구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "주문 처리 결과입니다. 한 자리 코드입니다.\n\"0\": 정상 접수\n\"1\": 경고\n\"2\": 보류\n\"3\": 투자유의\n\"4\": 경고 + 투자유의\n\"5\": 보류 + 투자유의\n\"6\": 단기과열\n\"7\": 경고 + 단기과열\n\"8\": 보류 + 단기과열\n\"9\": 투자경고\n\"a\": 경고 + 투자경고\n\"b\": 보류 + 투자경고\n\"c\": 투자위험\n\"d\": 경고 + 투자위험\n\"e\": 보류 + 투자위험\n\"f\": 정리매매\n\"g\": 경고 + 정리매매\n\"h\": 보류 + 정리매매\n\n\"0\" 이 아닌 값은 msg_cntt 를 사용자에게 보여 주십시오.", "depth" : 0 }, { "element" : "msg_cntt", "name" : "메시지내용", "type" : "String", "required" : "Y", "length" : "100", "description" : "경고·안내 메시지입니다. 정상 접수 시에는 빈 문자열입니다.", "depth" : 0 }, { "element" : "oder_rsev_mst_date", "name" : "주문예약마스터일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "예약이 등록된 일자입니다. 취소하실 때 이 값을 그대로 넣으십시오.", "depth" : 0 }, { "element" : "oder_rsev_mst_no", "name" : "주문예약마스터번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "예약 번호입니다. 취소하실 때 이 값을 그대로 넣으십시오.", "depth" : 0 }, { "element" : "pros_srno", "name" : "처리일련번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "처리 일련번호입니다.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "연속조회 여부입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "처리 결과 코드입니다. 성공 코드는 API 마다 다르므로 rsp_msg 와 함께 확인하십시오.\n\n오류는 종류와 무관하게 HTTP 500 으로 반환되며 이 필드에 사유 코드가 담깁니다.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "처리 결과 메시지입니다. 오류일 때 사유가 담기며, 더 자세한 사유는 rsp_sub_msg 에 담깁니다.", "depth" : 0 } ] }, "requestExample" : "POST /trading/v1/reserved-orders/sell\ncontent-type: application/json; charset=utf-8\nauthorization: Bearer {access_token}\nmac_address: {mac_address}\n\n{\n \"iscd\": \"005930\",\n \"adod_type_code\": \"01\",\n \"odqt\": \"1\",\n \"oder_unpr\": \"70000\",\n \"oder_cls_code\": \"01\",\n \"oder_rsev_cls_code\": \"1\",\n \"warn_cnfr_yn\": \"N\"\n}", "responseExample" : "{\n \"data\": {\n \"warn_cls_code\": \"0\",\n \"msg_cntt\": \"\",\n \"oder_rsev_mst_date\": \"20260908\",\n \"oder_rsev_mst_no\": 16,\n \"pros_srno\": 0\n },\n \"rsp_cd\": \"5620\",\n \"rsp_msg\": \"정상처리 되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "국내주식 예약주문 취소", "protocol" : "REST", "method" : "POST", "domain" : "", "url" : "/trading/v1/reserved-orders/cancel", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "접수된 국내주식 예약주문을 취소합니다.", "trs" : [ { "name" : "국내주식 예약주문 취소", "code" : "obtrs_oder_510a", "request" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출하기 위한 Request Body 데이터 포맷으로 \"application/json; charset=utf-8\" 설정", "depth" : 0 }, { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "종목 코드 6자리입니다. (예: \"005930\")", "depth" : 0 }, { "element" : "warn_cnfr_yn", "name" : "경고확인여부", "type" : "String", "required" : "N", "length" : "1", "description" : "착오매매 경고를 확인했는지 여부입니다. 기본은 \"N\" 입니다.", "depth" : 0 }, { "element" : "oder_rsev_mst_date", "name" : "주문예약마스터일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "취소할 예약의 등록 일자입니다. YYYYMMDD 8자리.", "depth" : 0 }, { "element" : "oder_rsev_mst_no", "name" : "주문예약마스터번호", "type" : "String", "required" : "Y", "length" : "11", "description" : "취소할 예약의 번호입니다.", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "예약주문 취소 결과", "type" : "Object", "required" : "Y", "length" : "-", "description" : "예약주문 취소 처리 결과입니다. 취소된 예약의 일자와 일련번호가 들어 있습니다.", "depth" : 0 }, { "element" : "warn_cls_code", "name" : "경고구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "주문 처리 결과입니다. 한 자리 코드입니다.\n\"0\": 정상 접수\n\"1\": 경고\n\"2\": 보류\n\"3\": 투자유의\n\"4\": 경고 + 투자유의\n\"5\": 보류 + 투자유의\n\"6\": 단기과열\n\"7\": 경고 + 단기과열\n\"8\": 보류 + 단기과열\n\"9\": 투자경고\n\"a\": 경고 + 투자경고\n\"b\": 보류 + 투자경고\n\"c\": 투자위험\n\"d\": 경고 + 투자위험\n\"e\": 보류 + 투자위험\n\"f\": 정리매매\n\"g\": 경고 + 정리매매\n\"h\": 보류 + 정리매매\n\n\"0\" 이 아닌 값은 msg_cntt 를 사용자에게 보여 주십시오.", "depth" : 0 }, { "element" : "msg_cntt", "name" : "메시지내용", "type" : "String", "required" : "Y", "length" : "100", "description" : "경고·안내 메시지입니다. 정상 접수 시에는 빈 문자열입니다.", "depth" : 0 }, { "element" : "oder_rsev_mst_date", "name" : "주문예약마스터일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "예약이 등록된 일자입니다. 취소하실 때 이 값을 그대로 넣으십시오.", "depth" : 0 }, { "element" : "oder_rsev_mst_no", "name" : "주문예약마스터번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "취소한 예약의 예약 번호입니다.", "depth" : 0 }, { "element" : "pros_srno", "name" : "처리일련번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "처리 일련번호입니다.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "연속조회 여부입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "처리 결과 코드입니다. 성공 코드는 API 마다 다르므로 rsp_msg 와 함께 확인하십시오.\n\n오류는 종류와 무관하게 HTTP 500 으로 반환되며 이 필드에 사유 코드가 담깁니다.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "처리 결과 메시지입니다. 오류일 때 사유가 담기며, 더 자세한 사유는 rsp_sub_msg 에 담깁니다.", "depth" : 0 } ] }, "requestExample" : "POST /trading/v1/reserved-orders/cancel\ncontent-type: application/json; charset=utf-8\nauthorization: Bearer {access_token}\nmac_address: {mac_address}\n\n{\n \"iscd\": \"005930\",\n \"oder_rsev_mst_date\": \"20260908\",\n \"oder_rsev_mst_no\": \"16\",\n \"warn_cnfr_yn\": \"N\"\n}", "responseExample" : "{\n \"data\": {\n \"warn_cls_code\": \"0\",\n \"msg_cntt\": \"\",\n \"oder_rsev_mst_date\": \"20260908\",\n \"oder_rsev_mst_no\": 16,\n \"pros_srno\": 0\n },\n \"rsp_cd\": \"5620\",\n \"rsp_msg\": \"정상처리 되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "국내주식 예약주문 조회", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/trading/v1/reserved-orders", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "접근토큰에 매핑된 계좌의 국내주식 예약주문 내역을 조회합니다.", "trs" : [ { "name" : "국내주식 예약주문 조회", "code" : "obtrs_oder_511r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "oder_sta_date", "name" : "주문시작일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "조회 시작일자를 YYYYMMDD 8자리로 입력합니다. 시작일자와 종료일자를 모두 넣으십시오.\n시작일자에 \"00000000\" 을 넣으면 시작 제한 없이 계좌의 모든 이력이 내려옵니다. 종료일자에는 쓰지 마십시오. (query string)", "depth" : 0 }, { "element" : "oder_fin_date", "name" : "주문종료일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "조회 종료일자를 YYYYMMDD 8자리로 입력합니다. 반드시 넣으십시오. \"00000000\" 을 넣으면 오류 없이 빈 결과(rsp_cd \"5820\")가 내려옵니다. 기간 끝을 열어 두려면 충분히 뒤의 날짜(예: \"20991231\")를 넣으십시오. (query string)", "depth" : 0 }, { "element" : "iqry_csnu", "name" : "조회건수", "type" : "String", "required" : "N", "length" : "11", "description" : "조회 건수 입력값입니다. 넣지 않으면 한 번에 30건이 내려옵니다. 응답의 tr_cont 가 \"1\" 이면 tr_cont_key 로 이어서 받으십시오. (query string)", "depth" : 0 }, { "element" : "iqry_cls_code", "name" : "조회구분코드", "type" : "String", "required" : "N", "length" : "1", "description" : "조회 구분입니다. \"1\": 취소 가능 건만(cncl_cls_code \"01\"), \"2\": 전체(취소된 예약 포함). 항목을 빼면 전체가 조회됩니다. (query string)", "depth" : 0 }, { "element" : "deal_cls_code", "name" : "매매구분코드", "type" : "String", "required" : "N", "length" : "1", "description" : "매매 구분입니다.\n\"0\": 전체\n\"1\": 매도\n\"2\": 매수\n\n\"1\" 을 넣으시면 매도 예약만 내려옵니다. 항목을 빼시면 전체가 조회됩니다. (query string)", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "N", "length" : "1", "description" : "다음 페이지를 요청할 때 \"1\"을 넣습니다. 첫 조회에는 넣지 않습니다. (query string)", "depth" : 0 }, { "element" : "tr_cont_key", "name" : "연속조회 키", "type" : "String", "required" : "N", "length" : "20", "description" : "이어서 조회할 때 직전 응답의 tr_cont_key 를 한 글자도 바꾸지 말고 그대로 넣고, tr_cont 에 \"1\" 을 함께 보내십시오. 첫 조회에는 넣지 않습니다. 오른쪽 공백은 자르지 말고 URL 인코딩하여 그대로 보내십시오. (query string)", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "예약주문 목록", "type" : "Object Array", "required" : "Y", "length" : "-", "description" : "예약주문 배열입니다.", "depth" : 0 }, { "element" : "rsev_reg_date", "name" : "예약등록일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "예약을 등록한 일자입니다. YYYYMMDD 8자리.", "depth" : 0 }, { "element" : "rsev_reg_time", "name" : "예약등록시각", "type" : "String", "required" : "Y", "length" : "9", "description" : "예약을 등록한 시각입니다. 9자리.", "depth" : 0 }, { "element" : "oder_rsev_mst_date", "name" : "주문예약마스터일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "취소 요청에 넣을 예약 일자입니다.", "depth" : 0 }, { "element" : "oder_rsev_mst_no", "name" : "주문예약마스터번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "취소 요청에 넣을 예약 번호입니다.", "depth" : 0 }, { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "종목 코드입니다. 앞에 한 자리 접두어가 붙어 내려옵니다(예: \"A005930\").\n예약주문을 취소하실 때는 같은 행의 oder_rsev_mst_date · oder_rsev_mst_no 를 넣으십시오.", "depth" : 0 }, { "element" : "iscd_name", "name" : "종목명", "type" : "String", "required" : "Y", "length" : "40", "description" : "화면에 그대로 표시할 수 있는 종목명입니다.", "depth" : 0 }, { "element" : "adod_type_code", "name" : "예약주문유형코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "예약주문 유형입니다.\n매수 ― \"02\" 현금 / \"04\" \"05\" 신용\n매도 ― \"01\" 현금 / \"03\" 신용융자 / \"11\" 예탁담보 / \"12\" 소액담보 / \"13\" 대용", "depth" : 0 }, { "element" : "deal_cls_code", "name" : "매매구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "매매 구분입니다.\n\"1\": 매도\n\"2\": 매수", "depth" : 0 }, { "element" : "oder_cls_code", "name" : "주문구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "주문 구분 코드\n\"01\": 지정가\n\"05\": 시장가\n\"06\": 조건부지정가\n\"12\": 최유리지정가\n\"13\": 최우선지정가\n\"81\": 시간외단일가", "depth" : 0 }, { "element" : "odqt", "name" : "주문수량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "예약한 주문 수량입니다.", "depth" : 0 }, { "element" : "oder_unpr", "name" : "주문단가", "type" : "Number", "required" : "Y", "length" : "19", "description" : "예약한 주문 단가입니다.", "depth" : 0 }, { "element" : "cncl_cls_code", "name" : "취소구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "취소 여부입니다.\n\"01\": 미취소 (아직 살아 있는 예약)\n\"02\": 취소됨", "depth" : 0 }, { "element" : "chan_type_cls_code", "name" : "채널유형구분코드", "type" : "String", "required" : "Y", "length" : "3", "description" : "예약이 접수된 채널입니다.", "depth" : 0 }, { "element" : "loan_date", "name" : "대출일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "신용 거래의 대출일자입니다. 현금 거래는 \"00000000\" 으로 내려옵니다.", "depth" : 0 }, { "element" : "loan_srno", "name" : "대출일련번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "신용 거래의 대출일련번호입니다.", "depth" : 0 }, { "element" : "oder_rsev_cls_code", "name" : "주문예약구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "예약 방식입니다. \"1\": 일반예약(익영업일 1회), \"2\": 기간잔량, \"3\": 기간예약.", "depth" : 0 }, { "element" : "oder_sta_date", "name" : "주문시작일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "주문이 나가기 시작하는 일자입니다. 일반예약이면 익영업일입니다.", "depth" : 0 }, { "element" : "oder_fin_date", "name" : "주문종료일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "주문이 나가는 마지막 일자입니다. 일반예약이면 주문시작일자와 같습니다.", "depth" : 0 }, { "element" : "acml_cntg_qty", "name" : "누적체결수량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "예약이 실행되어 체결된 누적 수량입니다.", "depth" : 0 }, { "element" : "exch_kind_code", "name" : "거래소종류코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "예약이 나갈 거래소입니다.\n\"01\": KRX\n\"02\": NXT\n\"03\": SOR", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 성공 응답 코드입니다.\n\"5762\": 조회 결과가 더 있음 (연속조회)\n\"5766\": 조회 완료\n\"5820\": 조회할 자료 없음\n오류는 종류와 무관하게 HTTP 500 으로 반환됩니다.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 이 값에 담깁니다.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "다음 페이지가 남아 있으면 \"1\", 마지막이면 \"0\"입니다.", "depth" : 0 }, { "element" : "tr_cont_key", "name" : "연속조회 키", "type" : "String", "required" : "N", "length" : "20", "description" : "tr_cont 가 \"1\"일 때만 응답에 담깁니다. 마지막 페이지(tr_cont 가 \"0\")와 오류 응답에는 이 항목 자체가 없습니다. 항목이 늘 있다고 보고 값을 꺼내면 마지막 페이지에서 오류가 납니다.\n\n다음 페이지를 요청하실 때는 직전 응답의 값을 그대로 넣으십시오. 값 오른쪽에 공백이 붙어 내려오는 경우가 있으니 잘라내지 마십시오.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "오류일 때 구체적인 사유가 담기는 경우 내려옵니다.", "depth" : 0 } ] }, "requestExample" : "GET /trading/v1/reserved-orders?oder_sta_date=20260101&oder_fin_date=20261231\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": [\n {\n \"rsev_reg_date\": \"20260910\",\n \"rsev_reg_time\": \"173645105\",\n \"oder_rsev_mst_date\": \"20260910\",\n \"oder_rsev_mst_no\": 4,\n \"iscd\": \"A005930\",\n \"iscd_name\": \"삼성전자\",\n \"adod_type_code\": \"02\",\n \"deal_cls_code\": \"2\",\n \"oder_cls_code\": \"01\",\n \"odqt\": 1,\n \"oder_unpr\": 1,\n \"cncl_cls_code\": \"02\",\n \"chan_type_cls_code\": \"120\",\n \"loan_date\": \"00000000\",\n \"loan_srno\": 0,\n \"oder_rsev_cls_code\": \"1\",\n \"oder_sta_date\": \"20260911\",\n \"oder_fin_date\": \"20260911\",\n \"acml_cntg_qty\": 0,\n \"exch_kind_code\": \"01\"\n },\n {\n \"rsev_reg_date\": \"20260908\",\n \"rsev_reg_time\": \"221831038\",\n \"oder_rsev_mst_date\": \"20260908\",\n \"oder_rsev_mst_no\": 18,\n \"iscd\": \"A005930\",\n \"iscd_name\": \"삼성전자\",\n \"adod_type_code\": \"02\",\n \"deal_cls_code\": \"2\",\n \"oder_cls_code\": \"01\",\n \"odqt\": 1,\n \"oder_unpr\": 70000,\n \"cncl_cls_code\": \"01\",\n \"chan_type_cls_code\": \"120\",\n \"loan_date\": \"00000000\",\n \"loan_srno\": 0,\n \"oder_rsev_cls_code\": \"1\",\n \"oder_sta_date\": \"20260909\",\n \"oder_fin_date\": \"20260909\",\n \"acml_cntg_qty\": 0,\n \"exch_kind_code\": \"01\"\n }\n ],\n \"rsp_cd\": \"5766\",\n \"rsp_msg\": \"조회가 완료되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "국내주식 실현손익 (일자별)", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/accounts/v1/me/profit-loss", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "접근토큰에 매핑된 계좌의 국내주식 실현손익을 일자별로 조회합니다.", "trs" : [ { "name" : "국내주식 실현손익 (일자별)", "code" : "obtrs_cntg_538r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "iqry_sta_date", "name" : "조회시작일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "조회 시작일자를 YYYYMMDD 형식 여덟 자리로 입력합니다.\n\n반드시 넣으셔야 합니다.\n\n시작일자를 종료일자보다 뒤로 넣으시거나 미래 일자를 넣으시면 오류가 아니라 0건이 내려옵니다. 자료가 없어서 0건인 것과 기간을 거꾸로 넣어 0건인 것이 응답으로 구분되지 않으므로, 보내시기 전에 두 일자의 앞뒤를 확인하십시오.\n\n기간 앞을 열어 두고 싶으시면 \"00000000\" 을 넣으십시오. 계좌의 처음부터 조회됩니다. (query string)", "depth" : 0 }, { "element" : "iqry_fin_date", "name" : "조회종료일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "조회 종료일자를 YYYYMMDD 형식 여덟 자리로 입력합니다.\n\n반드시 넣으셔야 합니다. (query string)", "depth" : 0 }, { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "N", "length" : "12", "description" : "종목 코드입니다. \"A\" + 단축코드 6자리 12자리로 넣으십시오.\n넣지 않으시면 전 종목을 조회합니다. (query string)", "depth" : 0 }, { "element" : "crdt_expn_incu_yn", "name" : "신용비용포함여부", "type" : "String", "required" : "N", "length" : "1", "description" : "신용 비용 포함 여부입니다. \"Y\" 또는 \"N\" 을 넣으십시오. (query string)", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "N", "length" : "1", "description" : "다음 페이지를 요청할 때 \"1\"을 넣습니다. 첫 조회에는 넣지 않습니다. (query string)", "depth" : 0 }, { "element" : "tr_cont_key", "name" : "연속조회 키", "type" : "String", "required" : "N", "length" : "20", "description" : "직전 응답의 tr_cont_key 를 그대로 넣습니다. 첫 조회에는 넣지 않습니다.\n\n값 오른쪽에 공백이 붙어 내려오는 경우가 있습니다. 잘라내지 말고 URL 인코딩하여 원본 그대로 보내십시오. (query string)", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "목록", "type" : "Object Array", "required" : "Y", "length" : "-", "description" : "조회 결과 배열입니다.", "depth" : 0 }, { "element" : "deal_date", "name" : "매매일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "매매가 일어난 일자입니다. YYYYMMDD 8자리.", "depth" : 0 }, { "element" : "byov_amt", "name" : "매수금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "해당 일자의 매수 체결금액 합계입니다.", "depth" : 0 }, { "element" : "seln_amt", "name" : "매도금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "해당 일자의 매도 체결금액 합계입니다.", "depth" : 0 }, { "element" : "deal_fee", "name" : "매매수수료", "type" : "Number", "required" : "Y", "length" : "19", "description" : "매매수수료 합계입니다. 매수분과 매도분을 더한 값입니다.", "depth" : 0 }, { "element" : "wtax_amt", "name" : "제세금금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "제세금입니다. 매도 시에만 발생합니다.", "depth" : 0 }, { "element" : "prls_amt", "name" : "손익금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "실현손익 금액입니다. 매도가 있는 날에만 채워집니다. 음수는 손실입니다.", "depth" : 0 }, { "element" : "plrt", "name" : "손익률", "type" : "Number", "required" : "Y", "length" : "23", "description" : "실현손익률(%)이며 손실이면 음수입니다.", "depth" : 0 }, { "element" : "byov_deal_fee", "name" : "매수매매수수료", "type" : "Number", "required" : "Y", "length" : "19", "description" : "매수에 부과된 매매수수료입니다.", "depth" : 0 }, { "element" : "seln_deal_fee", "name" : "매도매매수수료", "type" : "Number", "required" : "Y", "length" : "19", "description" : "매도에 부과된 매매수수료입니다.", "depth" : 0 }, { "element" : "loan_int", "name" : "대출이자", "type" : "Number", "required" : "Y", "length" : "19", "description" : "신용 거래의 대출이자입니다.", "depth" : 0 }, { "element" : "deal_trtx", "name" : "매매거래세", "type" : "Number", "required" : "Y", "length" : "19", "description" : "세금 항목입니다.\n\n같은 행의 제세금금액(wtax_amt)과 같은 값이 내려옵니다. 두 항목을 더해 세금 합계를 만드시면 두 배가 되므로 둘 중 하나만 쓰십시오.", "depth" : 0 }, { "element" : "deal_fee_amt", "name" : "매매수수료금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "실현손익 계산에서 차감되는 매매 비용입니다. 매도수수료(seln_deal_fee)와는 별개 항목입니다. 매매수수료(deal_fee)는 매수·매도 수수료의 합이므로 매도수수료와 같은 값이 아닙니다.", "depth" : 0 }, { "element" : "cntg_stnd_byng_amt", "name" : "체결기준매입금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "체결 기준 매입금액입니다. 매도한 수량의 취득원가이며, 실현손익은 매도금액에서 이 값과 비용을 뺀 것입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 응답 코드입니다.\n\"5766\": 조회 완료 · \"5820\": 조회할 자료 없음\n오류 응답 본문에는 data 와 tr_cont 가 없으므로 rsp_cd 를 먼저 확인한 뒤 data 를 읽으십시오.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 이 값에 담깁니다.\n오류 응답에는 data 와 tr_cont 가 없으므로 rsp_cd 를 먼저 확인한 뒤 data 를 읽으십시오.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "다음 페이지가 남아 있으면 \"1\", 마지막이면 \"0\"입니다.", "depth" : 0 }, { "element" : "tr_cont_key", "name" : "연속조회 키", "type" : "String", "required" : "N", "length" : "20", "description" : "마지막 페이지(tr_cont 가 \"0\")와 오류 응답에는 이 항목 자체가 없습니다.\n\n다음 페이지를 요청하실 때는 직전 응답의 값을 그대로 넣으십시오. 값 오른쪽에 공백이 붙어 내려오는 경우가 있으니 잘라내지 마십시오.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "응답에 덧붙는 상세 사유입니다. 값이 없으면 응답에서 이 항목 자체가 빠집니다.", "depth" : 0 } ] }, "requestExample" : "GET /accounts/v1/me/profit-loss?iqry_sta_date=20250101&iqry_fin_date=20260911\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": [\n {\n \"deal_date\": \"20260827\",\n \"byov_amt\": 3306300,\n \"seln_amt\": 0,\n \"deal_fee\": 8550,\n \"wtax_amt\": 0,\n \"prls_amt\": 0,\n \"plrt\": 0.0,\n \"byov_deal_fee\": 8550,\n \"seln_deal_fee\": 0,\n \"loan_int\": 0,\n \"deal_trtx\": 0,\n \"deal_fee_amt\": 0,\n \"cntg_stnd_byng_amt\": 0\n },\n {\n \"deal_date\": \"20260820\",\n \"byov_amt\": 1120000,\n \"seln_amt\": 0,\n \"deal_fee\": 5579,\n \"wtax_amt\": 0,\n \"prls_amt\": 0,\n \"plrt\": 0.0,\n \"byov_deal_fee\": 5579,\n \"seln_deal_fee\": 0,\n \"loan_int\": 0,\n \"deal_trtx\": 0,\n \"deal_fee_amt\": 0,\n \"cntg_stnd_byng_amt\": 0\n }\n ],\n \"rsp_cd\": \"5766\",\n \"rsp_msg\": \"조회가 완료되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "국내주식 실현손익 (종목별)", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/accounts/v1/me/profit-loss/symbols", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "접근토큰에 매핑된 계좌의 국내주식 실현손익을 종목별로 조회합니다.", "trs" : [ { "name" : "국내주식 실현손익 (종목별)", "code" : "obtrs_cntg_540r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "iqry_sta_date", "name" : "조회시작일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "조회 시작일자를 YYYYMMDD 형식 여덟 자리로 입력합니다.\n\n반드시 넣으셔야 합니다.\n\n종료일자보다 뒤로 넣으셔도 오류가 나지 않습니다. 이때는 조회 완료와 같은 모양으로 0건이 내려오고, 앞뒤가 바뀌었다는 사실은 응답의 상세 메시지(rsp_sub_msg)에만 담깁니다. 자료가 없어서 0건인 것과 구분하시려면 그 값을 함께 확인하십시오.\n\n기간 앞을 열어 두고 싶으시면 \"00000000\" 을 넣으십시오. 계좌의 처음부터 조회됩니다. (query string)", "depth" : 0 }, { "element" : "iqry_fin_date", "name" : "조회종료일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "조회 종료일자(YYYYMMDD 여덟 자리)입니다. 반드시 넣으십시오. (query string)", "depth" : 0 }, { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "N", "length" : "12", "description" : "종목 코드입니다. \"A\" + 단축코드 6자리 12자리로 넣으십시오.\n넣지 않으시면 전 종목을 조회합니다. (query string)", "depth" : 0 }, { "element" : "crdt_expn_incu_yn", "name" : "신용비용포함여부", "type" : "String", "required" : "N", "length" : "1", "description" : "신용 비용 포함 여부입니다. \"Y\" 또는 \"N\" 을 넣으십시오. (query string)", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "N", "length" : "1", "description" : "다음 페이지를 요청할 때 \"1\"을 넣습니다. 첫 조회에는 넣지 않습니다. (query string)", "depth" : 0 }, { "element" : "tr_cont_key", "name" : "연속조회 키", "type" : "String", "required" : "N", "length" : "20", "description" : "직전 응답의 tr_cont_key 를 받은 그대로 넣습니다. 첫 조회에는 넣지 않습니다. 값 오른쪽에 공백이 붙어 내려오는 경우가 있으니 잘라내지 마십시오. (query string)", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "목록", "type" : "Object Array", "required" : "Y", "length" : "-", "description" : "조회 결과 배열입니다.", "depth" : 0 }, { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "종목 코드입니다. 앞에 \"A\"(주식) 접두어가 붙어 내려옵니다. (예: \"A005930\")", "depth" : 0 }, { "element" : "isnm", "name" : "종목명", "type" : "String", "required" : "Y", "length" : "100", "description" : "종목명입니다. (예: \"동화약품\")", "depth" : 0 }, { "element" : "prls_amt", "name" : "손익금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "조회 기간 중 해당 종목의 실현손익 금액입니다. 음수는 손실입니다.", "depth" : 0 }, { "element" : "plrt", "name" : "손익률", "type" : "Number", "required" : "Y", "length" : "23", "description" : "해당 종목의 실현손익률(%)이며 손실이면 음수입니다.", "depth" : 0 }, { "element" : "byov_deal_fee", "name" : "매수매매수수료", "type" : "Number", "required" : "Y", "length" : "19", "description" : "매수에 부과된 매매수수료입니다.", "depth" : 0 }, { "element" : "seln_deal_fee", "name" : "매도매매수수료", "type" : "Number", "required" : "Y", "length" : "19", "description" : "매도에 부과된 매매수수료입니다.", "depth" : 0 }, { "element" : "loan_int", "name" : "대출이자", "type" : "Number", "required" : "Y", "length" : "19", "description" : "신용 거래의 대출이자입니다.", "depth" : 0 }, { "element" : "wtax_amt", "name" : "제세금금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "제세금입니다. 매도 시에만 발생합니다.", "depth" : 0 }, { "element" : "byov_stpl_amt", "name" : "매수약정금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "기간 중 매수 약정금액 합계입니다.", "depth" : 0 }, { "element" : "seln_stpl_amt", "name" : "매도약정금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "기간 중 매도 약정금액 합계입니다.", "depth" : 0 }, { "element" : "cntg_stnd_byng_amt", "name" : "체결기준매입금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "체결 기준 매입금액입니다. 매도한 수량의 취득원가이며, 실현손익은 매도금액에서 이 값과 비용을 뺀 것입니다.", "depth" : 0 }, { "element" : "deal_fee_amt", "name" : "매매수수료금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "실현손익 계산에서 차감되는 매매 비용입니다. 같은 응답의 매도수수료(seln_deal_fee)와는 별개 항목입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 응답 코드입니다.\n\"5820\": 조회 완료 · \"0760\": 계좌에 이 조회 권한이 없음\n이 조회는 자료가 있어도 \"5820\" 이 내려옵니다. 응답 메시지는 \"조회할 내역(자료)이 없습니다.\" 이지만 data 배열에는 종목이 채워져 있습니다. 자료 유무는 응답 코드가 아니라 data 배열의 길이로 판정하십시오.\n같은 조건에서 일자별 조회(/accounts/v1/me/profit-loss)는 자료가 있으면 \"5766\" 이므로 두 조회의 판정 코드를 돌려 쓰지 마십시오. 오류는 HTTP 500 으로 반환됩니다.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 이 값에 담깁니다.\n오류 응답에는 data 와 tr_cont 가 없으므로 rsp_cd 를 먼저 확인한 뒤 data 를 읽으십시오.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "다음 페이지가 남아 있으면 \"1\", 마지막이면 \"0\"입니다.", "depth" : 0 }, { "element" : "tr_cont_key", "name" : "연속조회 키", "type" : "String", "required" : "N", "length" : "20", "description" : "마지막 페이지(tr_cont 가 \"0\")와 오류 응답에는 이 항목 자체가 없습니다.\n\n다음 페이지를 요청하실 때는 직전 응답의 값을 그대로 넣으십시오. 값 오른쪽에 공백이 붙어 내려오는 경우가 있으니 잘라내지 마십시오.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "응답에 덧붙는 상세 사유입니다.\n\n오류 응답에만 담기는 것이 아닙니다. 이 조회는 자료가 있을 때에도 응답코드가 \"5820\" 으로 내려오는데, 조회시작일자를 조회종료일자보다 뒤로 넣으신 경우에는 같은 \"5820\" 에 0건이 내려오면서 이 항목에 \"종료일자보다 클 수 없습니다.\" 가 담깁니다.\n\n그러므로 0건을 받으셨을 때에는 이 항목이 비어 있는지 함께 확인하십시오. 값이 없으면 응답에서 이 항목 자체가 빠집니다.", "depth" : 0 } ] }, "requestExample" : "GET /accounts/v1/me/profit-loss/symbols?iqry_sta_date=20250101&iqry_fin_date=20260911\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": [\n {\n \"iscd\": \"A000020\",\n \"isnm\": \"동화약품\",\n \"prls_amt\": 0,\n \"plrt\": 0.0,\n \"byov_deal_fee\": 279,\n \"seln_deal_fee\": 0,\n \"loan_int\": 0,\n \"wtax_amt\": 0,\n \"byov_stpl_amt\": 141240,\n \"seln_stpl_amt\": 0,\n \"cntg_stnd_byng_amt\": 0,\n \"deal_fee_amt\": 0\n },\n {\n \"iscd\": \"A000070\",\n \"isnm\": \"삼양홀딩스\",\n \"prls_amt\": -4636,\n \"plrt\": -4.14,\n \"byov_deal_fee\": 110,\n \"seln_deal_fee\": 1114,\n \"loan_int\": 0,\n \"wtax_amt\": 162,\n \"byov_stpl_amt\": 55900,\n \"seln_stpl_amt\": 108600,\n \"cntg_stnd_byng_amt\": 111960,\n \"deal_fee_amt\": 0\n }\n ],\n \"rsp_cd\": \"5820\",\n \"rsp_msg\": \"조회할 내역(자료)이 없습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "국내주식 실현손익 (합계)", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/accounts/v1/me/profit-loss/summary", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "접근토큰에 매핑된 계좌의 국내주식 실현손익을 조회 기간 합계 한 건으로 조회합니다.", "trs" : [ { "name" : "국내주식 실현손익 (합계)", "code" : "obtrs_cntg_537r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "iqry_sta_date", "name" : "조회시작일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "조회 시작일자를 YYYYMMDD 형식 여덟 자리로 입력합니다.\n\n반드시 넣으셔야 합니다.\n\n시작일자를 종료일자보다 뒤로 넣으셔도 오류가 나지 않습니다. 이때 응답코드는 조회 완료와 같은 \"5766\" 이고 합계의 모든 금액이 0 으로 채워져 내려오므로, 기간을 거꾸로 넣으신 것과 그 기간에 매매가 없었던 것이 응답으로 구분되지 않습니다. 보내시기 전에 두 일자의 앞뒤를 확인하십시오.\n\n기간 앞을 열어 두고 싶으시면 \"00000000\" 을 넣으십시오. 계좌의 처음부터 합산됩니다. (query string)", "depth" : 0 }, { "element" : "iqry_fin_date", "name" : "조회종료일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "조회 종료일자를 YYYYMMDD 형식 여덟 자리로 입력합니다.\n\n반드시 넣으셔야 합니다.\n\n이 항목에 \"00000000\" 을 넣지 마십시오. 시작일자보다 작아져 합계가 모두 0 으로 내려옵니다. (query string)", "depth" : 0 }, { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "N", "length" : "12", "description" : "종목 코드입니다. \"A\" + 단축코드 6자리 12자리로 넣으십시오.\n넣지 않으시면 전 종목을 조회합니다. (query string)", "depth" : 0 }, { "element" : "crdt_expn_incu_yn", "name" : "신용비용포함여부", "type" : "String", "required" : "N", "length" : "1", "description" : "신용 비용 포함 여부입니다. \"Y\" 또는 \"N\" 을 넣으십시오. (query string)", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "DATA", "type" : "Object", "required" : "Y", "length" : "-", "description" : "조회 기간의 실현손익 합계 한 건입니다. 매도금액·매수금액·제비용과 실현손익, 수익률이 들어 있습니다.", "depth" : 0 }, { "element" : "seln_amt", "name" : "매도금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "매도 체결금액입니다.", "depth" : 0 }, { "element" : "byov_amt", "name" : "매수금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "매수 체결금액입니다.", "depth" : 0 }, { "element" : "deal_fee", "name" : "매매수수료", "type" : "Number", "required" : "Y", "length" : "19", "description" : "매매수수료 합계입니다. 매수분과 매도분을 더한 값입니다.", "depth" : 0 }, { "element" : "wtax_amt", "name" : "제세금금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "제세금입니다. 매도 시에만 발생합니다.", "depth" : 0 }, { "element" : "prls_amt", "name" : "손익금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "실현손익 금액입니다. 매도금액에서 체결기준매입금액(cntg_stnd_byng_amt)과 수수료·세금을 뺀 값이며 손실이면 음수입니다.", "depth" : 0 }, { "element" : "plrt", "name" : "손익률", "type" : "Number", "required" : "Y", "length" : "23", "description" : "조회 기간 전체의 실현손익률(%)이며 손실이면 음수입니다. 실현손익금액(prls_amt)을 체결기준매입금액(cntg_stnd_byng_amt)으로 나눈 값입니다.", "depth" : 0 }, { "element" : "byov_deal_fee", "name" : "매수매매수수료", "type" : "Number", "required" : "Y", "length" : "19", "description" : "매수에 부과된 매매수수료입니다.", "depth" : 0 }, { "element" : "seln_deal_fee", "name" : "매도매매수수료", "type" : "Number", "required" : "Y", "length" : "19", "description" : "매도에 부과된 매매수수료입니다.", "depth" : 0 }, { "element" : "loan_int", "name" : "대출이자", "type" : "Number", "required" : "Y", "length" : "19", "description" : "신용 거래의 대출이자입니다.", "depth" : 0 }, { "element" : "deal_fee_amt", "name" : "매매수수료금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "실현손익 계산에서 차감되는 매매 비용입니다. 매도수수료(seln_deal_fee)와는 별개 항목입니다. 매매수수료(deal_fee)는 매수·매도 수수료의 합이므로 매도수수료와 같은 값이 아닙니다.", "depth" : 0 }, { "element" : "deal_trtx", "name" : "매매거래세", "type" : "Number", "required" : "Y", "length" : "19", "description" : "조회 기간 전체의 세금 합계입니다.\n같은 응답의 제세금금액(wtax_amt)과 같은 값입니다. 두 항목을 더해 세금 합계를 만들면 두 배가 되므로 둘 중 하나만 쓰십시오.", "depth" : 0 }, { "element" : "cntg_stnd_byng_amt", "name" : "체결기준매입금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "체결 기준 매입금액입니다. 매도한 수량의 취득원가이며, 실현손익은 매도금액에서 이 값과 비용을 뺀 것입니다.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "항상 \"0\"으로 내려옵니다. 이 API는 연속조회를 지원하지 않습니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 응답 코드입니다. 성공 코드는 \"5766\" 입니다. API 마다 성공 코드가 다르므로 \"0000\" 만으로 성공을 판정하지 마십시오.\n오류는 종류와 무관하게 HTTP 500 으로 내려옵니다. \"EGW00200\" 은 초당 호출 한도를 넘긴 경우이므로 잠시 뒤 다시 보내십시오.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 이 값에 담깁니다. 정상일 때는 처리 결과 문구가 옵니다.", "depth" : 0 } ] }, "requestExample" : "GET /accounts/v1/me/profit-loss/summary?iqry_sta_date=20250101&iqry_fin_date=20260911\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": {\n \"seln_amt\": 1360220,\n \"byov_amt\": 174536740,\n \"deal_fee\": 406649,\n \"wtax_amt\": 2557,\n \"prls_amt\": 231201,\n \"plrt\": 20.7,\n \"byov_deal_fee\": 397207,\n \"seln_deal_fee\": 9442,\n \"loan_int\": 0,\n \"deal_fee_amt\": 132,\n \"deal_trtx\": 2557,\n \"cntg_stnd_byng_amt\": 1116888\n },\n \"rsp_cd\": \"5766\",\n \"rsp_msg\": \"조회가 완료되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "시세추이 조회(일봉)", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/market/v1/candles/days", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "국내주식 한 종목의 일별 시세를 최근 일자부터 조회합니다.", "trs" : [ { "name" : "주식 시세추이 조회 (일봉)", "code" : "ohhts_1002_003r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "mrkt_div_code", "name" : "시장 구분 코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "어느 시장의 시세를 볼지 정합니다.\n\"J\": KRX\n\"NJ\": 대체거래소(NXT)\n\"TJ\": KRX + NXT 통합\n\n위 세 값만 넣으십시오. NXT 에 상장되지 않은 종목을 \"NJ\" 로 조회하면 오류 없이 빈 배열이 내려옵니다.", "depth" : 0 }, { "element" : "exch_use_yn", "name" : "종가 기준 구분", "type" : "String", "required" : "N", "length" : "1", "description" : "종가를 어느 기준으로 받을지 정합니다. 넣지 않으면 \"Y\" 로 조회합니다.\n\"Y\": KRX 정규장 종가\n\"N\": 애프터마켓(~20:00)까지 포함한 그날의 마지막 체결가\n\n정규장 종가는 mrkt_div_code \"TJ\" 와 \"Y\" 를 함께 넣을 때만 내려옵니다. \"J\"·\"NJ\" 에서는 \"Y\" 와 \"N\" 의 결과가 같아서, \"J\" 에 \"Y\" 를 넣어도 애프터마켓까지 포함한 값이 내려옵니다. \"TJ\" 에서 \"Y\" 와 \"N\" 은 시가·고가·저가·종가·전일대비가 달라지고 거래량·거래대금은 같습니다.", "depth" : 0 }, { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "종목 코드입니다. 6자리(005930) 또는 A 를 붙인 7자리(A005930)로 넣습니다.", "depth" : 0 }, { "element" : "mod_stpr_cls_code", "name" : "수정주가구분코드", "type" : "String", "required" : "N", "length" : "3", "description" : "수정주가 구분입니다. \"0\" 또는 \"1\" 을 넣습니다.\n0:수정종각 (기본값)\n1:원종가", "depth" : 0 }, { "element" : "from", "name" : "조회 시작일자", "type" : "String", "required" : "N", "length" : "8", "description" : "조회 시작일자입니다. YYYYMMDD 8자리이며 to 와 함께 넣으면 그 기간의 일봉이 내려오고, 기간은 최대 1년입니다.\n기간 조회는 from 과 to 를 함께 넣어야 합니다. from 만 넣으면 그 날짜부터 과거 방향으로 40건, 둘 다 없으면 최신 40건이 내려옵니다.", "depth" : 0 }, { "element" : "to", "name" : "조회 종료일자", "type" : "String", "required" : "N", "length" : "8", "description" : "조회 종료일자입니다. YYYYMMDD 8자리이며 from 과 함께 넣습니다. to 만 넣으면 무시되고 최신 40건이 내려옵니다.", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "일봉 목록", "type" : "Object Array", "required" : "Y", "length" : "-", "description" : "일봉 배열입니다. 최신 일자가 먼저 오며, from·to 를 넣지 않으면 최신 40건이 내려옵니다.", "depth" : 0 }, { "element" : "date", "name" : "일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "일자(YYYYMMDD)", "depth" : 0 }, { "element" : "oprc", "name" : "시가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "당일 첫 체결 가격(시가)입니다.", "depth" : 0 }, { "element" : "hprc", "name" : "고가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "당일 장중 가장 높았던 체결 가격(고가)입니다.", "depth" : 0 }, { "element" : "lprc", "name" : "저가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "당일 장중 가장 낮았던 체결 가격(저가)입니다.", "depth" : 0 }, { "element" : "stck_clpr", "name" : "주식종가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "요청한 시장 구분과 종가 기준에 따른 종가입니다. 정규장 종가는 mrkt_div_code \"TJ\" 이고 exch_use_yn 이 \"Y\"(기본)일 때입니다.", "depth" : 0 }, { "element" : "prdy_vrss_sign", "name" : "전일대비부호", "type" : "String", "required" : "Y", "length" : "2", "description" : "전일 대비 부호입니다.\n\"1\": 상한\n\"2\": 상승\n\"3\": 보합\n\"4\": 하한\n\"5\": 하락", "depth" : 0 }, { "element" : "prdy_vrss", "name" : "전일대비", "type" : "Number", "required" : "Y", "length" : "13", "description" : "요청한 종가 기준(exch_use_yn)의 종가에서 전일 정규장 종가(기준가)를 뺀 값입니다.", "depth" : 0 }, { "element" : "prdy_ctrt", "name" : "전일대비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "요청한 종가 기준(exch_use_yn)의 종가가 전일 정규장 종가(기준가) 대비 몇 % 변했는지를 나타내는 등락률(%)입니다.", "depth" : 0 }, { "element" : "acml_vol", "name" : "누적거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "장 시작부터 지금까지 체결된 주식 수를 모두 더한 값입니다. 개별 체결 수량이 아닙니다.", "depth" : 0 }, { "element" : "acml_tr_pbmn", "name" : "누적거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "해당 일자에 체결된 거래대금을 모두 더한 값입니다.", "depth" : 0 }, { "element" : "tday_rltv", "name" : "당일체결강도", "type" : "String", "required" : "Y", "length" : "12.2", "description" : "그날의 체결강도입니다. 소수 2자리 문자열로 내려옵니다.", "depth" : 0 }, { "element" : "d5_rltv", "name" : "5일체결강도", "type" : "String", "required" : "Y", "length" : "12.2", "description" : "최근 5거래일의 체결강도입니다. 소수 2자리 문자열입니다. (예: \"92.47\")", "depth" : 0 }, { "element" : "d20_rltv", "name" : "20일체결강도", "type" : "String", "required" : "Y", "length" : "12.2", "description" : "최근 20거래일의 체결강도입니다. 소수 2자리 문자열입니다.", "depth" : 0 }, { "element" : "d60_rltv", "name" : "60일체결강도", "type" : "String", "required" : "Y", "length" : "12.2", "description" : "최근 60거래일의 체결강도입니다. 소수 2자리 문자열입니다.", "depth" : 0 }, { "element" : "d120_rltv", "name" : "120일체결강도", "type" : "String", "required" : "Y", "length" : "12.2", "description" : "최근 120거래일의 체결강도입니다. 소수 2자리 문자열입니다.", "depth" : 0 }, { "element" : "d240_rltv", "name" : "240일체결강도", "type" : "String", "required" : "Y", "length" : "12.2", "description" : "최근 240거래일의 체결강도입니다. 소수 2자리 문자열입니다.", "depth" : 0 }, { "element" : "d360_rltv", "name" : "360일체결강도", "type" : "String", "required" : "Y", "length" : "12.2", "description" : "최근 360거래일의 체결강도입니다. 소수 2자리 문자열입니다.", "depth" : 0 }, { "element" : "frgn_ntby_qty", "name" : "외국인순매수수량", "type" : "Number", "required" : "Y", "length" : "13", "description" : "외국인 순매수 수량입니다. 매수에서 매도를 뺀 값이며 음수는 순매도입니다. 기관은 orgn_ntby_vol 입니다.", "depth" : 0 }, { "element" : "orgn_ntby_vol", "name" : "기관순매수거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "기관 순매수 수량. 음수는 순매도입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 성공 응답 코드입니다. \"0000\" 이 정상입니다.\n결과가 없을 때도 \"0000\" 과 빈 배열이 내려옵니다. 오류는 HTTP 500 으로 반환되므로 성공·실패는 이 값으로 판정하십시오.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 담깁니다. 오류 응답에는 data 가 없으니 rsp_cd 를 먼저 확인한 뒤 data 를 읽으십시오.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "오류일 때 조치 정보가 담기는 항목입니다.", "depth" : 0 } ] }, "requestExample" : "GET /market/v1/candles/days?mrkt_div_code=TJ&iscd=005930\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": [\n {\n \"date\": \"20260910\",\n \"oprc\": 6668000,\n \"hprc\": 12382000,\n \"lprc\": 6668000,\n \"stck_clpr\": 8389000,\n \"prdy_vrss_sign\": \"5\",\n \"prdy_vrss\": -1136000,\n \"prdy_ctrt\": \"-11.93\",\n \"acml_vol\": 8356,\n \"acml_tr_pbmn\": 70755998000,\n \"tday_rltv\": \"296.96\",\n \"d5_rltv\": \"98.78\",\n \"d20_rltv\": \"112.80\",\n \"d60_rltv\": \"103.67\",\n \"d120_rltv\": \"103.19\",\n \"d240_rltv\": \"104.97\",\n \"d360_rltv\": \"106.53\",\n \"frgn_ntby_qty\": 0,\n \"orgn_ntby_vol\": 0\n },\n {\n \"date\": \"20260909\",\n \"oprc\": 9525000,\n \"hprc\": 9525000,\n \"lprc\": 5129000,\n \"stck_clpr\": 7650000,\n \"prdy_vrss_sign\": \"2\",\n \"prdy_vrss\": 323000,\n \"prdy_ctrt\": \"4.41\",\n \"acml_vol\": 356371,\n \"acml_tr_pbmn\": 3157912575500,\n \"tday_rltv\": \"34.88\",\n \"d5_rltv\": \"42.34\",\n \"d20_rltv\": \"104.03\",\n \"d60_rltv\": \"100.73\",\n \"d120_rltv\": \"101.38\",\n \"d240_rltv\": \"104.22\",\n \"d360_rltv\": \"106.27\",\n \"frgn_ntby_qty\": -24752,\n \"orgn_ntby_vol\": -191600\n }\n ],\n \"rsp_cd\": \"0000\",\n \"rsp_msg\": \"정상 처리 되었습니다.\"\n}" } ] }, { "name" : "시세추이 조회(분봉)", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/market/v1/candles/minutes", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "국내주식 한 종목의 분봉을 조회합니다", "trs" : [ { "name" : "주식 시세추이 조회 (분봉)", "code" : "ohhts_kapi_005r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "mrkt_div_code", "name" : "시장 구분 코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "어느 시장의 시세를 볼지 정합니다.\n\"J\": KRX\n\"NJ\": 대체거래소(NXT)\n\"TJ\": KRX + NXT 통합", "depth" : 0 }, { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "종목 코드입니다. 6자리(005930) 또는 A 를 붙인 7자리(A005930)로 넣으십시오.\n형식이 맞지 않는 코드는 오류 없이 정상 응답코드로 처리될 수 있으며, 예를 들어 뒤에 문자가 붙은 \"A005930ZZZZZ\" 는 봉이 한 건만 내려옵니다. 결과가 비어 있거나 건수가 적으면 종목 코드부터 확인하십시오.", "depth" : 0 }, { "element" : "hour_cls_code", "name" : "봉 간격", "type" : "String", "required" : "Y", "length" : "6", "description" : "봉 간격을 초 단위로 입력합니다. 15는 15초, 60은 1분, 3600은 1시간입니다. 반드시 넣으십시오.\n해외는 해외주식 시세추이 조회(분봉)(/market/v1/overseas/candles/minutes)을 사용하십시오.", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "분봉 목록", "type" : "Object Array", "required" : "Y", "length" : "-", "description" : "분봉 배열입니다. 최신 봉이 먼저 오며 한 번에 40건까지 내려오고, 응답에 연속조회 키(tr_cont_key)는 담기지 않습니다.\n장 마감 뒤 과거 구간은 시세추이 조회(일봉)(/market/v1/candles/days)을 쓰십시오.", "depth" : 0 }, { "element" : "cntg_hour", "name" : "체결시간", "type" : "String", "required" : "Y", "length" : "6", "description" : "그 봉 구간의 시각입니다. HHMMSS 여섯 자리로 내려옵니다.", "depth" : 0 }, { "element" : "stck_prpr", "name" : "주식현재가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "가장 최근 체결된 가격입니다.", "depth" : 0 }, { "element" : "tday_rltv", "name" : "당일체결강도", "type" : "String", "required" : "Y", "length" : "9", "description" : "당일 체결강도(%)입니다.", "depth" : 0 }, { "element" : "acml_vol", "name" : "누적거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "장 시작부터 지금까지 체결된 주식 수를 모두 더한 값입니다. 개별 체결 수량이 아닙니다.", "depth" : 0 }, { "element" : "cntg_vol", "name" : "체결거래량", "type" : "Number", "required" : "Y", "length" : "13", "description" : "해당 구간의 체결 수량", "depth" : 0 }, { "element" : "oprc", "name" : "시가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "그 봉 구간에서 처음 체결된 가격(시가)입니다.", "depth" : 0 }, { "element" : "hprc", "name" : "고가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "그 봉 구간에서 체결된 가격 가운데 가장 높은 값(고가)입니다.", "depth" : 0 }, { "element" : "lprc", "name" : "저가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "그 봉 구간에서 체결된 가격 가운데 가장 낮은 값(저가)입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 성공 응답 코드는 \"0000\" 입니다.\n조회 결과가 없을 때도 \"0000\" 과 빈 배열이 내려오므로 결과 건수로 확인하십시오.\n오류는 종류와 무관하게 HTTP 500 으로 반환되므로, 성공·실패는 HTTP 상태가 아니라 이 값으로 판정하십시오.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 담기며, 조치 정보가 있으면 rsp_sub_msg 에 담깁니다.\n오류 응답에는 data 와 tr_cont 가 없으므로 rsp_cd 를 먼저 확인한 뒤 data 를 읽으십시오.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "오류일 때 조치 정보가 담기는 항목입니다.", "depth" : 0 } ] }, "requestExample" : "GET /market/v1/candles/minutes?mrkt_div_code=J&iscd=000660&hour_cls_code=15\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": [\n {\n \"cntg_hour\": \"180800\",\n \"stck_prpr\": 4486000,\n \"tday_rltv\": \"4.12\",\n \"acml_vol\": 56361,\n \"cntg_vol\": 2,\n \"oprc\": 4486000,\n \"hprc\": 4486000,\n \"lprc\": 4486000\n },\n {\n \"cntg_hour\": \"174800\",\n \"stck_prpr\": 4486000,\n \"tday_rltv\": \"4.12\",\n \"acml_vol\": 56359,\n \"cntg_vol\": 275,\n \"oprc\": 4486000,\n \"hprc\": 4486000,\n \"lprc\": 4486000\n }\n ],\n \"rsp_cd\": \"0000\",\n \"rsp_msg\": \"정상 처리 되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "종목별 투자자매매동향", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/market/v1/investors", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "국내주식 한 종목의 일자별 투자자 매매동향을 조회합니다.", "trs" : [ { "name" : "국내주식 투자자매매동향", "code" : "ohhts_1085_001r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "mrkt_div_code", "name" : "시장 구분 코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "시장 구분입니다.\n\"J\": KRX\n\"NJ\": 대체거래소(NXT)\n\"TJ\": KRX + NXT 통합\n\"TJ\" 로 조회해도 \"J\"(KRX)와 같은 자료가 내려옵니다.\n위 세 값만 넣으십시오. (query string)", "depth" : 0 }, { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "종목 코드입니다. 6자리(005930) 또는 A 를 붙인 7자리(A005930)로 넣으십시오.", "depth" : 0 }, { "element" : "from", "name" : "조회 시작일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "조회 시작일자를 YYYYMMDD 8자리 숫자로 넣으십시오. (예: 20260901)\n필수 항목입니다. 받은 자료가 요청한 기간인지 date 로 확인하십시오. (query string)", "depth" : 0 }, { "element" : "to", "name" : "조회 종료일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "조회 종료일자를 YYYYMMDD 8자리 숫자로 넣으십시오. (예: 20260911)\n필수 항목입니다. 받은 자료가 요청한 기간인지 date 로 확인하십시오. (query string)", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "N", "length" : "1", "description" : "연속조회 여부입니다. 이 API 는 기간 전체가 한 번에 내려오며 응답에 tr_cont 가 담기지 않습니다. 값을 넣어 조회하면 빈 배열이 내려오므로 넣지 마십시오. (query string)", "depth" : 0 }, { "element" : "tr_cont_key", "name" : "연속조회 키", "type" : "String", "required" : "N", "length" : "20", "description" : "연속조회 키입니다. 이 API 는 응답에 연속조회 키가 내려오지 않으므로 보낼 필요가 없으며, tr_cont 와 함께 보내면 빈 배열이 내려옵니다. (query string)", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "목록", "type" : "Object Array", "required" : "Y", "length" : "-", "description" : "조회 결과 배열입니다. 최근 일자가 먼저 옵니다.\n요청한 시작일까지 받았는지는 목록 마지막 행의 date 로 확인하십시오.", "depth" : 0 }, { "element" : "date", "name" : "일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "일자입니다. YYYYMMDD 8자리이며 최근 일자가 먼저 옵니다.", "depth" : 0 }, { "element" : "stck_prpr", "name" : "주식현재가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "가장 최근 체결된 가격입니다.", "depth" : 0 }, { "element" : "prdy_vrss", "name" : "전일대비", "type" : "Number", "required" : "Y", "length" : "13", "description" : "전일 종가 대비 등락폭입니다.", "depth" : 0 }, { "element" : "prdy_vrss_sign", "name" : "전일대비부호", "type" : "String", "required" : "Y", "length" : "2", "description" : "등락 부호입니다.\n\"1\" 상한 · \"2\" 상승 · \"3\" 보합 · \"4\" 하한 · \"5\" 하락", "depth" : 0 }, { "element" : "prdy_ctrt", "name" : "전일대비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "전일 종가 대비 등락률입니다. 단위는 퍼센트.", "depth" : 0 }, { "element" : "prsn_ntby_vol", "name" : "개인순매수거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "개인의 순매수 거래량입니다. 매수 거래량에서 매도 거래량을 뺀 값이며, 음수는 순매도입니다.", "depth" : 0 }, { "element" : "frgn_ntby_vol", "name" : "외국인순매수거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "외국인의 순매수 거래량입니다. 매수 거래량에서 매도 거래량을 뺀 값이며, 음수는 순매도입니다.", "depth" : 0 }, { "element" : "orgn_ntby_vol", "name" : "기관순매수거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "기관의 순매수 거래량입니다. 매수 거래량에서 매도 거래량을 뺀 값이며, 음수는 순매도입니다.", "depth" : 0 }, { "element" : "prsn_ntby_tr_pbmn", "name" : "개인순매수거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "개인의 순매수 거래대금입니다. 매수 거래대금에서 매도 거래대금을 뺀 값이며, 음수는 순매도입니다.", "depth" : 0 }, { "element" : "frgn_ntby_tr_pbmn", "name" : "외국인순매수거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "외국인의 순매수 거래대금입니다. 매수 거래대금에서 매도 거래대금을 뺀 값이며, 음수는 순매도입니다.", "depth" : 0 }, { "element" : "orgn_ntby_tr_pbmn", "name" : "기구순매수거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "기관의 순매수 거래대금입니다. 매수 거래대금에서 매도 거래대금을 뺀 값이며, 음수는 순매도입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 성공 응답 코드는 \"0000\" 입니다.\n조회 결과가 없을 때도 \"0000\" 과 빈 배열이 내려오므로 결과 건수로 확인하십시오.\n오류는 종류와 무관하게 HTTP 500 으로 반환되므로, 성공·실패는 HTTP 상태가 아니라 이 값으로 판정하십시오.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 담기며, 조치 정보가 있으면 rsp_sub_msg 에 담깁니다.\n오류 응답에는 data 와 tr_cont 가 없으므로 rsp_cd 를 먼저 확인한 뒤 data 를 읽으십시오.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "N", "length" : "1", "description" : "이 API 는 연속조회를 지원하지 않습니다. 응답에 이 항목이 담기지 않습니다.", "depth" : 0 }, { "element" : "tr_cont_key", "name" : "연속조회 키", "type" : "String", "required" : "N", "length" : "20", "description" : "이 API 는 연속조회를 지원하지 않아 응답에 연속조회 키가 담기지 않습니다.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "오류일 때 조치 정보가 담기는 항목입니다.", "depth" : 0 } ] }, "requestExample" : "GET /market/v1/investors?mrkt_div_code=J&iscd=A005930&from=20260901&to=20260911\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": [\n {\n \"date\": \"20260910\",\n \"stck_prpr\": 1263000,\n \"prdy_vrss\": 1000,\n \"prdy_vrss_sign\": \"2\",\n \"prdy_ctrt\": \"0.08\",\n \"prsn_ntby_vol\": -2057529,\n \"frgn_ntby_vol\": -223832,\n \"orgn_ntby_vol\": -66491,\n \"prsn_ntby_tr_pbmn\": -2277305,\n \"frgn_ntby_tr_pbmn\": 147905,\n \"orgn_ntby_tr_pbmn\": -45443\n },\n {\n \"date\": \"20260909\",\n \"stck_prpr\": 692000,\n \"prdy_vrss\": -296000,\n \"prdy_vrss_sign\": \"4\",\n \"prdy_ctrt\": \"-29.96\",\n \"prsn_ntby_vol\": -2078110,\n \"frgn_ntby_vol\": -363198,\n \"orgn_ntby_vol\": 93428,\n \"prsn_ntby_tr_pbmn\": -2306321,\n \"frgn_ntby_tr_pbmn\": -59411,\n \"orgn_ntby_tr_pbmn\": 190848\n }\n ],\n \"rsp_cd\": \"0000\",\n \"rsp_msg\": \"정상 처리 되었습니다.\"\n}" } ] }, { "name" : "종목별 투자자매매동향 상세", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/market/v1/investors/detail", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "국내주식 한 종목의 일자별 투자자 매매동향을 상세 구분으로 조회합니다.", "trs" : [ { "name" : "국내주식 투자자매매동향 상세", "code" : "ohhts_1086_001r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "mrkt_div_code", "name" : "시장 구분 코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "시장 구분입니다. \"J\"(KRX)를 넣으십시오. (query string)", "depth" : 0 }, { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "종목 코드입니다. 6자리(005930) 또는 A 를 붙인 7자리(A005930)로 넣으십시오.", "depth" : 0 }, { "element" : "from", "name" : "조회 시작일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "조회 시작일자를 YYYYMMDD 8자리 숫자로 넣으십시오. (예: 20260901)\n필수 항목입니다. 지나치게 이른 시작일을 넣으면 응답이 오지 않을 수 있으니, 자료가 있는 구간으로 넣으십시오. (query string)", "depth" : 0 }, { "element" : "to", "name" : "조회 종료일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "조회 종료일자를 YYYYMMDD 8자리 숫자로 넣으십시오. (예: 20260911)\n필수 항목입니다. 받은 자료가 요청한 기간인지 date 로 확인하십시오. (query string)", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "N", "length" : "1", "description" : "연속조회 여부입니다. 이 API 는 기간 전체가 한 번에 내려오며 응답에 tr_cont 가 담기지 않습니다. 값을 넣어 조회하면 빈 배열이 내려오므로 넣지 마십시오. (query string)", "depth" : 0 }, { "element" : "tr_cont_key", "name" : "연속조회 키", "type" : "String", "required" : "N", "length" : "20", "description" : "연속조회 키입니다. 이 API 는 응답에 연속조회 키가 내려오지 않으므로 보낼 필요가 없으며, tr_cont 와 함께 보내면 빈 배열이 내려옵니다. (query string)", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "목록", "type" : "Object Array", "required" : "Y", "length" : "-", "description" : "조회 결과 배열입니다. 최근 일자가 먼저 옵니다.\n기간을 길게 잡아도 한 번에 모두 내려옵니다.\n지나치게 이른 시작일을 넣으면 응답이 오지 않을 수 있으니, 시작일을 자료가 있는 구간으로 당겨 호출하십시오.", "depth" : 0 }, { "element" : "date", "name" : "일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "일자입니다. YYYYMMDD 8자리이며 최근 일자가 먼저 옵니다.", "depth" : 0 }, { "element" : "stck_prpr", "name" : "주식현재가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "가장 최근 체결된 가격입니다.", "depth" : 0 }, { "element" : "prsn_ntby_vol", "name" : "개인순매수거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "개인의 순매수 거래량입니다. 매수 거래량에서 매도 거래량을 뺀 값이며, 음수는 순매도입니다.", "depth" : 0 }, { "element" : "frgn_ntby_vol", "name" : "외국인순매수거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "외국인의 순매수 거래량입니다. 매수 거래량에서 매도 거래량을 뺀 값이며, 음수는 순매도입니다.", "depth" : 0 }, { "element" : "orgn_ntby_vol", "name" : "기관순매수거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "기관의 순매수 거래량입니다. 매수 거래량에서 매도 거래량을 뺀 값이며, 음수는 순매도입니다.", "depth" : 0 }, { "element" : "fund_ntby_vol", "name" : "기금순매수거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "기금의 순매수 거래량입니다. 매수 거래량에서 매도 거래량을 뺀 값이며, 음수는 순매도입니다.", "depth" : 0 }, { "element" : "insu_ntby_vol", "name" : "보험순매수거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "보험의 순매수 거래량입니다. 매수 거래량에서 매도 거래량을 뺀 값이며, 음수는 순매도입니다.", "depth" : 0 }, { "element" : "bank_ntby_vol", "name" : "은행순매수거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "은행의 순매수 거래량입니다. 매수 거래량에서 매도 거래량을 뺀 값이며, 음수는 순매도입니다.", "depth" : 0 }, { "element" : "ivtr_ntby_vol", "name" : "투자신탁순매수거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "투자신탁의 순매수 거래량입니다. 매수 거래량에서 매도 거래량을 뺀 값이며, 음수는 순매도입니다.", "depth" : 0 }, { "element" : "mrbn_ntby_vol", "name" : "종금순매수거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "종금의 순매수 거래량입니다. 매수 거래량에서 매도 거래량을 뺀 값이며, 음수는 순매도입니다.", "depth" : 0 }, { "element" : "scrt_ntby_vol", "name" : "증권순매수거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "증권의 순매수 거래량입니다. 매수 거래량에서 매도 거래량을 뺀 값이며, 음수는 순매도입니다.", "depth" : 0 }, { "element" : "pe_fund_ntby_vol", "name" : "사모펀드순매수거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "사모펀드의 순매수 거래량입니다. 매수 거래량에서 매도 거래량을 뺀 값이며, 음수는 순매도입니다.", "depth" : 0 }, { "element" : "etc_corp_ntby_vol", "name" : "기타법인순매수거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "기타법인의 순매수 거래량입니다. 매수 거래량에서 매도 거래량을 뺀 값이며, 음수는 순매도입니다.", "depth" : 0 }, { "element" : "etc_orgt_ntby_vol", "name" : "기타단체순매수거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "기타단체의 순매수 거래량입니다. 매수 거래량에서 매도 거래량을 뺀 값이며 음수는 순매도입니다.", "depth" : 0 }, { "element" : "prsn_ntby_tr_pbmn", "name" : "개인순매수거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "개인의 순매수 거래대금입니다. 매수 거래대금에서 매도 거래대금을 뺀 값이며, 음수는 순매도입니다.", "depth" : 0 }, { "element" : "frgn_ntby_tr_pbmn", "name" : "외국인순매수거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "외국인의 순매수 거래대금입니다. 매수 거래대금에서 매도 거래대금을 뺀 값이며, 음수는 순매도입니다.", "depth" : 0 }, { "element" : "orgn_ntby_tr_pbmn", "name" : "기구순매수거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "기관의 순매수 거래대금입니다. 매수 거래대금에서 매도 거래대금을 뺀 값이며, 음수는 순매도입니다.", "depth" : 0 }, { "element" : "fund_ntby_tr_pbmn", "name" : "기금순매수거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "기금의 순매수 거래대금입니다. 매수 거래대금에서 매도 거래대금을 뺀 값이며, 음수는 순매도입니다.", "depth" : 0 }, { "element" : "insu_ntby_tr_pbmn", "name" : "보험순매수거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "보험의 순매수 거래대금입니다. 매수 거래대금에서 매도 거래대금을 뺀 값이며, 음수는 순매도입니다.", "depth" : 0 }, { "element" : "bank_ntby_tr_pbmn", "name" : "은행순매수거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "은행의 순매수 거래대금입니다. 매수 거래대금에서 매도 거래대금을 뺀 값이며, 음수는 순매도입니다.", "depth" : 0 }, { "element" : "ivtr_ntby_tr_pbmn", "name" : "투자신탁순매수거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "투자신탁의 순매수 거래대금입니다. 매수 거래대금에서 매도 거래대금을 뺀 값이며, 음수는 순매도입니다.", "depth" : 0 }, { "element" : "mrbn_ntby_tr_pbmn", "name" : "종금순매수거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "종금의 순매수 거래대금입니다. 매수 거래대금에서 매도 거래대금을 뺀 값이며, 음수는 순매도입니다.", "depth" : 0 }, { "element" : "scrt_ntby_tr_pbmn", "name" : "증권순매수거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "증권의 순매수 거래대금입니다. 매수 거래대금에서 매도 거래대금을 뺀 값이며, 음수는 순매도입니다.", "depth" : 0 }, { "element" : "pe_fund_ntby_tr_pbmn", "name" : "사모펀드순매수거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "사모펀드의 순매수 거래대금입니다. 매수 거래대금에서 매도 거래대금을 뺀 값이며, 음수는 순매도입니다.", "depth" : 0 }, { "element" : "etc_corp_ntby_tr_pbmn", "name" : "기타법인순매수거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "기타법인의 순매수 거래대금입니다. 매수 거래대금에서 매도 거래대금을 뺀 값이며, 음수는 순매도입니다.", "depth" : 0 }, { "element" : "etc_orgt_ntby_tr_pbmn", "name" : "기타단체순매수거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "기타단체의 순매수 거래대금입니다. 매수 거래대금에서 매도 거래대금을 뺀 값이며, 음수는 순매도입니다.", "depth" : 0 }, { "element" : "prsn_seln_vol", "name" : "개인매도거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "개인의 매도 거래량입니다.", "depth" : 0 }, { "element" : "prsn_shnu_vol", "name" : "개인매수거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "개인의 매수 거래량입니다.", "depth" : 0 }, { "element" : "prsn_seln_tr_pbmn", "name" : "개인매도거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "개인의 매도 거래대금입니다.", "depth" : 0 }, { "element" : "prsn_shnu_tr_pbmn", "name" : "개인매수거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "개인의 매수 거래대금입니다.", "depth" : 0 }, { "element" : "frgn_seln_vol", "name" : "외국인매도거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "외국인의 매도 거래량입니다.", "depth" : 0 }, { "element" : "frgn_shnu_vol", "name" : "외국인매수거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "외국인의 매수 거래량입니다.", "depth" : 0 }, { "element" : "frgn_seln_tr_pbmn", "name" : "외국인매도거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "외국인의 매도 거래대금입니다.", "depth" : 0 }, { "element" : "frgn_shnu_tr_pbmn", "name" : "외국인매수거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "외국인의 매수 거래대금입니다.", "depth" : 0 }, { "element" : "orgn_seln_vol", "name" : "기구매도거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "기관의 매도 거래량입니다.", "depth" : 0 }, { "element" : "orgn_shnu_vol", "name" : "기구매수거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "기관의 매수 거래량입니다.", "depth" : 0 }, { "element" : "orgn_seln_tr_pbmn", "name" : "기구매도거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "기관의 매도 거래대금입니다.", "depth" : 0 }, { "element" : "orgn_shnu_tr_pbmn", "name" : "기구매수거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "기관의 매수 거래대금입니다.", "depth" : 0 }, { "element" : "fund_seln_vol", "name" : "기금매도거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "기금의 매도 거래량입니다.", "depth" : 0 }, { "element" : "fund_shnu_vol", "name" : "기금매수거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "기금의 매수 거래량입니다.", "depth" : 0 }, { "element" : "fund_seln_tr_pbmn", "name" : "기금매도거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "기금의 매도 거래대금입니다.", "depth" : 0 }, { "element" : "fund_shnu_tr_pbmn", "name" : "기금매수거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "기금의 매수 거래대금입니다.", "depth" : 0 }, { "element" : "insu_seln_vol", "name" : "보험매도거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "보험의 매도 거래량입니다.", "depth" : 0 }, { "element" : "insu_shnu_vol", "name" : "보험매수거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "보험의 매수 거래량입니다.", "depth" : 0 }, { "element" : "insu_seln_tr_pbmn", "name" : "보험매도거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "보험의 매도 거래대금입니다.", "depth" : 0 }, { "element" : "insu_shnu_tr_pbmn", "name" : "보험매수거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "보험의 매수 거래대금입니다.", "depth" : 0 }, { "element" : "bank_seln_vol", "name" : "은행매도거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "은행의 매도 거래량입니다.", "depth" : 0 }, { "element" : "bank_shnu_vol", "name" : "은행매수거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "은행의 매수 거래량입니다.", "depth" : 0 }, { "element" : "bank_seln_tr_pbmn", "name" : "은행매도거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "은행의 매도 거래대금입니다.", "depth" : 0 }, { "element" : "bank_shnu_tr_pbmn", "name" : "은행매수거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "은행의 매수 거래대금입니다.", "depth" : 0 }, { "element" : "ivtr_seln_vol", "name" : "투자신탁매도거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "투자신탁의 매도 거래량입니다.", "depth" : 0 }, { "element" : "ivtr_shnu_vol", "name" : "투자신탁매수거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "투자신탁의 매수 거래량입니다.", "depth" : 0 }, { "element" : "ivtr_seln_tr_pbmn", "name" : "투자신탁매도거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "투자신탁의 매도 거래대금입니다.", "depth" : 0 }, { "element" : "ivtr_shnu_tr_pbmn", "name" : "투자신탁매수거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "투자신탁의 매수 거래대금입니다.", "depth" : 0 }, { "element" : "mrbn_seln_vol", "name" : "종금매도거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "종금의 매도 거래량입니다.", "depth" : 0 }, { "element" : "mrbn_shnu_vol", "name" : "종금매수거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "종금의 매수 거래량입니다.", "depth" : 0 }, { "element" : "mrbn_seln_tr_pbmn", "name" : "종금매도거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "종금의 매도 거래대금입니다.", "depth" : 0 }, { "element" : "mrbn_shnu_tr_pbmn", "name" : "종금매수거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "종금의 매수 거래대금입니다.", "depth" : 0 }, { "element" : "scrt_seln_vol", "name" : "증권매도거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "증권의 매도 거래량입니다.", "depth" : 0 }, { "element" : "scrt_shnu_vol", "name" : "증권매수거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "증권의 매수 거래량입니다.", "depth" : 0 }, { "element" : "scrt_seln_tr_pbmn", "name" : "증권매도거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "증권의 매도 거래대금입니다.", "depth" : 0 }, { "element" : "scrt_shnu_tr_pbmn", "name" : "증권매수거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "증권의 매수 거래대금입니다.", "depth" : 0 }, { "element" : "pe_fund_seln_vol", "name" : "사모펀드매도거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "사모펀드의 매도 거래량입니다.", "depth" : 0 }, { "element" : "pe_fund_shnu_vol", "name" : "사모펀드매수거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "사모펀드의 매수 거래량입니다.", "depth" : 0 }, { "element" : "pe_fund_seln_tr_pbmn", "name" : "사모펀드매도거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "사모펀드의 매도 거래대금입니다.", "depth" : 0 }, { "element" : "pe_fund_shnu_tr_pbmn", "name" : "사모펀드매수거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "사모펀드의 매수 거래대금입니다.", "depth" : 0 }, { "element" : "etc_corp_seln_vol", "name" : "기타법인매도거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "기타법인의 매도 거래량입니다.", "depth" : 0 }, { "element" : "etc_corp_shnu_vol", "name" : "기타법인매수거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "기타법인의 매수 거래량입니다.", "depth" : 0 }, { "element" : "etc_corp_seln_tr_pbmn", "name" : "기타법인매도거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "기타법인의 매도 거래대금입니다.", "depth" : 0 }, { "element" : "etc_corp_shnu_tr_pbmn", "name" : "기타법인매수거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "기타법인의 매수 거래대금입니다.", "depth" : 0 }, { "element" : "etc_orgt_seln_vol", "name" : "기타단체매도거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "기타단체의 매도 거래량입니다.", "depth" : 0 }, { "element" : "etc_orgt_shnu_vol", "name" : "기타단체매수거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "기타단체의 매수 거래량입니다.", "depth" : 0 }, { "element" : "etc_orgt_seln_tr_pbmn", "name" : "기타단체매도거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "기타단체의 매도 거래대금입니다.", "depth" : 0 }, { "element" : "etc_orgt_shnu_tr_pbmn", "name" : "기타단체매수거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "기타단체의 매수 거래대금입니다.", "depth" : 0 }, { "element" : "prdy_vrss", "name" : "전일대비", "type" : "Number", "required" : "Y", "length" : "13", "description" : "전일 종가 대비 등락폭입니다.", "depth" : 0 }, { "element" : "prdy_vrss_sign", "name" : "전일대비부호", "type" : "String", "required" : "Y", "length" : "2", "description" : "등락 부호입니다.\n\"1\" 상한 · \"2\" 상승 · \"3\" 보합 · \"4\" 하한 · \"5\" 하락", "depth" : 0 }, { "element" : "prdy_ctrt", "name" : "전일대비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "전일 종가 대비 등락률입니다. 단위는 퍼센트.", "depth" : 0 }, { "element" : "acml_vol", "name" : "누적거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "장 시작부터 지금까지 체결된 주식 수를 모두 더한 값입니다. 개별 체결 수량이 아닙니다.", "depth" : 0 }, { "element" : "acml_tr_pbmn", "name" : "누적거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "해당 일자에 체결된 거래대금을 모두 더한 값입니다.", "depth" : 0 }, { "element" : "pgm_ntby_tr_pbmn", "name" : "프로그램순매수거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "프로그램의 순매수 거래대금입니다. 매수 거래대금에서 매도 거래대금을 뺀 값이며, 음수는 순매도입니다.", "depth" : 0 }, { "element" : "pgm_seln_vol", "name" : "프로그램매도거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "프로그램의 매도 거래량입니다.", "depth" : 0 }, { "element" : "pgm_shnu_vol", "name" : "프로그램매수거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "프로그램의 매수 거래량입니다.", "depth" : 0 }, { "element" : "pgm_seln_tr_pbmn", "name" : "프로그램매도거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "프로그램의 매도 거래대금입니다.", "depth" : 0 }, { "element" : "pgm_shnu_tr_pbmn", "name" : "프로그램매수거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "프로그램의 매수 거래대금입니다.", "depth" : 0 }, { "element" : "pgm_ntby_vol", "name" : "프로그램순매수거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "프로그램의 순매수 거래량입니다. 매수 거래량에서 매도 거래량을 뺀 값이며, 음수는 순매도입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 성공 응답 코드는 \"0000\" 입니다.\n조회 결과가 없을 때도 \"0000\" 과 빈 배열이 내려오므로 결과 건수로 확인하십시오.\n오류는 종류와 무관하게 HTTP 500 으로 반환되므로, 성공·실패는 HTTP 상태가 아니라 이 값으로 판정하십시오.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 담기며, 조치 정보가 있으면 rsp_sub_msg 에 담깁니다.\n오류 응답에는 data 와 tr_cont 가 없으므로 rsp_cd 를 먼저 확인한 뒤 data 를 읽으십시오.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "N", "length" : "1", "description" : "이 API 는 연속조회를 지원하지 않습니다. 응답에 이 항목이 담기지 않습니다.", "depth" : 0 }, { "element" : "tr_cont_key", "name" : "연속조회 키", "type" : "String", "required" : "N", "length" : "20", "description" : "이 API 는 연속조회를 지원하지 않아 응답에 연속조회 키가 담기지 않습니다.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "오류일 때 조치 정보가 담기는 항목입니다.", "depth" : 0 } ] }, "requestExample" : "GET /market/v1/investors/detail?mrkt_div_code=J&iscd=A005930&from=20260901&to=20260911\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": [\n {\n \"date\": \"20260910\",\n \"stck_prpr\": 1263000,\n \"prsn_ntby_vol\": -2057529,\n \"frgn_ntby_vol\": -223832,\n \"orgn_ntby_vol\": -66491,\n \"fund_ntby_vol\": 1133,\n \"insu_ntby_vol\": 19089,\n \"bank_ntby_vol\": 17326,\n \"ivtr_ntby_vol\": -1708,\n \"mrbn_ntby_vol\": 4,\n \"scrt_ntby_vol\": -83016,\n \"pe_fund_ntby_vol\": -19319,\n \"etc_corp_ntby_vol\": 2344588,\n \"etc_orgt_ntby_vol\": 0,\n \"prsn_ntby_tr_pbmn\": -2277305,\n \"frgn_ntby_tr_pbmn\": 147905,\n \"orgn_ntby_tr_pbmn\": -45443,\n \"fund_ntby_tr_pbmn\": -622,\n \"insu_ntby_tr_pbmn\": 9725,\n \"bank_ntby_tr_pbmn\": 11538,\n \"ivtr_ntby_tr_pbmn\": -2557,\n \"mrbn_ntby_tr_pbmn\": 3,\n \"scrt_ntby_tr_pbmn\": -24735,\n \"pe_fund_ntby_tr_pbmn\": -38795,\n \"etc_corp_ntby_tr_pbmn\": 2172055,\n \"etc_orgt_ntby_tr_pbmn\": 0,\n \"prsn_seln_vol\": 3732457,\n \"prsn_shnu_vol\": 1674928,\n \"prsn_seln_tr_pbmn\": 3530568,\n \"prsn_shnu_tr_pbmn\": 1253263,\n \"frgn_seln_vol\": 10286800,\n \"frgn_shnu_vol\": 10062968,\n \"frgn_seln_tr_pbmn\": 9334782,\n \"frgn_shnu_tr_pbmn\": 9482687,\n \"orgn_seln_vol\": 4550639,\n \"orgn_shnu_vol\": 4484148,\n \"orgn_seln_tr_pbmn\": 4795347,\n \"orgn_shnu_tr_pbmn\": 4749904,\n \"fund_seln_vol\": 8415,\n \"fund_shnu_vol\": 9548,\n \"fund_seln_tr_pbmn\": 9910,\n \"fund_shnu_tr_pbmn\": 9288,\n \"insu_seln_vol\": 2115,\n \"insu_shnu_vol\": 21204,\n \"insu_seln_tr_pbmn\": 2523,\n \"insu_shnu_tr_pbmn\": 12248,\n \"bank_seln_vol\": 6418,\n \"bank_shnu_vol\": 23744,\n \"bank_seln_tr_pbmn\": 6727,\n \"bank_shnu_tr_pbmn\": 18265,\n \"ivtr_seln_vol\": 23276,\n \"ivtr_shnu_vol\": 21568,\n \"ivtr_seln_tr_pbmn\": 17691,\n \"ivtr_shnu_tr_pbmn\": 15134,\n \"mrbn_seln_vol\": 3,\n \"mrbn_shnu_vol\": 7,\n \"mrbn_seln_tr_pbmn\": 3,\n \"mrbn_shnu_tr_pbmn\": 6,\n \"scrt_seln_vol\": 4455254,\n \"scrt_shnu_vol\": 4372238,\n \"scrt_seln_tr_pbmn\": 4687893,\n \"scrt_shnu_tr_pbmn\": 4663157,\n \"pe_fund_seln_vol\": 55158,\n \"pe_fund_shnu_vol\": 35839,\n \"pe_fund_seln_tr_pbmn\": 70599,\n \"pe_fund_shnu_tr_pbmn\": 31805,\n \"etc_corp_seln_vol\": 6550,\n \"etc_corp_shnu_vol\": 2351138,\n \"etc_corp_seln_tr_pbmn\": 4696,\n \"etc_corp_shnu_tr_pbmn\": 2176751,\n \"etc_orgt_seln_vol\": 0,\n \"etc_orgt_shnu_vol\": 0,\n \"etc_orgt_seln_tr_pbmn\": 0,\n \"etc_orgt_shnu_tr_pbmn\": 0,\n \"prdy_vrss\": 1000,\n \"prdy_vrss_sign\": \"2\",\n \"prdy_ctrt\": \"0.08\",\n \"acml_vol\": 287281,\n \"acml_tr_pbmn\": 400691850500,\n \"pgm_ntby_tr_pbmn\": 217704,\n \"pgm_seln_vol\": 10438197,\n \"pgm_shnu_vol\": 10337042,\n \"pgm_seln_tr_pbmn\": 9455467,\n \"pgm_shnu_tr_pbmn\": 9673171,\n \"pgm_ntby_vol\": -101155\n },\n {\n \"date\": \"20260909\",\n \"stck_prpr\": 692000,\n \"prsn_ntby_vol\": -2078110,\n \"frgn_ntby_vol\": -363198,\n \"orgn_ntby_vol\": 93428,\n \"fund_ntby_vol\": 212,\n \"insu_ntby_vol\": 20087,\n \"bank_ntby_vol\": 17294,\n \"ivtr_ntby_vol\": 1971,\n \"mrbn_ntby_vol\": 6,\n \"scrt_ntby_vol\": 23177,\n \"pe_fund_ntby_vol\": 30681,\n \"etc_corp_ntby_vol\": 2344616,\n \"etc_orgt_ntby_vol\": 0,\n \"prsn_ntby_tr_pbmn\": -2306321,\n \"frgn_ntby_tr_pbmn\": -59411,\n \"orgn_ntby_tr_pbmn\": 190848,\n \"fund_ntby_tr_pbmn\": -1970,\n \"insu_ntby_tr_pbmn\": 11363,\n \"bank_ntby_tr_pbmn\": 11664,\n \"ivtr_ntby_tr_pbmn\": 1606,\n \"mrbn_ntby_tr_pbmn\": 5,\n \"scrt_ntby_tr_pbmn\": 140568,\n \"pe_fund_ntby_tr_pbmn\": 27612,\n \"etc_corp_ntby_tr_pbmn\": 2172097,\n \"etc_orgt_ntby_tr_pbmn\": 0,\n \"prsn_seln_vol\": 3711063,\n \"prsn_shnu_vol\": 1632953,\n \"prsn_seln_tr_pbmn\": 3501811,\n \"prsn_shnu_tr_pbmn\": 1195489,\n \"frgn_seln_vol\": 10267160,\n \"frgn_shnu_vol\": 9903962,\n \"frgn_seln_tr_pbmn\": 9308410,\n \"frgn_shnu_tr_pbmn\": 9248999,\n \"orgn_seln_vol\": 4303355,\n \"orgn_shnu_vol\": 4396783,\n \"orgn_seln_tr_pbmn\": 4447578,\n \"orgn_shnu_tr_pbmn\": 4638427,\n \"fund_seln_vol\": 6545,\n \"fund_shnu_vol\": 6757,\n \"fund_seln_tr_pbmn\": 7095,\n \"fund_shnu_tr_pbmn\": 5125,\n \"insu_seln_vol\": 1115,\n \"insu_shnu_vol\": 21202,\n \"insu_seln_tr_pbmn\": 883,\n \"insu_shnu_tr_pbmn\": 12246,\n \"bank_seln_vol\": 5338,\n \"bank_shnu_vol\": 22632,\n \"bank_seln_tr_pbmn\": 4976,\n \"bank_shnu_tr_pbmn\": 16640,\n \"ivtr_seln_vol\": 19248,\n \"ivtr_shnu_vol\": 21219,\n \"ivtr_seln_tr_pbmn\": 13114,\n \"ivtr_shnu_tr_pbmn\": 14721,\n \"mrbn_seln_vol\": 1,\n \"mrbn_shnu_vol\": 7,\n \"mrbn_seln_tr_pbmn\": 1,\n \"mrbn_shnu_tr_pbmn\": 6,\n \"scrt_seln_vol\": 4265950,\n \"scrt_shnu_vol\": 4289127,\n \"scrt_seln_tr_pbmn\": 4417316,\n \"scrt_shnu_tr_pbmn\": 4557884,\n \"pe_fund_seln_vol\": 5158,\n \"pe_fund_shnu_vol\": 35839,\n \"pe_fund_seln_tr_pbmn\": 4193,\n \"pe_fund_shnu_tr_pbmn\": 31805,\n \"etc_corp_seln_vol\": 6517,\n \"etc_corp_shnu_vol\": 2351133,\n \"etc_corp_seln_tr_pbmn\": 4648,\n \"etc_corp_shnu_tr_pbmn\": 2176745,\n \"etc_orgt_seln_vol\": 0,\n \"etc_orgt_shnu_vol\": 0,\n \"etc_orgt_seln_tr_pbmn\": 0,\n \"etc_orgt_shnu_tr_pbmn\": 0,\n \"prdy_vrss\": -296000,\n \"prdy_vrss_sign\": \"4\",\n \"prdy_ctrt\": \"-29.96\",\n \"acml_vol\": 1898347,\n \"acml_tr_pbmn\": 2054534533500,\n \"pgm_ntby_tr_pbmn\": 68340,\n \"pgm_seln_vol\": 10430339,\n \"pgm_shnu_vol\": 10228206,\n \"pgm_seln_tr_pbmn\": 9446317,\n \"pgm_shnu_tr_pbmn\": 9514656,\n \"pgm_ntby_vol\": -202133\n }\n ],\n \"rsp_cd\": \"0000\",\n \"rsp_msg\": \"정상 처리 되었습니다.\"\n}" } ] }, { "name" : "현재가 조회", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/market/v1/prices", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "국내주식 한 종목의 현재가와 당일 시세를 조회합니다.", "trs" : [ { "name" : "주식 현재가 조회", "code" : "ohhts_1001_001r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "mrkt_div_code", "name" : "시장 구분 코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "어느 시장의 시세를 볼지 정합니다.\n\"J\": KRX\n\"NJ\": 대체거래소(NXT)\n\"TJ\": KRX + NXT 통합\n\n위 세 값만 넣으십시오. 그 밖의 값도 오류 없이 정상 응답코드로 내려올 수 있으므로 보내는 값을 먼저 확인하십시오.", "depth" : 0 }, { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "종목 코드입니다. 6자리(005930) 또는 대문자 A 를 붙인 7자리(A005930)로 넣으십시오. 값 앞뒤의 공백은 무시됩니다.\n표준코드(KR7005930003)·소문자 a(a005930)·등록되지 않은 코드는 오류 없이 정상 응답코드 \"0000\" 으로 내려오되 값이 비거나 0 입니다. 뒤에 문자가 더 붙은 값(예: A005930ZZZZZ)은 앞 7자리만 읽습니다. 응답의 단축종목코드(shrn_iscd)가 채워져 있는지 확인하십시오.", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "현재가 정보", "type" : "Object", "required" : "Y", "length" : "-", "description" : "종목의 현재가 정보입니다.", "depth" : 0 }, { "element" : "issu_stat_cls_code", "name" : "종목상태구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "종목 상태 구분 코드입니다(2자리).", "depth" : 0 }, { "element" : "marg_rate", "name" : "증거금비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "이 종목의 증거금 비율(%)입니다.", "depth" : 0 }, { "element" : "rprs_mrkt_kor_name", "name" : "대표시장한글명", "type" : "String", "required" : "Y", "length" : "40", "description" : "이 종목이 속한 대표 시장의 한글 이름입니다. (예: \"KOSPI200\")", "depth" : 0 }, { "element" : "nw_hprc_lprc_clcd", "name" : "신고가저가구분코드", "type" : "String", "required" : "Y", "length" : "10", "description" : "신고가·신저가 구분입니다.", "depth" : 0 }, { "element" : "rprs_bstp_kor_isnm", "name" : "대표업종한글종목명", "type" : "String", "required" : "Y", "length" : "40", "description" : "이 종목이 속한 대표 업종의 한글 이름입니다. 빈 값으로 내려올 수 있으므로 업종 표시에 쓰기 전에 값을 확인하십시오. 시장 구분이 필요하시면 같은 응답의 대표시장한글명(rprs_mrkt_kor_name)을 쓰십시오.", "depth" : 0 }, { "element" : "tmpr_susp_yn", "name" : "임시정지여부", "type" : "String", "required" : "Y", "length" : "2", "description" : "임시 정지 여부\n\"Y\": 정지\n\"N\": 정상", "depth" : 0 }, { "element" : "oprc_rang_exts_yn", "name" : "시가범위연장여부", "type" : "String", "required" : "Y", "length" : "2", "description" : "시가 결정 시 가격 범위가 연장되었는지 여부입니다.\n\"Y\": 연장\n\"N\": 미연장\n\n빈 값으로 내려올 수 있으므로 빈 값을 함께 처리하십시오.", "depth" : 0 }, { "element" : "clpr_rang_exts_yn", "name" : "종가범위연장여부", "type" : "String", "required" : "Y", "length" : "2", "description" : "종가 결정 시 가격 범위가 연장되었는지 여부입니다.\n\"Y\": 연장\n\"N\": 미연장\n\n빈 값으로 내려올 수 있으므로 빈 값을 함께 처리하십시오.", "depth" : 0 }, { "element" : "crdt_able_yn", "name" : "신용가능여부", "type" : "String", "required" : "Y", "length" : "2", "description" : "신용 거래 가능 여부\n\"Y\": 가능\n\"N\": 불가", "depth" : 0 }, { "element" : "grmn_rate_cls_code", "name" : "보증금비율구분코드", "type" : "String", "required" : "Y", "length" : "5", "description" : "증거금률 구분입니다. 값이 있으면 증거금률(%)입니다.", "depth" : 0 }, { "element" : "elw_pblc_yn", "name" : "ELW발행여부", "type" : "String", "required" : "Y", "length" : "2", "description" : "ELW 발행 여부입니다.\n\"Y\": 발행\n\"N\": 미발행\n\n빈 값으로 내려올 수 있으므로 빈 값을 함께 처리하십시오.", "depth" : 0 }, { "element" : "stck_prpr", "name" : "주식현재가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "현재가입니다.\n\n실시간 국내주식 현재가(/websocket/ohhts-stck-cntg)에서는 같은 값이 prpr 이라는 다른 이름으로 옵니다. 조회로 첫 화면을 채우고 실시간으로 이어 붙이실 때는 이름을 맞춰 주십시오. 가중평균주가도 이 조회는 wghn_avrg_prc, 실시간은 wghn_avrg_stck_prc 입니다.", "depth" : 0 }, { "element" : "prdy_vrss", "name" : "전일대비", "type" : "Number", "required" : "Y", "length" : "13", "description" : "전일 종가 대비 등락 금액", "depth" : 0 }, { "element" : "prdy_vrss_sign", "name" : "전일대비부호", "type" : "String", "required" : "Y", "length" : "2", "description" : "전일 대비 부호\n\"1\": 상한\n\"2\": 상승\n\"3\": 보합\n\"4\": 하한\n\"5\": 하락", "depth" : 0 }, { "element" : "prdy_ctrt", "name" : "전일대비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "전일 종가 대비 등락률(%)", "depth" : 0 }, { "element" : "acml_vol", "name" : "누적거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "장 시작부터 지금까지 체결된 주식 수를 모두 더한 값입니다. 개별 체결 수량이 아닙니다.", "depth" : 0 }, { "element" : "prdy_vrss_vol_rate", "name" : "전일대비거래량비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "전일 대비 거래량 비율(%)입니다.", "depth" : 0 }, { "element" : "prdy_smns_hour_vol_rate", "name" : "전일동일시간거래량비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "전일 같은 시간 대비 거래량 비율(%)입니다.", "depth" : 0 }, { "element" : "oprc", "name" : "시가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "당일 첫 체결 가격(시가)입니다.", "depth" : 0 }, { "element" : "hprc", "name" : "고가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "당일 장중 가장 높았던 체결 가격(고가)입니다.", "depth" : 0 }, { "element" : "lprc", "name" : "저가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "당일 장중 가장 낮았던 체결 가격(저가)입니다.", "depth" : 0 }, { "element" : "mxpr", "name" : "상한가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "당일 주문 가능한 최고 가격(상한가)입니다.", "depth" : 0 }, { "element" : "llam", "name" : "하한가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "당일 주문 가능한 최저 가격(하한가)입니다.", "depth" : 0 }, { "element" : "sdpr", "name" : "기준가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "당일 기준가(전일 종가)", "depth" : 0 }, { "element" : "wghn_avrg_prc", "name" : "가중평균가격", "type" : "String", "required" : "Y", "length" : "11", "description" : "당일 가중평균 가격입니다.", "depth" : 0 }, { "element" : "ssts_cntg_qty", "name" : "공매도체결수량", "type" : "Number", "required" : "Y", "length" : "13", "description" : "당일 공매도 체결 수량입니다.", "depth" : 0 }, { "element" : "frgn_ehrt", "name" : "외국인소진율", "type" : "String", "required" : "Y", "length" : "9", "description" : "외국인이 보유할 수 있는 한도 중 실제로 채운 비율(%)입니다. 100에 가까울수록 외국인 매수 여력이 적습니다.", "depth" : 0 }, { "element" : "whol_fncg_rmnd_rate", "name" : "전체융자잔고비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "전체 융자 잔고 비율(%)", "depth" : 0 }, { "element" : "frgn_hldn_qty_icdc", "name" : "외국인보유수량증감", "type" : "Number", "required" : "Y", "length" : "13", "description" : "전일 대비 외국인 보유 수량 증감입니다.", "depth" : 0 }, { "element" : "pvt_scnd_dmrs", "name" : "피벗2차디저항", "type" : "Number", "required" : "Y", "length" : "13", "description" : "피벗 2차 저항선(디저항)입니다.", "depth" : 0 }, { "element" : "pvt_fst_dmrs", "name" : "피벗1차디저항", "type" : "Number", "required" : "Y", "length" : "13", "description" : "피벗 1차 저항선(디저항)입니다.", "depth" : 0 }, { "element" : "pvt_pont", "name" : "피벗포인트", "type" : "Number", "required" : "Y", "length" : "13", "description" : "피벗 포인트(기준선)입니다.", "depth" : 0 }, { "element" : "pvt_fst_dmsp", "name" : "피벗1차디지지", "type" : "Number", "required" : "Y", "length" : "13", "description" : "피벗 1차 지지선(디지지)입니다.", "depth" : 0 }, { "element" : "pvt_scnd_dmsp", "name" : "피벗2차디지지", "type" : "Number", "required" : "Y", "length" : "13", "description" : "피벗 2차 지지선(디지지)입니다.", "depth" : 0 }, { "element" : "dmrs", "name" : "디저항", "type" : "Number", "required" : "Y", "length" : "13", "description" : "저항선(디저항) 가격입니다.", "depth" : 0 }, { "element" : "dmsp", "name" : "디지지", "type" : "Number", "required" : "Y", "length" : "13", "description" : "지지선(디지지) 가격입니다.", "depth" : 0 }, { "element" : "fcam", "name" : "액면가", "type" : "String", "required" : "Y", "length" : "14", "description" : "1주의 액면가입니다.", "depth" : 0 }, { "element" : "sspr", "name" : "대용가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "대용가. 대용 주문 시 담보로 인정되는 금액입니다.", "depth" : 0 }, { "element" : "aspr_unit", "name" : "호가단위", "type" : "Number", "required" : "Y", "length" : "13", "description" : "호가 단위입니다.", "depth" : 0 }, { "element" : "deal_qty_unit", "name" : "매매수량단위", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매매 수량 단위. 주문 수량은 이 단위의 배수여야 합니다.", "depth" : 0 }, { "element" : "cpfn", "name" : "자본금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "자본금입니다. 억원 단위입니다.", "depth" : 0 }, { "element" : "lstn_stcn", "name" : "상장주수", "type" : "Number", "required" : "Y", "length" : "19", "description" : "이 종목이 발행해 상장된 총 주식 수입니다. 시가총액(avls)을 원 단위로 구하려면 현재가 × 이 값으로 계산하십시오.", "depth" : 0 }, { "element" : "avls", "name" : "시가총액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "시가총액입니다. 1억원 단위로 내려오며, 원 단위가 필요하면 1억을 곱하십시오.", "depth" : 0 }, { "element" : "prdy_avls_rank", "name" : "전일시가총액순위", "type" : "Number", "required" : "Y", "length" : "5", "description" : "전일 기준 시가총액 순위입니다. 0 으로 내려올 수 있으므로 순위 표시에 쓰기 전에 값을 확인하십시오. 시가총액 자체는 같은 응답의 시가총액(avls)을 쓰십시오.", "depth" : 0 }, { "element" : "frgn_hldn_qty", "name" : "외국인보유수량", "type" : "Number", "required" : "Y", "length" : "13", "description" : "외국인이 보유한 주식 수량입니다.", "depth" : 0 }, { "element" : "per", "name" : "PER", "type" : "String", "required" : "Y", "length" : "9", "description" : "주가수익비율(PER)입니다.", "depth" : 0 }, { "element" : "pbr", "name" : "PBR", "type" : "String", "required" : "Y", "length" : "9", "description" : "주가순자산비율(PBR)입니다.", "depth" : 0 }, { "element" : "fnaf_eps", "name" : "재무EPS", "type" : "String", "required" : "Y", "length" : "26", "description" : "주당순이익(EPS)", "depth" : 0 }, { "element" : "fnaf_bps", "name" : "재무BPS", "type" : "String", "required" : "Y", "length" : "26", "description" : "주당순자산(BPS)", "depth" : 0 }, { "element" : "dryy_hgpr", "name" : "연중최고가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "연중 최고가입니다.", "depth" : 0 }, { "element" : "dryy_hgpr_date", "name" : "연중최고가일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "연중 최고가 일자(YYYYMMDD)", "depth" : 0 }, { "element" : "dryy_hgpr_rate", "name" : "연중최고가비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "연중 최고가 대비율(%)", "depth" : 0 }, { "element" : "dryy_lwpr", "name" : "연중최저가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "연중 최저가입니다.", "depth" : 0 }, { "element" : "dryy_lwpr_rate", "name" : "연중최저가비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "연중 최저가 대비율(%)", "depth" : 0 }, { "element" : "dryy_lwpr_date", "name" : "연중최저가일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "연중 최저가 일자(YYYYMMDD)", "depth" : 0 }, { "element" : "52_week_hgpr", "name" : "52주최고가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "52주 최고가입니다.", "depth" : 0 }, { "element" : "52_week_hgpr_rate", "name" : "52주최고가비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "52주 최고가 대비율(%)", "depth" : 0 }, { "element" : "52_week_hgpr_date", "name" : "52주최고가일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "52주 최고가 일자(YYYYMMDD)", "depth" : 0 }, { "element" : "52_week_lwpr", "name" : "52주최저가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "최근 52주 최저가입니다.", "depth" : 0 }, { "element" : "52_week_lwpr_rate", "name" : "52주최저가비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "52주 최저가 대비율(%)", "depth" : 0 }, { "element" : "52_week_lwpr_date", "name" : "52주최저가일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "52주 최저가 일자(YYYYMMDD)", "depth" : 0 }, { "element" : "ssts_yn", "name" : "공매도여부", "type" : "String", "required" : "Y", "length" : "2", "description" : "공매도 가능 여부\n\"Y\": 가능\n\"N\": 불가", "depth" : 0 }, { "element" : "shrn_iscd", "name" : "단축종목코드", "type" : "String", "required" : "Y", "length" : "9", "description" : "단축 종목코드(6자리)", "depth" : 0 }, { "element" : "sltr_yn", "name" : "정리매매여부", "type" : "String", "required" : "Y", "length" : "2", "description" : "정리매매 여부\n\"Y\": 해당\n\"N\": 비해당", "depth" : 0 }, { "element" : "invt_epmd_cntt", "name" : "투자유의내용", "type" : "String", "required" : "Y", "length" : "50", "description" : "투자 유의 안내 문구입니다.", "depth" : 0 }, { "element" : "kor_isnm", "name" : "한글종목명", "type" : "String", "required" : "Y", "length" : "40", "description" : "종목의 한글명입니다.", "depth" : 0 }, { "element" : "stac_month", "name" : "결산월", "type" : "String", "required" : "Y", "length" : "2", "description" : "결산월입니다. 2자리 월로 내려옵니다. (예: \"12\")", "depth" : 0 }, { "element" : "prdy_vol", "name" : "전일거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "전일 거래량입니다.", "depth" : 0 }, { "element" : "glob_ntby_qty", "name" : "외국계순매수수량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "외국인 순매수 수량입니다.", "depth" : 0 }, { "element" : "acml_tr_pbmn", "name" : "누적거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "장 시작부터 지금까지 체결된 거래대금을 모두 더한 값입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 성공 응답 코드입니다.\n\"0000\": 정상 처리\n\n조회 결과가 없을 때도 \"0000\" 이 내려옵니다. 목록을 내려주는 조회는 빈 배열이, 한 건을 내려주는 조회는 값이 0 이거나 빈 내용이 \"0000\" 과 함께 옵니다. 결과 건수나 값으로 직접 확인하십시오.\n\n오류는 종류와 무관하게 HTTP 500 으로 반환됩니다. 성공·실패는 HTTP 상태가 아니라 이 값으로 판정하시고, 다른 계열 API 는 성공 코드가 \"0000\" 이 아닐 수 있으니 API 마다 확인하십시오.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 담깁니다.\n오류 응답에는 data·tr_cont 가 없으므로 data 를 읽기 전에 HTTP 상태와 rsp_cd 를 먼저 확인하십시오. 조치에 필요한 정보는 rsp_sub_msg 에 담길 수 있습니다.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "오류일 때 내려올 수 있는 상세 사유입니다. 조치에 필요한 정보가 담깁니다. 정상 응답에는 포함되지 않습니다.", "depth" : 0 } ] }, "requestExample" : "GET /market/v1/prices?mrkt_div_code=J&iscd=005930\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": {\n \"issu_stat_cls_code\": \"55\",\n \"marg_rate\": \"30\",\n \"rprs_mrkt_kor_name\": \"KOSPI200\",\n \"nw_hprc_lprc_clcd\": \"신고가\",\n \"rprs_bstp_kor_isnm\": \"\",\n \"tmpr_susp_yn\": \"N\",\n \"oprc_rang_exts_yn\": \"\",\n \"clpr_rang_exts_yn\": \"\",\n \"crdt_able_yn\": \"Y\",\n \"grmn_rate_cls_code\": \"30\",\n \"elw_pblc_yn\": \"\",\n \"stck_prpr\": 1263000,\n \"prdy_vrss\": 1000,\n \"prdy_vrss_sign\": \"2\",\n \"prdy_ctrt\": \"0.08\",\n \"acml_vol\": 286714,\n \"prdy_vrss_vol_rate\": \"15.10\",\n \"prdy_smns_hour_vol_rate\": \"21.87\",\n \"oprc\": 1251000,\n \"hprc\": 1640000,\n \"lprc\": 884000,\n \"mxpr\": 1640000,\n \"llam\": 884000,\n \"sdpr\": 1262000,\n \"wghn_avrg_prc\": \"1396914\",\n \"ssts_cntg_qty\": 59031,\n \"frgn_ehrt\": \"46.71\",\n \"whol_fncg_rmnd_rate\": \"0.40\",\n \"frgn_hldn_qty_icdc\": 0,\n \"pvt_scnd_dmrs\": 1481333,\n \"pvt_fst_dmrs\": 1086666,\n \"pvt_pont\": 889333,\n \"pvt_fst_dmsp\": 494666,\n \"pvt_scnd_dmsp\": 297333,\n \"dmrs\": 988000,\n \"dmsp\": 396000,\n \"fcam\": \"100\",\n \"sspr\": 199430,\n \"aspr_unit\": 1000,\n \"deal_qty_unit\": 1,\n \"cpfn\": 7780,\n \"lstn_stcn\": 5846278608,\n \"avls\": 73838499,\n \"prdy_avls_rank\": 0,\n \"frgn_hldn_qty\": 2730694215,\n \"per\": \"18.27\",\n \"pbr\": \"1.87\",\n \"fnaf_eps\": \"6564\",\n \"fnaf_bps\": \"63997\",\n \"dryy_hgpr\": 1640000,\n \"dryy_hgpr_date\": \"20260910\",\n \"dryy_hgpr_rate\": \"-22.99\",\n \"dryy_lwpr\": 120200,\n \"dryy_lwpr_rate\": \"950.75\",\n \"dryy_lwpr_date\": \"20260102\",\n \"52_week_hgpr\": 1640000,\n \"52_week_hgpr_rate\": \"-22.99\",\n \"52_week_hgpr_date\": \"20260910\",\n \"52_week_lwpr\": 72100,\n \"52_week_lwpr_rate\": \"1651.73\",\n \"52_week_lwpr_date\": \"20250911\",\n \"ssts_yn\": \"Y\",\n \"shrn_iscd\": \"005930\",\n \"sltr_yn\": \"N\",\n \"invt_epmd_cntt\": \"\",\n \"kor_isnm\": \"삼성전자\",\n \"stac_month\": \"12\",\n \"prdy_vol\": 1898347,\n \"glob_ntby_qty\": 146721,\n \"acml_tr_pbmn\": 400514936000\n },\n \"rsp_cd\": \"0000\",\n \"rsp_msg\": \"정상 처리 되었습니다.\"\n}" } ] }, { "name" : "시간외 단일가 조회", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/market/v1/prices/after", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "국내주식 한 종목의 시간외 단일가 시세를 조회합니다.", "trs" : [ { "name" : "주식 시간외 현재가 조회", "code" : "ohhts_1181_002r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "mrkt_div_code", "name" : "시장 구분 코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "어느 시장의 시세를 볼지 정합니다.\n\"J\": KRX\n\"NJ\": 대체거래소(NXT)\n\"TJ\": KRX + NXT 통합\n\n시간외 단일가는 \"J\" 로 조회하십시오. \"TJ\" 로 조회하면 단축종목코드(shrn_iscd)는 채워지지만 시간외단일가현재가(ovtm_untp_prpr)와 거래량(ovtm_untp_vol)이 0 인 응답이 정상 응답코드로 내려옵니다.", "depth" : 0 }, { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "종목 코드입니다. 6자리(005930)로 넣으십시오. 등록되지 않은 종목코드는 오류 없이 정상 응답코드로 내려올 수 있으므로, 응답의 단축종목코드(shrn_iscd)가 채워져 있는지 확인하십시오.", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "시간외 단일가 정보", "type" : "Object", "required" : "Y", "length" : "-", "description" : "종목의 시간외 단일가 정보입니다.", "depth" : 0 }, { "element" : "shrn_iscd", "name" : "단축종목코드", "type" : "String", "required" : "Y", "length" : "9", "description" : "단축 종목코드(6자리)", "depth" : 0 }, { "element" : "kor_isnm", "name" : "한글종목명", "type" : "String", "required" : "Y", "length" : "40", "description" : "종목의 한글명입니다. 코드 대신 이 값을 그대로 표시하실 수 있습니다.", "depth" : 0 }, { "element" : "rprs_mrkt_kor_name", "name" : "대표시장한글명", "type" : "String", "required" : "Y", "length" : "40", "description" : "이 종목이 속한 대표 시장의 한글 이름입니다. (예: \"KOSPI200\")", "depth" : 0 }, { "element" : "rprs_bstp_kor_isnm", "name" : "대표업종한글종목명", "type" : "String", "required" : "Y", "length" : "40", "description" : "이 종목이 속한 대표 업종의 한글 이름입니다. 빈 값으로 내려올 수 있으므로 업종 표시에 쓰기 전에 값을 확인하십시오. 시장 구분이 필요하시면 같은 응답의 대표시장한글명(rprs_mrkt_kor_name)을 쓰십시오.", "depth" : 0 }, { "element" : "ovtm_untp_prpr", "name" : "시간외단일가현재가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "시간외 단일가 체결가입니다. 체결 여부는 시간외단일가 거래량(ovtm_untp_vol)으로 함께 확인하십시오.", "depth" : 0 }, { "element" : "ovtm_untp_prdy_vrss", "name" : "시간외단일가전일대비", "type" : "Number", "required" : "Y", "length" : "13", "description" : "시간외단일가 전일 대비 등락 금액", "depth" : 0 }, { "element" : "ovtm_untp_prdy_vrss_sign", "name" : "시간외단일가전일대비부호", "type" : "String", "required" : "Y", "length" : "2", "description" : "시간외 단일가의 전일 대비 부호입니다.\n\"1\": 상한\n\"2\": 상승\n\"3\": 보합\n\"4\": 하한\n\"5\": 하락\n\n시장 구분을 \"TJ\" 로 조회하면 빈 값이 내려옵니다. 빈 값도 함께 처리하십시오.", "depth" : 0 }, { "element" : "ovtm_untp_prdy_ctrt", "name" : "시간외단일가전일대비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "시간외단일가 전일 대비 등락률(%)", "depth" : 0 }, { "element" : "ovtm_untp_vol", "name" : "시간외단일가거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "시간외 단일가 거래량입니다.", "depth" : 0 }, { "element" : "ovtm_untp_oprc", "name" : "시간외단일가시가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "시간외 단일가 시가입니다.", "depth" : 0 }, { "element" : "ovtm_untp_hprc", "name" : "시간외단일가고가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "시간외 단일가 고가입니다.", "depth" : 0 }, { "element" : "ovtm_untp_lprc", "name" : "시간외단일가저가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "시간외 단일가 저가입니다.", "depth" : 0 }, { "element" : "ovtm_untp_antc_cnpr", "name" : "시간외단일가예상체결가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "시간외 단일가 예상 체결가입니다.", "depth" : 0 }, { "element" : "ovtm_untp_antc_cntg_ctrt", "name" : "시간외단일가예상체결대비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "시간외단일가 예상 체결 대비율(%)", "depth" : 0 }, { "element" : "ovtm_untp_antc_cnqn", "name" : "시간외단일가예상체결량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "시간외 단일가 시간대에 지금 주문대로 체결된다면 나올 예상 체결 수량입니다.", "depth" : 0 }, { "element" : "ovtm_untp_mxpr", "name" : "시간외단일가상한가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "시간외 단일가 상한가입니다. 0 으로 내려올 수 있으므로 가격 범위 판단에 쓰지 마십시오.", "depth" : 0 }, { "element" : "ovtm_untp_llam", "name" : "시간외단일가하한가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "시간외 단일가 하한가입니다. 0 으로 내려올 수 있으므로 가격 범위 판단에 쓰지 마십시오.", "depth" : 0 }, { "element" : "ovtm_untp_sdpr", "name" : "시간외단일가기준가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "시간외 단일가의 기준가입니다. 정규장 현재가(stck_prpr)와 다른 값이 내려올 수 있습니다.", "depth" : 0 }, { "element" : "ovtm_untp_tr_pbmn", "name" : "시간외단일가거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "시간외 단일가 거래대금입니다.", "depth" : 0 }, { "element" : "sspr", "name" : "대용가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "대용가. 대용 주문 시 담보로 인정되는 금액입니다.", "depth" : 0 }, { "element" : "lstn_stcn", "name" : "상장주수", "type" : "Number", "required" : "Y", "length" : "19", "description" : "이 종목이 발행해 상장된 총 주식 수입니다.", "depth" : 0 }, { "element" : "fcam", "name" : "액면가", "type" : "String", "required" : "Y", "length" : "14", "description" : "1주의 액면가입니다.", "depth" : 0 }, { "element" : "cpfn", "name" : "자본금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "자본금입니다. 억원 단위입니다.", "depth" : 0 }, { "element" : "per", "name" : "PER", "type" : "String", "required" : "Y", "length" : "9", "description" : "주가수익비율(PER)입니다.", "depth" : 0 }, { "element" : "stac_month", "name" : "결산월", "type" : "String", "required" : "Y", "length" : "2", "description" : "결산월입니다. 2자리 월로 내려옵니다. (예: \"12\")", "depth" : 0 }, { "element" : "frgn_ehrt", "name" : "외국인소진율", "type" : "String", "required" : "Y", "length" : "9", "description" : "외국인이 보유할 수 있는 한도 중 실제로 채운 비율(%)입니다. 100에 가까울수록 외국인 매수 여력이 적습니다.", "depth" : 0 }, { "element" : "frgn_hldn_qty", "name" : "외국인보유수량", "type" : "Number", "required" : "Y", "length" : "13", "description" : "외국인이 보유한 주식 수량입니다.", "depth" : 0 }, { "element" : "stck_prpr", "name" : "주식현재가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "가장 최근 체결된 가격입니다.", "depth" : 0 }, { "element" : "prdy_vrss", "name" : "전일대비", "type" : "Number", "required" : "Y", "length" : "13", "description" : "전일 종가 대비 등락 금액", "depth" : 0 }, { "element" : "prdy_vrss_sign", "name" : "전일대비부호", "type" : "String", "required" : "Y", "length" : "2", "description" : "전일 대비 부호\n\"1\": 상한\n\"2\": 상승\n\"3\": 보합\n\"4\": 하한\n\"5\": 하락", "depth" : 0 }, { "element" : "prdy_ctrt", "name" : "전일대비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "전일 종가 대비 등락률(%)", "depth" : 0 }, { "element" : "acml_vol", "name" : "누적거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "장 시작부터 지금까지 체결된 주식 수를 모두 더한 값입니다. 개별 체결 수량이 아닙니다.", "depth" : 0 }, { "element" : "prdy_vrss_vol_rate", "name" : "전일대비거래량비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "전일 대비 거래량 비율(%)입니다. 이 조회의 응답에는 전일거래량이 담기지 않으며, 현재가 조회(/market/v1/prices)에 전일거래량(prdy_vol)이 있습니다.", "depth" : 0 }, { "element" : "oprc", "name" : "시가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "당일 첫 체결 가격(시가)입니다.", "depth" : 0 }, { "element" : "hprc", "name" : "고가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "당일 장중 가장 높았던 체결 가격(고가)입니다.", "depth" : 0 }, { "element" : "lprc", "name" : "저가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "당일 장중 가장 낮았던 체결 가격(저가)입니다.", "depth" : 0 }, { "element" : "d250_hgpr", "name" : "250일최고가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "최근 250거래일 중 가장 높은 가격입니다.", "depth" : 0 }, { "element" : "d250_hgpr_date", "name" : "250일최고가일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "250일 최고가 일자(YYYYMMDD)", "depth" : 0 }, { "element" : "d250_hgpr_rate", "name" : "250일최고가비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "250일 최고가 대비율(%)", "depth" : 0 }, { "element" : "d250_lwpr", "name" : "250일최저가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "최근 250거래일 최저가입니다.", "depth" : 0 }, { "element" : "d250_lwpr_date", "name" : "250일최저가일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "250거래일 최저가(d250_lwpr)가 나온 일자(YYYYMMDD 8자리)입니다.", "depth" : 0 }, { "element" : "d250_lwpr_rate", "name" : "250일최저가비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "250일 최저가 대비율(%)", "depth" : 0 }, { "element" : "ovtm_untp_antc_cntg_vrss", "name" : "시간외단일가예상체결대비", "type" : "Number", "required" : "Y", "length" : "13", "description" : "시간외단일가 예상 체결 대비 등락 금액", "depth" : 0 }, { "element" : "ovtm_untp_antc_vrss_sign", "name" : "시간외단일가예상대비부호", "type" : "String", "required" : "Y", "length" : "2", "description" : "시간외 단일가의 예상 체결 대비 부호입니다.\n\"1\": 상한\n\"2\": 상승\n\"3\": 보합\n\"4\": 하한\n\"5\": 하락\n\n시장 구분을 \"TJ\" 로 조회하면 빈 값이 내려옵니다. 빈 값도 함께 처리하십시오.", "depth" : 0 }, { "element" : "crdt_able_yn", "name" : "신용가능여부", "type" : "String", "required" : "Y", "length" : "2", "description" : "신용 거래 가능 여부\n\"Y\": 가능\n\"N\": 불가", "depth" : 0 }, { "element" : "marg_rate", "name" : "증거금비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "이 종목을 살 때 필요한 증거금 비율(%)입니다. 30이면 주문금액의 30%를 현금으로 갖고 있어야 합니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 성공 응답 코드입니다.\n\"0000\": 정상 처리\n\n조회 결과가 없을 때도 \"0000\" 이 내려옵니다. 목록을 내려주는 조회는 빈 배열이, 한 건을 내려주는 조회는 값이 0 이거나 빈 내용이 \"0000\" 과 함께 옵니다. 결과 건수나 값으로 직접 확인하십시오.\n\n오류는 종류와 무관하게 HTTP 500 으로 반환됩니다. 성공·실패는 HTTP 상태가 아니라 이 값으로 판정하시고, 다른 계열 API 는 성공 코드가 \"0000\" 이 아닐 수 있으니 API 마다 확인하십시오.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 담깁니다.\n오류 응답에는 data·tr_cont 가 없으므로 data 를 읽기 전에 HTTP 상태와 rsp_cd 를 먼저 확인하십시오. 조치에 필요한 정보는 rsp_sub_msg 에 담길 수 있습니다.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "오류일 때 내려올 수 있는 상세 사유입니다. 조치에 필요한 정보가 담깁니다. 정상 응답에는 포함되지 않습니다.", "depth" : 0 } ] }, "requestExample" : "GET /market/v1/prices/after?mrkt_div_code=J&iscd=000660\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": {\n \"shrn_iscd\": \"000660\",\n \"kor_isnm\": \"SK하이닉스\",\n \"rprs_mrkt_kor_name\": \"KOSPI200\",\n \"rprs_bstp_kor_isnm\": \"\",\n \"ovtm_untp_prpr\": 1745000,\n \"ovtm_untp_prdy_vrss\": 64000,\n \"ovtm_untp_prdy_vrss_sign\": \"2\",\n \"ovtm_untp_prdy_ctrt\": \"3.81\",\n \"ovtm_untp_vol\": 11,\n \"ovtm_untp_oprc\": 1681000,\n \"ovtm_untp_hprc\": 1745000,\n \"ovtm_untp_lprc\": 1681000,\n \"ovtm_untp_antc_cnpr\": 1745000,\n \"ovtm_untp_antc_cntg_ctrt\": \"3.81\",\n \"ovtm_untp_antc_cnqn\": 1,\n \"ovtm_untp_mxpr\": 0,\n \"ovtm_untp_llam\": 0,\n \"ovtm_untp_sdpr\": 1681000,\n \"ovtm_untp_tr_pbmn\": 18681000,\n \"sspr\": 1326820,\n \"lstn_stcn\": 730492365,\n \"fcam\": \"5000\",\n \"cpfn\": 37466,\n \"per\": \"11.04\",\n \"stac_month\": \"12\",\n \"frgn_ehrt\": \"50.55\",\n \"frgn_hldn_qty\": 369257786,\n \"stck_prpr\": 8389000,\n \"prdy_vrss\": -1136000,\n \"prdy_vrss_sign\": \"5\",\n \"prdy_ctrt\": \"-11.93\",\n \"acml_vol\": 8356,\n \"prdy_vrss_vol_rate\": \"2.34\",\n \"oprc\": 6668000,\n \"hprc\": 12382000,\n \"lprc\": 6668000,\n \"d250_hgpr\": 16512000,\n \"d250_hgpr_date\": \"20260903\",\n \"d250_hgpr_rate\": \"-49.19\",\n \"d250_lwpr\": 255000,\n \"d250_lwpr_date\": \"20250901\",\n \"d250_lwpr_rate\": \"3189.80\",\n \"ovtm_untp_antc_cntg_vrss\": 64000,\n \"ovtm_untp_antc_vrss_sign\": \"2\",\n \"crdt_able_yn\": \"Y\",\n \"marg_rate\": \"30\"\n },\n \"rsp_cd\": \"0000\",\n \"rsp_msg\": \"정상 처리 되었습니다.\"\n}" } ] }, { "name" : "호가 조회", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/market/v1/orderbook", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "국내주식 한 종목의 매도·매수 호가와 잔량을 10단계까지 조회합니다.", "trs" : [ { "name" : "주식 호가 조회", "code" : "ohhts_1001_005r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "mrkt_div_code", "name" : "시장 구분 코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "어느 시장의 호가를 볼지 정합니다.\n\"J\": KRX\n\"NJ\": 대체거래소(NXT)\n\"TJ\": KRX + NXT 통합\n\n위 세 값만 넣으십시오. 그 밖의 값도 오류 없이 정상 응답코드로 내려오므로 보내는 값을 먼저 확인하십시오.", "depth" : 0 }, { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "종목 코드입니다. 6자리(005930) 또는 대문자 A 를 붙인 7자리(A005930)로 넣으십시오. 등록되지 않은 종목코드도 오류 없이 정상 응답코드로 내려올 수 있으므로, 응답의 단축종목코드(shrn_iscd)가 채워져 있는지 확인하십시오.", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "호가 정보", "type" : "Object", "required" : "Y", "length" : "-", "description" : "종목의 호가 정보입니다.", "depth" : 0 }, { "element" : "prpr_hour", "name" : "현재가시간", "type" : "String", "required" : "Y", "length" : "6", "description" : "호가 시각(HHMMSS)", "depth" : 0 }, { "element" : "askp", "name" : "매도호가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매도호가 1단계 가격입니다.\n\n실시간 국내주식 호가(/websocket/ohhts-stck-aspr)에서는 같은 항목이 askp1 로 내려옵니다.", "depth" : 0 }, { "element" : "askp2", "name" : "매도호가2", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매도호가 2단계 가격", "depth" : 0 }, { "element" : "askp3", "name" : "매도호가3", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매도호가 3단계 가격", "depth" : 0 }, { "element" : "askp4", "name" : "매도호가4", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매도호가 4단계 가격", "depth" : 0 }, { "element" : "askp5", "name" : "매도호가5", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매도호가 5단계 가격", "depth" : 0 }, { "element" : "askp6", "name" : "매도호가6", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매도호가 6단계 가격", "depth" : 0 }, { "element" : "askp7", "name" : "매도호가7", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매도호가 7단계 가격", "depth" : 0 }, { "element" : "askp8", "name" : "매도호가8", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매도호가 8단계 가격", "depth" : 0 }, { "element" : "askp9", "name" : "매도호가9", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매도호가 9단계 가격", "depth" : 0 }, { "element" : "askp10", "name" : "매도호가10", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매도호가 10단계 가격", "depth" : 0 }, { "element" : "bidp", "name" : "매수호가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매수호가 1단계 가격입니다.\n\n실시간 국내주식 호가(/websocket/ohhts-stck-aspr)에서는 같은 항목이 bidp1 로 내려옵니다.", "depth" : 0 }, { "element" : "bidp2", "name" : "매수호가2", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매수호가 2단계 가격", "depth" : 0 }, { "element" : "bidp3", "name" : "매수호가3", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매수호가 3단계 가격", "depth" : 0 }, { "element" : "bidp4", "name" : "매수호가4", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매수호가 4단계 가격", "depth" : 0 }, { "element" : "bidp5", "name" : "매수호가5", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매수호가 5단계 가격", "depth" : 0 }, { "element" : "bidp6", "name" : "매수호가6", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매수호가 6단계 가격", "depth" : 0 }, { "element" : "bidp7", "name" : "매수호가7", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매수호가 7단계 가격", "depth" : 0 }, { "element" : "bidp8", "name" : "매수호가8", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매수호가 8단계 가격", "depth" : 0 }, { "element" : "bidp9", "name" : "매수호가9", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매수호가 9단계 가격", "depth" : 0 }, { "element" : "bidp10", "name" : "매수호가10", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매수호가 10단계 가격", "depth" : 0 }, { "element" : "askp_rsqn1", "name" : "매도호가잔량1", "type" : "Number", "required" : "Y", "length" : "13", "description" : "1번째로 싼 매도호가에 걸려 있는 수량입니다. 1단계가 가장 싼 매도호가이며, 번호가 커질수록 가격이 높아집니다.", "depth" : 0 }, { "element" : "askp_rsqn2", "name" : "매도호가잔량2", "type" : "Number", "required" : "Y", "length" : "13", "description" : "2번째로 싼 매도호가에 걸려 있는 수량입니다. 1단계가 가장 싼 매도호가이며, 번호가 커질수록 가격이 높아집니다.", "depth" : 0 }, { "element" : "askp_rsqn3", "name" : "매도호가잔량3", "type" : "Number", "required" : "Y", "length" : "13", "description" : "3번째로 싼 매도호가에 걸려 있는 수량입니다. 1단계가 가장 싼 매도호가이며, 번호가 커질수록 가격이 높아집니다.", "depth" : 0 }, { "element" : "askp_rsqn4", "name" : "매도호가잔량4", "type" : "Number", "required" : "Y", "length" : "13", "description" : "4번째로 싼 매도호가에 걸려 있는 수량입니다. 1단계가 가장 싼 매도호가이며, 번호가 커질수록 가격이 높아집니다.", "depth" : 0 }, { "element" : "askp_rsqn5", "name" : "매도호가잔량5", "type" : "Number", "required" : "Y", "length" : "13", "description" : "5번째로 싼 매도호가에 걸려 있는 수량입니다. 1단계가 가장 싼 매도호가이며, 번호가 커질수록 가격이 높아집니다.", "depth" : 0 }, { "element" : "askp_rsqn6", "name" : "매도호가잔량6", "type" : "Number", "required" : "Y", "length" : "13", "description" : "6번째로 싼 매도호가에 걸려 있는 수량입니다. 1단계가 가장 싼 매도호가이며, 번호가 커질수록 가격이 높아집니다.", "depth" : 0 }, { "element" : "askp_rsqn7", "name" : "매도호가잔량7", "type" : "Number", "required" : "Y", "length" : "13", "description" : "7번째로 싼 매도호가에 걸려 있는 수량입니다. 1단계가 가장 싼 매도호가이며, 번호가 커질수록 가격이 높아집니다.", "depth" : 0 }, { "element" : "askp_rsqn8", "name" : "매도호가잔량8", "type" : "Number", "required" : "Y", "length" : "13", "description" : "8번째로 싼 매도호가에 걸려 있는 수량입니다. 1단계가 가장 싼 매도호가이며, 번호가 커질수록 가격이 높아집니다.", "depth" : 0 }, { "element" : "askp_rsqn9", "name" : "매도호가잔량9", "type" : "Number", "required" : "Y", "length" : "13", "description" : "9번째로 싼 매도호가에 걸려 있는 수량입니다. 1단계가 가장 싼 매도호가이며, 번호가 커질수록 가격이 높아집니다.", "depth" : 0 }, { "element" : "askp_rsqn10", "name" : "매도호가잔량10", "type" : "Number", "required" : "Y", "length" : "13", "description" : "10번째로 싼 매도호가에 걸려 있는 수량입니다. 1단계가 가장 싼 매도호가이며, 번호가 커질수록 가격이 높아집니다.", "depth" : 0 }, { "element" : "bidp_rsqn1", "name" : "매수호가잔량1", "type" : "Number", "required" : "Y", "length" : "13", "description" : "1번째로 비싼 매수호가에 걸려 있는 수량입니다. 1단계가 가장 비싼 매수호가이며, 번호가 커질수록 가격이 낮아집니다.", "depth" : 0 }, { "element" : "bidp_rsqn2", "name" : "매수호가잔량2", "type" : "Number", "required" : "Y", "length" : "13", "description" : "2번째로 비싼 매수호가에 걸려 있는 수량입니다. 1단계가 가장 비싼 매수호가이며, 번호가 커질수록 가격이 낮아집니다.", "depth" : 0 }, { "element" : "bidp_rsqn3", "name" : "매수호가잔량3", "type" : "Number", "required" : "Y", "length" : "13", "description" : "3번째로 비싼 매수호가에 걸려 있는 수량입니다. 1단계가 가장 비싼 매수호가이며, 번호가 커질수록 가격이 낮아집니다.", "depth" : 0 }, { "element" : "bidp_rsqn4", "name" : "매수호가잔량4", "type" : "Number", "required" : "Y", "length" : "13", "description" : "4번째로 비싼 매수호가에 걸려 있는 수량입니다. 1단계가 가장 비싼 매수호가이며, 번호가 커질수록 가격이 낮아집니다.", "depth" : 0 }, { "element" : "bidp_rsqn5", "name" : "매수호가잔량5", "type" : "Number", "required" : "Y", "length" : "13", "description" : "5번째로 비싼 매수호가에 걸려 있는 수량입니다. 1단계가 가장 비싼 매수호가이며, 번호가 커질수록 가격이 낮아집니다.", "depth" : 0 }, { "element" : "bidp_rsqn6", "name" : "매수호가잔량6", "type" : "Number", "required" : "Y", "length" : "13", "description" : "6번째로 비싼 매수호가에 걸려 있는 수량입니다. 1단계가 가장 비싼 매수호가이며, 번호가 커질수록 가격이 낮아집니다.", "depth" : 0 }, { "element" : "bidp_rsqn7", "name" : "매수호가잔량7", "type" : "Number", "required" : "Y", "length" : "13", "description" : "7번째로 비싼 매수호가에 걸려 있는 수량입니다. 1단계가 가장 비싼 매수호가이며, 번호가 커질수록 가격이 낮아집니다.", "depth" : 0 }, { "element" : "bidp_rsqn8", "name" : "매수호가잔량8", "type" : "Number", "required" : "Y", "length" : "13", "description" : "8번째로 비싼 매수호가에 걸려 있는 수량입니다. 1단계가 가장 비싼 매수호가이며, 번호가 커질수록 가격이 낮아집니다.", "depth" : 0 }, { "element" : "bidp_rsqn9", "name" : "매수호가잔량9", "type" : "Number", "required" : "Y", "length" : "13", "description" : "9번째로 비싼 매수호가에 걸려 있는 수량입니다. 1단계가 가장 비싼 매수호가이며, 번호가 커질수록 가격이 낮아집니다.", "depth" : 0 }, { "element" : "bidp_rsqn10", "name" : "매수호가잔량10", "type" : "Number", "required" : "Y", "length" : "13", "description" : "10번째로 비싼 매수호가에 걸려 있는 수량입니다. 1단계가 가장 비싼 매수호가이며, 번호가 커질수록 가격이 낮아집니다.", "depth" : 0 }, { "element" : "askp_rsqn_icdc1", "name" : "매도호가잔량증감1", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매도호가 1단계 잔량 증감", "depth" : 0 }, { "element" : "askp_rsqn_icdc2", "name" : "매도호가잔량증감2", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매도호가 2단계 잔량 증감", "depth" : 0 }, { "element" : "askp_rsqn_icdc3", "name" : "매도호가잔량증감3", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매도호가 3단계 잔량 증감", "depth" : 0 }, { "element" : "askp_rsqn_icdc4", "name" : "매도호가잔량증감4", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매도호가 4단계 잔량 증감", "depth" : 0 }, { "element" : "askp_rsqn_icdc5", "name" : "매도호가잔량증감5", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매도호가 5단계 잔량 증감", "depth" : 0 }, { "element" : "askp_rsqn_icdc6", "name" : "매도호가잔량증감6", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매도호가 6단계 잔량 증감", "depth" : 0 }, { "element" : "askp_rsqn_icdc7", "name" : "매도호가잔량증감7", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매도호가 7단계 잔량 증감", "depth" : 0 }, { "element" : "askp_rsqn_icdc8", "name" : "매도호가잔량증감8", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매도호가 8단계 잔량 증감", "depth" : 0 }, { "element" : "askp_rsqn_icdc9", "name" : "매도호가잔량증감9", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매도호가 9단계 잔량 증감", "depth" : 0 }, { "element" : "askp_rsqn_icdc10", "name" : "매도호가잔량증감10", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매도호가 10단계 잔량 증감", "depth" : 0 }, { "element" : "bidp_rsqn_icdc1", "name" : "매수호가잔량증감1", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매수호가 1단계 잔량 증감", "depth" : 0 }, { "element" : "bidp_rsqn_icdc2", "name" : "매수호가잔량증감2", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매수호가 2단계 잔량 증감", "depth" : 0 }, { "element" : "bidp_rsqn_icdc3", "name" : "매수호가잔량증감3", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매수호가 3단계 잔량 증감", "depth" : 0 }, { "element" : "bidp_rsqn_icdc4", "name" : "매수호가잔량증감4", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매수호가 4단계 잔량 증감", "depth" : 0 }, { "element" : "bidp_rsqn_icdc5", "name" : "매수호가잔량증감5", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매수호가 5단계 잔량 증감", "depth" : 0 }, { "element" : "bidp_rsqn_icdc6", "name" : "매수호가잔량증감6", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매수호가 6단계 잔량 증감", "depth" : 0 }, { "element" : "bidp_rsqn_icdc7", "name" : "매수호가잔량증감7", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매수호가 7단계 잔량 증감", "depth" : 0 }, { "element" : "bidp_rsqn_icdc8", "name" : "매수호가잔량증감8", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매수호가 8단계 잔량 증감", "depth" : 0 }, { "element" : "bidp_rsqn_icdc9", "name" : "매수호가잔량증감9", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매수호가 9단계 잔량 증감", "depth" : 0 }, { "element" : "bidp_rsqn_icdc10", "name" : "매수호가잔량증감10", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매수호가 10단계 잔량 증감", "depth" : 0 }, { "element" : "total_askp_rsqn", "name" : "총매도호가잔량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "총 매도호가 잔량입니다.", "depth" : 0 }, { "element" : "total_bidp_rsqn", "name" : "총매수호가잔량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "총 매수호가 잔량입니다.", "depth" : 0 }, { "element" : "total_askp_rsqn_icdc", "name" : "총매도호가잔량증감", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매도 총잔량 증감입니다.", "depth" : 0 }, { "element" : "total_bidp_rsqn_icdc", "name" : "총매수호가잔량증감", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매수 총잔량 증감입니다.", "depth" : 0 }, { "element" : "ovtm_total_askp_icdc", "name" : "시간외총매도호가증감", "type" : "Number", "required" : "Y", "length" : "13", "description" : "시간외 총 매도호가 잔량 증감", "depth" : 0 }, { "element" : "ovtm_total_bidp_icdc", "name" : "시간외총매수호가증감", "type" : "Number", "required" : "Y", "length" : "13", "description" : "시간외 총 매수호가 잔량 증감", "depth" : 0 }, { "element" : "ovtm_total_askp_rsqn", "name" : "시간외총매도호가잔량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "시간외 총 매도호가 잔량입니다.", "depth" : 0 }, { "element" : "ovtm_total_bidp_rsqn", "name" : "시간외총매수호가잔량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "시간외 총 매수호가 잔량입니다.", "depth" : 0 }, { "element" : "total_ntby_rsqn", "name" : "총순매수잔량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "총 순매수 잔량입니다.", "depth" : 0 }, { "element" : "lp_total_askp_rsqn", "name" : "LP총매도호가잔량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "유동성공급자(LP) 총 매도호가 잔량", "depth" : 0 }, { "element" : "lp_total_bidp_rsqn", "name" : "LP총매수호가잔량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "유동성공급자(LP) 총 매수호가 잔량", "depth" : 0 }, { "element" : "mdtm_prc", "name" : "중간가격", "type" : "Number", "required" : "Y", "length" : "13", "description" : "중간가 주문을 위한 기준 가격 항목입니다.", "depth" : 0 }, { "element" : "seln_mdtm_aspr_total_rsqn", "name" : "매도중간호가총잔량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "중간가 매도 주문의 총 잔량입니다.", "depth" : 0 }, { "element" : "shnu_mdtm_aspr_total_rsqn", "name" : "매수중간호가총잔량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "중간가 매수 주문의 총 잔량입니다.", "depth" : 0 }, { "element" : "ats_mdtm_prc", "name" : "대체거래소중간가격", "type" : "Number", "required" : "Y", "length" : "13", "description" : "대체거래소(ATS)의 중간가 기준 가격 항목입니다. 시장 구분을 \"NJ\" 로 넣어 조회해도 0 으로 내려올 수 있습니다.\n\n0 을 대체거래소 자료 없음으로 읽지 마시고, 대체거래소 시세가 필요하시면 같은 응답의 현재가(stck_prpr)와 호가 항목을 \"NJ\" 로 조회해 쓰십시오.", "depth" : 0 }, { "element" : "ats_seln_mdtm_aspr_rsqn", "name" : "대체거래소매도중간호가잔량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "대체거래소(ATS) 중간가 매도호가 잔량", "depth" : 0 }, { "element" : "ats_shnu_mdtm_aspr_rsqn", "name" : "대체거래소매수중간호가잔량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "대체거래소(ATS) 중간가 매수호가 잔량", "depth" : 0 }, { "element" : "shrn_mkop_cls_code", "name" : "단축장운영구분코드", "type" : "String", "required" : "Y", "length" : "3", "description" : "장 운영 구분입니다. 시장(mrkt_div_code)마다 값이 다르며 빈 값으로 내려올 수 있습니다.", "depth" : 0 }, { "element" : "shrn_iscd", "name" : "단축종목코드", "type" : "String", "required" : "Y", "length" : "9", "description" : "단축 종목코드(6자리)", "depth" : 0 }, { "element" : "stck_prpr", "name" : "주식현재가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "가장 최근 체결된 가격입니다.", "depth" : 0 }, { "element" : "oprc", "name" : "시가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "당일 첫 체결 가격(시가)입니다.", "depth" : 0 }, { "element" : "hprc", "name" : "고가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "당일 장중 가장 높았던 체결 가격(고가)입니다.", "depth" : 0 }, { "element" : "lprc", "name" : "저가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "당일 장중 가장 낮았던 체결 가격(저가)입니다.", "depth" : 0 }, { "element" : "sdpr", "name" : "기준가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "당일 기준가(전일 종가)", "depth" : 0 }, { "element" : "antc_cnpr", "name" : "예상체결가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "예상 체결가입니다.", "depth" : 0 }, { "element" : "antc_cntg_vrss_sign", "name" : "예상체결대비부호", "type" : "String", "required" : "Y", "length" : "2", "description" : "예상 체결의 전일 대비 부호입니다.\n\"1\": 상한\n\"2\": 상승\n\"3\": 보합\n\"4\": 하한\n\"5\": 하락\n\n예상 체결가(antc_cnpr)가 채워지지 않는 동안에는 빈 값 또는 \"0\" 이 내려옵니다. 다섯 값만 담긴다고 보고 변환하지 마시고 빈 값과 \"0\" 을 함께 처리하십시오.", "depth" : 0 }, { "element" : "antc_cntg_vrss", "name" : "예상체결대비", "type" : "Number", "required" : "Y", "length" : "13", "description" : "예상 체결 대비 등락 금액", "depth" : 0 }, { "element" : "antc_cntg_prdy_ctrt", "name" : "예상체결전일대비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "예상 체결 전일 대비율(%)", "depth" : 0 }, { "element" : "antc_vol", "name" : "예상거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "지금 주문대로 체결된다면 나올 예상 체결 수량입니다.", "depth" : 0 }, { "element" : "d5_mvbl_avrg_prc", "name" : "5일이동평균가격", "type" : "Number", "required" : "Y", "length" : "13", "description" : "5일 이동평균 가격입니다.", "depth" : 0 }, { "element" : "wghn_avrg_prc", "name" : "가중평균가격", "type" : "String", "required" : "Y", "length" : "11", "description" : "당일 가중평균 가격입니다.\n\n실시간 국내주식 현재가(/websocket/ohhts-stck-cntg)에서는 같은 항목이 wghn_avrg_stck_prc 라는 다른 이름으로 옵니다. 조회로 첫 화면을 채우고 실시간으로 이어 붙이실 때는 이름을 맞춰 주십시오.", "depth" : 0 }, { "element" : "nw_mkop_cls_code", "name" : "신장운영구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "장 운영 상태 코드입니다(2자리, 빈 값 가능).\n같은 항목이 실시간 구독에서는 mkop_clcd 라는 이름으로 내려옵니다.", "depth" : 0 }, { "element" : "mxpr", "name" : "상한가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "당일 주문 가능한 최고 가격(상한가)입니다.", "depth" : 0 }, { "element" : "llam", "name" : "하한가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "당일 주문 가능한 최저 가격(하한가)입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 성공 응답 코드입니다.\n\"0000\": 정상 처리\n\n조회 결과가 없을 때도 \"0000\" 이 내려옵니다. 목록을 내려주는 조회는 빈 배열이, 한 건을 내려주는 조회는 값이 0 이거나 빈 내용이 \"0000\" 과 함께 옵니다. 결과 건수나 값으로 직접 확인하십시오.\n\n오류는 종류와 무관하게 HTTP 500 으로 반환됩니다. 성공·실패는 HTTP 상태가 아니라 이 값으로 판정하시고, 다른 계열 API 는 성공 코드가 \"0000\" 이 아닐 수 있으니 API 마다 확인하십시오.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 담깁니다.\n오류 응답에는 data·tr_cont 가 없으므로 data 를 읽기 전에 HTTP 상태와 rsp_cd 를 먼저 확인하십시오. 조치에 필요한 정보는 rsp_sub_msg 에 담길 수 있습니다.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "오류일 때 내려올 수 있는 상세 사유입니다. 조치에 필요한 정보가 담깁니다. 정상 응답에는 포함되지 않습니다.", "depth" : 0 } ] }, "requestExample" : "GET /market/v1/orderbook?mrkt_div_code=J&iscd=000660\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": {\n \"prpr_hour\": \"200000\",\n \"askp\": 8589000,\n \"askp2\": 8591000,\n \"askp3\": 8592000,\n \"askp4\": 8593000,\n \"askp5\": 8594000,\n \"askp6\": 8595000,\n \"askp7\": 8596000,\n \"askp8\": 8597000,\n \"askp9\": 8598000,\n \"askp10\": 8599000,\n \"bidp\": 8442000,\n \"bidp2\": 8360000,\n \"bidp3\": 8338000,\n \"bidp4\": 8332000,\n \"bidp5\": 8331000,\n \"bidp6\": 8323000,\n \"bidp7\": 8320000,\n \"bidp8\": 8316000,\n \"bidp9\": 8312000,\n \"bidp10\": 8311000,\n \"askp_rsqn1\": 3,\n \"askp_rsqn2\": 1,\n \"askp_rsqn3\": 1,\n \"askp_rsqn4\": 2,\n \"askp_rsqn5\": 3,\n \"askp_rsqn6\": 1,\n \"askp_rsqn7\": 3,\n \"askp_rsqn8\": 4,\n \"askp_rsqn9\": 3,\n \"askp_rsqn10\": 2,\n \"bidp_rsqn1\": 1,\n \"bidp_rsqn2\": 1,\n \"bidp_rsqn3\": 1,\n \"bidp_rsqn4\": 1,\n \"bidp_rsqn5\": 1,\n \"bidp_rsqn6\": 1,\n \"bidp_rsqn7\": 1,\n \"bidp_rsqn8\": 1,\n \"bidp_rsqn9\": 1,\n \"bidp_rsqn10\": 1,\n \"askp_rsqn_icdc1\": 0,\n \"askp_rsqn_icdc2\": 0,\n \"askp_rsqn_icdc3\": 0,\n \"askp_rsqn_icdc4\": 0,\n \"askp_rsqn_icdc5\": 0,\n \"askp_rsqn_icdc6\": 0,\n \"askp_rsqn_icdc7\": 0,\n \"askp_rsqn_icdc8\": 0,\n \"askp_rsqn_icdc9\": 0,\n \"askp_rsqn_icdc10\": 0,\n \"bidp_rsqn_icdc1\": 0,\n \"bidp_rsqn_icdc2\": 0,\n \"bidp_rsqn_icdc3\": 0,\n \"bidp_rsqn_icdc4\": 0,\n \"bidp_rsqn_icdc5\": 0,\n \"bidp_rsqn_icdc6\": 0,\n \"bidp_rsqn_icdc7\": 0,\n \"bidp_rsqn_icdc8\": 0,\n \"bidp_rsqn_icdc9\": 0,\n \"bidp_rsqn_icdc10\": 0,\n \"total_askp_rsqn\": 23,\n \"total_bidp_rsqn\": 10,\n \"total_askp_rsqn_icdc\": 0,\n \"total_bidp_rsqn_icdc\": 0,\n \"ovtm_total_askp_icdc\": 0,\n \"ovtm_total_bidp_icdc\": 0,\n \"ovtm_total_askp_rsqn\": 0,\n \"ovtm_total_bidp_rsqn\": 971,\n \"total_ntby_rsqn\": -13,\n \"lp_total_askp_rsqn\": 0,\n \"lp_total_bidp_rsqn\": 0,\n \"mdtm_prc\": 0,\n \"seln_mdtm_aspr_total_rsqn\": 0,\n \"shnu_mdtm_aspr_total_rsqn\": 0,\n \"ats_mdtm_prc\": 0,\n \"ats_seln_mdtm_aspr_rsqn\": 0,\n \"ats_shnu_mdtm_aspr_rsqn\": 0,\n \"shrn_mkop_cls_code\": \"AC2\",\n \"shrn_iscd\": \"000660\",\n \"stck_prpr\": 8389000,\n \"oprc\": 6668000,\n \"hprc\": 12382000,\n \"lprc\": 6668000,\n \"sdpr\": 9525000,\n \"antc_cnpr\": 0,\n \"antc_cntg_vrss_sign\": \"\",\n \"antc_cntg_vrss\": 0,\n \"antc_cntg_prdy_ctrt\": \"0.00\",\n \"antc_vol\": 0,\n \"d5_mvbl_avrg_prc\": 8847400,\n \"wghn_avrg_prc\": \"8467688\",\n \"nw_mkop_cls_code\": \"20\",\n \"mxpr\": 12382000,\n \"llam\": 6668000\n },\n \"rsp_cd\": \"0000\",\n \"rsp_msg\": \"정상 처리 되었습니다.\"\n}" } ] }, { "name" : "시간외 단일가 호가 조회", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/market/v1/orderbook/after", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "국내주식 한 종목의 시간외 단일가 호가 잔량을 조회합니다.", "trs" : [ { "name" : "주식 시간외 호가 조회", "code" : "ohhts_1181_001r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "mrkt_div_code", "name" : "시장 구분 코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "어느 시장의 호가를 볼지 정합니다.\n\"J\": KRX\n\"NJ\": 대체거래소(NXT)\n\"TJ\": KRX + NXT 통합\n\n시간외 단일가 호가는 \"J\" 로 조회하십시오. \"NJ\"·\"TJ\" 로 조회하면 오류 없이 시간외단일가 총잔량이 모두 0 인 응답이 정상 응답코드로 내려옵니다. 소문자 \"j\" 로 조회해도 같으며, 이때는 단축종목코드(shrn_iscd)도 빈 값입니다. 0 이 내려오면 시장 구분 값부터 확인하십시오.", "depth" : 0 }, { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "종목 코드입니다. 6자리(005930)로 넣으십시오. 등록되지 않은 종목코드는 오류 없이 정상 응답코드로 내려올 수 있으므로, 응답의 단축종목코드(shrn_iscd)가 채워져 있는지 확인하십시오.", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "시간외 단일가 호가 정보", "type" : "Object", "required" : "Y", "length" : "-", "description" : "종목의 시간외 단일가 호가 정보입니다.", "depth" : 0 }, { "element" : "ovtm_untp_last_hour", "name" : "시간외단일가최종시간", "type" : "String", "required" : "Y", "length" : "8", "description" : "시간외단일가 최종 시각입니다. HHMMSS 6자리.\n\n시장 구분을 \"NJ\" 로 조회하면 \"000000\" 이, \"TJ\" 로 조회하면 빈 문자열이 내려옵니다. 시각으로 변환하기 전에 6자리 숫자인지 확인하십시오.", "depth" : 0 }, { "element" : "ovtm_untp_total_askp_rsqn", "name" : "시간외단일가총매도호가잔량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "시간외 단일가 매도 총잔량입니다.", "depth" : 0 }, { "element" : "ovtm_untp_total_bidp_rsqn", "name" : "시간외단일가총매수호가잔량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "시간외 단일가 매수 총잔량입니다.", "depth" : 0 }, { "element" : "ovtm_untp_total_askp_icdc", "name" : "시간외단일가총매도호가증감", "type" : "Number", "required" : "Y", "length" : "13", "description" : "시간외단일가 총 매도호가 잔량 증감", "depth" : 0 }, { "element" : "ovtm_untp_total_bidp_icdc", "name" : "시간외단일가총매수호가증감", "type" : "Number", "required" : "Y", "length" : "13", "description" : "시간외단일가 총 매수호가 잔량 증감", "depth" : 0 }, { "element" : "ovtm_total_bidp_rsqn", "name" : "시간외총매수호가잔량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "시간외 총 매수호가 잔량입니다.", "depth" : 0 }, { "element" : "ovtm_total_askp_rsqn", "name" : "시간외총매도호가잔량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "시간외 총 매도호가 잔량입니다.", "depth" : 0 }, { "element" : "ovtm_total_bidp_icdc", "name" : "시간외총매수호가증감", "type" : "Number", "required" : "Y", "length" : "13", "description" : "시간외 총 매수호가 잔량 증감", "depth" : 0 }, { "element" : "ovtm_total_askp_icdc", "name" : "시간외총매도호가증감", "type" : "Number", "required" : "Y", "length" : "13", "description" : "시간외 총 매도호가 잔량 증감", "depth" : 0 }, { "element" : "total_askp_rsqn", "name" : "총매도호가잔량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "총 매도호가 잔량입니다. 이 조회의 응답에는 단계별 잔량이 담기지 않으며, 시간외 단일가의 매도 잔량이 필요하시면 시간외단일가총매도호가잔량(ovtm_untp_total_askp_rsqn)을 쓰십시오.", "depth" : 0 }, { "element" : "total_bidp_rsqn", "name" : "총매수호가잔량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "총 매수호가 잔량입니다. 이 조회의 응답에는 단계별 잔량이 담기지 않으며, 시간외 단일가의 매수 잔량이 필요하시면 시간외단일가총매수호가잔량(ovtm_untp_total_bidp_rsqn)을 쓰십시오.", "depth" : 0 }, { "element" : "total_askp_rsqn_icdc", "name" : "총매도호가잔량증감", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매도 총잔량 증감입니다.", "depth" : 0 }, { "element" : "total_bidp_rsqn_icdc", "name" : "총매수호가잔량증감", "type" : "Number", "required" : "Y", "length" : "13", "description" : "매수 총잔량 증감입니다.", "depth" : 0 }, { "element" : "shrn_iscd", "name" : "단축종목코드", "type" : "String", "required" : "Y", "length" : "9", "description" : "단축 종목코드(6자리)", "depth" : 0 }, { "element" : "ovtm_untp_prpr", "name" : "시간외단일가현재가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "시간외 단일가 체결가입니다.", "depth" : 0 }, { "element" : "ovtm_untp_oprc", "name" : "시간외단일가시가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "시간외 단일가 시가입니다.", "depth" : 0 }, { "element" : "ovtm_untp_hprc", "name" : "시간외단일가고가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "시간외 단일가 고가입니다.", "depth" : 0 }, { "element" : "ovtm_untp_lprc", "name" : "시간외단일가저가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "시간외 단일가 저가입니다.", "depth" : 0 }, { "element" : "ovtm_untp_mxpr", "name" : "시간외단일가상한가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "시간외 단일가로 낼 수 있는 가장 높은 가격 자리입니다. 이 조회에서는 같은 응답의 시간외단일가현재가와 기준가가 채워져 있을 때에도 0 으로 내려옵니다.\n\n이 항목을 가격 범위 판단에 쓰지 마십시오.", "depth" : 0 }, { "element" : "ovtm_untp_llam", "name" : "시간외단일가하한가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "시간외 단일가로 낼 수 있는 가장 낮은 가격 자리입니다. 이 조회에서는 같은 응답의 시간외단일가현재가와 기준가가 채워져 있을 때에도 0 으로 내려옵니다.\n\n이 항목을 가격 범위 판단에 쓰지 마십시오.", "depth" : 0 }, { "element" : "ovtm_untp_sdpr", "name" : "시간외단일가기준가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "시간외 단일가의 기준가입니다. 정규장 기준가(sdpr)와 다른 값이 내려올 수 있으므로 서로 바꿔 쓰지 마십시오.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 성공 응답 코드입니다.\n\"0000\": 정상 처리\n\n조회 결과가 없을 때도 \"0000\" 이 내려옵니다. 목록을 내려주는 조회는 빈 배열이, 한 건을 내려주는 조회는 값이 0 이거나 빈 내용이 \"0000\" 과 함께 옵니다. 결과 건수나 값으로 직접 확인하십시오.\n\n오류는 종류와 무관하게 HTTP 500 으로 반환됩니다. 성공·실패는 HTTP 상태가 아니라 이 값으로 판정하시고, 다른 계열 API 는 성공 코드가 \"0000\" 이 아닐 수 있으니 API 마다 확인하십시오.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 담깁니다.\n오류 응답에는 data·tr_cont 가 없으므로 data 를 읽기 전에 HTTP 상태와 rsp_cd 를 먼저 확인하십시오. 조치에 필요한 정보는 rsp_sub_msg 에 담길 수 있습니다.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "오류일 때 내려올 수 있는 상세 사유입니다. 조치에 필요한 정보가 담깁니다. 정상 응답에는 포함되지 않습니다.", "depth" : 0 } ] }, "requestExample" : "GET /market/v1/orderbook/after?mrkt_div_code=J&iscd=000660\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": {\n \"ovtm_untp_last_hour\": \"153119\",\n \"ovtm_untp_total_askp_rsqn\": 10,\n \"ovtm_untp_total_bidp_rsqn\": 1054,\n \"ovtm_untp_total_askp_icdc\": 2,\n \"ovtm_untp_total_bidp_icdc\": 0,\n \"ovtm_total_bidp_rsqn\": 971,\n \"ovtm_total_askp_rsqn\": 0,\n \"ovtm_total_bidp_icdc\": 0,\n \"ovtm_total_askp_icdc\": 0,\n \"total_askp_rsqn\": 23,\n \"total_bidp_rsqn\": 10,\n \"total_askp_rsqn_icdc\": 0,\n \"total_bidp_rsqn_icdc\": 0,\n \"shrn_iscd\": \"000660\",\n \"ovtm_untp_prpr\": 1745000,\n \"ovtm_untp_oprc\": 1681000,\n \"ovtm_untp_hprc\": 1745000,\n \"ovtm_untp_lprc\": 1681000,\n \"ovtm_untp_mxpr\": 0,\n \"ovtm_untp_llam\": 0,\n \"ovtm_untp_sdpr\": 1681000\n },\n \"rsp_cd\": \"0000\",\n \"rsp_msg\": \"정상 처리 되었습니다.\"\n}" } ] }, { "name" : "체결추이 조회(분)", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/market/v1/trades/minutes", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "국내주식 체결추이 조회(분)", "trs" : [ { "name" : "주식 체결추이 조회 (분)", "code" : "ohhts_1002_002r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "mrkt_div_code", "name" : "시장 구분 코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "어느 시장의 체결을 볼지 정합니다.\n\"J\": KRX\n\"NJ\": 대체거래소(NXT)\n\"TJ\": KRX + NXT 통합\n\n같은 종목이라도 시장마다 누적거래량이 다릅니다.", "depth" : 0 }, { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "종목 코드입니다. 6자리(005930)로 넣으십시오. 등록되지 않은 종목코드는 오류 없이 빈 목록이 정상 응답코드로 내려오며 자료가 없는 경우와 구분되지 않으므로, 빈 목록을 받으면 종목코드부터 확인하십시오.", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "체결 목록", "type" : "Object Array", "required" : "Y", "length" : "-", "description" : "체결 내역을 일정 구간으로 묶은 배열입니다. 최신 구간이 먼저 오고 한 번에 40건까지 내려옵니다.\n\n한 행이 1분 구간이라고 보지 마십시오. 묶는 간격은 체결시간(cntg_hour)으로 확인하십시오.", "depth" : 0 }, { "element" : "cntg_hour", "name" : "체결시간", "type" : "String", "required" : "Y", "length" : "6", "description" : "체결 시각(HHMMSS). 집계 구간의 시각입니다.", "depth" : 0 }, { "element" : "stck_prpr", "name" : "주식현재가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "가장 최근 체결된 가격입니다.", "depth" : 0 }, { "element" : "prdy_vrss_sign", "name" : "전일대비부호", "type" : "String", "required" : "Y", "length" : "2", "description" : "전일 대비 부호\n\"1\": 상한\n\"2\": 상승\n\"3\": 보합\n\"4\": 하한\n\"5\": 하락", "depth" : 0 }, { "element" : "prdy_vrss", "name" : "전일대비", "type" : "Number", "required" : "Y", "length" : "13", "description" : "전일 종가 대비 등락 금액", "depth" : 0 }, { "element" : "prdy_ctrt", "name" : "전일대비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "전일 종가 대비 등락률(%)", "depth" : 0 }, { "element" : "cntg_vol", "name" : "체결거래량", "type" : "Number", "required" : "Y", "length" : "13", "description" : "해당 구간의 체결 수량", "depth" : 0 }, { "element" : "acml_vol", "name" : "누적거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "장 시작부터 지금까지 체결된 주식 수를 모두 더한 값입니다. 개별 체결 수량이 아닙니다.", "depth" : 0 }, { "element" : "acml_tr_pbmn", "name" : "누적거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "장 시작부터 지금까지 체결된 거래대금을 모두 더한 값입니다.", "depth" : 0 }, { "element" : "askp", "name" : "매도호가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "체결 시점의 매도호가입니다.", "depth" : 0 }, { "element" : "bidp", "name" : "매수호가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "체결 시점의 매수호가입니다.", "depth" : 0 }, { "element" : "tday_rltv", "name" : "당일체결강도", "type" : "String", "required" : "Y", "length" : "9", "description" : "당일 체결강도(%)입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 성공 응답 코드입니다.\n\"0000\": 정상 처리\n\n조회 결과가 없을 때도 \"0000\" 이 내려옵니다. 목록을 내려주는 조회는 빈 배열이, 한 건을 내려주는 조회는 값이 0 이거나 빈 내용이 \"0000\" 과 함께 옵니다. 결과 건수나 값으로 직접 확인하십시오.\n\n오류는 종류와 무관하게 HTTP 500 으로 반환됩니다. 성공·실패는 HTTP 상태가 아니라 이 값으로 판정하시고, 다른 계열 API 는 성공 코드가 \"0000\" 이 아닐 수 있으니 API 마다 확인하십시오.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 담깁니다.\n오류 응답에는 data·tr_cont 가 없으므로 data 를 읽기 전에 HTTP 상태와 rsp_cd 를 먼저 확인하십시오. 조치에 필요한 정보는 rsp_sub_msg 에 담길 수 있습니다.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "오류일 때 내려올 수 있는 상세 사유입니다. 조치에 필요한 정보가 담깁니다. 정상 응답에는 포함되지 않습니다.", "depth" : 0 } ] }, "requestExample" : "GET /market/v1/trades/minutes?mrkt_div_code=J&iscd=000660\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": [\n {\n \"cntg_hour\": \"180745\",\n \"stck_prpr\": 4486000,\n \"prdy_vrss_sign\": \"1\",\n \"prdy_vrss\": 1035000,\n \"prdy_ctrt\": \"29.99\",\n \"cntg_vol\": 2,\n \"acml_vol\": 56361,\n \"acml_tr_pbmn\": 232719186000,\n \"askp\": 0,\n \"bidp\": 0,\n \"tday_rltv\": \"4.12\"\n },\n {\n \"cntg_hour\": \"174755\",\n \"stck_prpr\": 4486000,\n \"prdy_vrss_sign\": \"1\",\n \"prdy_vrss\": 1035000,\n \"prdy_ctrt\": \"29.99\",\n \"cntg_vol\": 6,\n \"acml_vol\": 56359,\n \"acml_tr_pbmn\": 232710214000,\n \"askp\": 0,\n \"bidp\": 0,\n \"tday_rltv\": \"4.12\"\n }\n ],\n \"rsp_cd\": \"0000\",\n \"rsp_msg\": \"정상 처리 되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "체결추이 조회(틱)", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/market/v1/trades/ticks", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "국내주식 체결추이 조회(틱)", "trs" : [ { "name" : "주식 체결추이 조회 (틱)", "code" : "ohhts_1002_001r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "mrkt_div_code", "name" : "시장 구분 코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "어느 시장의 체결을 볼지 정합니다.\n\"J\": KRX\n\"NJ\": 대체거래소(NXT)\n\"TJ\": KRX + NXT 통합\n\n같은 종목이라도 시장마다 누적거래량이 다릅니다.", "depth" : 0 }, { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "종목 코드입니다. 6자리(005930)로 넣으십시오. 등록되지 않은 종목코드는 오류 없이 빈 목록이 정상 응답코드로 내려오며 자료가 없는 경우와 구분되지 않으므로, 빈 목록을 받으면 종목코드부터 확인하십시오.", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "체결 목록", "type" : "Object Array", "required" : "Y", "length" : "-", "description" : "체결 내역 배열입니다. 최신 체결이 먼저 옵니다.\n\n한 번에 40건까지 내려오며, 응답 본문에는 다음 페이지를 이어받는 키(tr_cont_key)가 포함되지 않습니다.", "depth" : 0 }, { "element" : "prpr_hour", "name" : "현재가시간", "type" : "String", "required" : "Y", "length" : "6", "description" : "체결 시각(HHMMSS)입니다.\n\n같은 뜻의 값이 체결추이 조회(분)(/market/v1/trades/minutes)에서는 cntg_hour 라는 이름으로 내려옵니다. 두 API 를 함께 쓰실 때 항목명을 맞추어 주십시오.", "depth" : 0 }, { "element" : "stck_prpr", "name" : "주식현재가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "가장 최근 체결된 가격입니다.", "depth" : 0 }, { "element" : "prdy_vrss_sign", "name" : "전일대비부호", "type" : "String", "required" : "Y", "length" : "2", "description" : "전일 대비 부호\n\"1\": 상한\n\"2\": 상승\n\"3\": 보합\n\"4\": 하한\n\"5\": 하락", "depth" : 0 }, { "element" : "prdy_vrss", "name" : "전일대비", "type" : "Number", "required" : "Y", "length" : "13", "description" : "전일 종가 대비 등락 금액", "depth" : 0 }, { "element" : "prdy_ctrt", "name" : "전일대비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "전일 종가 대비 등락률(%)", "depth" : 0 }, { "element" : "cntg_vol", "name" : "체결거래량", "type" : "Number", "required" : "Y", "length" : "13", "description" : "해당 체결의 수량입니다.", "depth" : 0 }, { "element" : "acml_vol", "name" : "누적거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "장 시작부터 지금까지 체결된 주식 수를 모두 더한 값입니다. 개별 체결 수량이 아닙니다.", "depth" : 0 }, { "element" : "acml_tr_pbmn", "name" : "누적거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "장 시작부터 지금까지 체결된 거래대금을 모두 더한 값입니다.", "depth" : 0 }, { "element" : "askp", "name" : "매도호가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "체결 시점의 매도호가입니다.", "depth" : 0 }, { "element" : "bidp", "name" : "매수호가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "체결 시점의 매수호가입니다.", "depth" : 0 }, { "element" : "tday_rltv", "name" : "당일체결강도", "type" : "String", "required" : "Y", "length" : "9", "description" : "당일 체결강도(%)입니다.", "depth" : 0 }, { "element" : "altn_exch_ssn_id", "name" : "대체거래소세션ID", "type" : "String", "required" : "Y", "length" : "2", "description" : "체결이 이루어진 세션의 구분 값입니다. KRX 체결에는 \"40\", 대체거래소(NXT) 체결에는 \"42\" 가 내려옵니다.\n\nKRX(\"J\")만 조회하시면 빈 값이고, 통합(\"TJ\")으로 조회하시면 KRX 체결에도 값이 채워집니다. 값이 있다는 것만으로 대체거래소 체결이라고 보지 마시고 거래소코드(exch_code)로 가르십시오.", "depth" : 0 }, { "element" : "altn_exch_board_id", "name" : "대체거래소보드ID", "type" : "String", "required" : "Y", "length" : "2", "description" : "체결이 이루어진 보드의 구분 값입니다. 대체거래소(NXT) 체결에는 \"G1\", KRX 체결에는 \"G4\" 가 내려옵니다.\n\nKRX(\"J\")만 조회하시면 빈 값이고, 통합(\"TJ\")으로 조회하시면 KRX 체결에도 값이 채워집니다. 값이 있다는 것만으로 대체거래소 체결이라고 보지 마시고 거래소코드(exch_code)로 가르십시오.", "depth" : 0 }, { "element" : "exch_code", "name" : "거래소코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "체결이 이루어진 거래소 코드입니다.\n\"1\": KRX\n\"2\": 대체거래소(NXT)\n\n통합(\"TJ\")으로 조회하실 때만 채워지고, KRX(\"J\")와 대체거래소(\"NJ\")로 조회하실 때는 빈 값입니다. 어느 거래소의 체결인지 나누어 보시려면 \"TJ\" 로 조회하십시오.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 성공 응답 코드입니다.\n\"0000\": 정상 처리\n\n조회 결과가 없을 때도 \"0000\" 이 내려옵니다. 목록을 내려주는 조회는 빈 배열이, 한 건을 내려주는 조회는 값이 0 이거나 빈 내용이 \"0000\" 과 함께 옵니다. 결과 건수나 값으로 직접 확인하십시오.\n\n오류는 종류와 무관하게 HTTP 500 으로 반환됩니다. 성공·실패는 HTTP 상태가 아니라 이 값으로 판정하시고, 다른 계열 API 는 성공 코드가 \"0000\" 이 아닐 수 있으니 API 마다 확인하십시오.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 담깁니다.\n오류 응답에는 data·tr_cont 가 없으므로 data 를 읽기 전에 HTTP 상태와 rsp_cd 를 먼저 확인하십시오. 조치에 필요한 정보는 rsp_sub_msg 에 담길 수 있습니다.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "오류일 때 내려올 수 있는 상세 사유입니다. 조치에 필요한 정보가 담깁니다. 정상 응답에는 포함되지 않습니다.", "depth" : 0 } ] }, "requestExample" : "GET /market/v1/trades/ticks?mrkt_div_code=J&iscd=000660\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": [\n {\n \"prpr_hour\": \"195958\",\n \"stck_prpr\": 8389000,\n \"prdy_vrss_sign\": \"5\",\n \"prdy_vrss\": -1136000,\n \"prdy_ctrt\": \"-11.93\",\n \"cntg_vol\": 1,\n \"acml_vol\": 8356,\n \"acml_tr_pbmn\": 70755998000,\n \"askp\": 0,\n \"bidp\": 0,\n \"tday_rltv\": \"296.96\",\n \"altn_exch_ssn_id\": \"\",\n \"altn_exch_board_id\": \"\",\n \"exch_code\": \"\"\n },\n {\n \"prpr_hour\": \"195958\",\n \"stck_prpr\": 8398000,\n \"prdy_vrss_sign\": \"5\",\n \"prdy_vrss\": -1127000,\n \"prdy_ctrt\": \"-11.83\",\n \"cntg_vol\": 1,\n \"acml_vol\": 8355,\n \"acml_tr_pbmn\": 70747609000,\n \"askp\": 0,\n \"bidp\": 0,\n \"tday_rltv\": \"297.13\",\n \"altn_exch_ssn_id\": \"\",\n \"altn_exch_board_id\": \"\",\n \"exch_code\": \"\"\n }\n ],\n \"rsp_cd\": \"0000\",\n \"rsp_msg\": \"정상 처리 되었습니다.\"\n}" } ] }, { "name" : "국내 영업일 조회", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/reference/v1/market-days", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "영업일 여부와 전전·전·익·익익 영업일", "trs" : [ { "name" : "국내 영업일 조회", "code" : "obcpp_bsdy_021r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "영업일 정보", "type" : "Object", "required" : "Y", "length" : "-", "description" : "조회 기준일의 영업일 정보입니다. 직전·당일·다음 영업일과 정규장 개시·종료 시각이 한 건으로 들어 있습니다.\n앞뒤로 각각 두 영업일이 내려옵니다.", "depth" : 0 }, { "element" : "tday_bsdy", "name" : "당일영업일", "type" : "String", "required" : "Y", "length" : "8", "description" : "조회 시점의 영업일입니다. YYYYMMDD 8자리.", "depth" : 0 }, { "element" : "bef_bsdy", "name" : "전영업일", "type" : "String", "required" : "Y", "length" : "8", "description" : "직전 영업일입니다. YYYYMMDD 8자리.", "depth" : 0 }, { "element" : "bef_bef_bsdy", "name" : "전전영업일", "type" : "String", "required" : "Y", "length" : "8", "description" : "직전 영업일의 그 앞 영업일입니다.", "depth" : 0 }, { "element" : "nx_bsdy", "name" : "익영업일", "type" : "String", "required" : "Y", "length" : "8", "description" : "다음 영업일입니다. YYYYMMDD 8자리.", "depth" : 0 }, { "element" : "nx_nx_bsdy", "name" : "익익영업일", "type" : "String", "required" : "Y", "length" : "8", "description" : "다음 영업일의 그 다음 영업일입니다. YYYYMMDD 8자리.", "depth" : 0 }, { "element" : "sta_hour", "name" : "시작시간", "type" : "String", "required" : "Y", "length" : "6", "description" : "정규장이 시작되는 시각(HHMMSS 6자리)입니다. 시장별 시각은 국내 장운영 조회(/reference/v1/market-hours)를 쓰십시오.", "depth" : 0 }, { "element" : "fin_hour", "name" : "종료시간", "type" : "String", "required" : "Y", "length" : "6", "description" : "정규장이 끝나는 시각(HHMMSS 6자리)입니다. 시장별 마감 시각은 국내 장운영 조회(/reference/v1/market-hours)를 쓰십시오.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "항상 \"0\"으로 내려옵니다. 이 API는 연속조회를 지원하지 않습니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 성공 응답 코드는 \"0000\"(정상 처리)입니다.\n성공 코드는 API 마다 다릅니다. 다른 API 에서는 \"5766\"·\"5762\"·\"5820\" 등이 성공 코드입니다.\n\n오류는 종류와 무관하게 HTTP 500 으로 반환되므로, 성공·실패는 HTTP 상태가 아니라 이 값으로 판정하십시오.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "처리 결과 메시지입니다. 오류일 때 사유가 담기며, 더 자세한 사유는 rsp_sub_msg 에 담깁니다.", "depth" : 0 } ] }, "requestExample" : "GET /reference/v1/market-days\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": {\n \"tday_bsdy\": \"20260911\",\n \"bef_bsdy\": \"20260910\",\n \"bef_bef_bsdy\": \"20260909\",\n \"nx_bsdy\": \"20260914\",\n \"nx_nx_bsdy\": \"20260915\",\n \"sta_hour\": \"090000\",\n \"fin_hour\": \"153000\"\n },\n \"rsp_cd\": \"0000\",\n \"rsp_msg\": \"정상 처리 되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "국내 장운영 조회", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/reference/v1/market-hours", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "국내 시장의 장운영 상태와 시간표를 조회합니다.", "trs" : [ { "name" : "국내 장운영 조회", "code" : "obtrs_sstm_506r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "mkpl_cls_code", "name" : "매매시장구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "조회할 매매시장 코드입니다. 두 자리로 넣으십시오.\n\"01\" 유가증권 · \"02\" 코넥스 · \"03\" 코스닥 · \"24\" 소액채권 (query string)", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "장운영 정보", "type" : "Object", "required" : "Y", "length" : "-", "description" : "요청한 매매시장의 당일 장운영 정보입니다. 장운영 상태 코드와 단일가·시간외 등 시간대별 개시·종료 시각이 한 건으로 들어 있습니다.", "depth" : 0 }, { "element" : "mkpl_cls_code", "name" : "매매시장구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "요청에 넣은 매매시장 구분 코드가 그대로 돌아옵니다.\n\"01\": 유가증권\n\"02\": 코넥스\n\"03\": 코스닥\n\"24\": 소액채권", "depth" : 0 }, { "element" : "frml_ovtm_cls_code", "name" : "정규시간외구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "한 자리 구분 코드입니다. 값에 대응하는 이름은 제공되지 않습니다.", "depth" : 0 }, { "element" : "mkop_cls_code", "name" : "장운영구분코드", "type" : "String", "required" : "Y", "length" : "3", "description" : "현재 시점의 장운영 상태를 나타내는 세 자리 코드입니다. 시장마다 값이 다르고 시각에 따라 바뀌며, 코드에 대응하는 이름은 제공되지 않습니다.\n장이 끝난 뒤에도 \"000\" 이 되지 않는 시장이 있으므로 \"000\" 여부로 장 종료를 판정하지 마십시오.", "depth" : 0 }, { "element" : "mkob_mkop_cls_code", "name" : "장개시전장운영구분코드", "type" : "String", "required" : "Y", "length" : "3", "description" : "장 개시 전 구간의 장운영 상태 코드입니다. 세 자리 숫자이며, 코드에 대응하는 이름은 제공되지 않습니다.", "depth" : 0 }, { "element" : "pgtr_mkop_cls_code", "name" : "프로그램매매장운영구분코드", "type" : "String", "required" : "Y", "length" : "3", "description" : "프로그램매매의 장운영 상태 코드입니다. 세 자리 숫자이며, 코드에 대응하는 이름은 제공되지 않습니다.", "depth" : 0 }, { "element" : "cptn_bltr_mkop_cls_code", "name" : "경쟁대량매매장운영구분코드", "type" : "String", "required" : "Y", "length" : "3", "description" : "경쟁 대량매매의 장운영 상태 코드입니다. 세 자리 숫자이며, 코드에 대응하는 이름은 제공되지 않습니다.", "depth" : 0 }, { "element" : "trst_mkop_cls_code", "name" : "자사주장운영구분코드", "type" : "String", "required" : "Y", "length" : "3", "description" : "자사주 매매의 장운영 상태 코드입니다. 세 자리 숫자이며, 코드에 대응하는 이름은 응답에 함께 오지 않습니다.", "depth" : 0 }, { "element" : "buyin_mkop_cls_code", "name" : "BUYIN장운영구분코드", "type" : "String", "required" : "Y", "length" : "3", "description" : "BUYIN(결제 부족분 강제 매수)의 장운영 상태 코드입니다. 세 자리 숫자이며, 코드에 대응하는 이름은 응답에 함께 오지 않습니다.", "depth" : 0 }, { "element" : "oprc_untp_begn_time", "name" : "시가단일가개시시각", "type" : "String", "required" : "Y", "length" : "9", "description" : "시가 단일가 매매 개시 시각입니다. HHMMSS 형식입니다.", "depth" : 0 }, { "element" : "oprc_untp_clsn_time", "name" : "시가단일가마감시각", "type" : "String", "required" : "Y", "length" : "9", "description" : "시가 단일가 매매 마감 시각입니다. HHMMSS 형식입니다.", "depth" : 0 }, { "element" : "pgm_aspr_fin_time", "name" : "프로그램호가종료시각", "type" : "String", "required" : "Y", "length" : "9", "description" : "프로그램매매 호가 접수 종료 시각입니다. HHMMSS 6자리로 내려옵니다.", "depth" : 0 }, { "element" : "trst_tr_fin_time", "name" : "자사주거래종료시각", "type" : "String", "required" : "Y", "length" : "9", "description" : "자사주 거래가 끝나는 시각입니다. HHMMSS 형식입니다.", "depth" : 0 }, { "element" : "clpr_untp_begn_time", "name" : "종가단일가개시시각", "type" : "String", "required" : "Y", "length" : "9", "description" : "종가 단일가 매매 개시 시각입니다. HHMMSS 형식입니다.", "depth" : 0 }, { "element" : "clpr_untp_fin_time", "name" : "종가단일가종료시각", "type" : "String", "required" : "Y", "length" : "9", "description" : "종가 단일가 매매가 끝나는 시각입니다. HHMMSS 형식입니다.", "depth" : 0 }, { "element" : "mkob_ovtm_begn_time", "name" : "장개시전시간외개시시각", "type" : "String", "required" : "Y", "length" : "9", "description" : "장 개시 전 시간외 매매 개시 시각입니다. HHMMSS 형식입니다.", "depth" : 0 }, { "element" : "mkob_ovtm_fin_time", "name" : "장개시전시간외종료시각", "type" : "String", "required" : "Y", "length" : "9", "description" : "장 개시 전 시간외 매매 종료 시각입니다. HHMMSS 형식입니다.", "depth" : 0 }, { "element" : "mkfa_ovtm_begn_time", "name" : "장종료후시간외개시시각", "type" : "String", "required" : "Y", "length" : "9", "description" : "장 종료 후 시간외 매매 개시 시각입니다. HHMMSS 형식입니다.", "depth" : 0 }, { "element" : "mkfa_ovtm_cntg_indc_time", "name" : "장종료후시간외체결지시시각", "type" : "String", "required" : "Y", "length" : "9", "description" : "장 종료 후 시간외 매매의 체결 지시 시각입니다. HHMMSS 형식입니다.", "depth" : 0 }, { "element" : "mkfa_ovtm_fin_time", "name" : "장종료후시간외종료시각", "type" : "String", "required" : "Y", "length" : "9", "description" : "장 종료 후 시간외 매매 종료 시각입니다. HHMMSS 형식입니다.", "depth" : 0 }, { "element" : "ovtm_untp_begn_time", "name" : "시간외단일가개시시각", "type" : "String", "required" : "Y", "length" : "9", "description" : "시간외 단일가 매매 개시 시각입니다. HHMMSS 형식입니다.", "depth" : 0 }, { "element" : "ovtm_untp_fin_time", "name" : "시간외단일가종료시각", "type" : "String", "required" : "Y", "length" : "9", "description" : "시간외 단일가 매매 종료 시각입니다. HHMMSS 형식입니다.", "depth" : 0 }, { "element" : "pros_date", "name" : "처리일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 장운영 정보가 적용되는 일자입니다. YYYYMMDD 8자리.", "depth" : 0 }, { "element" : "oder_stop_yn", "name" : "주문중지여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "주문 중지 여부입니다.", "depth" : 0 }, { "element" : "oder_trnm_stat_code", "name" : "주문전송상태코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "주문 전송 상태 코드입니다.\n값에 대응하는 이름은 응답에 함께 오지 않습니다.", "depth" : 0 }, { "element" : "itmt_cptn_bltr_fin_time", "name" : "장중경쟁대량매매종료시각", "type" : "String", "required" : "Y", "length" : "9", "description" : "장중 경쟁 대량매매가 끝나는 시각입니다. 앞 6자리(HHMMSS)만 잘라 쓰십시오. 소액채권(24)은 빈 문자열이 내려옵니다.", "depth" : 0 }, { "element" : "gnrl_byng_trns_tr_begn_time", "name" : "일반매입인도거래개시시각", "type" : "String", "required" : "Y", "length" : "9", "description" : "일반 매입인도(BUYIN) 거래 개시 시각입니다. HHMMSS 형식입니다. 소액채권(24)은 빈 문자열이 내려옵니다.", "depth" : 0 }, { "element" : "gnrl_byng_trns_tr_fin_time", "name" : "일반매입인도거래종료시각", "type" : "String", "required" : "Y", "length" : "9", "description" : "일반 매입인도(BUYIN) 거래 종료 시각입니다. HHMMSS 형식입니다. 소액채권(24)은 빈 문자열이 내려옵니다.", "depth" : 0 }, { "element" : "tday_byng_trns_tr_begn_time", "name" : "당일매입인도거래개시시각", "type" : "String", "required" : "Y", "length" : "9", "description" : "당일 매입인도(BUYIN) 거래 개시 시각입니다. HHMMSS 형식입니다. 소액채권(24)은 빈 문자열이 내려옵니다.", "depth" : 0 }, { "element" : "tday_byng_trns_tr_fin_time", "name" : "당일매입인도거래종료시각", "type" : "String", "required" : "Y", "length" : "9", "description" : "당일 매입인도(BUYIN) 거래 종료 시각입니다. HHMMSS 형식입니다. 소액채권(24)은 빈 문자열이 내려옵니다.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "항상 \"0\"으로 내려옵니다. 이 API는 연속조회를 지원하지 않습니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 성공 응답 코드는 \"5766\"(조회 완료)입니다.\n\n오류는 종류와 무관하게 HTTP 500 으로 반환되므로, 성공·실패는 HTTP 상태가 아니라 이 값으로 판정하십시오.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "처리 결과 메시지입니다. 오류일 때 사유가 담기며, 더 자세한 사유는 rsp_sub_msg 에 담깁니다.", "depth" : 0 } ] }, "requestExample" : "GET /reference/v1/market-hours?mkpl_cls_code=01\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": {\n \"mkpl_cls_code\": \"01\",\n \"frml_ovtm_cls_code\": \"0\",\n \"mkop_cls_code\": \"000\",\n \"mkob_mkop_cls_code\": \"000\",\n \"pgtr_mkop_cls_code\": \"000\",\n \"cptn_bltr_mkop_cls_code\": \"000\",\n \"trst_mkop_cls_code\": \"000\",\n \"buyin_mkop_cls_code\": \"000\",\n \"oprc_untp_begn_time\": \"083000000\",\n \"oprc_untp_clsn_time\": \"090000000\",\n \"pgm_aspr_fin_time\": \"152000\",\n \"trst_tr_fin_time\": \"150000000\",\n \"clpr_untp_begn_time\": \"152000000\",\n \"clpr_untp_fin_time\": \"153000000\",\n \"mkob_ovtm_begn_time\": \"083000000\",\n \"mkob_ovtm_fin_time\": \"084000000\",\n \"mkfa_ovtm_begn_time\": \"153000000\",\n \"mkfa_ovtm_cntg_indc_time\": \"154000000\",\n \"mkfa_ovtm_fin_time\": \"160000000\",\n \"ovtm_untp_begn_time\": \"160000000\",\n \"ovtm_untp_fin_time\": \"200000000\",\n \"pros_date\": \"20260911\",\n \"oder_stop_yn\": \"0\",\n \"oder_trnm_stat_code\": \"2\",\n \"itmt_cptn_bltr_fin_time\": \"150000000\",\n \"gnrl_byng_trns_tr_begn_time\": \"153500000\",\n \"gnrl_byng_trns_tr_fin_time\": \"154500000\",\n \"tday_byng_trns_tr_begn_time\": \"175000000\",\n \"tday_byng_trns_tr_fin_time\": \"180000000\"\n },\n \"rsp_cd\": \"5766\",\n \"rsp_msg\": \"조회가 완료되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "국내지수 시세추이 조회", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/market/v1/index/candles/days", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "국내지수 시세추이 조회", "trs" : [ { "name" : "지수 시세추이 조회 (국내, 일-주-월-년봉)", "code" : "ohhts_1514_101r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "조회할 지수의 코드입니다. (예: 코스피 KGG01P)", "depth" : 0 }, { "element" : "period_cls_code", "name" : "조회주기구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "일봉·주봉·월봉·연봉 중 무엇을 조회할지 정합니다. 일봉 D · 주봉 W · 월봉 M · 연봉 Y 를 넣습니다.", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "봉 목록", "type" : "Object Array", "required" : "Y", "length" : "-", "description" : "봉 배열입니다. 최신 일자가 먼저 옵니다.", "depth" : 0 }, { "element" : "date", "name" : "일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "해당 봉의 일자(YYYYMMDD)입니다.\n월봉 조회에서는 마지막 행이 00000000 이고 값이 모두 0인 빈 행으로 올 수 있습니다. 자료가 아니므로 제외하고 쓰십시오.", "depth" : 0 }, { "element" : "prpr", "name" : "지수", "type" : "Number", "required" : "Y", "length" : "14", "description" : "해당 봉의 종가(지수)입니다. 일봉은 그날의 마지막 지수이고, 주봉·월봉은 그 기간의 마지막 거래일 지수입니다.", "depth" : 0 }, { "element" : "prdy_vrss_sign", "name" : "전일대비부호", "type" : "String", "required" : "Y", "length" : "2", "description" : "전일 대비 방향입니다.\n\"2\": 상승\n\"5\": 하락\n\"3\": 보합", "depth" : 0 }, { "element" : "prdy_ctrt", "name" : "전일대비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "전일 대비 등락률(%)입니다.", "depth" : 0 }, { "element" : "oprc", "name" : "시가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "해당 봉 기간의 첫 체결 가격(시가)입니다. 주봉·월봉에서는 그 기간 첫 거래일의 시가입니다.", "depth" : 0 }, { "element" : "hprc", "name" : "고가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "해당 봉 기간 중 가장 높았던 체결 가격(고가)입니다. 주봉·월봉에서는 그 기간 전체의 최고가입니다.", "depth" : 0 }, { "element" : "lprc", "name" : "저가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "해당 봉 기간 중 가장 낮았던 체결 가격(저가)입니다. 주봉·월봉에서는 그 기간 전체의 최저가입니다.", "depth" : 0 }, { "element" : "acml_vol", "name" : "누적거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "해당 봉 기간 동안 체결된 주식 수를 모두 더한 값입니다. 개별 체결 수량이 아닙니다.", "depth" : 0 }, { "element" : "acml_tr_pbmn", "name" : "누적거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "해당 봉 기간 동안 체결된 거래대금을 모두 더한 값입니다.", "depth" : 0 } ] }, "requestExample" : "GET /market/v1/index/candles/days?iscd=KGG01P&period_cls_code=D", "responseExample" : "{\n \"data\": [\n {\n \"date\": \"20260928\",\n \"prpr\": 2487.15,\n \"prdy_vrss_sign\": \"2\",\n \"prdy_ctrt\": 0.63,\n \"oprc\": 2475.00,\n \"hprc\": 2491.30,\n \"lprc\": 2468.90,\n \"acml_vol\": 512345678,\n \"acml_tr_pbmn\": 8123456789000\n },\n {\n \"date\": \"20260925\",\n \"prpr\": 2471.50,\n \"prdy_vrss_sign\": \"5\",\n \"prdy_ctrt\": -0.41,\n \"oprc\": 2480.10,\n \"hprc\": 2483.00,\n \"lprc\": 2465.20,\n \"acml_vol\": 498765432,\n \"acml_tr_pbmn\": 7891234567000\n }\n ],\n \"rsp_cd\": \"0000\",\n \"rsp_msg\": \"정상 처리 되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "국내지수 시세추이 조회 (분봉)", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/market/v1/index/candles/minutes", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "국내지수 시세추이 조회 (분봉)", "trs" : [ { "name" : "지수 시세추이 조회 (국내, 분봉)", "code" : "ohhts_8001_002r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "조회할 지수의 코드입니다. (예: 코스피 KGG01P)", "depth" : 0 }, { "element" : "hour_cls_code", "name" : "봉 간격(초)", "type" : "String", "required" : "Y", "length" : "7", "description" : "봉 간격을 초 단위로 입력합니다. 60은 1분봉, 300은 5분봉입니다.\n\n반드시 넣으셔야 합니다.", "depth" : 0 }, { "element" : "from", "name" : "조회 시작일자", "type" : "String", "required" : "N", "length" : "8", "description" : "조회 시작일자입니다. YYYYMMDD 8자리이며 to 와 함께 넣어 기간을 지정합니다. (query string)", "depth" : 0 }, { "element" : "to", "name" : "조회 종료일자", "type" : "String", "required" : "N", "length" : "8", "description" : "조회 종료일자입니다. YYYYMMDD 8자리.\nfrom과 함께 사용합니다. (query string)", "depth" : 0 }, { "element" : "past_data_incu_yn", "name" : "과거데이터포함여부", "type" : "String", "required" : "N", "length" : "2", "description" : "과거 데이터 포함 여부입니다. \"Y\" 또는 \"N\" 을 넣습니다.", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "분봉 목록", "type" : "Object Array", "required" : "Y", "length" : "-", "description" : "분봉 배열입니다.", "depth" : 0 }, { "element" : "date", "name" : "일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "체결이 일어난 일자(YYYYMMDD)입니다.", "depth" : 0 }, { "element" : "cntg_hour", "name" : "체결시간", "type" : "String", "required" : "Y", "length" : "6", "description" : "해당 봉의 체결 시각(HHMMSS)입니다.\n888888, 999999 처럼 시각이 아닌 값이 내려오는 행이 있습니다.", "depth" : 0 }, { "element" : "prpr", "name" : "지수", "type" : "Number", "required" : "Y", "length" : "14", "description" : "현재가입니다.", "depth" : 0 }, { "element" : "oprc", "name" : "시가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "시가입니다.", "depth" : 0 }, { "element" : "hprc", "name" : "고가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "고가입니다.", "depth" : 0 }, { "element" : "lprc", "name" : "저가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "저가입니다.", "depth" : 0 }, { "element" : "cntg_vol", "name" : "체결거래량", "type" : "Number", "required" : "Y", "length" : "12", "description" : "해당 봉 구간의 체결 거래량입니다.", "depth" : 0 } ] }, "requestExample" : "GET /market/v1/index/candles/minutes?iscd=KGG01P&hour_cls_code=60", "responseExample" : "{\n \"data\": [\n {\n \"date\": \"20260928\",\n \"cntg_hour\": \"101530\",\n \"prpr\": 2483.40,\n \"oprc\": 2482.90,\n \"hprc\": 2483.80,\n \"lprc\": 2482.50,\n \"cntg_vol\": 182340\n }\n ],\n \"rsp_cd\": \"0000\",\n \"rsp_msg\": \"정상 처리 되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "국내지수 현재가 조회", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/market/v1/index/prices", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "국내지수 현재가 조회", "trs" : [ { "name" : "지수 현재가 조회 (국내)", "code" : "ohhts_1514_001r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "조회할 지수의 코드입니다. (예: 코스피 KGG01P)", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "DATA", "type" : "Object", "required" : "Y", "length" : "-", "description" : "지수 현재가 정보입니다. 현재지수와 전일 대비 등락, 시가·고가·저가, 상승·하락 종목 수, 52주 최고·최저 지수가 한 건으로 내려옵니다.", "depth" : 0 }, { "element" : "kor_isnm", "name" : "한글종목명", "type" : "String", "required" : "Y", "length" : "65", "description" : "지수의 한글 명칭입니다.", "depth" : 0 }, { "element" : "stck_prpr", "name" : "현재지수", "type" : "Number", "required" : "Y", "length" : "13", "description" : "가장 최근 체결된 가격입니다.", "depth" : 0 }, { "element" : "prdy_clpr", "name" : "전일종가", "type" : "Number", "required" : "Y", "length" : "10", "description" : "전일 종가(전일 지수)입니다.", "depth" : 0 }, { "element" : "acml_tr_pbmn", "name" : "누적거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "장 시작부터 지금까지 체결된 거래대금을 모두 더한 값입니다.", "depth" : 0 }, { "element" : "prdy_vrss", "name" : "전일대비", "type" : "Number", "required" : "Y", "length" : "13", "description" : "전일 대비 변화량입니다. 부호는 prdy_vrss_sign으로 판단합니다.", "depth" : 0 }, { "element" : "prdy_vrss_sign", "name" : "전일대비부호", "type" : "String", "required" : "Y", "length" : "2", "description" : "전일 대비 방향입니다.\n\"2\": 상승\n\"5\": 하락\n\"3\": 보합", "depth" : 0 }, { "element" : "prdy_ctrt", "name" : "전일대비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "전일 대비 등락률(%)입니다.", "depth" : 0 }, { "element" : "acml_vol", "name" : "누적거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "장 시작부터 지금까지 체결된 주식 수를 모두 더한 값입니다. 개별 체결 수량이 아닙니다.", "depth" : 0 }, { "element" : "tr_frmt_issu_cnt", "name" : "거래형성종목수", "type" : "Number", "required" : "Y", "length" : "13", "description" : "이 지수 구성 종목 중 거래가 형성된 종목 수입니다.", "depth" : 0 }, { "element" : "tr_frmt_ctrt", "name" : "거래형성대비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "거래형성종목수의 전일 대비 비율(%)입니다.", "depth" : 0 }, { "element" : "stck_last_tr_date", "name" : "최종거래일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "가장 최근 거래가 있었던 일자(YYYYMMDD)입니다.", "depth" : 0 }, { "element" : "mtrt_date", "name" : "만기일", "type" : "String", "required" : "Y", "length" : "8", "description" : "만기일(YYYYMMDD)입니다.", "depth" : 0 }, { "element" : "oprc", "name" : "시가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "당일 첫 체결 가격(시가)입니다.", "depth" : 0 }, { "element" : "oprc_hour", "name" : "시가시간", "type" : "String", "required" : "Y", "length" : "6", "description" : "시가가 형성된 시각(HHMMSS)입니다.", "depth" : 0 }, { "element" : "prdy_clpr_vrss_oprc", "name" : "전일종가대비시가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "전일 종가 대비 시가의 차이입니다.", "depth" : 0 }, { "element" : "prdy_clpr_vrss_oprc_rate", "name" : "전일종가대비시가비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "전일 종가 대비 시가의 비율(%)입니다.", "depth" : 0 }, { "element" : "hprc", "name" : "고가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "당일 장중 가장 높았던 체결 가격(고가)입니다.", "depth" : 0 }, { "element" : "hgpr_hour", "name" : "최고가시간", "type" : "String", "required" : "Y", "length" : "6", "description" : "고가가 형성된 시각(HHMMSS)입니다.", "depth" : 0 }, { "element" : "prdy_clpr_vrss_hgpr", "name" : "전일종가대비고가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "전일 종가 대비 고가의 차이입니다.", "depth" : 0 }, { "element" : "prdy_clpr_vrss_hgpr_rate", "name" : "전일종가대비고가비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "전일 종가 대비 고가의 비율(%)입니다.", "depth" : 0 }, { "element" : "lprc", "name" : "저가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "당일 장중 가장 낮았던 체결 가격(저가)입니다.", "depth" : 0 }, { "element" : "lwpr_hour", "name" : "최저가시간", "type" : "String", "required" : "Y", "length" : "6", "description" : "저가가 형성된 시각(HHMMSS)입니다.", "depth" : 0 }, { "element" : "prdy_clpr_vrss_lwpr", "name" : "전일종가대비저가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "전일 종가 대비 저가의 차이입니다.", "depth" : 0 }, { "element" : "prdy_clpr_vrss_lwpr_rate", "name" : "전일종가대비저가비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "전일 종가 대비 저가의 비율(%)입니다.", "depth" : 0 }, { "element" : "ascn_issu_cnt", "name" : "상승종목수", "type" : "Number", "required" : "Y", "length" : "13", "description" : "이 지수 구성 종목 중 상승한 종목 수입니다.", "depth" : 0 }, { "element" : "down_issu_cnt", "name" : "하락종목수", "type" : "Number", "required" : "Y", "length" : "13", "description" : "이 지수 구성 종목 중 하락한 종목 수입니다.", "depth" : 0 }, { "element" : "stnr_issu_cnt", "name" : "보합종목수", "type" : "Number", "required" : "Y", "length" : "13", "description" : "이 지수 구성 종목 중 보합인 종목 수입니다.", "depth" : 0 }, { "element" : "uplm_issu_cnt", "name" : "상한종목수", "type" : "Number", "required" : "Y", "length" : "5", "description" : "이 지수 구성 종목 중 상한가인 종목 수입니다.", "depth" : 0 }, { "element" : "lslm_issu_cnt", "name" : "하한종목수", "type" : "Number", "required" : "Y", "length" : "5", "description" : "이 지수 구성 종목 중 하한가인 종목 수입니다.", "depth" : 0 }, { "element" : "52_week_hghs_nmix", "name" : "52주최고지수", "type" : "Number", "required" : "Y", "length" : "14", "description" : "최근 52주 중 최고 지수 값입니다.", "depth" : 0 }, { "element" : "52_week_hgpr_date", "name" : "52주최고가일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "52주 최고 지수가 기록된 일자(YYYYMMDD)입니다.", "depth" : 0 }, { "element" : "52_week_hgpr_rate", "name" : "52주최고가비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "현재 지수의 52주 최고 지수 대비 비율(%)입니다.", "depth" : 0 }, { "element" : "52_week_lwst_nmix", "name" : "52주최저지수", "type" : "Number", "required" : "Y", "length" : "14", "description" : "최근 52주 중 최저 지수 값입니다.", "depth" : 0 }, { "element" : "52_week_lwpr_date", "name" : "52주최저가일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "52주 최저 지수가 기록된 일자(YYYYMMDD)입니다.", "depth" : 0 }, { "element" : "52_week_lwpr_rate", "name" : "52주최저가비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "현재 지수의 52주 최저 지수 대비 비율(%)입니다.", "depth" : 0 } ] }, "requestExample" : "GET /market/v1/index/prices?iscd=KGG01P", "responseExample" : "{\n \"data\": {\n \"kor_isnm\": \"코스피\",\n \"stck_prpr\": 2487.15,\n \"prdy_clpr\": 2471.50,\n \"acml_tr_pbmn\": 8123456789000,\n \"prdy_vrss\": 15.65,\n \"prdy_vrss_sign\": \"2\",\n \"prdy_ctrt\": 0.63,\n \"acml_vol\": 512345678,\n \"tr_frmt_issu_cnt\": 820,\n \"tr_frmt_ctrt\": 1.2,\n \"stck_last_tr_date\": \"20260928\",\n \"mtrt_date\": \"\",\n \"oprc\": 2475.00,\n \"oprc_hour\": \"090000\",\n \"prdy_clpr_vrss_oprc\": 3.50,\n \"prdy_clpr_vrss_oprc_rate\": 0.14,\n \"hprc\": 2491.30,\n \"hgpr_hour\": \"133512\",\n \"prdy_clpr_vrss_hgpr\": 19.80,\n \"prdy_clpr_vrss_hgpr_rate\": 0.80,\n \"lprc\": 2468.90,\n \"lwpr_hour\": \"090530\",\n \"prdy_clpr_vrss_lwpr\": -2.60,\n \"prdy_clpr_vrss_lwpr_rate\": -0.11,\n \"ascn_issu_cnt\": 540,\n \"down_issu_cnt\": 310,\n \"stnr_issu_cnt\": 70,\n \"uplm_issu_cnt\": 3,\n \"lslm_issu_cnt\": 1,\n \"52_week_hghs_nmix\": 2602.40,\n \"52_week_hgpr_date\": \"20260815\",\n \"52_week_hgpr_rate\": -4.43,\n \"52_week_lwst_nmix\": 2180.70,\n \"52_week_lwpr_date\": \"20260110\",\n \"52_week_lwpr_rate\": 14.05\n },\n \"rsp_cd\": \"0000\",\n \"rsp_msg\": \"정상 처리 되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] } ] }, { "name" : "해외주식", "apis" : [ { "name" : "해외주식 매수 주문", "protocol" : "REST", "method" : "POST", "domain" : "", "url" : "/trading/v1/overseas/orders/buy", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "해외주식 매수 주문을 접수합니다.", "trs" : [ { "name" : "해외주식 매수 주문", "code" : "obtro_oder_101a", "request" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출하기 위한 Request Body 데이터 포맷으로 \"application/json; charset=utf-8\" 설정", "depth" : 0 }, { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "ovrs_stck_symb_iscd", "name" : "해외주식심볼종목코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "해외주식 심볼입니다. (예: \"AAPL\")", "depth" : 0 }, { "element" : "ovrs_exch_vndr_idno", "name" : "해외거래소벤더식별번호", "type" : "String", "required" : "Y", "length" : "6", "description" : "종목이 상장된 거래소 코드입니다.\n\"0321\": 뉴욕(NYSE)\n\"0537\": 나스닥(NASDAQ)\n\"0066\": 아멕스(AMEX)\n\"0104\": 홍콩\n\"0215\": 상해\n\"0106\": 도쿄\n전체 목록은 해외 거래소 조회(/reference/v1/overseas/exchanges)로 확인하십시오.", "depth" : 0 }, { "element" : "oder_cls_code", "name" : "주문구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "주문 구분 코드\n\"01\": 지정가\n\"05\": 시장가\n\"31\": LOO (장 개시 지정가)\n\"32\": LOC (장 마감 지정가)\n\"33\": MOO (장 개시 시장가)\n\"34\": MOC (장 마감 시장가)\n\"35\": Limit VWAP\n\"36\": Limit TWAP\n\"37\": VWAP\n\"38\": TWAP", "depth" : 0 }, { "element" : "oder_cond_cls_code", "name" : "주문조건구분코드", "type" : "String", "required" : "N", "length" : "1", "description" : "주문 조건입니다.\n\"0\": 조건 없음\n\"2\": 개장 전\n\"7\": 종가 \noder_cls_code 가 01 지정가, 05시장가의 경우 0 \n31 LOO, 33 MOO의 경우 2 \n 32 LOC, 34 MOC의 경우 7 \n35, 36, 37, 38 (VWAP/TWAP계열)은 0", "depth" : 0 }, { "element" : "odqt", "name" : "주문수량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "주문 수량입니다.", "depth" : 0 }, { "element" : "ovrs_stck_oder_prc", "name" : "주문가격", "type" : "String", "required" : "Y", "length" : "20", "description" : "주문 단가입니다(현지 통화). 소수점 이하 4자리까지 입력할 수 있으며, 초과하면 IGW50002 오류로 거절됩니다.\n지정가 계열(oder_cls_code \"01\" \"31\" \"32\" \"35\" \"36\")은 단가를, 시장가 계열(\"05\" \"33\" \"34\" \"37\" \"38\")은 0을 넣습니다.", "depth" : 0 }, { "element" : "warn_cnfr_yn", "name" : "경고확인여부", "type" : "String", "required" : "N", "length" : "1", "description" : "경고 확인 여부\n\"N\": 미확인\n\"Y\": 확인\n평소에는 넣지 않아도 됩니다. 응답의 warn_cls_code 가 \"1\"(경고) 또는 \"3\"(미국 PTP 종목 과세 확인)이면 warn_msg 내용을 확인한 뒤 같은 요청에 이 값을 \"Y\"로 넣어 재전송합니다.", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "DATA", "type" : "Object", "required" : "Y", "length" : "-", "description" : "주문 접수 결과입니다. 접수된 주문 번호와 경고 여부가 내려옵니다.", "depth" : 0 }, { "element" : "oder_no", "name" : "주문번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "이번 요청으로 채번된 주문 번호입니다. 이 주문을 정정·취소할 때 해외주식 주문 정정(/trading/v1/overseas/orders/modify)·취소(/trading/v1/overseas/orders/cancel)의 orgl_oder_no 에 넣는 값입니다.", "depth" : 0 }, { "element" : "warn_cls_code", "name" : "경고구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "경고 구분 코드\n\"0\": 정상 접수\n\n경고 ― \"1\"(경고) · \"3\"(미국 PTP 종목 과세 확인)\nwarn_msg 내용을 확인한 뒤 같은 요청을 warn_cnfr_yn \"Y\"로 재전송하십시오.\n\n보류 ― \"2\"", "depth" : 0 }, { "element" : "warn_msg", "name" : "메시지내용", "type" : "String", "required" : "Y", "length" : "100", "description" : "경고 또는 안내 문구입니다. 해당 사항이 없으면 빈 값입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "응답 코드\n\"0001\": 주문 접수 성공\n오류는 종류와 무관하게 HTTP 500 으로 반환되며 사유는 rsp_msg 에 담깁니다.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 이 값에 담깁니다.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "항상 \"0\"으로 내려옵니다. 이 API는 연속조회를 지원하지 않습니다.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "오류일 때만 내려오며 조치 정보가 담깁니다.\n정상 응답에는 포함되지 않습니다.", "depth" : 0 } ] }, "requestExample" : "POST /trading/v1/overseas/orders/buy\nContent-Type: application/json; charset=utf-8\nauthorization: Bearer {access_token}\n\n{\n \"ovrs_stck_symb_iscd\": \"AAPL\",\n \"ovrs_exch_vndr_idno\": \"0537\",\n \"oder_cls_code\": \"01\",\n \"oder_cond_cls_code\": \"0\",\n \"odqt\": 1,\n \"ovrs_stck_oder_prc\": 150.00\n}", "responseExample" : "{\n \"data\": {\n \"oder_no\": 284260,\n \"warn_cls_code\": \"0\",\n \"warn_msg\": \"\"\n },\n \"rsp_cd\": \"0001\",\n \"rsp_msg\": \"주문이 완료되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "해외주식 매도 주문", "protocol" : "REST", "method" : "POST", "domain" : "", "url" : "/trading/v1/overseas/orders/sell", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "보유 해외주식의 매도 주문을 접수합니다.", "trs" : [ { "name" : "해외주식 매도 주문", "code" : "obtro_oder_101a", "request" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출하기 위한 Request Body 데이터 포맷으로 \"application/json; charset=utf-8\" 설정", "depth" : 0 }, { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "ovrs_stck_symb_iscd", "name" : "해외주식심볼종목코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "해외주식 심볼입니다. (예: \"AAPL\")", "depth" : 0 }, { "element" : "ovrs_exch_vndr_idno", "name" : "해외거래소벤더식별번호", "type" : "String", "required" : "Y", "length" : "6", "description" : "종목이 상장된 거래소 코드입니다.\n미국 ― \"0321\": 뉴욕(NYSE), \"0537\": 나스닥(NASDAQ), \"0066\": 아멕스(AMEX)\n중화권 ― \"0104\": 홍콩, \"0215\": 상해, \"0214\": 심천\n일본 ― \"0106\": 도쿄, \"0107\": 오사카, \"0112\": 자스닥\n베트남 ― \"0770\": 호치민, \"0771\": 하노이\n전체 목록은 해외 거래소 조회(/reference/v1/overseas/exchanges)로 확인하십시오.", "depth" : 0 }, { "element" : "oder_cls_code", "name" : "주문구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "주문 구분 코드\n\"01\": 지정가\n\"05\": 시장가\n\"31\": LOO (장 개시 지정가)\n\"32\": LOC (장 마감 지정가)\n\"33\": MOO (장 개시 시장가)\n\"34\": MOC (장 마감 시장가)\n\"35\": Limit VWAP\n\"36\": Limit TWAP\n\"37\": VWAP\n\"38\": TWAP\n\n지정가 계열(\"01\" \"31\" \"32\" \"35\" \"36\")은 ovrs_stck_oder_prc 에 단가를 넣고, 시장가 계열(\"05\" \"33\" \"34\" \"37\" \"38\")은 0을 넣습니다.", "depth" : 0 }, { "element" : "oder_cond_cls_code", "name" : "주문조건구분코드", "type" : "String", "required" : "N", "length" : "1", "description" : "주문 조건입니다.\n\"0\": 조건 없음\n\"2\": 개장 전\n\"7\": 종가\n\n 지정가·시장가 주문은 넣지 않으셔도 됩니다.\noder_cls_code 가 01 지정가, 05시장가의 경우 0 \n31 LOO, 33 MOO의 경우 2 \n 32 LOC, 34 MOC의 경우 7 \n35, 36, 37, 38 (VWAP/TWAP계열)은 0", "depth" : 0 }, { "element" : "odqt", "name" : "주문수량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "주문 수량입니다.", "depth" : 0 }, { "element" : "ovrs_stck_oder_prc", "name" : "주문가격", "type" : "String", "required" : "Y", "length" : "20", "description" : "주문 단가입니다(현지 통화). 소수점 이하 4자리까지 입력할 수 있으며, 초과하면 IGW50002 오류로 거절됩니다.\n지정가 계열(oder_cls_code \"01\" \"31\" \"32\" \"35\" \"36\")은 단가를, 시장가 계열(\"05\" \"33\" \"34\" \"37\" \"38\")은 0을 넣습니다.", "depth" : 0 }, { "element" : "warn_cnfr_yn", "name" : "경고확인여부", "type" : "String", "required" : "N", "length" : "1", "description" : "경고 확인 여부\n\"N\": 미확인\n\"Y\": 확인\n평소에는 넣지 않으셔도 됩니다. 응답의 warn_cls_code 가 \"1\"(경고) 또는 \"3\"(미국 PTP 종목 과세 확인)이면 warn_msg 내용을 확인한 뒤 같은 요청에 이 값을 \"Y\" 로 넣어 다시 보내십시오.", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "DATA", "type" : "Object", "required" : "Y", "length" : "-", "description" : "주문 접수 결과입니다. 접수된 주문 번호와 경고 여부가 내려옵니다.", "depth" : 0 }, { "element" : "oder_no", "name" : "주문번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "이번 요청으로 채번된 주문 번호입니다.\n이 주문을 다시 정정·취소할 때 해외주식 주문 정정(/trading/v1/overseas/orders/modify)·취소(/trading/v1/overseas/orders/cancel)의 orgl_oder_no 에 넣는 값입니다.", "depth" : 0 }, { "element" : "warn_cls_code", "name" : "경고구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "경고 구분 코드\n\"0\": 정상 접수\n\"1\": 경고\n\"2\": 보류\n\"3\": 미국 PTP 종목 과세 확인\n\n\"1\" 또는 \"3\" 이면 warn_msg 내용을 확인한 뒤 같은 요청을 warn_cnfr_yn \"Y\" 로 재전송하십시오.", "depth" : 0 }, { "element" : "warn_msg", "name" : "메시지내용", "type" : "String", "required" : "Y", "length" : "100", "description" : "경고 또는 안내 문구입니다. 해당 사항이 없으면 빈 값입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "응답 코드\n\"0001\": 주문 접수 성공\n사유는 rsp_msg 에 담깁니다.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 이 값에 담깁니다.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "연속조회 여부입니다.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "오류일 때 구체적인 사유가 담기는 경우 내려옵니다.", "depth" : 0 } ] }, "requestExample" : "POST /trading/v1/overseas/orders/sell\nContent-Type: application/json; charset=utf-8\nauthorization: Bearer {access_token}\n\n{\n \"ovrs_stck_symb_iscd\": \"TSLA\",\n \"ovrs_exch_vndr_idno\": \"0537\",\n \"oder_cls_code\": \"01\",\n \"oder_cond_cls_code\": \"0\",\n \"odqt\": 1,\n \"ovrs_stck_oder_prc\": 1000\n}", "responseExample" : "{\n \"data\": {\n \"oder_no\": 284260,\n \"warn_cls_code\": \"0\",\n \"warn_msg\": \"\"\n },\n \"rsp_cd\": \"0001\",\n \"rsp_msg\": \"주문이 완료되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "해외주식 주문 정정", "protocol" : "REST", "method" : "POST", "domain" : "", "url" : "/trading/v1/overseas/orders/modify", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "접수된 해외주식 주문의 단가 또는 수량을 정정합니다.", "trs" : [ { "name" : "해외주식 주문 정정", "code" : "obtro_oder_102a", "request" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출하기 위한 Request Body 데이터 포맷으로 \"application/json; charset=utf-8\" 설정", "depth" : 0 }, { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "oder_date", "name" : "주문일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "정정할 주문의 주문일자를 YYYYMMDD 형식으로 넣습니다.", "depth" : 0 }, { "element" : "orgl_oder_no", "name" : "원주문번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "정정할 주문의 번호를 넣습니다. 주문 접수 응답 또는 주문체결내역 조회의 oder_no 입니다.", "depth" : 0 }, { "element" : "oder_cls_code", "name" : "주문구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "주문 구분 코드\n\"01\": 지정가\n\"05\": 시장가\n\"31\": LOO (장 개시 지정가)\n\"32\": LOC (장 마감 지정가)\n\"33\": MOO (장 개시 시장가)\n\"34\": MOC (장 마감 시장가)\n\"35\": Limit VWAP\n\"36\": Limit TWAP\n\"37\": VWAP\n\"38\": TWAP\n\n지정가 계열(\"01\" \"31\" \"32\" \"35\" \"36\")은 ovrs_stck_oder_prc 에 단가를 넣고, 시장가 계열(\"05\" \"33\" \"34\" \"37\" \"38\")은 0을 넣습니다.", "depth" : 0 }, { "element" : "odqt", "name" : "주문수량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "주문 수량입니다.", "depth" : 0 }, { "element" : "ovrs_stck_oder_prc", "name" : "주문가격", "type" : "String", "required" : "Y", "length" : "20", "description" : "정정 후 단가입니다(현지 통화). 소수점 이하 4자리까지 입력할 수 있으며, 초과하면 IGW50002 오류로 거절됩니다.\n지정가 계열(oder_cls_code \"01\" \"31\" \"32\" \"35\" \"36\")은 단가를, 시장가 계열(\"05\" \"33\" \"34\" \"37\" \"38\")은 0을 넣습니다.", "depth" : 0 }, { "element" : "oder_cond_cls_code", "name" : "주문조건구분코드", "type" : "String", "required" : "N", "length" : "1", "description" : "주문 조건입니다.\n\"0\": 조건 없음\n\"2\": 개장 전\n\"7\": 종가\n\n 지정가·시장가 주문은 넣지 않으셔도 됩니다.\noder_cls_code 가 01 지정가, 05시장가의 경우 0 \n31 LOO, 33 MOO의 경우 2 \n 32 LOC, 34 MOC의 경우 7 \n35, 36, 37, 38 (VWAP/TWAP계열)은 0", "depth" : 0 }, { "element" : "warn_cnfr_yn", "name" : "경고확인여부", "type" : "String", "required" : "N", "length" : "1", "description" : "경고 확인 여부\n\"N\": 미확인\n\"Y\": 확인\n평소에는 넣지 않으셔도 됩니다. 응답의 warn_cls_code 가 \"1\"(경고) 또는 \"3\"(미국 PTP 종목 과세 확인)이면 warn_msg 내용을 확인한 뒤 같은 요청에 이 값을 \"Y\" 로 넣어 다시 보내십시오.", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "DATA", "type" : "Object", "required" : "Y", "length" : "-", "description" : "주문 접수 결과입니다. 접수된 주문 번호와 경고 여부가 내려옵니다.", "depth" : 0 }, { "element" : "oder_no", "name" : "주문번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "이번 요청으로 채번된 주문 번호입니다.\n이 주문을 다시 정정·취소할 때 해외주식 주문 정정(/trading/v1/overseas/orders/modify)·취소(/trading/v1/overseas/orders/cancel)의 orgl_oder_no 에 넣는 값입니다.", "depth" : 0 }, { "element" : "warn_cls_code", "name" : "경고구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "경고 구분 코드\n\"0\": 정상 접수\n\"1\": 경고\n\"2\": 보류\n\"3\": 미국 PTP 종목 과세 확인\n\n\"1\" 또는 \"3\" 이면 warn_msg 내용을 확인한 뒤 같은 요청을 warn_cnfr_yn \"Y\" 로 재전송하십시오.", "depth" : 0 }, { "element" : "warn_msg", "name" : "메시지내용", "type" : "String", "required" : "Y", "length" : "100", "description" : "경고 또는 안내 문구입니다. 해당 사항이 없으면 빈 값입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "응답 코드\n\"0001\": 주문 접수 성공\n사유는 rsp_msg 에 담깁니다.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 이 값에 담깁니다.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "연속조회 여부입니다.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "오류일 때 구체적인 사유가 담기는 경우 내려옵니다.", "depth" : 0 } ] }, "requestExample" : "POST /trading/v1/overseas/orders/modify\nContent-Type: application/json; charset=utf-8\nauthorization: Bearer {access_token}\n\n{\n \"oder_date\": \"20260825\",\n \"orgl_oder_no\": 284262,\n \"oder_cls_code\": \"01\",\n \"odqt\": 1,\n \"ovrs_stck_oder_prc\": 1200,\n \"oder_cond_cls_code\": \"0\"\n}", "responseExample" : "{\n \"data\": {\n \"oder_no\": 284260,\n \"warn_cls_code\": \"0\",\n \"warn_msg\": \"\"\n },\n \"rsp_cd\": \"0001\",\n \"rsp_msg\": \"주문이 완료되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "해외주식 주문 취소", "protocol" : "REST", "method" : "POST", "domain" : "", "url" : "/trading/v1/overseas/orders/cancel", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "접수된 해외주식 주문을 취소합니다.", "trs" : [ { "name" : "해외주식 주문 취소", "code" : "obtro_oder_102a", "request" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출하기 위한 Request Body 데이터 포맷으로 \"application/json; charset=utf-8\" 설정", "depth" : 0 }, { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "oder_date", "name" : "주문일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "취소할 주문의 주문일자를 YYYYMMDD 형식으로 넣습니다.", "depth" : 0 }, { "element" : "orgl_oder_no", "name" : "원주문번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "취소할 주문의 번호를 넣습니다. 주문 접수 응답 또는 주문체결내역 조회의 oder_no 입니다.", "depth" : 0 }, { "element" : "oder_cls_code", "name" : "주문구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "원주문의 주문 구분 코드를 그대로 넣습니다.\n\"01\": 지정가\n\"05\": 시장가\n\"31\": LOO\n\"32\": LOC\n\"33\": MOO\n\"34\": MOC\n\"35\": Limit VWAP\n\"36\": Limit TWAP\n\"37\": VWAP\n\"38\": TWAP", "depth" : 0 }, { "element" : "odqt", "name" : "주문수량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "주문 수량입니다.", "depth" : 0 }, { "element" : "warn_cnfr_yn", "name" : "경고확인여부", "type" : "String", "required" : "N", "length" : "1", "description" : "경고 확인 여부\n\"N\": 미확인\n\"Y\": 확인\n평소에는 넣지 않으셔도 됩니다. 응답의 warn_cls_code 가 \"1\"(경고) 또는 \"3\"(미국 PTP 종목 과세 확인)이면 warn_msg 내용을 확인한 뒤 같은 요청에 이 값을 \"Y\"로 넣어 재전송합니다.", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "DATA", "type" : "Object", "required" : "Y", "length" : "-", "description" : "주문 접수 결과입니다. 접수된 주문 번호와 경고 여부가 내려옵니다.", "depth" : 0 }, { "element" : "oder_no", "name" : "주문번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "취소 요청으로 채번된 주문 번호입니다.", "depth" : 0 }, { "element" : "warn_cls_code", "name" : "경고구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "경고 구분 코드\n\"0\": 정상 접수\n\n경고 ― \"1\"(경고) · \"3\"(미국 PTP 종목 과세 확인)\nwarn_msg 내용을 확인한 뒤 같은 요청을 warn_cnfr_yn \"Y\"로 재전송하십시오.\n\n보류 ― \"2\"\n\n국내주식 주문과 값 체계가 다르므로 코드를 공용으로 쓰지 마십시오.", "depth" : 0 }, { "element" : "warn_msg", "name" : "메시지내용", "type" : "String", "required" : "Y", "length" : "100", "description" : "경고 또는 안내 문구입니다. 해당 사항이 없으면 빈 값입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "응답 코드\n\"0001\": 주문 접수 성공\n오류는 종류와 무관하게 HTTP 500 으로 반환되며 사유는 rsp_msg 에 담깁니다.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 이 값에 담깁니다.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "항상 \"0\"으로 내려옵니다. 이 API는 연속조회를 지원하지 않습니다.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "오류일 때만 내려오며 조치 정보가 담깁니다.\n정상 응답에는 포함되지 않습니다.", "depth" : 0 } ] }, "requestExample" : "POST /trading/v1/overseas/orders/cancel\nContent-Type: application/json; charset=utf-8\nauthorization: Bearer {access_token}\n\n{\n \"oder_date\": \"20260825\",\n \"orgl_oder_no\": 284263,\n \"oder_cls_code\": \"01\",\n \"odqt\": 1\n}", "responseExample" : "{\n \"data\": {\n \"oder_no\": 284260,\n \"warn_cls_code\": \"0\",\n \"warn_msg\": \"\"\n },\n \"rsp_cd\": \"0001\",\n \"rsp_msg\": \"주문이 완료되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "해외주식 주문가능금액 조회", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/trading/v1/overseas/orders/estimate", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "해외주식 주문 전에 통화별 주문 가능 금액을 조회합니다.", "trs" : [ { "name" : "해외주식 주문가능금액 조회", "code" : "obtro_acnt_151r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "intg_marg_iqry_yn", "name" : "통합증거금조회여부", "type" : "String", "required" : "N", "length" : "1", "description" : "통합증거금 기준으로 조회할지 지정합니다.\n\"Y\": 통합증거금 기준\n\"N\": 일반 기준 (query string)", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "통화별 주문가능 목록", "type" : "Object Array", "required" : "Y", "length" : "-", "description" : "통화별 주문 가능 금액 배열입니다.\n\n주문 가능 수량은 내려오지 않습니다. 이 조회는 종목과 단가를 받지 않으므로 수량은 직접 계산하셔야 합니다. 호가 단위와 최소 주문 수량은 해외주식 현재가 조회(/market/v1/overseas/prices)의 shnu_aspr_unit · shnu_oder_qty_unit 으로 확인하십시오.", "depth" : 0 }, { "element" : "crcd", "name" : "통화코드", "type" : "String", "required" : "Y", "length" : "3", "description" : "통화 코드입니다.", "depth" : 0 }, { "element" : "stnd_deps_camt", "name" : "외화예수금", "type" : "String", "required" : "Y", "length" : "20", "description" : "해당 통화의 예수금입니다.", "depth" : 0 }, { "element" : "exrt", "name" : "기준환율", "type" : "String", "required" : "Y", "length" : "12", "description" : "원화 환산에 적용된 환율입니다.", "depth" : 0 }, { "element" : "stnd_evdn_camt", "name" : "증거금", "type" : "String", "required" : "Y", "length" : "20", "description" : "증거금입니다.", "depth" : 0 }, { "element" : "othr_crnc_evdn_camt", "name" : "타통화증거금", "type" : "String", "required" : "Y", "length" : "20", "description" : "다른 통화 잔액을 증거금으로 활용한 금액입니다.", "depth" : 0 }, { "element" : "pcur_oder_able_camt", "name" : "주문가능금액(원화)", "type" : "String", "required" : "Y", "length" : "20", "description" : "주문 가능 금액을 원화로 환산한 값입니다. oder_crnc_oder_able_camt x exrt 와 같습니다.", "depth" : 0 }, { "element" : "oder_crnc_oder_able_camt", "name" : "주문가능금액(주문통화)", "type" : "String", "required" : "Y", "length" : "20", "description" : "주문 통화 기준 주문 가능 금액입니다.", "depth" : 0 }, { "element" : "camt", "name" : "재매매가능금액", "type" : "String", "required" : "Y", "length" : "20", "description" : "재매매 가능 금액입니다.", "depth" : 0 }, { "element" : "frcr_amt", "name" : "외화추정예수금", "type" : "String", "required" : "Y", "length" : "20", "description" : "외화 추정 예수금입니다. 현재 예수금은 stnd_deps_camt 입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 성공 응답 코드입니다.\n\"5766\": 조회 완료\n\"5820\": 조회할 자료 없음\n\n오류는 종류와 무관하게 HTTP 500 으로 반환되므로, 성공·실패는 HTTP 상태가 아니라 이 값으로 판정하십시오.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 이 값에 담깁니다.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "항상 \"0\"으로 내려옵니다. 이 API는 연속조회를 지원하지 않습니다.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "오류일 때만 내려오며 조치 정보가 담깁니다.\n정상 응답에는 포함되지 않습니다.", "depth" : 0 } ] }, "requestExample" : "GET /trading/v1/overseas/orders/estimate?intg_marg_iqry_yn=Y\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": [\n {\n \"crcd\": \"USD\",\n \"stnd_deps_camt\": \"13233.1900\",\n \"exrt\": \"1338.2000\",\n \"stnd_evdn_camt\": \"0.0000\",\n \"othr_crnc_evdn_camt\": \"0.0000\",\n \"pcur_oder_able_camt\": \"17708654.0000\",\n \"oder_crnc_oder_able_camt\": \"13233.1900\",\n \"camt\": \"0.0000\",\n \"frcr_amt\": \"13233.190\"\n }\n ],\n \"rsp_cd\": \"5766\",\n \"rsp_msg\": \"조회가 완료되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "해외주식 당일 주문체결내역 조회", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/trading/v1/overseas/orders/today", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "당일 해외주식 주문·체결 내역을 조회합니다. 당일 건만 내려오므로 정정·취소 대상을 찾거나 방금 낸 주문의 체결 여부를 확인할 때 사용하십시오.", "trs" : [ { "name" : "해외주식 당일 주문체결내역 조회", "code" : "obtro_oder_103r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "cntg_cls_code", "name" : "체결구분코드", "type" : "String", "required" : "N", "length" : "1", "description" : "체결 여부 구분입니다.\n\"0\": 전체\n\"1\": 체결\n\"2\": 미체결", "depth" : 0 }, { "element" : "seln_byov_clcd", "name" : "매도매수구분코드", "type" : "String", "required" : "N", "length" : "1", "description" : "매도·매수 구분입니다.\n\"0\": 전체\n\"1\": 매도\n\"2\": 매수", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "당일 주문체결 내역 목록", "type" : "Object Array", "required" : "Y", "length" : "-", "description" : "당일 주문·체결 내역 배열입니다.", "depth" : 0 }, { "element" : "oder_date", "name" : "주문일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "주문일자입니다. YYYYMMDD 형식입니다. 정정·취소 요청에 이 값을 함께 넣습니다.", "depth" : 0 }, { "element" : "oder_no", "name" : "주문번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "주문 번호입니다. 정정·취소 요청의 orgl_oder_no 에 이 값을 넣습니다.", "depth" : 0 }, { "element" : "orgl_oder_no", "name" : "원주문번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "정정·취소 주문이 직접 대상으로 삼은 주문의 번호입니다. 신규 주문은 0 입니다.", "depth" : 0 }, { "element" : "ovrs_stck_mrkt_tr_cls_code", "name" : "해외주식시장거래구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "해외 시장 거래 구분입니다. \"01\": 미국, \"02\": 홍콩, \"03\": 상해, \"04\": 심천, \"05\": 일본.\n그 밖의 값: \"06\" 호주, \"07\" 싱가폴, \"08\" 런던, \"10\" 독일, \"12\" 프랑스, \"21\" 캐나다, \"24\" 베트남, \"26\" 스위스 등.", "depth" : 0 }, { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "종목 코드입니다. 심볼에 거래소 접미어가 붙은 형태입니다. (예: \"PLTR.OQ\")", "depth" : 0 }, { "element" : "iscd_name", "name" : "종목코드명", "type" : "String", "required" : "Y", "length" : "40", "description" : "종목명입니다.", "depth" : 0 }, { "element" : "seln_byov_clcd", "name" : "매도매수구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "매매 구분입니다.\n\"1\": 매도\n\"2\": 매수", "depth" : 0 }, { "element" : "aspr_type_code", "name" : "호가유형코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "호가 유형입니다.\n\"1\": 시장가\n\"2\": 지정가\n\"4\": LOO\n\"5\": LOC\n\"6\": MOO\n\"7\": MOC\n\"8\": Limit VWAP\n\"9\": Limit TWAP\n\"A\": VWAP\n\"B\": TWAP", "depth" : 0 }, { "element" : "oder_cond_cls_code", "name" : "주문조건구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "주문의 조건 코드입니다.", "depth" : 0 }, { "element" : "odqt", "name" : "주문수량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "주문 수량입니다.", "depth" : 0 }, { "element" : "rctf_odqt", "name" : "정정주문수량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "정정 요청한 수량입니다.", "depth" : 0 }, { "element" : "cncl_odqt", "name" : "취소주문수량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "취소 요청한 수량입니다.", "depth" : 0 }, { "element" : "rctf_cnfr_qty", "name" : "정정확인수량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "정정이 확정된 수량입니다.", "depth" : 0 }, { "element" : "cncl_cnfr_qty", "name" : "취소확인수량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "취소가 확정된 수량입니다.", "depth" : 0 }, { "element" : "ovrs_stck_oder_prc", "name" : "주문가격", "type" : "String", "required" : "Y", "length" : "20", "description" : "주문 단가입니다.", "depth" : 0 }, { "element" : "cntg_qty", "name" : "체결수량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "체결된 수량입니다. 미체결 건은 0입니다.", "depth" : 0 }, { "element" : "cntg_crnc_prc", "name" : "체결통화가격", "type" : "String", "required" : "Y", "length" : "20", "description" : "체결 단가입니다. 미체결 건은 0입니다. 거래 통화 기준입니다.", "depth" : 0 }, { "element" : "ncnt_qty", "name" : "미체결수량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "미체결 수량입니다.", "depth" : 0 }, { "element" : "oder_able_qty", "name" : "주문가능수량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "정정·취소가 가능한 수량입니다.", "depth" : 0 }, { "element" : "oder_rctf_cncl_cls_code", "name" : "주문정정취소구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "이 행이 원주문인지 정정·취소인지 구분합니다.\n\"0\": 원주문\n\"1\": 정정\n\"2\": 취소", "depth" : 0 }, { "element" : "oder_exec_ymdh", "name" : "주문실행일시", "type" : "String", "required" : "Y", "length" : "19", "description" : "주문이 접수된 일시입니다. \"YYYY-MM-DD HH:MM:SS\" 형식입니다.", "depth" : 0 }, { "element" : "ovrs_stck_oder_stat_cls_code", "name" : "주문상태구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "주문의 접수 처리 상태입니다.\n\"0\": 정상\n\"1\": 거부\n\"2\": 자동거부\n\"3\": 자동취소(체결후)\n\"4\": 미접수", "depth" : 0 }, { "element" : "onln_yn", "name" : "온라인 주문가능 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "온라인으로 접수된 건인지 여부입니다.\n\"Y\": 온라인\n\"N\": 영업점", "depth" : 0 }, { "element" : "ovrs_stck_symb_iscd", "name" : "해외주식심볼종목코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "거래소 접미어를 뗀 순수 심볼입니다. (예: \"PLTR\")", "depth" : 0 }, { "element" : "ovrs_exch_vndr_idno", "name" : "해외거래소벤더식별번호", "type" : "String", "required" : "Y", "length" : "6", "description" : "종목이 상장된 거래소 코드입니다.\n\"0537\": 나스닥\n\"0321\": 뉴욕\n\"0066\": 아멕스\n\"0104\": 홍콩\n\"0215\": 상해\n\"0214\": 심천\n\"0106\": 도쿄\n\"0000\": 장외(OTC)\n\n전체 목록은 해외 거래소 조회(/reference/v1/overseas/exchanges)로 얻으실 수 있습니다.", "depth" : 0 }, { "element" : "ovrs_stck_rfus_idnt_code", "name" : "거부식별코드", "type" : "String", "required" : "Y", "length" : "10", "description" : "주문 거부를 식별하는 코드입니다. 거부 사유는 ovrs_stck_rfus_reas 를 읽으십시오.", "depth" : 0 }, { "element" : "ovrs_stck_rfus_reas", "name" : "거부사유", "type" : "String", "required" : "Y", "length" : "100", "description" : "주문이 거부된 경우의 사유입니다. 정상 접수 건은 빈 값입니다.", "depth" : 0 }, { "element" : "deal_cls_code", "name" : "매매구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "매매 구분입니다.\n\"0\": 상계\n\"1\": 매도\n\"2\": 매수\n\"3\": 매수청산\n\"4\": 매도청산\n\"5\": 권리행사\n\"6\": 의무배정\n\"7\": 행사포기\n\"8\": 의무면제", "depth" : 0 }, { "element" : "oder_pros_time", "name" : "주문처리시각", "type" : "String", "required" : "Y", "length" : "9", "description" : "주문 처리 시각입니다.", "depth" : 0 }, { "element" : "dcpn_loeq_ciph", "name" : "소수점이하자릿수", "type" : "Number", "required" : "Y", "length" : "5", "description" : "소수점 이하 자릿수입니다.", "depth" : 0 }, { "element" : "byov_unit_qty", "name" : "매수단위수량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "매수 주문 수량 단위입니다.", "depth" : 0 }, { "element" : "seln_unit_qty", "name" : "매도단위수량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "매도 주문 수량 단위입니다.", "depth" : 0 }, { "element" : "rctf_cncl_cls_code", "name" : "정정취소구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "정정·취소 처리 상태입니다.\n\"1\": 정상\n\"2\": 정정\n\"3\": 취소\n\noder_rctf_cncl_cls_code 와 코드 체계가 다릅니다. 이 행이 원주문인지 정정·취소인지는 oder_rctf_cncl_cls_code 로 판단하십시오.", "depth" : 0 }, { "element" : "loan_date", "name" : "대출일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "대출 일자입니다. 대출 주문이 아니면 빈 값입니다.", "depth" : 0 }, { "element" : "loan_srno", "name" : "대출일련번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "대출 일련번호입니다.", "depth" : 0 }, { "element" : "loan_dtl_type_code", "name" : "대출상세유형코드", "type" : "String", "required" : "Y", "length" : "4", "description" : "대출 상세 유형입니다.\n\"0000\": 보통\n\"0101\": 자기융자\n\"0102\": 유통융자\n\"0103\": 자기대주\n\"0104\": 유통대주\n\"0201\": 예탁주식\n\"0251\": 예탁주식(해외)\n\n대출 주문이 아니면 \"0000\"입니다.", "depth" : 0 }, { "element" : "oder_cfee", "name" : "주문통화수수료", "type" : "String", "required" : "Y", "length" : "20", "description" : "주문 수수료입니다. 거래 통화 기준입니다.", "depth" : 0 }, { "element" : "acpl_oder_cexpn", "name" : "현지주문통화비용", "type" : "String", "required" : "Y", "length" : "20", "description" : "주문에 발생한 현지 비용입니다. 거래 통화 기준입니다.", "depth" : 0 }, { "element" : "cntg_camt", "name" : "체결통화금액", "type" : "String", "required" : "Y", "length" : "20", "description" : "체결 금액입니다. 미체결 건은 0입니다. 거래 통화 기준입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 성공 응답 코드입니다. \"5766\": 조회 완료, \"5820\": 조회할 자료 없음.\n오류는 종류와 무관하게 HTTP 500 으로 반환됩니다.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 이 값에 담깁니다.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "연속조회 여부입니다.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "오류일 때 구체적인 사유가 담기는 경우 내려옵니다.", "depth" : 0 } ] }, "requestExample" : "GET /trading/v1/overseas/orders/today?cntg_cls_code=2\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": [\n {\n \"oder_date\": \"20260826\",\n \"oder_no\": 718028,\n \"orgl_oder_no\": 0,\n \"ovrs_stck_mrkt_tr_cls_code\": \"01\",\n \"iscd\": \"TSLA.OQ\",\n \"iscd_name\": \"테슬라\",\n \"seln_byov_clcd\": \"2\",\n \"aspr_type_code\": \"2\",\n \"oder_cond_cls_code\": \"8\",\n \"odqt\": 1,\n \"rctf_odqt\": 0,\n \"cncl_odqt\": 0,\n \"rctf_cnfr_qty\": 0,\n \"cncl_cnfr_qty\": 0,\n \"ovrs_stck_oder_prc\": \"350.58000000\",\n \"cntg_qty\": 1,\n \"cntg_crnc_prc\": \"349.29000000\",\n \"ncnt_qty\": 0,\n \"oder_able_qty\": 0,\n \"oder_rctf_cncl_cls_code\": \"0\",\n \"oder_exec_ymdh\": \"2026-08-26 12:48:23\",\n \"ovrs_stck_oder_stat_cls_code\": \"0\",\n \"onln_yn\": \"Y\",\n \"ovrs_stck_symb_iscd\": \"TSLA\",\n \"ovrs_exch_vndr_idno\": \"0537\",\n \"ovrs_stck_rfus_idnt_code\": \"\",\n \"ovrs_stck_rfus_reas\": \"\",\n \"deal_cls_code\": \"2\",\n \"oder_pros_time\": \"124823\",\n \"dcpn_loeq_ciph\": 4,\n \"byov_unit_qty\": 1,\n \"seln_unit_qty\": 1,\n \"rctf_cncl_cls_code\": \"1\",\n \"loan_date\": \"\",\n \"loan_srno\": 0,\n \"loan_dtl_type_code\": \"0000\",\n \"oder_cfee\": \"0.8700\",\n \"acpl_oder_cexpn\": \"0.0000\",\n \"cntg_camt\": \"349.2900\"\n }\n ],\n \"rsp_cd\": \"5766\",\n \"rsp_msg\": \"조회가 완료되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "해외주식 예약주문 매수", "protocol" : "REST", "method" : "POST", "domain" : "", "url" : "/trading/v1/overseas/reserved-orders/buy", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "해외 시장이 열리기 전에 매수 주문을 미리 걸어 두는 예약주문을 접수합니다.", "trs" : [ { "name" : "해외주식 예약주문 매수", "code" : "obtro_oder_112a", "request" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출하기 위한 Request Body 데이터 포맷으로 \"application/json; charset=utf-8\" 설정", "depth" : 0 }, { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "ovrs_stck_symb_iscd", "name" : "해외주식심볼종목코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "해외주식 심볼입니다. (예: AAPL)", "depth" : 0 }, { "element" : "ovrs_exch_vndr_idno", "name" : "해외거래소벤더식별번호", "type" : "String", "required" : "Y", "length" : "6", "description" : "거래소 벤더 코드입니다. 해외 거래소 조회의 ovrs_exch_vndr_idno 를 넣으십시오. (예: 나스닥 0537)", "depth" : 0 }, { "element" : "rsev_aspr_tpcd", "name" : "예약호가유형코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "예약 주문의 호가 유형입니다.\n\"1\": 지정가\n\"2\": 시장가\n\"4\": LOO(장개시 지정가)\n\"5\": LOC(장마감 지정가)\n\"6\": MOO(장개시 시장가)\n\"7\": MOC(장마감 시장가)\n\"8\": Limit VWAP\n\"9\": Limit TWAP\n\"A\": VWAP\n\"B\": TWAP", "depth" : 0 }, { "element" : "odqt", "name" : "주문수량", "type" : "String", "required" : "Y", "length" : "19", "description" : "주문 수량입니다.", "depth" : 0 }, { "element" : "ovrs_stck_oder_prc", "name" : "주문가격", "type" : "String", "required" : "Y", "length" : "20", "description" : "주문 단가입니다(현지 통화). 소수점 이하 4자리까지 입력할 수 있으며, 초과하면 IGW50002 오류로 거절됩니다.", "depth" : 0 }, { "element" : "oder_aspr_rate", "name" : "주문호가비율", "type" : "String", "required" : "N", "length" : "10", "description" : "주문 호가 비율입니다.", "depth" : 0 }, { "element" : "warn_cnfr_yn", "name" : "경고확인여부", "type" : "String", "required" : "N", "length" : "1", "description" : "착오매매 경고를 확인했는지 여부입니다.\n\"N\": 미확인\n\"Y\": 확인\n\n처음에는 \"N\" 으로 보내거나 넣지 않습니다.", "depth" : 0 }, { "element" : "oder_rsev_cls_code", "name" : "주문예약구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "예약 방식입니다.\n\"1\": 일반예약\n\"2\": 기간잔량\n\"3\": 기간예약\n\"4\": 특정일주문", "depth" : 0 }, { "element" : "oder_rsev_hour_clcd", "name" : "주문예약시간구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "예약 주문을 언제 발주할지 정하는 시간 구분입니다.\n\"0\": 장개시\n\"1\": 장마감 10분 전\n\"2\": 장마감 30분 전\n\"3\": 장개시 30분 후", "depth" : 0 }, { "element" : "oder_sta_date", "name" : "주문시작일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "주문이 나가기 시작하는 일자입니다. YYYYMMDD 8자리.", "depth" : 0 }, { "element" : "oder_fin_date", "name" : "주문종료일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "주문이 나가는 마지막 일자입니다. YYYYMMDD 8자리.", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "예약주문 접수 결과", "type" : "Object", "required" : "Y", "length" : "-", "description" : "해외주식 예약 매수 주문의 접수 결과입니다. 예약 번호(oder_rsev_mst_no)와 경고 정보(warn_cls_code, warn_msg)가 들어 있습니다. 취소에는 이 예약 번호를 예약주문 취소의 oder_rsev_mst_no 에 넣으십시오.", "depth" : 0 }, { "element" : "oder_rsev_mst_no", "name" : "주문예약마스터번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "예약 번호입니다. 취소하실 때 이 값을 넣으십시오.", "depth" : 0 }, { "element" : "warn_cls_code", "name" : "경고구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "주문 처리 결과입니다. \"0\" 이면 정상 접수입니다. \"0\" 이 아니면 warn_msg 의 내용을 확인하십시오.", "depth" : 0 }, { "element" : "warn_msg", "name" : "메시지내용", "type" : "String", "required" : "Y", "length" : "100", "description" : "경고·안내 메시지입니다. 정상 접수 시에는 빈 문자열입니다.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "연속조회 여부입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "처리 결과 코드입니다. 성공 코드는 API 마다 다르므로 rsp_msg 와 함께 확인하십시오.\n\n오류는 종류와 무관하게 HTTP 500 으로 반환되며 이 필드에 사유 코드가 담깁니다.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "처리 결과 메시지입니다. 오류일 때 사유가 담기며, 더 자세한 사유는 rsp_sub_msg 에 담깁니다.", "depth" : 0 } ] }, "requestExample" : "POST /trading/v1/overseas/reserved-orders/buy\ncontent-type: application/json; charset=utf-8\nauthorization: Bearer {access_token}\nmac_address: {mac_address}\n\n{\n \"ovrs_stck_symb_iscd\": \"AAPL\",\n \"ovrs_exch_vndr_idno\": \"0537\",\n \"rsev_aspr_tpcd\": \"1\",\n \"odqt\": \"10.55\",\n \"ovrs_stck_oder_prc\": \"252.82\",\n \"oder_rsev_cls_code\": \"3\",\n \"oder_rsev_hour_clcd\": \"0\",\n \"oder_sta_date\": \"20260914\",\n \"oder_fin_date\": \"20260930\",\n \"warn_cnfr_yn\": \"N\"\n}", "responseExample" : "{\n \"data\": {\n \"oder_rsev_mst_no\": 21,\n \"warn_cls_code\": \"0\",\n \"warn_msg\": \"\"\n },\n \"rsp_cd\": \"5620\",\n \"rsp_msg\": \"정상 처리 되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "해외주식 예약주문 매도", "protocol" : "REST", "method" : "POST", "domain" : "", "url" : "/trading/v1/overseas/reserved-orders/sell", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "보유 해외주식의 매도 주문을 시장이 열리기 전에 미리 걸어 두는 예약주문을 접수합니다.", "trs" : [ { "name" : "해외주식 예약주문 매도", "code" : "obtro_oder_112a", "request" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출하기 위한 Request Body 데이터 포맷으로 \"application/json; charset=utf-8\" 설정", "depth" : 0 }, { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "ovrs_stck_symb_iscd", "name" : "해외주식심볼종목코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "해외주식 심볼입니다. (예: AAPL)", "depth" : 0 }, { "element" : "ovrs_exch_vndr_idno", "name" : "해외거래소벤더식별번호", "type" : "String", "required" : "Y", "length" : "6", "description" : "거래소 벤더 코드입니다. 해외 거래소 조회의 ovrs_exch_vndr_idno 를 넣으십시오. (예: 나스닥 0537)", "depth" : 0 }, { "element" : "rsev_aspr_tpcd", "name" : "예약호가유형코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "예약 주문의 호가 유형입니다.\n\"1\": 지정가\n\"2\": 시장가\n\"4\": LOO(장개시 지정가)\n\"5\": LOC(장마감 지정가)\n\"6\": MOO(장개시 시장가)\n\"7\": MOC(장마감 시장가)\n\"8\": Limit VWAP\n\"9\": Limit TWAP\n\"A\": VWAP\n\"B\": TWAP", "depth" : 0 }, { "element" : "odqt", "name" : "주문수량", "type" : "String", "required" : "Y", "length" : "19", "description" : "주문 수량입니다.", "depth" : 0 }, { "element" : "ovrs_stck_oder_prc", "name" : "주문가격", "type" : "String", "required" : "Y", "length" : "20", "description" : "주문 단가입니다(현지 통화). 소수점 이하 4자리까지 입력할 수 있으며, 초과하면 IGW50002 오류로 거절됩니다.", "depth" : 0 }, { "element" : "oder_aspr_rate", "name" : "주문호가비율", "type" : "String", "required" : "N", "length" : "10", "description" : "주문 호가 비율입니다.", "depth" : 0 }, { "element" : "warn_cnfr_yn", "name" : "경고확인여부", "type" : "String", "required" : "N", "length" : "1", "description" : "착오매매 경고를 확인했는지 여부입니다.\n\"N\": 미확인\n\"Y\": 확인\n\n처음에는 \"N\" 으로 보내거나 넣지 않습니다.", "depth" : 0 }, { "element" : "oder_rsev_cls_code", "name" : "주문예약구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "예약 방식입니다.\n\"1\": 일반예약\n\"2\": 기간잔량\n\"3\": 기간예약\n\"4\": 특정일주문", "depth" : 0 }, { "element" : "oder_rsev_hour_clcd", "name" : "주문예약시간구분코드", "type" : "String", "required" : "N", "length" : "1", "description" : "예약 주문을 언제 발주할지 정하는 시간 구분입니다.\n\"0\": 장개시\n\"1\": 장마감 10분 전\n\"2\": 장마감 30분 전\n\"3\": 장개시 30분 후", "depth" : 0 }, { "element" : "oder_sta_date", "name" : "주문시작일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "주문이 나가기 시작하는 일자입니다. YYYYMMDD 8자리.", "depth" : 0 }, { "element" : "oder_fin_date", "name" : "주문종료일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "주문이 나가는 마지막 일자입니다. YYYYMMDD 8자리.", "depth" : 0 }, { "element" : "loan_oder_cls_code", "name" : "대출주문구분코드", "type" : "String", "required" : "N", "length" : "2", "description" : "대출 재원 구분입니다.\n\"03\": 예탁담보", "depth" : 0 }, { "element" : "svc_cls_code", "name" : "서비스구분코드", "type" : "String", "required" : "N", "length" : "3", "description" : "서비스 구분입니다.\n\"203\": 담보 상환 매도", "depth" : 0 }, { "element" : "loan_date", "name" : "대출일자", "type" : "String", "required" : "N", "length" : "8", "description" : "대출 일자입니다.", "depth" : 0 }, { "element" : "loan_srno", "name" : "대출일련번호", "type" : "String", "required" : "N", "length" : "11", "description" : "대출 일련번호입니다.", "depth" : 0 }, { "element" : "whol_amt_rdmp_yn", "name" : "UI전체금액상환여부", "type" : "String", "required" : "N", "length" : "1", "description" : "전체 금액을 상환할지 여부입니다. \"Y\" 또는 \"N\".", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "예약주문 접수 결과", "type" : "Object", "required" : "Y", "length" : "-", "description" : "해외주식 예약 매도 주문의 접수 결과입니다. 예약 번호(oder_rsev_mst_no)와 경고 정보(warn_cls_code, warn_msg)가 들어 있습니다. 취소에는 이 예약 번호를 예약주문 취소의 oder_rsev_mst_no 에 넣으십시오.", "depth" : 0 }, { "element" : "oder_rsev_mst_no", "name" : "주문예약마스터번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "예약 번호입니다. 취소하실 때 이 값을 넣으십시오.", "depth" : 0 }, { "element" : "warn_cls_code", "name" : "경고구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "주문 처리 결과입니다. \"0\" 이면 정상 접수입니다. \"0\" 이 아니면 warn_msg 의 내용을 확인하십시오.", "depth" : 0 }, { "element" : "warn_msg", "name" : "메시지내용", "type" : "String", "required" : "Y", "length" : "100", "description" : "경고·안내 메시지입니다. 정상 접수 시에는 빈 문자열입니다.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "연속조회 여부입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "처리 결과 코드입니다. 성공 코드는 API 마다 다르므로 rsp_msg 와 함께 확인하십시오.\n\n오류는 종류와 무관하게 HTTP 500 으로 반환되며 이 필드에 사유 코드가 담깁니다.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "처리 결과 메시지입니다. 오류일 때 사유가 담기며, 더 자세한 사유는 rsp_sub_msg 에 담깁니다.", "depth" : 0 } ] }, "requestExample" : "POST /trading/v1/overseas/reserved-orders/sell\ncontent-type: application/json; charset=utf-8\nauthorization: Bearer {access_token}\nmac_address: {mac_address}\n\n{\n \"ovrs_stck_symb_iscd\": \"AAPL\",\n \"ovrs_exch_vndr_idno\": \"0537\",\n \"rsev_aspr_tpcd\": \"1\",\n \"odqt\": \"10.55\",\n \"ovrs_stck_oder_prc\": \"252.82\",\n \"oder_rsev_cls_code\": \"1\",\n \"oder_rsev_hour_clcd\": \"0\",\n \"warn_cnfr_yn\": \"N\"\n}", "responseExample" : "{\n \"data\": {\n \"oder_rsev_mst_no\": 21,\n \"warn_cls_code\": \"0\",\n \"warn_msg\": \"\"\n },\n \"rsp_cd\": \"5620\",\n \"rsp_msg\": \"정상 처리 되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "해외주식 예약주문 취소", "protocol" : "REST", "method" : "POST", "domain" : "", "url" : "/trading/v1/overseas/reserved-orders/cancel", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "접수된 해외주식 예약주문을 취소합니다.", "trs" : [ { "name" : "해외주식 예약주문 취소", "code" : "obtro_oder_113a", "request" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출하기 위한 Request Body 데이터 포맷으로 \"application/json; charset=utf-8\" 설정", "depth" : 0 }, { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "oder_rsev_mst_date", "name" : "주문예약마스터일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "예약 일자입니다. 취소하실 때 이 값을 넣으십시오.", "depth" : 0 }, { "element" : "oder_rsev_mst_no", "name" : "주문예약마스터번호", "type" : "String", "required" : "Y", "length" : "11", "description" : "예약 번호입니다. 취소하실 때 이 값을 넣으십시오.", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "예약주문 취소 결과", "type" : "Object", "required" : "Y", "length" : "-", "description" : "해외주식 예약주문 취소 처리 결과입니다. 처리 일련번호(pros_srno)가 들어 있습니다.", "depth" : 0 }, { "element" : "pros_srno", "name" : "처리일련번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "처리 일련번호입니다.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "연속조회 여부입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "처리 결과 코드입니다. 성공 코드는 API 마다 다르므로 rsp_msg 와 함께 확인하십시오.\n\n오류는 종류와 무관하게 HTTP 500 으로 반환되며 이 필드에 사유 코드가 담깁니다.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "처리 결과 메시지입니다. 오류일 때 사유가 담기며, 더 자세한 사유는 rsp_sub_msg 에 담깁니다.", "depth" : 0 } ] }, "requestExample" : "POST /trading/v1/overseas/reserved-orders/cancel\ncontent-type: application/json; charset=utf-8\nauthorization: Bearer {access_token}\nmac_address: {mac_address}\n\n{\n \"oder_rsev_mst_date\": \"20260318\",\n \"oder_rsev_mst_no\": \"5\"\n}", "responseExample" : "{\n \"data\": {\n \"pros_srno\": 3\n },\n \"rsp_cd\": \"0000\",\n \"rsp_msg\": \"정상 처리 되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "해외주식 예약주문 조회", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/trading/v1/overseas/reserved-orders", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "접근토큰에 매핑된 계좌의 해외주식 예약주문 내역을 조회합니다.", "trs" : [ { "name" : "해외주식 예약주문 조회", "code" : "obtro_oder_114r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "iqry_sta_date", "name" : "조회시작일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "조회 시작일자를 YYYYMMDD 8자리로 입력합니다. 조회종료일자·매도매수구분코드와 함께 필수입니다. (query string)", "depth" : 0 }, { "element" : "iqry_fin_date", "name" : "조회종료일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "조회 종료일자를 YYYYMMDD 8자리로 입력합니다. 조회시작일자·매도매수구분코드와 함께 필수입니다. (query string)", "depth" : 0 }, { "element" : "seln_byov_clcd", "name" : "매도매수구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "매도·매수 구분입니다.\n\"0\": 전체\n\"1\": 매도\n\"2\": 매수", "depth" : 0 }, { "element" : "iqry_cls_code", "name" : "조회구분코드", "type" : "String", "required" : "N", "length" : "1", "description" : "조회 구분입니다.\n\"1\": 주문일\n\"2\": 예약일", "depth" : 0 }, { "element" : "iqry_idnt_clcd", "name" : "조회식별구분코드", "type" : "String", "required" : "N", "length" : "1", "description" : "조회 대상 구분입니다.\n\"0\": 전체\n\"1\": 전체(취소분 제외)\n\"2\": 예약 상태인 건만 (query string)", "depth" : 0 }, { "element" : "oder_rsev_cls_code", "name" : "주문예약구분코드", "type" : "String", "required" : "N", "length" : "1", "description" : "예약 방식입니다.\n\"0\": 전체\n\"1\": 일반예약\n\"2\": 기간잔량\n\"3\": 기간예약\n\"4\": 특정일주문", "depth" : 0 }, { "element" : "tday_deal_yn", "name" : "당일매매여부", "type" : "String", "required" : "N", "length" : "1", "description" : "당일 매매분만 볼지 여부입니다. \"Y\" 또는 \"N\". (query string)", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "N", "length" : "1", "description" : "다음 페이지를 요청할 때 \"1\"을 넣습니다. 첫 조회에는 넣지 않습니다. (query string)", "depth" : 0 }, { "element" : "tr_cont_key", "name" : "연속조회 키", "type" : "String", "required" : "N", "length" : "20", "description" : "직전 응답의 tr_cont_key 를 그대로 넣습니다. 첫 조회에는 넣지 않습니다.\n\n값 오른쪽에 공백이 붙어 내려오는 경우가 있습니다. 잘라내지 말고 URL 인코딩하여 원본 그대로 보내십시오. (query string)", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "목록", "type" : "Object Array", "required" : "Y", "length" : "-", "description" : "조회 결과 배열입니다.", "depth" : 0 }, { "element" : "rsev_acpt_date", "name" : "예약접수일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "예약이 접수된 일자입니다.", "depth" : 0 }, { "element" : "rsev_acpt_srno", "name" : "예약접수일련번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "예약 접수 일련번호입니다.", "depth" : 0 }, { "element" : "ovrs_stck_mrkt_tr_cls_code", "name" : "해외주식시장거래구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "해외 시장 거래 구분입니다.\n\"01\": 미국\n\"02\": 홍콩\n\"03\": 상해\n\"04\": 심천\n\"05\": 일본\n\"06\": 호주\n\"07\": 싱가폴\n\"08\": 런던\n\"09\": 런던인터내셔날\n\"10\": 독일\n\"11\": 핀란드\n\"12\": 프랑스\n\"13\": 벨기에\n\"14\": 네덜란드\n\"15\": 포르투갈\n\"16\": 그리스\n\"17\": 아일랜드\n\"18\": 이탈리아\n\"19\": 스페인\n\"20\": 오스트리아\n\"21\": 캐나다\n\"23\": 인도네시아\n\"24\": 베트남\n\"26\": 스위스", "depth" : 0 }, { "element" : "seln_byov_clcd", "name" : "매도매수구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "매매 구분입니다.\n\"1\": 매도\n\"2\": 매수", "depth" : 0 }, { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "종목 코드입니다.", "depth" : 0 }, { "element" : "kor_isnm", "name" : "한글종목명", "type" : "String", "required" : "Y", "length" : "100", "description" : "종목명(한글)입니다.", "depth" : 0 }, { "element" : "rsev_aspr_tpcd", "name" : "예약호가유형코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "예약 주문의 호가 유형입니다.\n\"1\": 지정가\n\"2\": 시장가\n\"4\": LOO(장개시 지정가)\n\"5\": LOC(장마감 지정가)\n\"6\": MOO(장개시 시장가)\n\"7\": MOC(장마감 시장가)\n\"8\": Limit VWAP\n\"9\": Limit TWAP\n\"A\": VWAP\n\"B\": TWAP", "depth" : 0 }, { "element" : "odqt", "name" : "주문수량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "주문 수량입니다.", "depth" : 0 }, { "element" : "ovrs_stck_oder_prc", "name" : "주문가격", "type" : "Number", "required" : "Y", "length" : "20", "description" : "주문 단가입니다(현지 통화).", "depth" : 0 }, { "element" : "oder_aspr_rate", "name" : "주문호가비율", "type" : "Number", "required" : "Y", "length" : "10", "description" : "주문 호가 비율입니다.", "depth" : 0 }, { "element" : "oder_input_time", "name" : "주문입력시각", "type" : "String", "required" : "Y", "length" : "6", "description" : "주문을 입력한 시각입니다.", "depth" : 0 }, { "element" : "fee_mdia_grp_code", "name" : "수수료매체그룹코드", "type" : "String", "required" : "Y", "length" : "3", "description" : "예약을 접수한 매체(채널)를 나타내는 세 자리 코드입니다.", "depth" : 0 }, { "element" : "ovrs_stck_symb_iscd", "name" : "해외주식심볼종목코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "해외주식 심볼입니다. (예: AAPL)", "depth" : 0 }, { "element" : "ovrs_exch_vndr_idno", "name" : "해외거래소벤더식별번호", "type" : "String", "required" : "Y", "length" : "6", "description" : "거래소 벤더 코드입니다. 해외 거래소 조회의 ovrs_exch_vndr_idno 를 넣으십시오. (예: 나스닥 0537)", "depth" : 0 }, { "element" : "dcpn_loeq_ciph", "name" : "소수점이하자릿수", "type" : "Number", "required" : "Y", "length" : "5", "description" : "소수점 이하 자릿수입니다.", "depth" : 0 }, { "element" : "code_vald_val_kor_name", "name" : "코드유효값한글명", "type" : "String", "required" : "Y", "length" : "200", "description" : "예약을 접수한 매체의 이름입니다. 같은 응답의 fee_mdia_grp_code 에 대응하는 표기이며 화면에 그대로 보여 주실 수 있습니다.", "depth" : 0 }, { "element" : "oder_rsev_cls_code", "name" : "주문예약구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "예약 방식입니다.\n\"1\": 일반예약\n\"2\": 기간잔량\n\"3\": 기간예약\n\"4\": 특정일주문", "depth" : 0 }, { "element" : "oder_rsev_hour_clcd", "name" : "주문예약시간구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "예약 주문을 언제 발주할지 정하는 시간 구분입니다.\n\"0\": 장개시\n\"1\": 장마감 10분 전\n\"2\": 장마감 30분 전\n\"3\": 장개시 30분 후", "depth" : 0 }, { "element" : "oder_sta_date", "name" : "주문시작일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "주문이 나가기 시작하는 일자입니다. YYYYMMDD 8자리.", "depth" : 0 }, { "element" : "oder_fin_date", "name" : "주문종료일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "주문이 나가는 마지막 일자입니다. YYYYMMDD 8자리.", "depth" : 0 }, { "element" : "acml_cntg_qty", "name" : "누적체결수량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "예약이 실행되어 체결된 누적 수량입니다.", "depth" : 0 }, { "element" : "loan_date", "name" : "대출일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "대출 일자입니다.", "depth" : 0 }, { "element" : "loan_srno", "name" : "대출일련번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "대출 일련번호입니다.", "depth" : 0 }, { "element" : "loan_dtl_type_code", "name" : "대출상세유형코드", "type" : "String", "required" : "Y", "length" : "4", "description" : "대출 상세 유형입니다. 네 자리로 내려옵니다.\n\"0000\": 보통\n\"0101\": 자기융자\n\"0102\": 유통융자\n\"0103\": 자기대주\n\"0104\": 유통대주\n\"0201\": 예탁주식\n\"0251\": 예탁주식(해외)", "depth" : 0 }, { "element" : "ovrs_stck_tr_ctcd", "name" : "해외주식거래국가코드", "type" : "String", "required" : "Y", "length" : "3", "description" : "거래 국가 코드입니다. 응답에 내려온 값을 그대로 문자열로 다루십시오.", "depth" : 0 }, { "element" : "cncl_able_yn", "name" : "취소가능여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "이 예약을 지금 취소할 수 있는지 여부입니다. \"Y\": 취소 가능, \"N\": 취소 불가.", "depth" : 0 }, { "element" : "pros_cls_code", "name" : "처리구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "예약 건의 처리 구분입니다. 한 자리 코드입니다.", "depth" : 0 }, { "element" : "rsev_cncl_yn", "name" : "예약취소여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "예약이 취소되었는지 여부입니다. \"Y\" 이면 취소된 건입니다.", "depth" : 0 }, { "element" : "rsev_qty", "name" : "예약수량", "type" : "Number", "required" : "Y", "length" : "22", "description" : "예약 수량입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 성공 응답 코드입니다.\n\"5762\": 조회 결과가 더 있음 (연속조회)\n\"5766\": 조회 완료\n\"5820\": 조회할 자료 없음\n오류는 종류와 무관하게 HTTP 500 으로 반환됩니다.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 이 값에 담깁니다.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "다음 페이지가 남아 있으면 \"1\", 마지막이면 \"0\"입니다.", "depth" : 0 }, { "element" : "tr_cont_key", "name" : "연속조회 키", "type" : "String", "required" : "N", "length" : "20", "description" : "다음 페이지를 요청하실 때는 직전 응답의 값을 그대로 넣으십시오. 잘라내지 마십시오.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "오류일 때 구체적인 사유가 담기는 경우 내려옵니다.", "depth" : 0 } ] }, "requestExample" : "GET /trading/v1/overseas/reserved-orders?iqry_sta_date=20260101&iqry_fin_date=20261231&seln_byov_clcd=0\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": [\n {\n \"data\": \"\",\n \"rsev_acpt_date\": \"20260910\",\n \"rsev_acpt_srno\": 7,\n \"ovrs_stck_mrkt_tr_cls_code\": \"01\",\n \"seln_byov_clcd\": \"2\",\n \"iscd\": \"AAPL.OQ\",\n \"kor_isnm\": \"애플\",\n \"rsev_aspr_tpcd\": \"1\",\n \"odqt\": 1,\n \"ovrs_stck_oder_prc\": 150.0,\n \"oder_aspr_rate\": 0,\n \"oder_input_time\": \"131025\",\n \"fee_mdia_grp_code\": \"120\",\n \"ovrs_stck_symb_iscd\": \"AAPL\",\n \"ovrs_exch_vndr_idno\": \"0537\",\n \"dcpn_loeq_ciph\": 2,\n \"code_vald_val_kor_name\": \"일반예약\",\n \"oder_rsev_cls_code\": \"1\",\n \"oder_rsev_hour_clcd\": \"0\",\n \"oder_sta_date\": \"20260911\",\n \"oder_fin_date\": \"20260911\",\n \"acml_cntg_qty\": 0,\n \"loan_date\": \"00000000\",\n \"loan_srno\": 0,\n \"loan_dtl_type_code\": \"\",\n \"ovrs_stck_tr_ctcd\": \"US\",\n \"cncl_able_yn\": \"Y\",\n \"pros_cls_code\": \"1\",\n \"rsev_cncl_yn\": \"N\",\n \"rsev_qty\": 1,\n \"rsp_cd\": \"\",\n \"rsp_msg\": \"\",\n \"tr_cont\": \"\",\n \"tr_cont_key\": \"\",\n \"rsp_sub_msg\": \"\"\n }\n ],\n \"rsp_cd\": \"5766\",\n \"rsp_msg\": \"조회가 완료되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "해외주식 시세추이 조회 (분봉)", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/market/v1/overseas/candles/minutes", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "해외주식 한 종목의 분봉을 최근 구간부터 조회합니다.", "trs" : [ { "name" : "해외주식 시세추이 조회 (분봉)", "code" : "ohhts_eapi_005r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "mrkt_div_code", "name" : "시장 구분 코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "해외 시세는 \"OV\"를 넣습니다.\n\n(query string)", "depth" : 0 }, { "element" : "mrkt_cls_code", "name" : "거래소 구분 코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "거래소 구분입니다.\n\"OQ\": 나스닥\n\"NY\": 뉴욕\n\"AX\": 아멕스\n\"HK\": 홍콩증권거래소\n\"SH\": 상하이증권거래소\n\"SZ\": 심천증권거래소\n\"JP\": 도쿄증권거래소 (query string)", "depth" : 0 }, { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "16", "description" : "해외 종목 심볼을 입력합니다. (예: AAPL)\n\n(query string)", "depth" : 0 }, { "element" : "dely_rltm_cls_code", "name" : "지연실시간구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "시세 종류입니다.\n\"0\": 실시간\n\"1\": 지연 (query string)", "depth" : 0 }, { "element" : "hour_cls_code", "name" : "봉 간격", "type" : "String", "required" : "Y", "length" : "7", "description" : "봉 간격을 초 단위로 입력합니다. 60은 1분, 300은 5분입니다.\n\n반드시 넣으셔야 합니다. 빠뜨리면 오류가 반환됩니다.\n\n숫자가 아닌 값은 오류 없이 60(1분)으로 조회됩니다. (query string)", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "분봉 목록", "type" : "Object Array", "required" : "Y", "length" : "-", "description" : "분봉 배열입니다. 최근 봉이 앞에 옵니다.\n\n한 번에 40건까지 내려옵니다.", "depth" : 0 }, { "element" : "korea_hour", "name" : "체결시간", "type" : "String", "required" : "Y", "length" : "6", "description" : "집계 구간의 국내 기준 시각입니다. HHMMSS 형식이며 간격은 hour_cls_code 를 따릅니다.", "depth" : 0 }, { "element" : "prpr", "name" : "현재가", "type" : "String", "required" : "Y", "length" : "14", "description" : "해당 봉 구간의 마지막 체결 가격입니다. 구간 종가이므로 행마다 값이 다릅니다.", "depth" : 0 }, { "element" : "cntg_vol", "name" : "체결거래량", "type" : "Number", "required" : "Y", "length" : "13", "description" : "해당 구간의 체결 수량입니다.", "depth" : 0 }, { "element" : "acml_vol", "name" : "누적거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "장 시작부터 해당 봉 구간이 끝난 시점까지 체결된 주식 수를 모두 더한 값입니다.", "depth" : 0 }, { "element" : "rltv", "name" : "체결강도", "type" : "String", "required" : "Y", "length" : "10", "description" : "체결강도(%)입니다.", "depth" : 0 }, { "element" : "dcpn_cnt", "name" : "소수점수", "type" : "Number", "required" : "Y", "length" : "2", "description" : "가격의 소수점 자릿수입니다.", "depth" : 0 }, { "element" : "korea_date", "name" : "한국일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "집계 구간의 국내 기준 일자입니다. YYYYMMDD 형식입니다.", "depth" : 0 }, { "element" : "oprc", "name" : "시가", "type" : "String", "required" : "Y", "length" : "14", "description" : "해당 봉 구간에서 처음 체결된 가격입니다.", "depth" : 0 }, { "element" : "hprc", "name" : "고가", "type" : "String", "required" : "Y", "length" : "14", "description" : "해당 봉 구간에서 가장 높았던 체결 가격입니다.", "depth" : 0 }, { "element" : "lprc", "name" : "저가", "type" : "String", "required" : "Y", "length" : "14", "description" : "해당 봉 구간에서 가장 낮았던 체결 가격입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 성공 응답 코드입니다.\n\"0000\": 정상 처리\n\n오류는 종류와 무관하게 HTTP 500 으로 반환되므로, 성공·실패는 HTTP 상태가 아니라 이 값으로 판정하십시오.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 담깁니다.\n\n오류 응답에는 data 와 tr_cont 가 담기지 않습니다. 오류일 때 본문은 rsp_cd·rsp_msg(일부 API 는 rsp_sub_msg 포함)로 이루어지므로, rsp_cd 를 먼저 확인한 뒤 data 를 읽으십시오.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "오류일 때 내려올 수 있는 상세 사유 항목입니다. 정상 응답에는 포함되지 않습니다.", "depth" : 0 } ] }, "requestExample" : "GET /market/v1/overseas/candles/minutes?mrkt_div_code=OV&mrkt_cls_code=OQ&iscd=AAPL&dely_rltm_cls_code=0&hour_cls_code=60\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": [\n {\n \"korea_hour\": \"164900\",\n \"prpr\": \"326.3100\",\n \"cntg_vol\": 10,\n \"acml_vol\": 24295,\n \"rltv\": \"96.73\",\n \"dcpn_cnt\": 4,\n \"korea_date\": \"20260911\",\n \"oprc\": \"326.3100\",\n \"hprc\": \"326.3100\",\n \"lprc\": \"326.3100\"\n },\n {\n \"korea_hour\": \"164500\",\n \"prpr\": \"326.2900\",\n \"cntg_vol\": 37,\n \"acml_vol\": 24285,\n \"rltv\": \"96.73\",\n \"dcpn_cnt\": 4,\n \"korea_date\": \"20260911\",\n \"oprc\": \"326.3000\",\n \"hprc\": \"326.3000\",\n \"lprc\": \"326.2900\"\n }\n ],\n \"rsp_cd\": \"0000\",\n \"rsp_msg\": \"정상 처리 되었습니다.\"\n}" } ] }, { "name" : "해외주식 시세추이 조회 (일봉)", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/market/v1/overseas/candles/days", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "해외주식 한 종목의 일별 시세를 조회합니다.", "trs" : [ { "name" : "해외주식 시세추이 조회 (일봉)", "code" : "ohhts_6001_003r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "mrkt_div_code", "name" : "시장 구분 코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "해외 시세는 \"OV\"를 넣습니다.\n\n(query string)", "depth" : 0 }, { "element" : "mrkt_cls_code", "name" : "거래소 구분 코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "거래소 구분입니다.\n\"OQ\": 나스닥\n\"NY\": 뉴욕\n\"AX\": 아멕스\n\"HK\": 홍콩증권거래소\n\"SH\": 상하이증권거래소\n\"SZ\": 심천증권거래소\n\"JP\": 도쿄증권거래소 (query string)", "depth" : 0 }, { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "16", "description" : "해외 종목 심볼을 입력합니다. (예: AAPL)\n\n(query string)", "depth" : 0 }, { "element" : "dely_rltm_cls_code", "name" : "지연실시간구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "시세 종류입니다.\n\"0\": 실시간\n\"1\": 지연 (query string)", "depth" : 0 }, { "element" : "mod_stpr_cls_code", "name" : "수정주가구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "수정주가 적용 구분입니다.\n\"0\": 분할을 반영해 보정한 주가\n\"1\": 보정 전 원래 주가\n\n반드시 넣으셔야 합니다. 빠뜨리면 오류가 반환됩니다. (query string)", "depth" : 0 }, { "element" : "from", "name" : "조회 시작일자", "type" : "String", "required" : "N", "length" : "8", "description" : "조회 시작일자입니다. YYYYMMDD 8자리.\nto와 함께 넣으면 그 기간의 일봉을 모두 반환합니다.\n미입력 시 최신 40건을 반환합니다. (query string)", "depth" : 0 }, { "element" : "to", "name" : "조회 종료일자", "type" : "String", "required" : "N", "length" : "8", "description" : "조회 종료일자입니다. YYYYMMDD 8자리\nfrom과 함께 사용합니다. (query string)", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "일봉 목록", "type" : "Object Array", "required" : "Y", "length" : "-", "description" : "일별 시세 배열입니다. 최근 일자가 앞에 옵니다.\n\nfrom·to 를 넣지 않으면 최근 40건이 내려옵니다. 기간을 지정하려면 from 과 to 를 함께 넣으십시오.", "depth" : 0 }, { "element" : "date", "name" : "일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "일자입니다. YYYYMMDD 형식입니다.", "depth" : 0 }, { "element" : "prpr", "name" : "종가", "type" : "String", "required" : "Y", "length" : "14", "description" : "해당 일자의 종가입니다. 소수점 자릿수는 같은 응답의 dcpn_cnt(소수점수)로 확인하십시오.", "depth" : 0 }, { "element" : "prdy_vrss_sign", "name" : "전일대비부호", "type" : "String", "required" : "Y", "length" : "1", "description" : "전일 대비 부호입니다.\n\"1\": 상한\n\"2\": 상승\n\"3\": 보합\n\"4\": 하한\n\"5\": 하락", "depth" : 0 }, { "element" : "prdy_vrss", "name" : "전일대비", "type" : "String", "required" : "Y", "length" : "14", "description" : "전일 대비 등락 가격입니다.", "depth" : 0 }, { "element" : "prdy_ctrt", "name" : "전일대비율", "type" : "String", "required" : "Y", "length" : "11", "description" : "전일 대비 등락률(%)입니다.", "depth" : 0 }, { "element" : "acml_vol", "name" : "누적거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "해당 일자 하루 동안 체결된 주식 수를 모두 더한 값입니다.", "depth" : 0 }, { "element" : "oprc", "name" : "시가", "type" : "String", "required" : "Y", "length" : "14", "description" : "해당 일자에 처음 체결된 가격입니다. 행마다 그 날의 시가이며, 배열 첫 행이 당일 시가입니다.", "depth" : 0 }, { "element" : "hprc", "name" : "고가", "type" : "String", "required" : "Y", "length" : "14", "description" : "해당 일자에 가장 높았던 체결 가격입니다.", "depth" : 0 }, { "element" : "lprc", "name" : "저가", "type" : "String", "required" : "Y", "length" : "14", "description" : "해당 일자에 가장 낮았던 체결 가격입니다.", "depth" : 0 }, { "element" : "dcpn_cnt", "name" : "소수점수", "type" : "Number", "required" : "Y", "length" : "2", "description" : "가격의 소수점 자릿수입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 성공 응답 코드입니다.\n\"0000\": 정상 처리\n\n오류는 종류와 무관하게 HTTP 500 으로 반환되므로, 성공·실패는 HTTP 상태가 아니라 이 값으로 판정하십시오.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 담깁니다.\n\n오류 응답에는 data 와 tr_cont 가 담기지 않습니다. 오류일 때 본문은 rsp_cd·rsp_msg(일부 API 는 rsp_sub_msg 포함)로 이루어지므로, rsp_cd 를 먼저 확인한 뒤 data 를 읽으십시오.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "오류일 때 내려올 수 있는 상세 사유 항목입니다. 정상 응답에는 포함되지 않습니다.", "depth" : 0 } ] }, "requestExample" : "GET /market/v1/overseas/candles/days?mrkt_div_code=OV&mrkt_cls_code=OQ&iscd=AAPL&dely_rltm_cls_code=0&mod_stpr_cls_code=0\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": [\n {\n \"date\": \"20260911\",\n \"prpr\": \"326.5700\",\n \"prdy_vrss_sign\": \"3\",\n \"prdy_vrss\": \"0.0000\",\n \"prdy_ctrt\": \"0.00\",\n \"acml_vol\": 0,\n \"oprc\": \"326.5700\",\n \"hprc\": \"326.5700\",\n \"lprc\": \"326.5700\",\n \"dcpn_cnt\": 4\n },\n {\n \"date\": \"20260910\",\n \"prpr\": \"326.5700\",\n \"prdy_vrss_sign\": \"2\",\n \"prdy_vrss\": \"11.2300\",\n \"prdy_ctrt\": \"3.56\",\n \"acml_vol\": 70011913,\n \"oprc\": \"316.6700\",\n \"hprc\": \"326.7400\",\n \"lprc\": \"316.5100\",\n \"dcpn_cnt\": 4\n }\n ],\n \"rsp_cd\": \"0000\",\n \"rsp_msg\": \"정상 처리 되었습니다.\"\n}" } ] }, { "name" : "해외주식 체결추이 (틱)", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/market/v1/overseas/trades/ticks", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "해외주식 한 종목의 체결 추이를 틱 단위로, 가장 최근 체결부터 조회합니다.", "trs" : [ { "name" : "해외주식 체결추이 조회 (틱)", "code" : "ohhts_eapi_006r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "mrkt_div_code", "name" : "시장 구분 코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "해외 시세는 \"OV\"를 넣습니다.\n\n(query string)", "depth" : 0 }, { "element" : "mrkt_cls_code", "name" : "거래소 구분 코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "거래소 구분입니다.\n\"OQ\": 나스닥\n\"NY\": 뉴욕\n\"AX\": 아멕스\n\"HK\": 홍콩증권거래소\n\"SH\": 상하이증권거래소\n\"SZ\": 심천증권거래소\n\"JP\": 도쿄증권거래소 (query string)", "depth" : 0 }, { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "16", "description" : "해외 종목 심볼을 입력합니다. (예: AAPL)\n\n(query string)", "depth" : 0 }, { "element" : "dely_rltm_cls_code", "name" : "지연실시간구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "시세 종류입니다.\n\"0\": 실시간\n\"1\": 지연 (query string)", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "N", "length" : "1", "description" : "연속조회 여부입니다. 이 API 는 응답에 tr_cont·tr_cont_key 가 내려오지 않습니다. 1 을 넣으면 오류 없이 data 가 빈 배열로 내려오므로 처음 조회에서는 넣지 않으셔도 됩니다. (query string)", "depth" : 0 }, { "element" : "tr_cont_key", "name" : "연속조회 키", "type" : "String", "required" : "N", "length" : "20", "description" : "연속조회 키입니다. 이 API 는 응답에 연속조회 키가 내려오지 않으므로 넣지 않으셔도 됩니다. (query string)", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "목록", "type" : "Object Array", "required" : "Y", "length" : "-", "description" : "체결 한 건이 한 행인 배열입니다. 가장 최근 체결이 앞에 옵니다.\n응답에 다음 페이지를 받을 키(tr_cont_key)가 내려오지 않습니다.", "depth" : 0 }, { "element" : "hour", "name" : "시간", "type" : "String", "required" : "Y", "length" : "6", "description" : "현지 체결 시각입니다. HHMMSS 6자리.", "depth" : 0 }, { "element" : "prpr", "name" : "현재가", "type" : "String", "required" : "Y", "length" : "14", "description" : "해당 체결 건의 가격입니다. 행마다 그때 체결된 가격이므로 값이 서로 다릅니다.\n\n배열 첫 행이 가장 최근 체결이며, 뒤로 갈수록 앞서 체결된 건입니다.", "depth" : 0 }, { "element" : "prdy_vrss", "name" : "전일대비", "type" : "String", "required" : "Y", "length" : "14", "description" : "전일 종가 대비 등락폭입니다.", "depth" : 0 }, { "element" : "prdy_vrss_sign", "name" : "전일대비부호", "type" : "String", "required" : "Y", "length" : "1", "description" : "등락 부호입니다.\n\"1\" 상한 · \"2\" 상승 · \"3\" 보합 · \"4\" 하한 · \"5\" 하락", "depth" : 0 }, { "element" : "prdy_ctrt", "name" : "전일대비율", "type" : "String", "required" : "Y", "length" : "11", "description" : "전일 종가 대비 등락률입니다. 단위는 퍼센트.", "depth" : 0 }, { "element" : "cntg_vol", "name" : "체결거래량", "type" : "Number", "required" : "Y", "length" : "13", "description" : "이 체결의 거래량입니다.", "depth" : 0 }, { "element" : "dcpn_cnt", "name" : "소수점수", "type" : "Number", "required" : "Y", "length" : "2", "description" : "가격의 소수점 자릿수입니다.", "depth" : 0 }, { "element" : "korea_hour", "name" : "한국시간", "type" : "String", "required" : "Y", "length" : "6", "description" : "한국 시각으로 환산한 체결 시각입니다. HHMMSS 6자리.", "depth" : 0 }, { "element" : "rltv", "name" : "체결강도", "type" : "String", "required" : "Y", "length" : "10", "description" : "체결강도입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 성공 응답 코드입니다.\n\"0000\": 정상 처리\n\n조회 결과가 없을 때도 \"0000\" 이 내려옵니다. 목록을 내려주는 조회는 빈 배열이 \"0000\" 과 함께 옵니다. 결과 건수로 직접 확인하십시오.\n\n오류는 종류와 무관하게 HTTP 500 으로 반환됩니다. 성공·실패는 HTTP 상태가 아니라 이 값으로 판정하시고, 다른 계열 API 는 성공 코드가 \"0000\" 이 아닐 수 있으니 API 마다 확인하십시오.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 담깁니다.\n\n오류 응답에는 data 와 tr_cont 가 담기지 않습니다. 오류일 때 본문은 rsp_cd·rsp_msg(일부 API 는 rsp_sub_msg 포함)로 이루어지므로, rsp_cd 를 먼저 확인한 뒤 data 를 읽으십시오.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "N", "length" : "1", "description" : "이 API 는 연속조회를 지원하지 않습니다. 응답에 이 항목이 담기지 않습니다.", "depth" : 0 }, { "element" : "tr_cont_key", "name" : "연속조회 키", "type" : "String", "required" : "N", "length" : "20", "description" : "이 API 는 연속조회를 지원하지 않아 응답에 연속조회 키가 담기지 않습니다.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "오류일 때 내려올 수 있는 상세 사유 항목입니다. 정상 응답에는 포함되지 않습니다.", "depth" : 0 } ] }, "requestExample" : "GET /market/v1/overseas/trades/ticks?mrkt_div_code=OV&mrkt_cls_code=OQ&iscd=AAPL&dely_rltm_cls_code=0\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": [\n {\n \"hour\": \"034840\",\n \"prpr\": \"326.3100\",\n \"prdy_vrss\": \"-0.2600\",\n \"prdy_vrss_sign\": \"5\",\n \"prdy_ctrt\": \"-0.08\",\n \"cntg_vol\": 10,\n \"dcpn_cnt\": 4,\n \"korea_hour\": \"164840\",\n \"rltv\": \"96.73\"\n },\n {\n \"hour\": \"034426\",\n \"prpr\": \"326.2900\",\n \"prdy_vrss\": \"-0.2800\",\n \"prdy_vrss_sign\": \"5\",\n \"prdy_ctrt\": \"-0.09\",\n \"cntg_vol\": 9,\n \"dcpn_cnt\": 4,\n \"korea_hour\": \"164426\",\n \"rltv\": \"96.73\"\n }\n ],\n \"rsp_cd\": \"0000\",\n \"rsp_msg\": \"정상 처리 되었습니다.\"\n}" } ] }, { "name" : "해외주식 체결추이 조회 (분)", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/market/v1/overseas/trades/minutes", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "해외주식 한 종목의 분 단위 체결 추이를 최근 구간부터 조회합니다.", "trs" : [ { "name" : "해외주식 체결추이 조회 (분)", "code" : "ohhts_eapi_005r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "mrkt_div_code", "name" : "시장 구분 코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "해외 시세는 \"OV\"를 넣습니다.\n\n(query string)", "depth" : 0 }, { "element" : "mrkt_cls_code", "name" : "거래소 구분 코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "거래소 구분입니다.\n\"OQ\": 나스닥\n\"NY\": 뉴욕\n\"AX\": 아멕스\n\"HK\": 홍콩증권거래소\n\"SH\": 상하이증권거래소\n\"SZ\": 심천증권거래소\n\"JP\": 도쿄증권거래소 (query string)", "depth" : 0 }, { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "16", "description" : "해외 종목 심볼을 입력합니다. (예: AAPL)\n\n(query string)", "depth" : 0 }, { "element" : "dely_rltm_cls_code", "name" : "지연실시간구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "시세 종류입니다.\n\"0\": 실시간\n\"1\": 지연\n\n지연(\"1\")으로 조회하면 이전 시각의 행이 섞여 내려올 수 있으니 체결시간(korea_hour)을 확인하십시오. (query string)", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "체결 목록", "type" : "Object Array", "required" : "Y", "length" : "-", "description" : "1분 단위로 집계한 체결 배열입니다. 최근 구간이 앞에 옵니다.\n\n한 번에 40건까지 내려옵니다.", "depth" : 0 }, { "element" : "korea_hour", "name" : "체결시간", "type" : "String", "required" : "Y", "length" : "6", "description" : "집계 구간의 국내 기준 시각입니다. HHMMSS 형식이며 1분 간격입니다.", "depth" : 0 }, { "element" : "prpr", "name" : "현재가", "type" : "String", "required" : "Y", "length" : "14", "description" : "해당 1분 구간의 마지막 체결 가격입니다. 행마다 그 분이 끝난 시점의 가격이므로 값이 서로 다릅니다.", "depth" : 0 }, { "element" : "prdy_vrss_sign", "name" : "전일대비부호", "type" : "String", "required" : "Y", "length" : "1", "description" : "전일 대비 부호입니다.\n\"1\": 상한\n\"2\": 상승\n\"3\": 보합\n\"4\": 하한\n\"5\": 하락", "depth" : 0 }, { "element" : "prdy_vrss", "name" : "전일대비", "type" : "String", "required" : "Y", "length" : "14", "description" : "전일 종가 대비 등락 가격입니다.", "depth" : 0 }, { "element" : "prdy_ctrt", "name" : "전일대비율", "type" : "String", "required" : "Y", "length" : "11", "description" : "전일 종가 대비 등락률(%)입니다.", "depth" : 0 }, { "element" : "cntg_vol", "name" : "체결거래량", "type" : "Number", "required" : "Y", "length" : "13", "description" : "해당 1분 구간에 체결된 수량입니다. 이 조회는 1분 단위로 집계되며, 다른 간격으로 보시려면 해외주식 시세추이 조회(분봉)에서 봉 간격(hour_cls_code)을 지정해 조회하십시오.", "depth" : 0 }, { "element" : "acml_vol", "name" : "누적거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "장 시작부터 해당 1분 구간까지 체결된 주식 수를 모두 더한 값입니다.", "depth" : 0 }, { "element" : "acml_tr_pbmn", "name" : "누적거래대금", "type" : "Number", "required" : "Y", "length" : "18", "description" : "장 시작부터 해당 구간까지 체결된 거래대금을 모두 더한 값입니다.", "depth" : 0 }, { "element" : "askp1", "name" : "매도호가1", "type" : "String", "required" : "Y", "length" : "14", "description" : "해당 구간의 매도 1호가입니다.", "depth" : 0 }, { "element" : "bidp1", "name" : "매수호가1", "type" : "String", "required" : "Y", "length" : "14", "description" : "해당 구간의 매수 1호가입니다.", "depth" : 0 }, { "element" : "rltv", "name" : "체결강도", "type" : "String", "required" : "Y", "length" : "10", "description" : "체결강도(%)입니다.", "depth" : 0 }, { "element" : "dcpn_cnt", "name" : "소수점수", "type" : "Number", "required" : "Y", "length" : "2", "description" : "가격의 소수점 자릿수입니다.", "depth" : 0 }, { "element" : "korea_date", "name" : "한국일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "집계 구간의 국내 기준 일자입니다. YYYYMMDD 형식입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 성공 응답 코드입니다.\n\"0000\": 정상 처리\n\n오류는 종류와 무관하게 HTTP 500 으로 반환되므로, 성공·실패는 HTTP 상태가 아니라 이 값으로 판정하십시오.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 담깁니다.\n\n오류 응답에는 data 와 tr_cont 가 담기지 않습니다. 오류일 때 본문은 rsp_cd·rsp_msg(일부 API 는 rsp_sub_msg 포함)로 이루어지므로, rsp_cd 를 먼저 확인한 뒤 data 를 읽으십시오.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "오류일 때 내려올 수 있는 상세 사유 항목입니다. 정상 응답에는 포함되지 않습니다.", "depth" : 0 } ] }, "requestExample" : "GET /market/v1/overseas/trades/minutes?mrkt_div_code=OV&mrkt_cls_code=OQ&iscd=AAPL&dely_rltm_cls_code=0\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": [\n {\n \"korea_hour\": \"164900\",\n \"prpr\": \"326.3100\",\n \"prdy_vrss_sign\": \"5\",\n \"prdy_vrss\": \"-0.2600\",\n \"prdy_ctrt\": \"-0.08\",\n \"cntg_vol\": 10,\n \"acml_vol\": 24295,\n \"acml_tr_pbmn\": 7916790,\n \"askp1\": \"326.4100\",\n \"bidp1\": \"326.3000\",\n \"rltv\": \"96.73\",\n \"dcpn_cnt\": 4,\n \"korea_date\": \"20260911\"\n },\n {\n \"korea_hour\": \"164500\",\n \"prpr\": \"326.2900\",\n \"prdy_vrss_sign\": \"5\",\n \"prdy_vrss\": \"-0.2800\",\n \"prdy_ctrt\": \"-0.09\",\n \"cntg_vol\": 37,\n \"acml_vol\": 24285,\n \"acml_tr_pbmn\": 7913527,\n \"askp1\": \"326.4600\",\n \"bidp1\": \"326.2900\",\n \"rltv\": \"96.73\",\n \"dcpn_cnt\": 4,\n \"korea_date\": \"20260911\"\n }\n ],\n \"rsp_cd\": \"0000\",\n \"rsp_msg\": \"정상 처리 되었습니다.\"\n}" } ] }, { "name" : "해외주식 주문체결내역 조회", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/trading/v1/overseas/orders/history", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "기간으로 해외주식 주문·체결 내역을 조회합니다. 정정·취소 건은 원주문과 별개의 행으로 내려오며, orgl_oder_no 는 최초 주문이 아니라 바로 직전 건을 가리킵니다.", "trs" : [ { "name" : "해외주식 주문체결내역 조회", "code" : "obtro_oder_201r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "oder_sta_date", "name" : "주문시작일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "조회 시작일자를 YYYYMMDD 8자리로 입력합니다.\n시작일자에 \"00000000\" 을 넣고 종료일자를 뒤의 날짜(예: \"20991231\")로 두면 전체 이력이 내려옵니다. 시작일자가 종료일자보다 크면 rsp_cd \"3174\" 오류입니다. (query string)", "depth" : 0 }, { "element" : "oder_fin_date", "name" : "주문종료일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "조회 종료일자를 YYYYMMDD 8자리로 입력합니다.\n\"00000000\" 은 넣지 마십시오. 시작일자보다 작아 rsp_cd \"3174\" 오류가 납니다. 기간 끝을 열어 두려면 충분히 뒤의 날짜(예: \"20991231\")를 넣으십시오. (query string)", "depth" : 0 }, { "element" : "seln_byov_clcd", "name" : "매도매수구분코드", "type" : "String", "required" : "N", "length" : "1", "description" : "매도·매수 구분입니다.\n\"0\": 전체\n\"1\": 매도\n\"2\": 매수\n\n값대로 걸러집니다. \"1\" 은 매도만 내려옵니다.\n\n항목을 빼시면 전체가 조회됩니다. 목록에 없는 한 자리 값은 전체 조회가 아니라 0건(rsp_cd \"5820\")이 내려옵니다. 자료가 없는 것과 값이 잘못된 것이 같은 응답이므로 보내시기 전에 세 값 가운데 하나인지 확인하십시오. (query string)", "depth" : 0 }, { "element" : "cntg_cls_code", "name" : "체결구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "체결 여부로 걸러냅니다.\n\"0\": 전체\n\"1\": 체결\n\"2\": 미체결\n\n필수 항목입니다. (query string)", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "N", "length" : "1", "description" : "다음 페이지를 요청하실 때 \"1\" 을 넣습니다. 첫 조회에는 넣지 않습니다. tr_cont_key 와 함께 쿼리 스트링으로 보내십시오.", "depth" : 0 }, { "element" : "tr_cont_key", "name" : "연속조회 키", "type" : "String", "required" : "N", "length" : "20", "description" : "직전 응답의 tr_cont_key 를 그대로 넣습니다. 첫 조회에는 넣지 않습니다. 쿼리 스트링으로 보내십시오.\n\n직전 응답의 값을 고치지 말고 그대로 보내십시오.", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "주문체결 내역 목록", "type" : "Object Array", "required" : "Y", "length" : "-", "description" : "주문·체결 내역 배열입니다.\n\n한 페이지에 30건까지 담깁니다. 그보다 많으면 tr_cont 가 \"1\" 로 내려오니 tr_cont_key 로 다음 페이지를 이어서 받으십시오.", "depth" : 0 }, { "element" : "oder_date", "name" : "주문일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "주문일자입니다. YYYYMMDD 형식입니다. 정정·취소 요청에 이 값을 함께 넣습니다.", "depth" : 0 }, { "element" : "oder_no", "name" : "주문번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "주문 번호입니다. 정정·취소 요청의 orgl_oder_no 에 이 값을 넣습니다.", "depth" : 0 }, { "element" : "orgl_oder_no", "name" : "원주문번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "이 정정·취소 주문이 대상으로 삼은 주문의 번호입니다. 신규 주문은 0 입니다.", "depth" : 0 }, { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "종목 코드입니다. 심볼에 거래소 접미어가 붙은 형태입니다. (예: \"PLTR.OQ\")", "depth" : 0 }, { "element" : "kor_isnm", "name" : "한글종목명", "type" : "String", "required" : "Y", "length" : "100", "description" : "한글 종목명입니다.", "depth" : 0 }, { "element" : "seln_byov_clcd", "name" : "매도매수구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "매매 구분입니다.\n\"1\": 매도\n\"2\": 매수", "depth" : 0 }, { "element" : "oder_dqty", "name" : "주문수량", "type" : "String", "required" : "Y", "length" : "24", "description" : "주문 수량입니다. 소수점 주문을 지원하므로 소수 자릿수가 붙습니다.", "depth" : 0 }, { "element" : "ovrs_stck_oder_prc", "name" : "주문가격", "type" : "String", "required" : "Y", "length" : "20", "description" : "주문 단가입니다.", "depth" : 0 }, { "element" : "cntg_dqty", "name" : "체결수량", "type" : "String", "required" : "Y", "length" : "24", "description" : "체결된 수량입니다. 미체결 건은 0입니다.", "depth" : 0 }, { "element" : "cntg_crnc_prc", "name" : "체결가격", "type" : "String", "required" : "Y", "length" : "20", "description" : "체결 단가입니다. 미체결 건은 0입니다. 거래 통화 기준입니다.", "depth" : 0 }, { "element" : "ncnt_odqt", "name" : "미체결수량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "미체결 수량 항목입니다. 실제 미체결 수량과 다를 수 있으므로 남은 수량은 같은 행의 주문수량(oder_dqty)에서 체결수량(cntg_dqty)을 빼서 구하십시오.", "depth" : 0 }, { "element" : "cntg_camt", "name" : "체결금액", "type" : "String", "required" : "Y", "length" : "20", "description" : "체결 금액입니다. 미체결 건은 0입니다. 거래 통화 기준입니다.", "depth" : 0 }, { "element" : "ovrs_stck_oder_stat_cls_code", "name" : "주문상태구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "주문의 접수 처리 상태입니다.\n\"0\": 정상\n\"1\": 거부\n\"2\": 자동거부\n\"3\": 자동취소(체결후)\n\"4\": 미접수", "depth" : 0 }, { "element" : "oder_rctf_cncl_cls_code", "name" : "주문정정취소구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "이 행이 원주문인지 정정·취소인지 구분합니다.\n\"0\": 원주문\n\"1\": 정정\n\"2\": 취소\n\n같은 행의 rctf_cncl_cls_name 에 \"정정\" \"취소\" 한글 표기가 함께 오며 원주문 행은 빈 값입니다.", "depth" : 0 }, { "element" : "rctf_cncl_cls_name", "name" : "정정취소구분명", "type" : "String", "required" : "Y", "length" : "40", "description" : "정정·취소 구분의 한글명입니다. 원주문 행은 빈 값입니다.", "depth" : 0 }, { "element" : "oder_exec_ymdh", "name" : "주문실행일시", "type" : "String", "required" : "Y", "length" : "19", "description" : "주문이 접수된 시각입니다. \"YYYY-MM-DD HH:MM:SS\" 형식입니다.", "depth" : 0 }, { "element" : "cntg_ymdh", "name" : "체결일시", "type" : "String", "required" : "Y", "length" : "19", "description" : "체결된 시각입니다. \"YYYY-MM-DD HH:MM:SS\" 형식이며 미체결 건은 빈 값입니다.", "depth" : 0 }, { "element" : "aspr_type_code", "name" : "호가유형코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "호가 유형입니다. \"1\": 시장가, \"2\": 지정가, \"4\": LOO, \"5\": LOC, \"6\": MOO, \"7\": MOC, \"8\": Limit VWAP, \"9\": Limit TWAP, \"A\": VWAP, \"B\": TWAP.", "depth" : 0 }, { "element" : "oder_cond_cls_code", "name" : "주문조건구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "주문의 조건 코드입니다.", "depth" : 0 }, { "element" : "ovrs_stck_mrkt_tr_cls_code", "name" : "해외주식시장거래구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "해외 시장 거래 구분입니다. \"01\": 미국, \"02\": 홍콩, \"03\": 상해, \"04\": 심천, \"05\": 일본.\n그 밖의 값: \"06\" 호주, \"07\" 싱가폴, \"08\" 런던, \"10\" 독일, \"12\" 프랑스, \"21\" 캐나다, \"24\" 베트남, \"26\" 스위스 등.", "depth" : 0 }, { "element" : "crcd", "name" : "통화코드", "type" : "String", "required" : "Y", "length" : "3", "description" : "거래 통화 코드입니다.", "depth" : 0 }, { "element" : "onln_yn", "name" : "온라인 주문가능 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "온라인으로 접수된 건인지 여부입니다.\n\"Y\": 온라인\n\"N\": 영업점", "depth" : 0 }, { "element" : "oder_cnfr_yn", "name" : "주문확인여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "주문 확인 여부입니다.\n\"Y\": 확인\n\"N\": 미확인", "depth" : 0 }, { "element" : "cntg_no", "name" : "체결번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "체결 번호입니다.", "depth" : 0 }, { "element" : "ovrs_stck_rfus_idnt_code", "name" : "거부식별코드", "type" : "String", "required" : "Y", "length" : "10", "description" : "주문 거부를 식별하는 코드입니다. 거부 사유는 ovrs_stck_rfus_reas 를 읽으십시오.", "depth" : 0 }, { "element" : "ovrs_stck_rfus_reas", "name" : "거부사유", "type" : "String", "required" : "Y", "length" : "100", "description" : "주문이 거부된 사유입니다. 정상 접수 건은 빈 값입니다.", "depth" : 0 }, { "element" : "loan_date", "name" : "대출일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "대출 일자입니다. 대출 주문이 아니면 빈 값입니다.", "depth" : 0 }, { "element" : "loan_dtl_type_code", "name" : "대출상세유형코드", "type" : "String", "required" : "Y", "length" : "4", "description" : "대출 상세 유형입니다.\n\"0000\": 보통\n\"0101\": 자기융자\n\"0102\": 유통융자\n\"0103\": 자기대주\n\"0104\": 유통대주\n\"0201\": 예탁주식\n\"0251\": 예탁주식(해외)\n\n대출 주문이 아니면 \"0000\"입니다.", "depth" : 0 }, { "element" : "entm_onsl_intg_clcd", "name" : "위탁자기통합구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "주문 단위 구분입니다.\n\"10\": 일반\n\"30\": 소수점", "depth" : 0 }, { "element" : "oder_amt", "name" : "주문금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "주문 금액 칸입니다. 이 항목은 0 으로 내려옵니다. 주문 금액은 주문수량(oder_dqty)에 주문가격(ovrs_stck_oder_prc)을 곱해 구하십시오.", "depth" : 0 }, { "element" : "oder_unpr", "name" : "주문단가", "type" : "Number", "required" : "Y", "length" : "19", "description" : "주문 단가 항목입니다. 0 으로 내려오며 같은 행의 주문금액(oder_amt)도 같습니다.\n주문 단가는 같은 행의 주문가격(ovrs_stck_oder_prc)을 쓰십시오.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 성공 응답 코드입니다. \"5762\": 조회 결과가 더 있음(연속조회), \"5766\": 조회 완료, \"5820\": 조회할 자료 없음.\n오류는 종류와 무관하게 HTTP 500 으로 반환됩니다.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 담깁니다.\n오류 응답 본문에는 rsp_cd·rsp_msg 가 있고 data 와 tr_cont 는 없으므로, data 를 꺼내기 전에 HTTP 상태와 rsp_cd 를 먼저 확인하십시오.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "다음 페이지가 남아 있으면 \"1\", 마지막이면 \"0\"입니다.", "depth" : 0 }, { "element" : "tr_cont_key", "name" : "연속조회 키", "type" : "String", "required" : "N", "length" : "64", "description" : "연속조회 키입니다. tr_cont 가 \"1\" 일 때만 담기며, 마지막 페이지와 오류 응답에는 이 항목이 없습니다.\n다음 페이지를 요청할 때는 직전 응답의 값을 한 글자도 바꾸지 말고 그대로 넣으십시오.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "오류일 때 구체적인 사유가 담기는 경우 내려옵니다.", "depth" : 0 } ] }, "requestExample" : "GET /trading/v1/overseas/orders/history?oder_sta_date=20260101&oder_fin_date=20261010&seln_byov_clcd=0&cntg_cls_code=2\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": [\n {\n \"oder_date\": \"20260824\",\n \"oder_no\": 7,\n \"orgl_oder_no\": 0,\n \"iscd\": \"NVDA.OQ\",\n \"kor_isnm\": \"엔비디아\",\n \"seln_byov_clcd\": \"2\",\n \"oder_dqty\": \"1.0000000000\",\n \"ovrs_stck_oder_prc\": \"216.46000000\",\n \"cntg_dqty\": \"0.0000000000\",\n \"cntg_crnc_prc\": \"0.00000000\",\n \"ncnt_odqt\": 0,\n \"cntg_camt\": \"0.0000\",\n \"ovrs_stck_oder_stat_cls_code\": \"0\",\n \"oder_rctf_cncl_cls_code\": \"0\",\n \"rctf_cncl_cls_name\": \"\",\n \"oder_exec_ymdh\": \"2026-08-24 11:21:47\",\n \"cntg_ymdh\": \"\",\n \"aspr_type_code\": \"2\",\n \"oder_cond_cls_code\": \"8\",\n \"ovrs_stck_mrkt_tr_cls_code\": \"01\",\n \"crcd\": \"USD\",\n \"onln_yn\": \"Y\",\n \"oder_cnfr_yn\": \"Y\",\n \"cntg_no\": 0,\n \"ovrs_stck_rfus_idnt_code\": \"\",\n \"ovrs_stck_rfus_reas\": \"\",\n \"loan_date\": \"\",\n \"loan_dtl_type_code\": \"0000\",\n \"entm_onsl_intg_clcd\": \"10\",\n \"oder_amt\": 0,\n \"oder_unpr\": 0\n },\n {\n \"oder_date\": \"20260824\",\n \"oder_no\": 8,\n \"orgl_oder_no\": 0,\n \"iscd\": \"AAPL.OQ\",\n \"kor_isnm\": \"애플\",\n \"seln_byov_clcd\": \"2\",\n \"oder_dqty\": \"1.0000000000\",\n \"ovrs_stck_oder_prc\": \"309.49000000\",\n \"cntg_dqty\": \"0.0000000000\",\n \"cntg_crnc_prc\": \"0.00000000\",\n \"ncnt_odqt\": 0,\n \"cntg_camt\": \"0.0000\",\n \"ovrs_stck_oder_stat_cls_code\": \"0\",\n \"oder_rctf_cncl_cls_code\": \"0\",\n \"rctf_cncl_cls_name\": \"\",\n \"oder_exec_ymdh\": \"2026-08-24 11:21:58\",\n \"cntg_ymdh\": \"\",\n \"aspr_type_code\": \"2\",\n \"oder_cond_cls_code\": \"8\",\n \"ovrs_stck_mrkt_tr_cls_code\": \"01\",\n \"crcd\": \"USD\",\n \"onln_yn\": \"Y\",\n \"oder_cnfr_yn\": \"Y\",\n \"cntg_no\": 0,\n \"ovrs_stck_rfus_idnt_code\": \"\",\n \"ovrs_stck_rfus_reas\": \"\",\n \"loan_date\": \"\",\n \"loan_dtl_type_code\": \"0000\",\n \"entm_onsl_intg_clcd\": \"10\",\n \"oder_amt\": 0,\n \"oder_unpr\": 0\n }\n ],\n \"rsp_cd\": \"5766\",\n \"rsp_msg\": \"조회가 완료되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "해외주식 주문체결 상세조회", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/trading/v1/overseas/orders/detail", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "해외주식 주문 한 건의 상세 내역을 조회합니다. 주문 수량과 단가, 체결 수량·체결 단가, 미체결 잔량(ncnt_odqt), 체결 시각, 거부된 주문의 사유(ovrs_stck_rfus_reas)까지 확인하실 수 있습니다.", "trs" : [ { "name" : "해외주식 주문번호 체결조회", "code" : "obtro_oder_271r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "oder_sta_date", "name" : "주문일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "조회할 주문의 주문일자를 YYYYMMDD 8자리로 입력합니다. 주문체결내역 조회(/trading/v1/overseas/orders/history) 응답의 oder_date 와 같은 값입니다. (query string)", "depth" : 0 }, { "element" : "oder_no", "name" : "주문번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "조회할 주문 번호입니다. 주문 접수 응답의 oder_no 또는 주문체결내역 조회 응답의 oder_no 를 그대로 넣으십시오.\n\n(query string)", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "주문체결 내역 목록", "type" : "Object Array", "required" : "Y", "length" : "-", "description" : "요청하신 주문번호 한 건의 내역입니다. 배열로 내려오지만 원소는 항상 한 건입니다.", "depth" : 0 }, { "element" : "oder_date", "name" : "주문일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "주문일자입니다. YYYYMMDD 형식입니다. 정정·취소 요청에 이 값을 함께 넣습니다.", "depth" : 0 }, { "element" : "oder_no", "name" : "주문번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "주문 번호입니다. 정정·취소 요청의 orgl_oder_no 에 이 값을 넣습니다.", "depth" : 0 }, { "element" : "orgl_oder_no", "name" : "원주문번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "이 정정·취소 주문이 대상으로 삼은 주문의 번호입니다. 신규 주문은 0 입니다.", "depth" : 0 }, { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "종목 코드입니다. 심볼에 거래소 접미어가 붙은 형태입니다. (예: \"PLTR.OQ\")", "depth" : 0 }, { "element" : "kor_isnm", "name" : "한글종목명", "type" : "String", "required" : "Y", "length" : "100", "description" : "한글 종목명입니다.", "depth" : 0 }, { "element" : "seln_byov_clcd", "name" : "매도매수구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "매매 구분입니다.\n\"1\": 매도\n\"2\": 매수", "depth" : 0 }, { "element" : "oder_dqty", "name" : "주문수량", "type" : "String", "required" : "Y", "length" : "24", "description" : "주문 수량입니다. 소수점 주문을 지원하므로 소수 자릿수가 붙습니다.", "depth" : 0 }, { "element" : "ovrs_stck_oder_prc", "name" : "주문가격", "type" : "String", "required" : "Y", "length" : "20", "description" : "주문 단가입니다.", "depth" : 0 }, { "element" : "cntg_dqty", "name" : "체결수량", "type" : "String", "required" : "Y", "length" : "24", "description" : "체결된 수량입니다. 미체결 건은 0입니다.", "depth" : 0 }, { "element" : "cntg_crnc_prc", "name" : "체결가격", "type" : "String", "required" : "Y", "length" : "20", "description" : "체결 단가입니다. 미체결 건은 0입니다.", "depth" : 0 }, { "element" : "ncnt_odqt", "name" : "미체결수량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "아직 체결되지 않은 수량입니다. 정상 접수된 미체결 주문에서도 0 으로 내려오는 경우가 있으므로 이 값을 쓰지 말고 잔량은 oder_dqty - cntg_dqty 로 계산하십시오.", "depth" : 0 }, { "element" : "cntg_camt", "name" : "체결금액", "type" : "String", "required" : "Y", "length" : "20", "description" : "체결 금액입니다. 미체결 건은 0입니다.", "depth" : 0 }, { "element" : "ovrs_stck_oder_stat_cls_code", "name" : "주문상태구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "주문의 접수 처리 상태입니다.\n\"0\": 정상\n\"1\": 거부\n\"2\": 자동거부\n\"3\": 자동취소(체결후)\n\"4\": 미접수", "depth" : 0 }, { "element" : "oder_rctf_cncl_cls_code", "name" : "주문정정취소구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "이 행이 원주문인지 정정·취소인지 구분합니다.\n\"0\": 원주문\n\"1\": 정정\n\"2\": 취소", "depth" : 0 }, { "element" : "rctf_cncl_cls_name", "name" : "정정취소구분명", "type" : "String", "required" : "Y", "length" : "40", "description" : "정정·취소 구분의 한글명입니다. 원주문 행은 빈 값입니다.", "depth" : 0 }, { "element" : "oder_exec_ymdh", "name" : "주문실행일시", "type" : "String", "required" : "Y", "length" : "19", "description" : "주문이 접수된 시각입니다. \"YYYY-MM-DD HH:MM:SS\" 형식입니다.", "depth" : 0 }, { "element" : "cntg_ymdh", "name" : "체결일시", "type" : "String", "required" : "Y", "length" : "19", "description" : "체결된 시각입니다. \"YYYY-MM-DD HH:MM:SS\" 형식이며 미체결 건은 빈 값입니다.", "depth" : 0 }, { "element" : "aspr_type_code", "name" : "호가유형코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "호가 유형입니다.\n\"1\": 시장가\n\"2\": 지정가\n\"4\": LOO\n\"5\": LOC\n\"6\": MOO\n\"7\": MOC\n\"8\": Limit VWAP\n\"9\": Limit TWAP\n\"A\": VWAP\n\"B\": TWAP", "depth" : 0 }, { "element" : "oder_cond_cls_code", "name" : "주문조건구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "주문 접수 시 주문 구분에 따라 부여된 조건 코드입니다.\n요청에 넣는 oder_cond_cls_code(\"0\" 조건 없음 · \"2\" 개장 전 · \"7\" 종가)와 값 체계가 다르므로 그대로 되돌려 보내지 마십시오.", "depth" : 0 }, { "element" : "ovrs_stck_mrkt_tr_cls_code", "name" : "해외주식시장거래구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "해외 시장 거래 구분입니다.\n01 미국, 02 홍콩, 03 상해, 04 심천, 05 일본, 06 호주, 07 싱가폴, 08 런던, 09 런던인터내셔날, 10 독일, 11 핀란드, 12 프랑스, 13 벨기에, 14 네덜란드, 15 포르투갈, 16 그리스, 17 아일랜드, 18 이탈리아, 19 스페인, 20 오스트리아, 21 캐나다, 23 인도네시아, 24 베트남, 26 스위스", "depth" : 0 }, { "element" : "crcd", "name" : "통화코드", "type" : "String", "required" : "Y", "length" : "3", "description" : "거래 통화 코드입니다.", "depth" : 0 }, { "element" : "oder_cnfr_yn", "name" : "주문확인여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "주문 확인 여부입니다.\n\"Y\": 확인\n\"N\": 미확인", "depth" : 0 }, { "element" : "cntg_no", "name" : "체결번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "체결 번호입니다. 체결되지 않은 주문은 0 입니다.\n\n같은 이름의 항목이 주문체결내역 조회(/trading/v1/overseas/orders/history)에서는 체결된 건도 0 으로 내려옵니다. 체결 번호가 필요하시면 이 API 를 쓰십시오.", "depth" : 0 }, { "element" : "ovrs_stck_rfus_idnt_code", "name" : "거부식별코드", "type" : "String", "required" : "Y", "length" : "10", "description" : "주문 거부를 식별하는 코드입니다. 정상 접수 건은 빈 값입니다.\n거부 사유는 ovrs_stck_rfus_reas 를 읽으십시오.", "depth" : 0 }, { "element" : "ovrs_stck_rfus_reas", "name" : "거부사유", "type" : "String", "required" : "Y", "length" : "100", "description" : "주문이 거부된 경우의 사유입니다. 정상 접수 건은 빈 값입니다.", "depth" : 0 }, { "element" : "loan_date", "name" : "대출일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "대출 일자입니다. 대출 주문이 아니면 빈 값입니다.", "depth" : 0 }, { "element" : "loan_dtl_type_code", "name" : "대출상세유형코드", "type" : "String", "required" : "Y", "length" : "4", "description" : "대출 상세 유형입니다.\n\"0000\": 보통\n\"0101\": 자기융자\n\"0102\": 유통융자\n\"0103\": 자기대주\n\"0104\": 유통대주\n\"0201\": 예탁주식\n\"0251\": 예탁주식(해외)\n\n대출 주문이 아니면 \"0000\"입니다.", "depth" : 0 }, { "element" : "entm_onsl_intg_clcd", "name" : "위탁자기통합구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "주문 단위 구분입니다.\n\"10\": 일반\n\"30\": 소수점", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 성공 응답 코드입니다.\n\"5766\": 조회 완료\n\"5820\": 조회할 자료 없음\n\n오류는 종류와 무관하게 HTTP 500 으로 반환되므로, 성공·실패는 HTTP 상태가 아니라 이 값으로 판정하십시오.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 이 값에 담깁니다.\n오류 응답에는 data 와 tr_cont 가 없으므로, rsp_cd 를 먼저 확인한 뒤 data 를 읽으십시오.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "연속조회 여부입니다. 이 API 의 정상 응답에서는 \"0\" 으로 내려옵니다.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "오류일 때만 내려오며 조치 정보가 담깁니다.\n정상 응답에는 포함되지 않습니다.", "depth" : 0 } ] }, "requestExample" : "GET /trading/v1/overseas/orders/detail?oder_sta_date=20260824&oder_no=9\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": [\n {\n \"oder_date\": \"20260824\",\n \"oder_no\": 9,\n \"orgl_oder_no\": 0,\n \"iscd\": \"PLTR.OQ\",\n \"kor_isnm\": \"팔란티어 테크\",\n \"seln_byov_clcd\": \"2\",\n \"oder_dqty\": \"1.0000000000\",\n \"ovrs_stck_oder_prc\": \"179.53000000\",\n \"cntg_dqty\": \"0.0000000000\",\n \"cntg_crnc_prc\": \"0.00000000\",\n \"ncnt_odqt\": 0,\n \"cntg_camt\": \"0.0000\",\n \"ovrs_stck_oder_stat_cls_code\": \"0\",\n \"oder_rctf_cncl_cls_code\": \"0\",\n \"rctf_cncl_cls_name\": \"\",\n \"oder_exec_ymdh\": \"2026-08-24 11:22:19\",\n \"cntg_ymdh\": \"\",\n \"aspr_type_code\": \"2\",\n \"oder_cond_cls_code\": \"8\",\n \"ovrs_stck_mrkt_tr_cls_code\": \"01\",\n \"crcd\": \"USD\",\n \"oder_cnfr_yn\": \"Y\",\n \"cntg_no\": 0,\n \"ovrs_stck_rfus_idnt_code\": \"\",\n \"ovrs_stck_rfus_reas\": \"\",\n \"loan_date\": \"\",\n \"loan_dtl_type_code\": \"0000\",\n \"entm_onsl_intg_clcd\": \"10\"\n }\n ],\n \"rsp_cd\": \"5766\",\n \"rsp_msg\": \"조회가 완료되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "해외주식 잔고 조회", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/accounts/v1/me/overseas/holdings", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "접근토큰에 매핑된 계좌의 해외주식 보유 내역을 조회합니다.", "trs" : [ { "name" : "해외주식 잔고 조회", "code" : "obtro_oder_110r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "N", "length" : "1", "description" : "다음 페이지를 요청할 때 정확히 \"1\" 을 넣습니다. 첫 조회에는 넣지 않습니다. 연속조회 키(tr_cont_key)와 반드시 함께 보내십시오. (query string)", "depth" : 0 }, { "element" : "tr_cont_key", "name" : "연속조회 키", "type" : "String", "required" : "N", "length" : "200", "description" : "직전 응답의 tr_cont_key 를 한 글자도 바꾸지 말고 그대로 URL 인코딩하여 넣습니다. 첫 조회에는 넣지 않습니다. tr_cont 에 \"1\" 을 함께 보내십시오. 키를 바꾸면 오류 없이 첫 페이지가 다시 내려옵니다. (query string)", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "보유 내역 목록", "type" : "Object Array", "required" : "Y", "length" : "-", "description" : "보유 종목 배열입니다.\n\n이 조회에는 요청 조건 항목이 없습니다. 거래소·통화별로 거르실 때는 응답의 거래소 코드(ovrs_exch_vndr_idno)나 통화(crcd)로 직접 추리십시오.", "depth" : 0 }, { "element" : "prod_cls_name", "name" : "상품구분명", "type" : "String", "required" : "Y", "length" : "40", "description" : "잔고 구분의 한글명입니다. rmnd_clcd 에 대응합니다.", "depth" : 0 }, { "element" : "rmnd_clcd", "name" : "잔고구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "잔고 구분입니다.\n\"1\": 일반\n\"2\": 소수\n\"3\": 대출", "depth" : 0 }, { "element" : "ovrs_stck_mrkt_tr_cls_code", "name" : "해외주식시장거래구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "해외 시장 거래 구분 코드입니다.", "depth" : 0 }, { "element" : "crcd", "name" : "통화코드", "type" : "String", "required" : "Y", "length" : "3", "description" : "거래 통화 코드입니다. (예: \"USD\")", "depth" : 0 }, { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "종목 코드입니다. 심볼에 거래소 접미어가 붙은 형태입니다. (예: \"AAPL.OQ\") 해외주식 현재가 조회(/market/v1/overseas/prices)에는 접미어를 뗀 순수 심볼인 해외주식심볼종목코드(ovrs_stck_symb_iscd)를 넣으십시오. 접미어가 붙은 채로 넣으시면 오류가 나지 않고 응답코드가 정상인 채 종목코드가 빈 값으로, 가격이 0 으로 내려옵니다. 값이 0 이라고 해서 그 종목의 가격이 0 인 것이 아니니, 응답의 iscd 가 비어 있는지로 조회 성공 여부를 판정하십시오.", "depth" : 0 }, { "element" : "isnm", "name" : "종목명", "type" : "String", "required" : "Y", "length" : "100", "description" : "종목명입니다.\n\n거래소 접미어가 붙은 종목 코드는 같은 행의 iscd, 접미어를 뗀 심볼은 ovrs_stck_symb_iscd 입니다.", "depth" : 0 }, { "element" : "rmnd_dqty", "name" : "잔고소수점수량", "type" : "String", "required" : "Y", "length" : "24.10", "description" : "보유 수량입니다. 소수 10자리 문자열로 내려오니 숫자로 바꿔 쓰십시오. (국내 보유종목 조회의 정수 수량 rmnd_qty 는 이 API 에 없습니다.)", "depth" : 0 }, { "element" : "seln_able_dqty", "name" : "매도가능수량", "type" : "String", "required" : "Y", "length" : "24.10", "description" : "매도 가능 수량입니다.", "depth" : 0 }, { "element" : "avrg_unpr", "name" : "평균단가", "type" : "String", "required" : "Y", "length" : "26.6", "description" : "매입 평균 단가입니다. 거래 통화 기준입니다.", "depth" : 0 }, { "element" : "vltn_prls_camt", "name" : "평가손익", "type" : "String", "required" : "Y", "length" : "20.4", "description" : "평가 손익입니다.", "depth" : 0 }, { "element" : "vltn_ert", "name" : "평가수익률", "type" : "String", "required" : "Y", "length" : "11.4", "description" : "평가 수익률(%)이며 소수 4자리 문자열입니다.", "depth" : 0 }, { "element" : "psnt_prc", "name" : "현재가격", "type" : "String", "required" : "Y", "length" : "20.6", "description" : "현재가입니다. 거래 통화 기준입니다.", "depth" : 0 }, { "element" : "prdy_vrss_rsfl_crnc_prc", "name" : "전일대비", "type" : "String", "required" : "Y", "length" : "20.8", "description" : "전일 대비 등락 가격입니다.", "depth" : 0 }, { "element" : "byov_camt", "name" : "매수금액", "type" : "String", "required" : "Y", "length" : "20.4", "description" : "매입 금액입니다.", "depth" : 0 }, { "element" : "frcr_vltn_amt", "name" : "외화평가금액", "type" : "String", "required" : "Y", "length" : "20.3", "description" : "평가 금액입니다. 소수 3자리 문자열입니다.", "depth" : 0 }, { "element" : "exrt", "name" : "환율", "type" : "String", "required" : "Y", "length" : "12.4", "description" : "평가에 적용된 환율입니다.", "depth" : 0 }, { "element" : "ovrs_stck_symb_iscd", "name" : "해외주식심볼종목코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "거래소 접미어를 뗀 순수 심볼입니다. (예: \"AAPL\") 해외주식 현재가 조회에는 종목코드(iscd)가 아니라 이 값을 넣으십시오. 시세 조회의 거래소 구분 코드(mrkt_cls_code)는 이 응답에 없으므로, 해외거래소벤더식별번호(ovrs_exch_vndr_idno) 설명의 대응표로 시세용 거래소 코드를 찾으십시오.", "depth" : 0 }, { "element" : "ovrs_exch_vndr_idno", "name" : "해외거래소벤더식별번호", "type" : "String", "required" : "Y", "length" : "6", "description" : "종목이 상장된 거래소의 벤더 코드입니다. 해외주식 현재가·호가 조회의 거래소 구분(mrkt_cls_code)은 이 벤더 코드가 아니라 시세용 거래소 코드를 받습니다. 벤더 코드를 넣으시면 오류 없이 빈 값이 내려옵니다. 대응은 \"0537\" 나스닥(OQ) · \"0321\" 뉴욕(NY) · \"0066\" 아멕스(AX) · \"0104\" 홍콩(HK) · \"0215\" 상해(SH) · \"0106\" 도쿄(JP) 입니다. 전체 대응표는 해외 거래소 조회(/reference/v1/overseas/exchanges)로 만드십시오.", "depth" : 0 }, { "element" : "dcpn_loeq_ciph", "name" : "소수점이하자릿수", "type" : "Number", "required" : "Y", "length" : "5", "description" : "소수점 이하 자릿수입니다. 보유 수량(rmnd_dqty)과 매도가능수량(seln_able_dqty)은 소수 10자리 문자열로 내려옵니다.", "depth" : 0 }, { "element" : "ovrs_stck_rsfl_tpcd", "name" : "등락유형코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "전일 종가 대비 등락 방향 코드입니다. 값에 대응하는 이름은 응답에 함께 오지 않습니다.", "depth" : 0 }, { "element" : "loan_dtl_type_code", "name" : "대출상세유형코드", "type" : "String", "required" : "Y", "length" : "4", "description" : "대출 상세 유형입니다.", "depth" : 0 }, { "element" : "loan_date", "name" : "대출일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "대출 일자입니다.", "depth" : 0 }, { "element" : "loan_srno", "name" : "대출일련번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "대출 일련번호입니다.", "depth" : 0 }, { "element" : "mtrt_date", "name" : "만기일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "대출 만기 일자입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 성공 응답 코드입니다.\n\"5766\": 조회 완료\n\"5820\": 조회할 자료 없음\n\n오류는 종류와 무관하게 HTTP 500 으로 반환되므로, 성공·실패는 HTTP 상태가 아니라 이 값으로 판정하십시오.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 이 값에 담깁니다.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "다음 페이지가 남아 있으면 \"1\", 마지막이면 \"0\" 입니다.\n한 번에 30건씩 내려오며, 다음 페이지는 tr_cont 와 tr_cont_key 를 요청에 함께 보내 이어서 받으십시오. 키는 쿼리스트링으로 보냅니다.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "응답에 덧붙는 상세 사유입니다. 값이 없으면 응답에서 이 항목 자체가 빠집니다.", "depth" : 0 }, { "element" : "tr_cont_key", "name" : "연속조회 키", "type" : "String", "required" : "N", "length" : "200", "description" : "tr_cont 가 \"1\" 일 때만 응답에 담깁니다. 마지막 페이지(tr_cont \"0\")와 오류 응답에는 이 항목이 없습니다. 값 안에 공백이 길게 이어지므로 잘라내거나 줄이지 말고 URL 인코딩하여 쿼리스트링으로 보내십시오.", "depth" : 0 } ] }, "requestExample" : "GET /accounts/v1/me/overseas/holdings\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": [\n {\n \"prod_cls_name\": \"일반\",\n \"rmnd_clcd\": \"1\",\n \"ovrs_stck_mrkt_tr_cls_code\": \"01\",\n \"crcd\": \"USD\",\n \"iscd\": \"AAPL.OQ\",\n \"isnm\": \"애플\",\n \"rmnd_dqty\": \"10791.0000000000\",\n \"seln_able_dqty\": \"10791.0000000000\",\n \"avrg_unpr\": \"247.108400\",\n \"vltn_prls_camt\": \"674346.6500\",\n \"vltn_ert\": \"25.2900\",\n \"psnt_prc\": \"309.600000\",\n \"prdy_vrss_rsfl_crnc_prc\": \"0.25000000\",\n \"byov_camt\": \"2666546.9500\",\n \"frcr_vltn_amt\": \"3340893.600\",\n \"exrt\": \"1383.6000\",\n \"ovrs_stck_symb_iscd\": \"AAPL\",\n \"ovrs_exch_vndr_idno\": \"0537\",\n \"dcpn_loeq_ciph\": 4,\n \"ovrs_stck_rsfl_tpcd\": \"5\",\n \"loan_dtl_type_code\": \"0000\",\n \"loan_date\": \"\",\n \"loan_srno\": 0,\n \"mtrt_date\": \"\"\n }\n ],\n \"rsp_cd\": \"5766\",\n \"rsp_msg\": \"조회가 완료되었습니다.\"\n}" } ] }, { "name" : "해외주식 외화잔고 조회", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/accounts/v1/me/overseas/currencies", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "접근토큰에 매핑된 계좌의 통화별 외화 잔고와 평가 내역을 조회합니다. 통화마다 한 건씩 배열로 내려옵니다.\n\n원화 환산 항목은 excl_wncr_vltn_amt 와 ovrs_stck_vltn_amt 두 가지입니다. excl_wncr_vltn_amt 는 같은 행의 estm_frcr_amt 에 평가환율(vltn_exrt)을 곱한 값이고, ovrs_stck_vltn_amt 는 그 통화로 보유한 해외주식 평가금액의 원화 합계로 종목별 평가 조회(/accounts/v1/me/holdings)의 해외 행 평가금액 합과 같았습니다.\n\n그 밖의 금액 항목(frcr_amt·estm_frcr_amt·entm_aset_vltn_amt)은 해당 통화 기준입니다. 이 API 의 응답에는 wncr_ 로 시작하는 항목이 없습니다.", "trs" : [ { "name" : "해외주식 외화잔고 조회", "code" : "obtro_oder_266r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "통화별 잔고 목록", "type" : "Object Array", "required" : "Y", "length" : "-", "description" : "통화별 잔고 배열입니다.", "depth" : 0 }, { "element" : "crcd", "name" : "통화코드", "type" : "String", "required" : "Y", "length" : "3", "description" : "통화 코드입니다.", "depth" : 0 }, { "element" : "frcr_amt", "name" : "외화 예수금", "type" : "String", "required" : "Y", "length" : "20", "description" : "해당 통화의 외화 예수금입니다.", "depth" : 0 }, { "element" : "estm_frcr_amt", "name" : "추정 외화 예수금", "type" : "String", "required" : "Y", "length" : "20", "description" : "추정 외화 예수금입니다.", "depth" : 0 }, { "element" : "entm_aset_vltn_amt", "name" : "외화 자산 합계", "type" : "String", "required" : "Y", "length" : "25", "description" : "추정 외화 자산평가금액입니다.", "depth" : 0 }, { "element" : "vltn_exrt", "name" : "평가환율", "type" : "String", "required" : "Y", "length" : "12", "description" : "평가환율입니다.", "depth" : 0 }, { "element" : "ovrs_stck_vltn_amt", "name" : "해외주식 평가금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "이 통화로 보유한 해외주식 평가금액의 원화 환산 값입니다.", "depth" : 0 }, { "element" : "excl_wncr_vltn_amt", "name" : "원화 평가금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "추정 외화 예수금(estm_frcr_amt)을 원화로 환산한 값입니다. estm_frcr_amt x vltn_exrt 와 같습니다. 주식 평가금액은 포함되지 않습니다. 원 단위 정수입니다.", "depth" : 0 }, { "element" : "srno", "name" : "일련번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "일련번호입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 성공 응답 코드입니다.\n\"5766\": 조회 완료\n\"5820\": 조회할 자료 없음\n\n오류는 종류와 무관하게 HTTP 500 으로 반환되므로, 성공·실패는 HTTP 상태가 아니라 이 값으로 판정하십시오.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 이 값에 담깁니다.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "다음 페이지가 남았는지 여부입니다. 통화별 잔고가 한 번의 호출로 모두 내려오면 \"0\" 입니다.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "응답에 덧붙는 상세 사유입니다. 값이 없으면 응답에서 이 항목 자체가 빠집니다.", "depth" : 0 } ] }, "requestExample" : "GET /accounts/v1/me/overseas/currencies\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": [\n {\n \"crcd\": \"USD\",\n \"frcr_amt\": \"13233.190\",\n \"estm_frcr_amt\": \"13233.190\",\n \"entm_aset_vltn_amt\": \"15915.13000\",\n \"vltn_exrt\": \"1338.2000\",\n \"ovrs_stck_vltn_amt\": 3588971,\n \"excl_wncr_vltn_amt\": 17708654,\n \"srno\": 1\n }\n ],\n \"rsp_cd\": \"5766\",\n \"rsp_msg\": \"조회가 완료되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "해외주식 실현손익", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/accounts/v1/me/overseas/profit-loss", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "접근토큰에 매핑된 계좌의 해외주식 실현손익을 매도 건별로 조회합니다.", "trs" : [ { "name" : "해외주식 실현손익", "code" : "obtro_oder_262r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "oder_sta_date", "name" : "주문시작일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "주문 시작일자를 YYYYMMDD 형식 여덟 자리로 입력합니다.\n\n반드시 넣으셔야 합니다. 시작일을 종료일보다 뒤로 넣으시면 응답코드 \"3174\" 로 거부됩니다. (query string)", "depth" : 0 }, { "element" : "oder_fin_date", "name" : "주문종료일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "주문 종료일자를 YYYYMMDD 형식 여덟 자리로 입력합니다.\n\n반드시 넣으셔야 합니다.\n\n시작일자(oder_sta_date)보다 앞선 날짜를 넣으시면 응답코드 \"3174\" 로 거부됩니다. (query string)", "depth" : 0 }, { "element" : "ovrs_stck_exch_idno", "name" : "해외주식거래소식별번호", "type" : "String", "required" : "N", "length" : "6", "description" : "거래소 코드입니다. (query string)", "depth" : 0 }, { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "N", "length" : "12", "description" : "종목 코드입니다. (query string)", "depth" : 0 }, { "element" : "loan_yn", "name" : "대출여부", "type" : "String", "required" : "N", "length" : "1", "description" : "대출 거래만 볼지 여부입니다. \"Y\" 또는 \"N\". (query string)", "depth" : 0 }, { "element" : "ctcd", "name" : "국가코드", "type" : "String", "required" : "Y", "length" : "3", "description" : "국가 코드(필수)입니다. 등록되지 않은 값(예: \"99\")도 오류 없이 0건이 내려옵니다. (query string)", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "N", "length" : "1", "description" : "다음 페이지를 요청할 때 \"1\"을 넣습니다. 첫 조회에는 넣지 않습니다.\n\n연속조회 키(tr_cont_key)와 함께 보내십시오. (query string)", "depth" : 0 }, { "element" : "tr_cont_key", "name" : "연속조회 키", "type" : "String", "required" : "N", "length" : "20", "description" : "직전 응답의 tr_cont_key 를 그대로 넣습니다. 첫 조회에는 넣지 않습니다.\n\n값 오른쪽에 공백이 붙어 내려오는 경우가 있습니다. 잘라내지 말고 URL 인코딩하여 원본 그대로 보내십시오. (query string)", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "목록", "type" : "Object Array", "required" : "Y", "length" : "-", "description" : "조회 결과 배열입니다. 자료 유무는 이 배열의 길이로 판정하십시오.\n오류 응답에는 이 항목 자체가 없습니다. 오류일 때 본문은 rsp_cd·rsp_msg 로 이루어지므로, rsp_cd 를 먼저 확인한 뒤 data 를 읽으십시오.", "depth" : 0 }, { "element" : "oder_date", "name" : "주문일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "주문 일자입니다. YYYYMMDD 8자리.", "depth" : 0 }, { "element" : "ovrs_stck_mrkt_tr_cls_code", "name" : "해외주식시장거래구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "해외 시장 거래 구분 코드입니다.", "depth" : 0 }, { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "종목 코드입니다.", "depth" : 0 }, { "element" : "kor_issu_abwr_name", "name" : "한글종목약어명", "type" : "String", "required" : "Y", "length" : "40", "description" : "종목명(한글 약어)입니다.", "depth" : 0 }, { "element" : "seln_qty", "name" : "매도수량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "매도 수량입니다.", "depth" : 0 }, { "element" : "seln_unpr", "name" : "매도단가", "type" : "Number", "required" : "Y", "length" : "20", "description" : "매도 단가입니다. 원화로 환산한 단가이며 원화매도금액(wncr_seln_amt)을 매도수량(seln_qty)으로 나눈 값입니다. 현지 통화 기준 매도 단가는 외화매도단가(frcr_seln_unpr)를 쓰십시오.", "depth" : 0 }, { "element" : "seln_frcr_amt", "name" : "매도외화금액", "type" : "Number", "required" : "Y", "length" : "20", "description" : "매도 외화금액입니다.", "depth" : 0 }, { "element" : "byov_unpr", "name" : "매수단가", "type" : "Number", "required" : "Y", "length" : "22", "description" : "매수 단가입니다(현지 통화).", "depth" : 0 }, { "element" : "cntg_stnd_byov_camt", "name" : "체결기준매수통화금액", "type" : "Number", "required" : "Y", "length" : "20", "description" : "체결 기준 매수 통화금액입니다. 매도한 수량의 취득원가입니다.", "depth" : 0 }, { "element" : "cntg_cfee", "name" : "체결통화수수료", "type" : "Number", "required" : "Y", "length" : "20", "description" : "체결 수수료입니다.", "depth" : 0 }, { "element" : "plrt", "name" : "손익률", "type" : "Number", "required" : "Y", "length" : "23", "description" : "손익률(%)입니다. 외화 기준 손익률은 외화손익률(frcr_plrt)을 쓰십시오.", "depth" : 0 }, { "element" : "rdmp_loan_int", "name" : "상환대출이자", "type" : "Number", "required" : "Y", "length" : "20", "description" : "상환 대출이자입니다.", "depth" : 0 }, { "element" : "crcd", "name" : "통화코드", "type" : "String", "required" : "Y", "length" : "3", "description" : "통화 코드입니다. (예: USD)", "depth" : 0 }, { "element" : "wncr_deal_prls_amt", "name" : "원화매매손익금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "원화 환산 매매손익 금액입니다.", "depth" : 0 }, { "element" : "wncr_fed_prls_amt", "name" : "원화환차손익금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "원화 환산 환차손익 금액입니다.", "depth" : 0 }, { "element" : "rlzt_prls_amt", "name" : "실현손익금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "원화 실현손익 금액입니다. 원화매매손익금액(wncr_deal_prls_amt)과 원화환차손익금액(wncr_fed_prls_amt)을 더한 값입니다.", "depth" : 0 }, { "element" : "wncr_seln_amt", "name" : "원화매도금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "원화 환산 매도금액입니다.", "depth" : 0 }, { "element" : "wncr_byov_unpr", "name" : "원화매수단가", "type" : "Number", "required" : "Y", "length" : "22", "description" : "원화 환산 매수 단가입니다.", "depth" : 0 }, { "element" : "wncr_byov_amt", "name" : "원화매수금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "원화 환산 매수금액입니다.", "depth" : 0 }, { "element" : "deal_expn", "name" : "매매비용", "type" : "Number", "required" : "Y", "length" : "19", "description" : "매매 비용 합계입니다.", "depth" : 0 }, { "element" : "loan_int", "name" : "대출이자", "type" : "Number", "required" : "Y", "length" : "19", "description" : "대출이자입니다.", "depth" : 0 }, { "element" : "frcr_rlzt_ernn_amt", "name" : "외화실현수익금액", "type" : "Number", "required" : "Y", "length" : "20", "description" : "외화 기준 실현손익 금액입니다.", "depth" : 0 }, { "element" : "frcr_seln_unpr", "name" : "외화매도단가", "type" : "Number", "required" : "Y", "length" : "20", "description" : "외화 기준 매도 단가입니다.", "depth" : 0 }, { "element" : "frcr_plrt", "name" : "외화손익률", "type" : "Number", "required" : "Y", "length" : "23", "description" : "외화 기준 손익률입니다.", "depth" : 0 }, { "element" : "avrg_seln_exrt", "name" : "평균매도환율", "type" : "Number", "required" : "Y", "length" : "12", "description" : "매도 평균 환율입니다.", "depth" : 0 }, { "element" : "avrg_byov_exrt", "name" : "평균매수환율", "type" : "Number", "required" : "Y", "length" : "12", "description" : "매수 평균 환율입니다.", "depth" : 0 }, { "element" : "summary", "name" : "합계", "type" : "Object", "required" : "Y", "length" : "-", "description" : "조회 기간 전체의 합계입니다. data 배열과 별개로 최상위에 내려옵니다.", "depth" : 0 }, { "element" : "deal_prls_camt", "name" : "매매손익통화금액", "type" : "Number", "required" : "Y", "length" : "20", "description" : "외화 기준 매매손익 합계입니다. data 배열에는 없고 합계(summary)에만 있습니다.", "depth" : 0 }, { "element" : "frcr_rlzt_prls_amt", "name" : "외화실현손익금액", "type" : "Number", "required" : "Y", "length" : "20", "description" : "외화 기준 실현손익 합계입니다. data 배열의 각 행에는 없고 합계(summary)에만 내려옵니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 응답 코드입니다.\n\"5766\": 조회 완료 · \"5820\": 조회할 자료 없음\n자료 유무는 응답 코드가 아니라 data 배열의 길이로 판정하십시오.\n오류는 HTTP 500 으로 내려옵니다. 시작일이 종료일보다 크면 \"3174\" 가 내려옵니다.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 이 값에 담깁니다.\n오류 응답에는 data 와 tr_cont 가 없으므로 rsp_cd 를 먼저 확인한 뒤 data 를 읽으십시오.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "다음 페이지가 남아 있으면 \"1\", 마지막이면 \"0\"입니다.", "depth" : 0 }, { "element" : "tr_cont_key", "name" : "연속조회 키", "type" : "String", "required" : "N", "length" : "20", "description" : "마지막 페이지(tr_cont 가 \"0\")와 오류 응답에는 이 항목 자체가 없습니다.\n\n다음 페이지를 요청하실 때는 직전 응답의 값을 그대로 넣으십시오. 값 오른쪽에 공백이 붙어 내려오는 경우가 있으니 잘라내지 마십시오.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "응답에 덧붙는 상세 사유입니다. 값이 없으면 응답에서 이 항목 자체가 빠집니다.", "depth" : 0 }, { "element" : "seln_frcr_amt", "name" : "매도외화금액", "type" : "Number", "required" : "Y", "length" : "20", "description" : "매도 외화금액 합계입니다.", "depth" : 0 }, { "element" : "cntg_stnd_byov_camt", "name" : "체결기준매수통화금액", "type" : "Number", "required" : "Y", "length" : "20", "description" : "체결기준 매수 통화금액 합계입니다.", "depth" : 0 }, { "element" : "cntg_cfee", "name" : "체결통화수수료", "type" : "Number", "required" : "Y", "length" : "20", "description" : "체결 통화 수수료 합계입니다.", "depth" : 0 }, { "element" : "plrt", "name" : "손익률", "type" : "Number", "required" : "Y", "length" : "23", "description" : "조회 기간 전체의 손익률(%)입니다.", "depth" : 0 }, { "element" : "wncr_seln_amt", "name" : "원화매도금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "원화로 환산한 매도금액 합계입니다.", "depth" : 0 }, { "element" : "wncr_byov_amt", "name" : "원화매수금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "원화로 환산한 매수금액 합계입니다.", "depth" : 0 }, { "element" : "wncr_deal_prls_amt", "name" : "원화매매손익금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "원화로 환산한 매매손익 합계입니다.", "depth" : 0 }, { "element" : "deal_expn", "name" : "매매비용", "type" : "Number", "required" : "Y", "length" : "19", "description" : "매매비용 합계입니다.", "depth" : 0 }, { "element" : "wncr_fed_prls_amt", "name" : "원화환차손익금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "원화로 환산한 환차손익 합계입니다.", "depth" : 0 }, { "element" : "rlzt_prls_amt", "name" : "실현손익금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "조회 기간 전체의 원화 실현손익 합계입니다. 원화매매손익금액(wncr_deal_prls_amt)과 원화환차손익금액(wncr_fed_prls_amt)을 더한 값입니다.", "depth" : 0 }, { "element" : "frcr_plrt", "name" : "외화손익률", "type" : "Number", "required" : "Y", "length" : "23", "description" : "외화 기준으로 계산한 조회 기간 전체의 손익률입니다.", "depth" : 0 } ] }, "requestExample" : "GET /accounts/v1/me/overseas/profit-loss?oder_sta_date=20260101&oder_fin_date=20260911&ctcd=840\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": [\n {\n \"oder_date\": \"20260518\",\n \"ovrs_stck_mrkt_tr_cls_code\": \"01\",\n \"iscd\": \"MU.OQ\",\n \"kor_issu_abwr_name\": \"마이크론 테크놀로지\",\n \"seln_qty\": 1,\n \"seln_unpr\": 1107287.0,\n \"seln_frcr_amt\": 738.29,\n \"byov_unpr\": 733.7,\n \"cntg_stnd_byov_camt\": 733.7,\n \"cntg_cfee\": 0.0,\n \"plrt\": 0.62,\n \"rdmp_loan_int\": 0.0,\n \"crcd\": \"USD\",\n \"wncr_deal_prls_amt\": 6884,\n \"wncr_fed_prls_amt\": -11,\n \"rlzt_prls_amt\": 6873,\n \"wncr_seln_amt\": 1107287,\n \"wncr_byov_unpr\": 1100414.0,\n \"wncr_byov_amt\": 1100414,\n \"deal_expn\": 0,\n \"loan_int\": 0,\n \"frcr_rlzt_ernn_amt\": 4.59,\n \"frcr_seln_unpr\": 738.29,\n \"frcr_plrt\": 0.62,\n \"avrg_seln_exrt\": 1499.8,\n \"avrg_byov_exrt\": 1499.816\n },\n {\n \"oder_date\": \"20260520\",\n \"ovrs_stck_mrkt_tr_cls_code\": \"01\",\n \"iscd\": \"AAPL.OQ\",\n \"kor_issu_abwr_name\": \"애플\",\n \"seln_qty\": 20,\n \"seln_unpr\": 448403.0,\n \"seln_frcr_amt\": 5963.6,\n \"byov_unpr\": 230.0,\n \"cntg_stnd_byov_camt\": 4600.0,\n \"cntg_cfee\": 0.0,\n \"plrt\": 0.11,\n \"rdmp_loan_int\": 0.0,\n \"crcd\": \"USD\",\n \"wncr_deal_prls_amt\": 2050581,\n \"wncr_fed_prls_amt\": 451100,\n \"rlzt_prls_amt\": 2501681,\n \"wncr_seln_amt\": 8968061,\n \"wncr_byov_unpr\": 323318.0,\n \"wncr_byov_amt\": 6466379,\n \"deal_expn\": 0,\n \"loan_int\": 0,\n \"frcr_rlzt_ernn_amt\": 1363.6,\n \"frcr_seln_unpr\": 298.18,\n \"frcr_plrt\": 29.64,\n \"avrg_seln_exrt\": 1503.8,\n \"avrg_byov_exrt\": 1405.7347\n }\n ],\n \"summary\": {\n \"seln_frcr_amt\": 6701.89,\n \"cntg_stnd_byov_camt\": 5333.7,\n \"cntg_cfee\": 0.0,\n \"deal_prls_camt\": 0.0,\n \"plrt\": 33.19,\n \"wncr_seln_amt\": 10078302,\n \"wncr_byov_amt\": 7566794,\n \"wncr_deal_prls_amt\": 2057484,\n \"deal_expn\": 0,\n \"wncr_fed_prls_amt\": 454023,\n \"rlzt_prls_amt\": 2511507,\n \"frcr_rlzt_prls_amt\": 1368.19,\n \"frcr_plrt\": 25.65\n },\n \"rsp_cd\": \"5766\",\n \"rsp_msg\": \"조회가 완료되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "해외주식 호가 조회", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/market/v1/overseas/orderbook", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "해외주식 한 종목의 매도·매수 호가와 잔량을 조회합니다.", "trs" : [ { "name" : "해외주식 호가 조회", "code" : "ohhts_6000_002r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "mrkt_div_code", "name" : "시장 구분 코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "해외 시세는 \"OV\"를 넣습니다.\n\n(query string)", "depth" : 0 }, { "element" : "mrkt_cls_code", "name" : "거래소 구분 코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "거래소 구분입니다.\n\"OQ\": 나스닥\n\"NY\": 뉴욕\n\"AX\": 아멕스\n\"HK\": 홍콩증권거래소\n\"SH\": 상하이증권거래소\n\"SZ\": 심천증권거래소\n\"JP\": 도쿄증권거래소 (query string)", "depth" : 0 }, { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "16", "description" : "해외 종목 심볼을 입력합니다. (예: AAPL)\n\n(query string)", "depth" : 0 }, { "element" : "dely_rltm_cls_code", "name" : "지연실시간구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "시세 종류입니다.\n\"0\": 실시간\n\"1\": 지연\n\n지연(\"1\")으로 조회하면 미국 종목(AAPL)의 호가·잔량이 모두 0 으로 내려옵니다. (query string)", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "호가 정보", "type" : "Object", "required" : "Y", "length" : "-", "description" : "종목의 호가 정보입니다. 항목은 10단계까지 있으며 채워지는 단계 수는 거래소·시세 종류에 따라 다릅니다.\n\n미국 종목(AAPL)은 실시간(\"0\")에서 10단계가 모두 채워지고, 지연(\"1\")에서는 가격·잔량이 모두 0 입니다. 홍콩 지연(\"1\")은 매수·매도 각 1단계만 채워집니다.\n\n비어 있는 단계는 0 으로 내려옵니다.", "depth" : 0 }, { "element" : "prdy_clpr", "name" : "전일종가", "type" : "String", "required" : "Y", "length" : "14", "description" : "전일 종가입니다. 등락 계산의 기준이 되는 값입니다.", "depth" : 0 }, { "element" : "prpr", "name" : "현재가", "type" : "String", "required" : "Y", "length" : "14", "description" : "가장 최근 체결된 가격(현재가)입니다. 전일 종가가 아니므로 등락 계산의 기준은 전일종가(prdy_clpr)를 쓰십시오.\n\n이 응답에는 소수점수(dcpn_cnt)가 없으므로 해외주식 현재가 조회(/market/v1/overseas/prices)의 dcpn_cnt 를 쓰시거나 숫자로 변환해 쓰십시오.", "depth" : 0 }, { "element" : "askp1", "name" : "매도호가1", "type" : "String", "required" : "Y", "length" : "14", "description" : "매도호가 1단계 가격입니다. 시장에서 가장 싼 매도 주문이며 번호가 커질수록 가격이 높아집니다. 호가가 없는 단계는 0 입니다.", "depth" : 0 }, { "element" : "askp2", "name" : "매도호가2", "type" : "String", "required" : "Y", "length" : "14", "description" : "매도호가 2단계 가격입니다. 호가가 없는 단계는 0 입니다.", "depth" : 0 }, { "element" : "askp3", "name" : "매도호가3", "type" : "String", "required" : "Y", "length" : "14", "description" : "매도호가 3단계 가격입니다. 호가가 없는 단계는 0 입니다.", "depth" : 0 }, { "element" : "askp4", "name" : "매도호가4", "type" : "String", "required" : "Y", "length" : "14", "description" : "매도호가 4단계 가격입니다. 호가가 없는 단계는 0 입니다.", "depth" : 0 }, { "element" : "askp5", "name" : "매도호가5", "type" : "String", "required" : "Y", "length" : "14", "description" : "매도호가 5단계 가격입니다. 호가가 없는 단계는 0 입니다.", "depth" : 0 }, { "element" : "askp6", "name" : "매도호가6", "type" : "String", "required" : "Y", "length" : "14", "description" : "매도호가 6단계 가격입니다. 호가가 없는 단계는 0 입니다.", "depth" : 0 }, { "element" : "askp7", "name" : "매도호가7", "type" : "String", "required" : "Y", "length" : "14", "description" : "매도호가 7단계 가격입니다. 호가가 없는 단계는 0 입니다.", "depth" : 0 }, { "element" : "askp8", "name" : "매도호가8", "type" : "String", "required" : "Y", "length" : "14", "description" : "매도호가 8단계 가격입니다. 호가가 없는 단계는 0 입니다.", "depth" : 0 }, { "element" : "askp9", "name" : "매도호가9", "type" : "String", "required" : "Y", "length" : "14", "description" : "매도호가 9단계 가격입니다. 호가가 없는 단계는 0 입니다.", "depth" : 0 }, { "element" : "askp10", "name" : "매도호가10", "type" : "String", "required" : "Y", "length" : "14", "description" : "매도호가 10단계 가격입니다. 호가가 없는 단계는 0 입니다.", "depth" : 0 }, { "element" : "bidp1", "name" : "매수호가1", "type" : "String", "required" : "Y", "length" : "14", "description" : "매수호가 1단계 가격입니다. 시장에서 가장 비싼 매수 주문이며 번호가 커질수록 가격이 낮아집니다. 호가가 없는 단계는 0 입니다.", "depth" : 0 }, { "element" : "bidp2", "name" : "매수호가2", "type" : "String", "required" : "Y", "length" : "14", "description" : "매수호가 2단계 가격입니다. 호가가 없는 단계는 0 입니다.", "depth" : 0 }, { "element" : "bidp3", "name" : "매수호가3", "type" : "String", "required" : "Y", "length" : "14", "description" : "매수호가 3단계 가격입니다. 호가가 없는 단계는 0 입니다.", "depth" : 0 }, { "element" : "bidp4", "name" : "매수호가4", "type" : "String", "required" : "Y", "length" : "14", "description" : "매수호가 4단계 가격입니다. 호가가 없는 단계는 0 입니다.", "depth" : 0 }, { "element" : "bidp5", "name" : "매수호가5", "type" : "String", "required" : "Y", "length" : "14", "description" : "매수호가 5단계 가격입니다. 호가가 없는 단계는 0 입니다.", "depth" : 0 }, { "element" : "bidp6", "name" : "매수호가6", "type" : "String", "required" : "Y", "length" : "14", "description" : "매수호가 6단계 가격입니다. 호가가 없는 단계는 0 입니다.", "depth" : 0 }, { "element" : "bidp7", "name" : "매수호가7", "type" : "String", "required" : "Y", "length" : "14", "description" : "매수호가 7단계 가격입니다. 호가가 없는 단계는 0 입니다.", "depth" : 0 }, { "element" : "bidp8", "name" : "매수호가8", "type" : "String", "required" : "Y", "length" : "14", "description" : "매수호가 8단계 가격입니다. 호가가 없는 단계는 0 입니다.", "depth" : 0 }, { "element" : "bidp9", "name" : "매수호가9", "type" : "String", "required" : "Y", "length" : "14", "description" : "매수호가 9단계 가격입니다. 호가가 없는 단계는 0 입니다.", "depth" : 0 }, { "element" : "bidp10", "name" : "매수호가10", "type" : "String", "required" : "Y", "length" : "14", "description" : "매수호가 10단계 가격입니다. 호가가 없는 단계는 0 입니다.", "depth" : 0 }, { "element" : "askp_rsqn1", "name" : "매도호가잔량1", "type" : "Number", "required" : "Y", "length" : "13", "description" : "1번째로 싼 매도호가에 걸려 있는 수량입니다. 1단계가 가장 싼 매도호가이며, 번호가 커질수록 가격이 높아집니다.", "depth" : 0 }, { "element" : "askp_rsqn2", "name" : "매도호가잔량2", "type" : "Number", "required" : "Y", "length" : "13", "description" : "2번째로 싼 매도호가에 걸려 있는 수량입니다. 1단계가 가장 싼 매도호가이며, 번호가 커질수록 가격이 높아집니다.", "depth" : 0 }, { "element" : "askp_rsqn3", "name" : "매도호가잔량3", "type" : "Number", "required" : "Y", "length" : "13", "description" : "3번째로 싼 매도호가에 걸려 있는 수량입니다. 1단계가 가장 싼 매도호가이며, 번호가 커질수록 가격이 높아집니다.", "depth" : 0 }, { "element" : "askp_rsqn4", "name" : "매도호가잔량4", "type" : "Number", "required" : "Y", "length" : "13", "description" : "4번째로 싼 매도호가에 걸려 있는 수량입니다. 1단계가 가장 싼 매도호가이며, 번호가 커질수록 가격이 높아집니다.", "depth" : 0 }, { "element" : "askp_rsqn5", "name" : "매도호가잔량5", "type" : "Number", "required" : "Y", "length" : "13", "description" : "5번째로 싼 매도호가에 걸려 있는 수량입니다. 1단계가 가장 싼 매도호가이며, 번호가 커질수록 가격이 높아집니다.", "depth" : 0 }, { "element" : "askp_rsqn6", "name" : "매도호가잔량6", "type" : "Number", "required" : "Y", "length" : "13", "description" : "6번째로 싼 매도호가에 걸려 있는 수량입니다. 1단계가 가장 싼 매도호가이며, 번호가 커질수록 가격이 높아집니다.", "depth" : 0 }, { "element" : "askp_rsqn7", "name" : "매도호가잔량7", "type" : "Number", "required" : "Y", "length" : "13", "description" : "7번째로 싼 매도호가에 걸려 있는 수량입니다. 1단계가 가장 싼 매도호가이며, 번호가 커질수록 가격이 높아집니다.", "depth" : 0 }, { "element" : "askp_rsqn8", "name" : "매도호가잔량8", "type" : "Number", "required" : "Y", "length" : "13", "description" : "8번째로 싼 매도호가에 걸려 있는 수량입니다. 1단계가 가장 싼 매도호가이며, 번호가 커질수록 가격이 높아집니다.", "depth" : 0 }, { "element" : "askp_rsqn9", "name" : "매도호가잔량9", "type" : "Number", "required" : "Y", "length" : "13", "description" : "9번째로 싼 매도호가에 걸려 있는 수량입니다. 1단계가 가장 싼 매도호가이며, 번호가 커질수록 가격이 높아집니다.", "depth" : 0 }, { "element" : "askp_rsqn10", "name" : "매도호가잔량10", "type" : "Number", "required" : "Y", "length" : "13", "description" : "10번째로 싼 매도호가에 걸려 있는 수량입니다. 1단계가 가장 싼 매도호가이며, 번호가 커질수록 가격이 높아집니다.", "depth" : 0 }, { "element" : "bidp_rsqn1", "name" : "매수호가잔량1", "type" : "Number", "required" : "Y", "length" : "13", "description" : "1번째로 비싼 매수호가에 걸려 있는 수량입니다. 1단계가 가장 비싼 매수호가이며, 번호가 커질수록 가격이 낮아집니다.", "depth" : 0 }, { "element" : "bidp_rsqn2", "name" : "매수호가잔량2", "type" : "Number", "required" : "Y", "length" : "13", "description" : "2번째로 비싼 매수호가에 걸려 있는 수량입니다. 1단계가 가장 비싼 매수호가이며, 번호가 커질수록 가격이 낮아집니다.", "depth" : 0 }, { "element" : "bidp_rsqn3", "name" : "매수호가잔량3", "type" : "Number", "required" : "Y", "length" : "13", "description" : "3번째로 비싼 매수호가에 걸려 있는 수량입니다. 1단계가 가장 비싼 매수호가이며, 번호가 커질수록 가격이 낮아집니다.", "depth" : 0 }, { "element" : "bidp_rsqn4", "name" : "매수호가잔량4", "type" : "Number", "required" : "Y", "length" : "13", "description" : "4번째로 비싼 매수호가에 걸려 있는 수량입니다. 1단계가 가장 비싼 매수호가이며, 번호가 커질수록 가격이 낮아집니다.", "depth" : 0 }, { "element" : "bidp_rsqn5", "name" : "매수호가잔량5", "type" : "Number", "required" : "Y", "length" : "13", "description" : "5번째로 비싼 매수호가에 걸려 있는 수량입니다. 1단계가 가장 비싼 매수호가이며, 번호가 커질수록 가격이 낮아집니다.", "depth" : 0 }, { "element" : "bidp_rsqn6", "name" : "매수호가잔량6", "type" : "Number", "required" : "Y", "length" : "13", "description" : "6번째로 비싼 매수호가에 걸려 있는 수량입니다. 1단계가 가장 비싼 매수호가이며, 번호가 커질수록 가격이 낮아집니다.", "depth" : 0 }, { "element" : "bidp_rsqn7", "name" : "매수호가잔량7", "type" : "Number", "required" : "Y", "length" : "13", "description" : "7번째로 비싼 매수호가에 걸려 있는 수량입니다. 1단계가 가장 비싼 매수호가이며, 번호가 커질수록 가격이 낮아집니다.", "depth" : 0 }, { "element" : "bidp_rsqn8", "name" : "매수호가잔량8", "type" : "Number", "required" : "Y", "length" : "13", "description" : "8번째로 비싼 매수호가에 걸려 있는 수량입니다. 1단계가 가장 비싼 매수호가이며, 번호가 커질수록 가격이 낮아집니다.", "depth" : 0 }, { "element" : "bidp_rsqn9", "name" : "매수호가잔량9", "type" : "Number", "required" : "Y", "length" : "13", "description" : "9번째로 비싼 매수호가에 걸려 있는 수량입니다. 1단계가 가장 비싼 매수호가이며, 번호가 커질수록 가격이 낮아집니다.", "depth" : 0 }, { "element" : "bidp_rsqn10", "name" : "매수호가잔량10", "type" : "Number", "required" : "Y", "length" : "13", "description" : "10번째로 비싼 매수호가에 걸려 있는 수량입니다. 1단계가 가장 비싼 매수호가이며, 번호가 커질수록 가격이 낮아집니다.", "depth" : 0 }, { "element" : "total_askp_rsqn", "name" : "총매도호가잔량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "매도호가 총 잔량입니다.", "depth" : 0 }, { "element" : "total_bidp_rsqn", "name" : "총매수호가잔량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "매수호가 총 잔량입니다.", "depth" : 0 }, { "element" : "oprc", "name" : "시가", "type" : "String", "required" : "Y", "length" : "14", "description" : "당일 첫 체결 가격(시가)입니다.", "depth" : 0 }, { "element" : "hprc", "name" : "고가", "type" : "String", "required" : "Y", "length" : "14", "description" : "당일 최고 체결 가격(고가)입니다.", "depth" : 0 }, { "element" : "lprc", "name" : "저가", "type" : "String", "required" : "Y", "length" : "14", "description" : "당일 최저 체결 가격(저가)입니다.", "depth" : 0 }, { "element" : "acpl_hour", "name" : "현지시간", "type" : "String", "required" : "Y", "length" : "6", "description" : "호가 시각(현지 기준)입니다. HHMMSS 형식입니다.", "depth" : 0 }, { "element" : "sdpr", "name" : "기준가", "type" : "String", "required" : "Y", "length" : "14", "description" : "기준 가격입니다. 전일 종가(prdy_clpr)와 다를 수 있으므로 등락 계산의 기준은 전일 종가를 쓰십시오.", "depth" : 0 }, { "element" : "korea_hour", "name" : "한국시간", "type" : "String", "required" : "Y", "length" : "6", "description" : "호가 시각(국내 기준)입니다. HHMMSS 형식입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 성공 응답 코드입니다.\n\"0000\": 정상 처리\n\n오류는 종류와 무관하게 HTTP 500 으로 반환되므로, 성공·실패는 HTTP 상태가 아니라 이 값으로 판정하십시오.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 담깁니다.\n\n오류 응답에는 data 와 tr_cont 가 담기지 않습니다. 오류일 때 본문은 rsp_cd·rsp_msg(일부 API 는 rsp_sub_msg 포함)로 이루어지므로, rsp_cd 를 먼저 확인한 뒤 data 를 읽으십시오.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "오류일 때 내려올 수 있는 상세 사유 항목입니다. 정상 응답에는 포함되지 않습니다.", "depth" : 0 } ] }, "requestExample" : "GET /market/v1/overseas/orderbook?mrkt_div_code=OV&mrkt_cls_code=OQ&iscd=AAPL&dely_rltm_cls_code=0\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": {\n \"prdy_clpr\": \"326.5700\",\n \"prpr\": \"326.5700\",\n \"askp1\": \"0.0000\",\n \"askp2\": \"0.0000\",\n \"askp3\": \"0.0000\",\n \"askp4\": \"0.0000\",\n \"askp5\": \"0.0000\",\n \"askp6\": \"0.0000\",\n \"askp7\": \"0.0000\",\n \"askp8\": \"0.0000\",\n \"askp9\": \"0.0000\",\n \"askp10\": \"0.0000\",\n \"bidp1\": \"0.0000\",\n \"bidp2\": \"0.0000\",\n \"bidp3\": \"0.0000\",\n \"bidp4\": \"0.0000\",\n \"bidp5\": \"0.0000\",\n \"bidp6\": \"0.0000\",\n \"bidp7\": \"0.0000\",\n \"bidp8\": \"0.0000\",\n \"bidp9\": \"0.0000\",\n \"bidp10\": \"0.0000\",\n \"askp_rsqn1\": 0,\n \"askp_rsqn2\": 0,\n \"askp_rsqn3\": 0,\n \"askp_rsqn4\": 0,\n \"askp_rsqn5\": 0,\n \"askp_rsqn6\": 0,\n \"askp_rsqn7\": 0,\n \"askp_rsqn8\": 0,\n \"askp_rsqn9\": 0,\n \"askp_rsqn10\": 0,\n \"bidp_rsqn1\": 0,\n \"bidp_rsqn2\": 0,\n \"bidp_rsqn3\": 0,\n \"bidp_rsqn4\": 0,\n \"bidp_rsqn5\": 0,\n \"bidp_rsqn6\": 0,\n \"bidp_rsqn7\": 0,\n \"bidp_rsqn8\": 0,\n \"bidp_rsqn9\": 0,\n \"bidp_rsqn10\": 0,\n \"total_askp_rsqn\": 0,\n \"total_bidp_rsqn\": 0,\n \"oprc\": \"326.5700\",\n \"hprc\": \"326.5700\",\n \"lprc\": \"326.5700\",\n \"acpl_hour\": \"034840\",\n \"sdpr\": \"326.5700\",\n \"korea_hour\": \"164840\"\n },\n \"rsp_cd\": \"0000\",\n \"rsp_msg\": \"정상 처리 되었습니다.\"\n}" } ] }, { "name" : "해외 거래소 조회", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/reference/v1/overseas/exchanges", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "해외주식 거래소 목록을 조회합니다.", "trs" : [ { "name" : "해외 거래소 조회", "code" : "obtro_comn_306r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "ovrs_stck_mrkt_tr_cls_code", "name" : "해외주식시장거래구분코드", "type" : "String", "required" : "N", "length" : "2", "description" : "시장 구분 코드(2자리)이며, 이 값으로 거래소 목록을 걸러냅니다. 반드시 두 자리로 넣으십시오.\n넣지 않으면 한 번에 30건씩 내려오며, 응답의 tr_cont 가 \"1\" 인 동안 tr_cont_key 로 이어서 받으십시오. (query string)", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "N", "length" : "1", "description" : "다음 페이지를 요청할 때 \"1\" 을 넣습니다. 첫 조회에는 넣지 않습니다. 직전 응답의 tr_cont_key 와 함께 쿼리 스트링으로 보내십시오.\n응답의 tr_cont 가 \"1\" 이면 다음 페이지가 남아 있습니다.", "depth" : 0 }, { "element" : "tr_cont_key", "name" : "연속조회 키", "type" : "String", "required" : "N", "length" : "20", "description" : "직전 응답의 tr_cont_key 를 그대로 넣습니다. 첫 조회에는 넣지 않습니다. 쿼리 스트링으로 보내십시오.\n값 오른쪽에 공백이 붙어 내려오므로 잘라내지 말고 URL 인코딩하여 받은 그대로 보내십시오.\n같은 API 의 직전 응답에서 받은 키만 넣으십시오.", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "거래소 목록", "type" : "Object Array", "required" : "Y", "length" : "-", "description" : "거래소 배열입니다.\n\n한 번에 30건씩 내려옵니다. tr_cont 가 \"1\" 이면 tr_cont_key 로 다음 페이지를 요청하십시오.", "depth" : 0 }, { "element" : "ovrs_stck_exch_idno", "name" : "거래소코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "거래소 코드(2자리)입니다. 해외주식 현재가 조회(/market/v1/overseas/prices) 등 시세 API 의 mrkt_cls_code 에 이 값을 넣고, 주문 API 에는 ovrs_exch_vndr_idno 를 넣습니다.\n\"OQ\" 나스닥 · \"NY\" 뉴욕 · \"AX\" 아멕스\n온라인 주문·시세 가능 여부는 onln_yn 으로 확인하십시오.", "depth" : 0 }, { "element" : "ovrs_exch_vndr_idno", "name" : "해외거래소벤더식별번호", "type" : "String", "required" : "Y", "length" : "6", "description" : "거래소 벤더 식별번호입니다. 해외주식 주문의 ovrs_exch_vndr_idno 에 이 값을 넣습니다. (예: 나스닥 \"0537\")", "depth" : 0 }, { "element" : "ovrs_stck_mrkt_tr_cls_code", "name" : "해외주식시장거래구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "이 거래소가 속한 시장 구분 코드(2자리)입니다.\n\"01\" 미국 · \"02\" 홍콩 · \"03\" 상해 · \"04\" 심천 · \"05\" 일본\n한 시장에 거래소가 여럿 있으므로 거래소를 가릴 때는 ovrs_stck_exch_idno 를 쓰십시오.", "depth" : 0 }, { "element" : "kor_name", "name" : "거래소명", "type" : "String", "required" : "Y", "length" : "40", "description" : "거래소 이름 자리입니다. 화면에 그대로 표시하지 마십시오. 거래소와 맞지 않는 값이 내려오는 곳이 있으므로, 이름을 보여 주려면 ovrs_stck_exch_idno 를 기준으로 표시할 이름을 직접 정해 두십시오.", "depth" : 0 }, { "element" : "fix_tlms_exch_code", "name" : "FIX거래소코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "FIX 거래소 코드입니다. 온라인 주문이 되지 않는 거래소는 빈 값으로 내려오는 경우가 있습니다. 주문 가능 여부는 onln_yn 으로 확인하십시오.", "depth" : 0 }, { "element" : "onln_yn", "name" : "온라인 주문가능 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "온라인 주문·시세 가능 여부입니다.\n\"Y\": 가능\n\"N\": 불가", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 성공 응답 코드입니다.\n\"5762\": 조회 결과가 더 있음 (연속조회)\n\"5766\": 조회 완료 (마지막 페이지)\n\"5820\": 조회할 자료 없음\n\n오류는 종류와 무관하게 HTTP 500 으로 반환되므로, 성공·실패는 HTTP 상태가 아니라 이 값으로 판정하십시오.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 담기며, 조치 정보가 있으면 rsp_sub_msg 에 담깁니다.\n오류 응답에는 data 와 tr_cont 가 없으므로 rsp_cd 를 먼저 확인한 뒤 data 를 읽으십시오.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "다음 페이지가 남아 있으면 \"1\", 마지막이면 \"0\"입니다.", "depth" : 0 }, { "element" : "tr_cont_key", "name" : "연속조회 키", "type" : "String", "required" : "N", "length" : "20", "description" : "다음 페이지를 요청하실 때 쓰는 키입니다. tr_cont 가 \"1\" 인 응답에 담기고, tr_cont 가 \"0\" 인 응답에는 내려오지 않으니 tr_cont 를 먼저 확인하십시오.\n\n값 오른쪽에 공백이 붙어 내려옵니다. 잘라내지 말고 URL 인코딩하여 원본 그대로 보내십시오.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "오류일 때 조치 정보가 담기는 항목입니다.", "depth" : 0 } ] }, "requestExample" : "GET /reference/v1/overseas/exchanges?ovrs_stck_mrkt_tr_cls_code=01\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": [\n {\n \"ovrs_stck_exch_idno\": \"AX\",\n \"ovrs_exch_vndr_idno\": \"0066\",\n \"ovrs_stck_mrkt_tr_cls_code\": \"01\",\n \"kor_name\": \"아멕스\",\n \"fix_tlms_exch_code\": \"A\",\n \"onln_yn\": \"Y\"\n },\n {\n \"ovrs_stck_exch_idno\": \"ET\",\n \"ovrs_exch_vndr_idno\": \"0000\",\n \"ovrs_stck_mrkt_tr_cls_code\": \"01\",\n \"kor_name\": \"OTC 기타\",\n \"fix_tlms_exch_code\": \"\",\n \"onln_yn\": \"N\"\n }\n ],\n \"rsp_cd\": \"5766\",\n \"rsp_msg\": \"조회가 완료되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "해외 장운영 조회", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/reference/v1/overseas/market-hours", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "해외 시장의 장운영 상태와 개장·마감 시각을 조회합니다.", "trs" : [ { "name" : "해외 장운영 조회", "code" : "obtro_comn_010r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "ovrs_stck_mrkt_tr_cls_code", "name" : "해외주식시장거래구분코드", "type" : "String", "required" : "N", "length" : "2", "description" : "시장 거래 구분 코드(2자리)입니다. 두 자리로 넣으십시오.\n범위 밖의 두 자리 값(예: \"33\")을 넣으면 HTTP 500 과 함께 data 가 없는 본문이 내려오며, 이때 rsp_cd 는 \"0000\" 입니다. (query string)", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "장운영 정보", "type" : "Object", "required" : "Y", "length" : "-", "description" : "요청하신 시장의 장운영 정보입니다. 배열이 아니라 한 건의 객체로 내려옵니다.\n\n시장 거래 구분(ovrs_stck_mrkt_tr_cls_code), 장운영 상태(ovrs_mkop_cls_code), 개시·종료 시각(mrkt_begn_time·mrkt_fin_time) 네 항목이 들어 있습니다. 시각은 한국시간 HHMM 네 자리 문자열이며, 장이 닫혀 있는 시장은 두 시각이 모두 \"0000\" 으로 내려옵니다.", "depth" : 0 }, { "element" : "ovrs_stck_mrkt_tr_cls_code", "name" : "해외주식시장거래구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "해외 시장 거래 구분 코드(2자리)입니다.\n예: \"01\" 미국 · \"02\" 홍콩 · \"05\" 일본", "depth" : 0 }, { "element" : "ovrs_mkop_cls_code", "name" : "해외장운영구분코드", "type" : "String", "required" : "Y", "length" : "3", "description" : "해외 장운영 상태 코드입니다.\n\"004\": 정규장 개시 · \"012\": 시장이 닫혀 있는 동안\n목록에 없는 값이 내려와도 오류로 다루지 마십시오.", "depth" : 0 }, { "element" : "mrkt_begn_time", "name" : "시장개시시각", "type" : "String", "required" : "Y", "length" : "4", "description" : "시장 개시 시각입니다. 한국시간 HHMM 4자리입니다.\n장이 닫혀 있는 시장은 \"0000\" 이 내려옵니다.", "depth" : 0 }, { "element" : "mrkt_fin_time", "name" : "시장종료시각", "type" : "String", "required" : "Y", "length" : "4", "description" : "시장 종료 시각입니다. 한국시간 HHMM 4자리입니다.\n\n자정을 넘기는 시장은 이 값이 개시 시각(mrkt_begn_time)보다 작게 내려오므로 단순 비교로 남은 시간을 계산하지 마십시오. 장이 닫혀 있는 시장은 \"0000\" 이 내려옵니다.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "항상 \"0\"으로 내려옵니다. 이 API는 연속조회를 지원하지 않습니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 성공 응답 코드는 \"5766\"(조회 완료)입니다.\n\"5820\": 조회할 자료 없음\n오류는 종류와 무관하게 HTTP 500 으로 반환되며 일부 오류는 rsp_cd 가 \"0000\" 으로 내려오므로, 성공 여부는 HTTP 상태와 rsp_cd \"5766\" 을 함께 확인하십시오. 초당 호출 한도를 넘기면 \"EGW00200\" 이 내려오니 잠시 뒤 다시 보내십시오.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 이 값에 담깁니다. 정상일 때는 처리 결과 문구가 옵니다.", "depth" : 0 } ] }, "requestExample" : "GET /reference/v1/overseas/market-hours?ovrs_stck_mrkt_tr_cls_code=01\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": {\n \"ovrs_stck_mrkt_tr_cls_code\": \"01\",\n \"ovrs_mkop_cls_code\": \"002\",\n \"mrkt_begn_time\": \"0000\",\n \"mrkt_fin_time\": \"0000\"\n },\n \"rsp_cd\": \"5766\",\n \"rsp_msg\": \"조회가 완료되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "해외 영업일 조회", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/reference/v1/overseas/market-days", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "해외 시장의 영업일을 조회합니다.", "trs" : [ { "name" : "해외 영업일 조회", "code" : "obtro_comn_006r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "ovrs_exch_vndr_idno", "name" : "해외거래소벤더식별번호", "type" : "String", "required" : "Y", "length" : "6", "description" : "해외 거래소 조회(/reference/v1/overseas/exchanges)의 ovrs_exch_vndr_idno 를 넣습니다. (예: 나스닥 \"0537\")\n예를 들어 \"0000\" 을 넣으면 rsp_cd \"5806\" 오류가 납니다. (query string)", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "영업일 정보", "type" : "Object", "required" : "Y", "length" : "-", "description" : "요청하신 거래소의 영업일 정보입니다. 배열이 아니라 한 건의 객체로 내려오고 영업일자(bsop_date) 한 항목만 들어 있습니다.\n\n벤더 코드 \"0000\" 을 넣으시면 이 항목이 내려오지 않고 응답코드 \"5806\" 이 옵니다. data 를 꺼내기 전에 rsp_cd 를 먼저 확인하십시오.", "depth" : 0 }, { "element" : "bsop_date", "name" : "영업일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "해당 거래소 기준의 영업일자입니다. YYYYMMDD 8자리.\n같은 시각에도 거래소마다 값이 다를 수 있습니다.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "항상 \"0\"으로 내려옵니다. 이 API는 연속조회를 지원하지 않습니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 성공 응답 코드는 \"5766\"(조회 완료)입니다.\n\"5806\": 조회 오류(예: 벤더 코드 \"0000\") · \"5820\": 조회할 자료 없음\n오류는 종류와 무관하게 HTTP 500 으로 반환되므로, 성공·실패는 HTTP 상태가 아니라 이 값으로 판정하십시오. 초당 호출 한도를 넘기면 \"EGW00200\" 이 내려오니 잠시 뒤 다시 보내십시오.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 이 값에 담깁니다. 정상일 때는 처리 결과 문구가 옵니다.", "depth" : 0 } ] }, "requestExample" : "GET /reference/v1/overseas/market-days?ovrs_exch_vndr_idno=0537\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": {\n \"bsop_date\": \"20260912\"\n },\n \"rsp_cd\": \"5766\",\n \"rsp_msg\": \"조회가 완료되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "실시간 환전신청", "protocol" : "REST", "method" : "POST", "domain" : "", "url" : "/forex/v1/exchanges", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "원화와 외화를 환전합니다.", "trs" : [ { "name" : "환전하기", "code" : "obtsd_fbnk_202a", "request" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출하기 위한 Request Body 데이터 포맷으로 \"application/json; charset=utf-8\" 설정", "depth" : 0 }, { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "mnec_clcd", "name" : "환전구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "환전 방향입니다.\n\"1\": 외화 매수(원화 → 외화)\n\"2\": 외화 매도(외화 → 원화)", "depth" : 0 }, { "element" : "wncr_amt", "name" : "원화금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "환전할 원화 금액입니다. 원 단위 정수입니다.", "depth" : 0 }, { "element" : "frcr_amt", "name" : "외화금액", "type" : "String", "required" : "Y", "length" : "20", "description" : "환전할 외화 금액입니다.", "depth" : 0 }, { "element" : "exrt_stnd_time", "name" : "환율기준시각", "type" : "String", "required" : "Y", "length" : "14", "description" : "환전 적용환율 조회(/forex/v1/rates/applied) 응답의 exrt_stnd_time 을 그대로 넣습니다.\n환전 응답의 exrt_stnd_time 은 요청값과 다를 수 있습니다.", "depth" : 0 }, { "element" : "iqry_exrt", "name" : "조회환율", "type" : "String", "required" : "Y", "length" : "12", "description" : "환전 적용환율 조회에서 받은 적용환율을 그대로 넣습니다.\n외화 매수(mnec_clcd \"1\")는 tltr_aply_byrt\n외화 매도(mnec_clcd \"2\")는 tltr_aply_slrt", "depth" : 0 }, { "element" : "crcd", "name" : "통화코드", "type" : "String", "required" : "Y", "length" : "3", "description" : "통화 코드입니다. (예: \"USD\")", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "환전 결과", "type" : "Object", "required" : "Y", "length" : "-", "description" : "체결된 환전 내역과 환전 후 잔액", "depth" : 0 }, { "element" : "tr_srno", "name" : "거래일련번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "이번 환전으로 채번된 거래 일련번호입니다.", "depth" : 0 }, { "element" : "rcpy_srno", "name" : "출납일련번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "이 환전으로 발생한 출납 거래의 일련번호입니다.", "depth" : 0 }, { "element" : "tact_lnkd_istu_code", "name" : "거래연계기관코드", "type" : "String", "required" : "Y", "length" : "3", "description" : "환전을 처리한 연계 기관 코드입니다. 세 자리 숫자이며 기관명은 응답에 함께 오지 않습니다.", "depth" : 0 }, { "element" : "tfam_prrm", "name" : "예수금전잔", "type" : "Number", "required" : "Y", "length" : "19", "description" : "환전 직전 원화 예수금 잔액입니다.", "depth" : 0 }, { "element" : "tfam_nwrm", "name" : "예수금 잔액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "환전 직후 원화 예수금 잔액입니다. 전잔에서 tr_amt 만큼 줄어듭니다.", "depth" : 0 }, { "element" : "frcr_tfam_prrm", "name" : "외화예수금전잔", "type" : "String", "required" : "Y", "length" : "20", "description" : "환전 직전 외화 예수금 잔액입니다. 소수 3자리 문자열입니다.", "depth" : 0 }, { "element" : "frcr_tfam_nwrm", "name" : "외화 예수금 잔액", "type" : "String", "required" : "Y", "length" : "20", "description" : "환전 직후 외화 예수금 잔액입니다. 전잔에서 frcr_tr_amt 만큼 늘어납니다.", "depth" : 0 }, { "element" : "aply_exrt", "name" : "적용환율", "type" : "String", "required" : "Y", "length" : "12", "description" : "실제 체결된 환율입니다. 소수 4자리 문자열입니다.", "depth" : 0 }, { "element" : "exrt_stnd_time", "name" : "환율기준시각", "type" : "String", "required" : "Y", "length" : "14", "description" : "체결에 적용된 환율의 기준 시각입니다. YYYYMMDDHHMMSS 형식입니다.\n요청에 넣은 값과 다를 수 있습니다.", "depth" : 0 }, { "element" : "crcd", "name" : "통화코드", "type" : "String", "required" : "Y", "length" : "3", "description" : "환전한 통화 코드입니다.", "depth" : 0 }, { "element" : "crcd_kor_name", "name" : "통화코드한글명", "type" : "String", "required" : "Y", "length" : "40", "description" : "통화의 한글 이름입니다. 화면에 그대로 표시하면 됩니다. (예: \"미국 달러\") 통화 코드는 crcd 입니다.", "depth" : 0 }, { "element" : "tr_amt", "name" : "거래금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "원화 거래금액입니다. 외화 금액 × 적용환율이며, 원화 예수금에서 이 금액이 빠져나갑니다.", "depth" : 0 }, { "element" : "frcr_tr_amt", "name" : "외화 거래금액", "type" : "String", "required" : "Y", "length" : "20", "description" : "외화 거래금액입니다. 소수 3자리 문자열입니다.", "depth" : 0 }, { "element" : "fee", "name" : "수수료", "type" : "Number", "required" : "Y", "length" : "19", "description" : "환전에 적용된 수수료입니다.", "depth" : 0 }, { "element" : "basc_spead", "name" : "기본스프레드", "type" : "String", "required" : "Y", "length" : "9", "description" : "기본 스프레드입니다. 환전에 실제 적용된 스프레드는 환전 적용환율 조회의 spead 를 사용하십시오.", "depth" : 0 }, { "element" : "prft_aply_clcd", "name" : "우대적용구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "이번 환전에 환율 우대가 적용됐는지를 나타냅니다.", "depth" : 0 }, { "element" : "prft_aply_cls_val", "name" : "우대적용구분값", "type" : "String", "required" : "Y", "length" : "40", "description" : "적용된 우대 내용입니다. 우대가 없으면 빈 값 또는 \"기본\"이 내려옵니다.", "depth" : 0 }, { "element" : "dc_mnrt", "name" : "할인금리", "type" : "String", "required" : "Y", "length" : "10", "description" : "적용된 할인 금리입니다.", "depth" : 0 }, { "element" : "max_mnec_yn", "name" : "최대환전여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "보유 외화 전액을 환전하는 최대 환전으로 처리됐는지 여부입니다.\n\"Y\": 최대 환전\n\"N\": 최대 환전이 아님\n\n빈 문자열로 내려오는 경우가 있습니다. \"N\" 과 빈 문자열을 같게 다루시고 빈 값을 오류로 처리하지 마십시오.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 성공 응답 코드입니다.\n\"0000\": 정상 처리", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 이 값에 담깁니다.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "항상 \"0\"으로 내려옵니다. 이 API는 연속조회를 지원하지 않습니다.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "오류일 때만 내려오며 조치 정보가 담깁니다.\n정상 응답에는 포함되지 않습니다.", "depth" : 0 } ] }, "requestExample" : "POST /forex/v1/exchanges\nContent-Type: application/json; charset=utf-8\nauthorization: Bearer {access_token}\n\n{\n \"crcd\": \"USD\",\n \"mnec_clcd\": \"1\",\n \"frcr_amt\": 300,\n \"wncr_amt\": 0,\n \"exrt_stnd_time\": \"20260820204850\",\n \"iqry_exrt\": \"1410.3600\"\n}", "responseExample" : "{\n \"data\": {\n \"tr_srno\": 72,\n \"rcpy_srno\": 72,\n \"tact_lnkd_istu_code\": \"287\",\n \"tfam_prrm\": 890600125,\n \"tfam_nwrm\": 890177017,\n \"frcr_tfam_prrm\": \"15294.870\",\n \"frcr_tfam_nwrm\": \"15594.870\",\n \"aply_exrt\": \"1410.3600\",\n \"exrt_stnd_time\": \"20260820204906\",\n \"crcd\": \"USD\",\n \"crcd_kor_name\": \"미국 달러\",\n \"tr_amt\": 423108,\n \"frcr_tr_amt\": \"300.000\",\n \"fee\": 4188,\n \"basc_spead\": \"0.0000\",\n \"prft_aply_clcd\": \"0\",\n \"prft_aply_cls_val\": \"\",\n \"dc_mnrt\": \"0.00000\",\n \"max_mnec_yn\": \"\"\n },\n \"rsp_cd\": \"0000\",\n \"rsp_msg\": \"정상 처리 되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "환전 내역 조회", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/forex/v1/exchanges/history", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "접근토큰에 매핑된 계좌의 환전 내역을 조회합니다.", "trs" : [ { "name" : "환전 내역 조회", "code" : "obtsd_fbnk_203r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "iqry_sta_date", "name" : "조회시작일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "조회 시작일자를 YYYYMMDD 8자리로 입력합니다. 기간 앞을 열어 두려면 \"00000000\" 을 넣습니다.\n시작일자가 종료일자보다 늦으면 오류 없이 \"5820\" 과 0건이 내려옵니다. 달력에 없는 날짜(\"20260231\")도 오류 없이 조회되므로 날짜 형식을 직접 확인하십시오.", "depth" : 0 }, { "element" : "iqry_fin_date", "name" : "조회종료일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "조회 종료일자를 YYYYMMDD 8자리로 입력합니다. 미래 일자를 넣어도 오류 없이 그 일자까지의 내역이 조회됩니다.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "N", "length" : "1", "description" : "다음 페이지를 요청할 때 \"1\"을 넣습니다. 첫 조회에는 넣지 않습니다.\n\n연속조회 키(tr_cont_key)와 함께 보냅니다. (query string)", "depth" : 0 }, { "element" : "tr_cont_key", "name" : "연속조회 키", "type" : "String", "required" : "N", "length" : "20", "description" : "직전 응답의 tr_cont_key 를 그대로 넣습니다. 첫 조회에는 넣지 않습니다.\n\n값 오른쪽에 공백이 붙어 내려오는 경우가 있습니다. 잘라내지 말고 URL 인코딩하여 원본 그대로 보내십시오. (query string)", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "환전 내역 목록", "type" : "Object Array", "required" : "Y", "length" : "-", "description" : "환전 내역 배열입니다.", "depth" : 0 }, { "element" : "tr_date", "name" : "거래일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "거래일자입니다. YYYYMMDD 형식입니다.", "depth" : 0 }, { "element" : "mnec_clcd", "name" : "환전구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "환전 방향입니다.\n\"1\": 외화 매수(원화 → 외화)\n\"2\": 외화 매도(외화 → 원화)\n\"3\": 환전 취소", "depth" : 0 }, { "element" : "aply_exrt", "name" : "적용환율", "type" : "String", "required" : "Y", "length" : "12", "description" : "체결된 환율입니다. 소수 4자리 문자열입니다.", "depth" : 0 }, { "element" : "chan_type_cls_code", "name" : "채널유형구분코드", "type" : "String", "required" : "Y", "length" : "3", "description" : "환전을 신청한 채널입니다.\n\"120\": Open API\n\"157\": MTS", "depth" : 0 }, { "element" : "aplt_date", "name" : "신청일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "환전 신청일자입니다. YYYYMMDD 형식입니다.", "depth" : 0 }, { "element" : "aplt_hour", "name" : "신청시간", "type" : "String", "required" : "Y", "length" : "6", "description" : "환전 신청시각입니다. HHMMSS 형식입니다.", "depth" : 0 }, { "element" : "aplt_srno", "name" : "신청일련번호", "type" : "Number", "required" : "Y", "length" : "11", "description" : "신청 일련번호입니다.", "depth" : 0 }, { "element" : "frcr_tr_amt", "name" : "외화 거래금액", "type" : "String", "required" : "Y", "length" : "20", "description" : "외화 거래금액입니다. 소수 3자리 문자열입니다.", "depth" : 0 }, { "element" : "tr_amt", "name" : "거래금액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "원화 거래금액입니다. 외화 금액 × 적용환율입니다.", "depth" : 0 }, { "element" : "crcd", "name" : "통화코드", "type" : "String", "required" : "Y", "length" : "3", "description" : "통화 코드입니다.", "depth" : 0 }, { "element" : "crcd_kor_name", "name" : "통화코드한글명", "type" : "String", "required" : "Y", "length" : "40", "description" : "통화의 한글 이름입니다. 화면에 그대로 표시하면 됩니다. (예: \"미국 달러\") 통화 코드는 crcd 입니다.", "depth" : 0 }, { "element" : "rspn_cntt", "name" : "응답내용", "type" : "String", "required" : "Y", "length" : "100", "description" : "처리 결과입니다. 정상 처리된 건은 \"정상\"이 내려옵니다.", "depth" : 0 }, { "element" : "prft_aply_clcd", "name" : "우대적용구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "이번 환전에 환율 우대가 적용됐는지를 나타냅니다.", "depth" : 0 }, { "element" : "prft_aply_cls_val", "name" : "우대적용구분값", "type" : "String", "required" : "Y", "length" : "40", "description" : "적용된 우대 내용입니다. 우대가 없으면 빈 값 또는 \"기본\"이 내려옵니다.", "depth" : 0 }, { "element" : "spead", "name" : "스프레드", "type" : "String", "required" : "Y", "length" : "9", "description" : "이 건에 적용된 스프레드입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 성공 응답 코드입니다.\n\"5762\": 조회 결과가 더 있음 (연속조회)\n\"5766\": 조회 완료\n\"5820\": 조회할 자료 없음\n\n오류는 종류와 무관하게 HTTP 500 으로 반환되므로, 성공·실패는 HTTP 상태가 아니라 이 값으로 판정하십시오.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 이 값에 담깁니다.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "다음 페이지가 남아 있으면 \"1\", 마지막이면 \"0\" 입니다.\n\"1\" 이면 같은 응답의 tr_cont_key 를 그대로 실어 다음 페이지를 요청하십시오.", "depth" : 0 }, { "element" : "tr_cont_key", "name" : "연속조회 키", "type" : "String", "required" : "N", "length" : "20", "description" : "다음 페이지가 있을 때(tr_cont \"1\")만 담깁니다. 마지막 페이지(tr_cont \"0\")와 오류 응답에는 이 항목이 없습니다.\n다음 페이지를 요청할 때는 값을 잘라내지 말고 그대로 넣으십시오(오른쪽에 공백이 붙어 내려옵니다).", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "오류일 때만 내려오며 조치 정보가 담깁니다.\n정상 응답에는 포함되지 않습니다.", "depth" : 0 } ] }, "requestExample" : "GET /forex/v1/exchanges/history?iqry_sta_date=20260101&iqry_fin_date=20260820\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": [\n {\n \"tr_date\": \"20260810\",\n \"mnec_clcd\": \"1\",\n \"aply_exrt\": \"1429.0700\",\n \"chan_type_cls_code\": \"157\",\n \"aplt_date\": \"20260810\",\n \"aplt_hour\": \"130401\",\n \"aplt_srno\": 100,\n \"frcr_tr_amt\": \"14694.870\",\n \"tr_amt\": 20999997,\n \"crcd\": \"USD\",\n \"crcd_kor_name\": \"미국 달러\",\n \"rspn_cntt\": \"정상\",\n \"prft_aply_clcd\": \"0\",\n \"prft_aply_cls_val\": \"기본\",\n \"spead\": \"14.1400\"\n },\n {\n \"tr_date\": \"20260820\",\n \"mnec_clcd\": \"1\",\n \"aply_exrt\": \"1409.2500\",\n \"chan_type_cls_code\": \"120\",\n \"aplt_date\": \"20260820\",\n \"aplt_hour\": \"204021\",\n \"aplt_srno\": 34,\n \"frcr_tr_amt\": \"300.000\",\n \"tr_amt\": 422775,\n \"crcd\": \"USD\",\n \"crcd_kor_name\": \"미국 달러\",\n \"rspn_cntt\": \"정상\",\n \"prft_aply_clcd\": \"0\",\n \"prft_aply_cls_val\": \"기본\",\n \"spead\": \"13.9500\"\n }\n ],\n \"rsp_cd\": \"5766\",\n \"rsp_msg\": \"조회가 완료되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "환전 적용환율 조회", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/forex/v1/rates/applied", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "환전을 실행하기 전에 실제로 적용될 환율을 조회합니다.", "trs" : [ { "name" : "환전 적용환율 조회", "code" : "obtsd_fbnk_201r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "crcd", "name" : "통화코드", "type" : "String", "required" : "Y", "length" : "3", "description" : "통화 코드입니다. (예: \"USD\") 세 자리로 넣으십시오.", "depth" : 0 }, { "element" : "mnec_clcd", "name" : "환전구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "환전 방향입니다.\n\"1\": 외화 매수(원화 → 외화)\n\"2\": 외화 매도(외화 → 원화)\n그 밖의 값(예: \"3\")은 \"필수 입력 항목이 누락되었습니다\"(7668)로 응답하고 rsp_sub_msg 에 \"환전 매수/매도구분\" 이 담깁니다.\n이 조회는 매수·매도 환율을 둘 다 내려주므로 매수는 tltr_aply_byrt, 매도는 tltr_aply_slrt 를 사용하십시오.", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "적용환율 정보", "type" : "Object", "required" : "Y", "length" : "-", "description" : "적용환율과 우대 내역", "depth" : 0 }, { "element" : "pros_date", "name" : "처리일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "조회 처리일자입니다. YYYYMMDD 형식입니다.", "depth" : 0 }, { "element" : "tltr_slrt", "name" : "전신환매도율", "type" : "String", "required" : "Y", "length" : "12", "description" : "전신환 매도율입니다.", "depth" : 0 }, { "element" : "tltr_byrt", "name" : "전신환매입율", "type" : "String", "required" : "Y", "length" : "12", "description" : "전신환 매입율입니다.", "depth" : 0 }, { "element" : "tltr_aply_byrt", "name" : "전신환적용매입율", "type" : "String", "required" : "Y", "length" : "12", "description" : "적용 매입율입니다. 소수 4자리 문자열입니다.\n외화 매수(mnec_clcd \"1\") 시 이 환율을 환전 요청에 넣습니다.", "depth" : 0 }, { "element" : "tltr_aply_slrt", "name" : "전신환적용매도율", "type" : "String", "required" : "Y", "length" : "12", "description" : "적용 매도율입니다. 소수 4자리 문자열입니다.\n외화 매도(mnec_clcd \"2\") 시 이 환율을 환전 요청에 넣습니다.", "depth" : 0 }, { "element" : "exrt_stnd_time", "name" : "환율기준시각", "type" : "String", "required" : "Y", "length" : "14", "description" : "이 조회의 기준 시각입니다. YYYYMMDDHHMMSS 형식입니다.\n환전할 때 이 값을 그대로 넣습니다. 환전 응답의 exrt_stnd_time 은 요청값과 다를 수 있습니다.", "depth" : 0 }, { "element" : "cust_grad_code", "name" : "고객등급코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "환율 우대에 쓰이는 고객 등급 코드입니다.\n\n코드에 대응하는 이름이 같은 응답의 cust_grad_code_name 으로 함께 내려오므로, 화면에는 이 코드 대신 cust_grad_code_name 을 그대로 쓰십시오.", "depth" : 0 }, { "element" : "cust_grad_code_name", "name" : "고객등급코드명", "type" : "String", "required" : "Y", "length" : "40", "description" : "환율 우대에 적용된 고객 등급의 이름입니다. 화면에 그대로 표시하면 됩니다. (예: \"플래티넘/등급없음\") 등급 코드는 cust_grad_code 입니다.", "depth" : 0 }, { "element" : "spead", "name" : "스프레드", "type" : "String", "required" : "Y", "length" : "9", "description" : "이번 환전에 적용되는 스프레드입니다. 기본스프레드는 basc_spead, 할인율은 dcrt 입니다.", "depth" : 0 }, { "element" : "splm_exrt", "name" : "추가환율", "type" : "String", "required" : "Y", "length" : "12", "description" : "가산된 환율입니다.", "depth" : 0 }, { "element" : "prft_aply_clcd", "name" : "우대적용구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "이번 환전에 환율 우대가 적용됐는지를 나타냅니다.", "depth" : 0 }, { "element" : "prft_aply_cls_val", "name" : "우대적용구분값", "type" : "String", "required" : "Y", "length" : "40", "description" : "적용된 우대 내용입니다. 우대가 없으면 빈 값 또는 \"기본\"이 내려옵니다.", "depth" : 0 }, { "element" : "dc_mnrt", "name" : "할인금리", "type" : "String", "required" : "Y", "length" : "10", "description" : "적용된 할인 금리입니다.", "depth" : 0 }, { "element" : "basc_spead", "name" : "기본스프레드", "type" : "String", "required" : "Y", "length" : "9", "description" : "고객 등급·우대가 반영되기 전의 기본 스프레드입니다. 적용되는 스프레드는 spead 입니다.", "depth" : 0 }, { "element" : "dcrt", "name" : "할인율", "type" : "String", "required" : "Y", "length" : "10", "description" : "기본스프레드에 적용된 할인율입니다. 소수 5자리 문자열입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 성공 응답 코드입니다.\n\"0000\": 정상 처리\n\n오류는 종류와 무관하게 HTTP 500 으로 반환되므로, 성공·실패는 HTTP 상태가 아니라 이 값으로 판정하십시오.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 이 값에 담깁니다.\n오류 응답에는 data 와 tr_cont 가 없으므로, rsp_cd 를 먼저 확인한 뒤 data 를 읽으십시오.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "항상 \"0\"으로 내려옵니다. 이 API는 연속조회를 지원하지 않습니다.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "오류일 때만 내려오며 조치 정보가 담깁니다.\n정상 응답에는 포함되지 않습니다.", "depth" : 0 } ] }, "requestExample" : "GET /forex/v1/rates/applied?crcd=USD&mnec_clcd=1\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": {\n \"pros_date\": \"20260911\",\n \"tltr_slrt\": \"1340.0000\",\n \"tltr_byrt\": \"1340.0000\",\n \"tltr_aply_byrt\": \"1353.4000\",\n \"tltr_aply_slrt\": \"1326.6000\",\n \"exrt_stnd_time\": \"20260911165301\",\n \"cust_grad_code\": \"25\",\n \"cust_grad_code_name\": \"플래티넘/등급없음\",\n \"spead\": \"13.4000\",\n \"splm_exrt\": \"0.0000\",\n \"prft_aply_clcd\": \"0\",\n \"prft_aply_cls_val\": \"\",\n \"dc_mnrt\": \"0.00000\",\n \"basc_spead\": \"13.4000\",\n \"dcrt\": \"0.00000\"\n },\n \"rsp_cd\": \"0000\",\n \"rsp_msg\": \"정상 처리 되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "고시환율 조회", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/forex/v1/rates", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "메리츠증권이 고시하는 실시간 환율을 조회합니다.", "trs" : [ { "name" : "고시환율 조회", "code" : "obtsd_fbnk_228r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "stnd_date", "name" : "기준일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "기준일자를 YYYYMMDD 8자리로 입력합니다. 반드시 넣으십시오.\n과거 일자도 조회할 수 있습니다. 토요일·공휴일에도 고시분이 내려오는 일자가 있으므로 요일로 짐작하지 말고 응답 목록의 길이로 확인하십시오. (query string)", "depth" : 0 }, { "element" : "crcd", "name" : "통화코드", "type" : "String", "required" : "N", "length" : "3", "description" : "조회할 통화 코드입니다. 대문자 세 자리로 넣으며(예: \"USD\"), 넣지 않으면 고시 중인 전 통화가 내려옵니다.\n소문자로 넣으면 오류 없이 \"5820\" 과 0건이 내려옵니다. (query string)", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "고시환율 목록", "type" : "Object Array", "required" : "Y", "length" : "-", "description" : "통화별 고시환율 배열입니다. 통화코드를 지정하지 않으면 고시 중인 전 통화가 내려옵니다.\n실제 환전에 적용되는 환율은 고객 등급·우대에 따라 달라지므로, 환전 전에는 환전 적용환율 조회(/forex/v1/rates/applied)로 확인하십시오.", "depth" : 0 }, { "element" : "crcd", "name" : "통화코드", "type" : "String", "required" : "Y", "length" : "3", "description" : "통화 코드입니다. (예: \"USD\")\n응답 목록의 순서나 개수에 의존하지 말고 이 값으로 통화를 찾으십시오.", "depth" : 0 }, { "element" : "crcd_kor_name", "name" : "통화코드한글명", "type" : "String", "required" : "Y", "length" : "40", "description" : "통화의 한글 이름입니다. 화면에 그대로 표시하면 됩니다. (예: \"미국 달러\") 통화 코드는 crcd 입니다.", "depth" : 0 }, { "element" : "stnd_exrt", "name" : "기준환율", "type" : "String", "required" : "Y", "length" : "12", "description" : "고시 기준환율입니다. 소수 4자리 문자열입니다.\n일본 엔(JPY)은 100엔 기준으로 고시되며 같은 행의 tltr_slrt·tltr_byrt 도 100엔 기준입니다. 반면 deal_stnd_exrt 는 1엔 기준이므로 두 값을 섞어 쓰지 마십시오(100배 차이).", "depth" : 0 }, { "element" : "tltr_slrt", "name" : "전신환매도율", "type" : "String", "required" : "Y", "length" : "12", "description" : "전신환 매도율입니다.", "depth" : 0 }, { "element" : "tltr_byrt", "name" : "전신환매입율", "type" : "String", "required" : "Y", "length" : "12", "description" : "전신환 매입율입니다.", "depth" : 0 }, { "element" : "pros_hour", "name" : "처리시간", "type" : "String", "required" : "Y", "length" : "6", "description" : "고시 처리 시각입니다. HHMMSS 형식입니다.", "depth" : 0 }, { "element" : "tltr_aply_slrt", "name" : "전신환적용매도율", "type" : "String", "required" : "Y", "length" : "12", "description" : "적용 매도율입니다. 소수 4자리 문자열입니다.\n환전 요청에 넣을 환율은 환전 적용환율 조회(/forex/v1/rates/applied)에서 받으십시오.", "depth" : 0 }, { "element" : "tltr_aply_byrt", "name" : "전신환적용매입율", "type" : "String", "required" : "Y", "length" : "12", "description" : "적용 매입율입니다. 소수 4자리 문자열입니다.\n환전 요청에 넣을 환율은 환전 적용환율 조회(/forex/v1/rates/applied)에서 받으십시오.", "depth" : 0 }, { "element" : "deal_stnd_exrt", "name" : "매매기준환율", "type" : "String", "required" : "Y", "length" : "11", "description" : "매매기준환율입니다. 소수 4자리 문자열입니다.\n\n일본 엔(JPY)은 1엔 기준으로 내려오므로, 100엔 기준으로 고시되는 같은 응답의 기준환율(stnd_exrt) · 전신환 환율과 섞어 쓰시면 100배 차이가 납니다.", "depth" : 0 }, { "element" : "tr_date", "name" : "거래일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "고시 기준 거래일자입니다. YYYYMMDD 형식입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 응답 코드입니다.\n\"5766\": 조회 완료(성공)\n\"5820\": 조회할 자료 없음(오류가 아니며 0건이 내려옵니다)\n자료 유무는 응답 코드가 아니라 data 배열의 길이로 판정하십시오. 오류는 종류와 무관하게 HTTP 500 으로 반환되므로 성공·실패는 HTTP 상태가 아니라 이 값으로 판정하십시오. 초당 호출 건수를 넘기면 \"EGW00200\" 이 내려오며, 잠시 뒤 같은 요청을 다시 보내십시오.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 이 값에 담깁니다.", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "항상 \"0\"으로 내려옵니다. 이 API는 연속조회를 지원하지 않습니다.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "오류일 때만 내려오며 조치 정보가 담깁니다.\n정상 응답에는 포함되지 않습니다.", "depth" : 0 } ] }, "requestExample" : "GET /forex/v1/rates?stnd_date=20260911\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": [\n {\n \"crcd\": \"USD\",\n \"crcd_kor_name\": \"미국 달러\",\n \"stnd_exrt\": \"1340.0000\",\n \"tltr_slrt\": \"1326.6000\",\n \"tltr_byrt\": \"1353.4000\",\n \"pros_hour\": \"165300\",\n \"tltr_aply_slrt\": \"1340.0000\",\n \"tltr_aply_byrt\": \"1340.0000\",\n \"deal_stnd_exrt\": \"1338.2000\",\n \"tr_date\": \"20260911\"\n },\n {\n \"crcd\": \"CNY\",\n \"crcd_kor_name\": \"중국 위안\",\n \"stnd_exrt\": \"200.4800\",\n \"tltr_slrt\": \"198.4600\",\n \"tltr_byrt\": \"202.5000\",\n \"pros_hour\": \"165300\",\n \"tltr_aply_slrt\": \"200.4600\",\n \"tltr_aply_byrt\": \"200.5000\",\n \"deal_stnd_exrt\": \"199.4200\",\n \"tr_date\": \"20260911\"\n }\n ],\n \"rsp_cd\": \"5766\",\n \"rsp_msg\": \"조회가 완료되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "해외지수 시세추이 조회", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/market/v1/overseas/index/candles/days", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "해외지수 시세추이 조회", "trs" : [ { "name" : "지수 시세추이 조회 (해외, 일-주-월-년봉)", "code" : "ohhts_8001_001r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "조회할 해외 지수의 코드입니다. (예: 나스닥 종합 NAS@IXIC, 니케이 225 NII@NI225, 상해종합 SHS@000001)", "depth" : 0 }, { "element" : "period_cls_code", "name" : "조회주기구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "일봉·주봉·월봉·연봉 중 무엇을 조회할지 정합니다. 일봉 D · 주봉 W · 월봉 M · 연봉 Y 를 넣습니다.", "depth" : 0 }, { "element" : "from", "name" : "조회 시작일자", "type" : "String", "required" : "N", "length" : "8", "description" : "조회 시작일자입니다. YYYYMMDD 8자리.\nto 와 함께 넣으면 그 기간의 봉을 모두 반환합니다. from 만 넣으면 그 일자부터 과거 100건, 둘 다 넣지 않으면 최근 100건이 내려옵니다.", "depth" : 0 }, { "element" : "to", "name" : "조회 종료일자", "type" : "String", "required" : "N", "length" : "8", "description" : "조회 종료일자입니다. YYYYMMDD 8자리.\nfrom과 함께 사용합니다. (query string)", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "봉 목록", "type" : "Object Array", "required" : "Y", "length" : "-", "description" : "봉 배열입니다. 최신 일자가 먼저 옵니다.", "depth" : 0 }, { "element" : "date", "name" : "일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "해당 봉의 일자(YYYYMMDD)입니다.", "depth" : 0 }, { "element" : "oprc", "name" : "시가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "해당 봉 기간의 첫 체결 가격(시가)입니다. 일봉은 당일, 주봉은 그 주 전체 기준입니다.", "depth" : 0 }, { "element" : "hprc", "name" : "고가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "해당 봉 기간 중 가장 높았던 체결 가격(고가)입니다. 일봉은 당일, 주봉은 그 주 전체 기준입니다.", "depth" : 0 }, { "element" : "lprc", "name" : "저가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "해당 봉 기간 중 가장 낮았던 체결 가격(저가)입니다. 일봉은 당일, 주봉은 그 주 전체 기준입니다.", "depth" : 0 }, { "element" : "prpr", "name" : "지수", "type" : "Number", "required" : "Y", "length" : "13", "description" : "해당 봉 기간의 지수 종가입니다. 아직 끝나지 않은 당일 봉에서는 조회 시점의 현재 지수가 들어갑니다.", "depth" : 0 }, { "element" : "prdy_vrss_sign", "name" : "전일대비부호", "type" : "String", "required" : "Y", "length" : "2", "description" : "전일 대비 방향입니다.\n\"2\": 상승\n\"5\": 하락\n\"3\": 보합", "depth" : 0 }, { "element" : "prdy_ctrt", "name" : "전일대비율", "type" : "String", "required" : "Y", "length" : "7", "description" : "전일 대비 등락률(%)입니다.", "depth" : 0 }, { "element" : "acml_vol", "name" : "누적거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "해당 봉 기간의 누적 거래량입니다. 주봉(W)의 값은 같은 기간 일봉 거래량의 합과 일치하지 않고(약 1000배), 진행 중인 당일 행은 0 으로 내려올 수 있으므로 일봉 합산과 비교하지 마십시오.", "depth" : 0 } ] }, "requestExample" : "GET /market/v1/overseas/index/candles/days?iscd=NAS@IXIC&period_cls_code=D&from=20260901&to=20260928", "responseExample" : "{\n \"data\": [\n {\n \"date\": \"20260926\",\n \"oprc\": 18245.30,\n \"hprc\": 18390.10,\n \"lprc\": 18201.50,\n \"prpr\": 18352.70,\n \"prdy_vrss_sign\": \"2\",\n \"prdy_ctrt\": 0.48,\n \"acml_vol\": 4321098765\n }\n ],\n \"rsp_cd\": \"0000\",\n \"rsp_msg\": \"정상 처리 되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "해외지수 시세추이 조회(분봉)", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/market/v1/overseas/index/candles/minutes", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "해외지수 시세추이 조회(분봉)", "trs" : [ { "name" : "지수 시세추이 조회 (해외, 분봉)", "code" : "ohhts_8001_002r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "조회할 해외 지수의 코드입니다. (예: 나스닥 종합 NAS@IXIC)", "depth" : 0 }, { "element" : "hour_cls_code", "name" : "봉 간격(초)", "type" : "String", "required" : "Y", "length" : "7", "description" : "봉 간격을 초 단위로 입력합니다. 60은 1분봉, 300은 5분봉입니다.\n\n반드시 넣으셔야 합니다. 빠뜨리면 오류가 반환됩니다.", "depth" : 0 }, { "element" : "from", "name" : "조회 시작일자", "type" : "String", "required" : "N", "length" : "8", "description" : "조회 시작일자입니다. YYYYMMDD 8자리.\nto와 함께 넣으면 그 기간의 봉을 모두 반환합니다. (query string)", "depth" : 0 }, { "element" : "to", "name" : "조회 종료일자", "type" : "String", "required" : "N", "length" : "8", "description" : "조회 종료일자입니다. YYYYMMDD 8자리.\nfrom과 함께 사용합니다. (query string)", "depth" : 0 }, { "element" : "past_data_incu_yn", "name" : "과거데이터포함여부", "type" : "String", "required" : "N", "length" : "2", "description" : "과거 데이터 포함 여부입니다. \"N\"은 당일 자료만 내려옵니다. 미입력 시 전 영업일 자료가 함께 내려옵니다.", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "분봉 목록", "type" : "Object Array", "required" : "Y", "length" : "-", "description" : "분봉 배열입니다. 최신 봉이 먼저 옵니다.", "depth" : 0 }, { "element" : "date", "name" : "일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "체결이 일어난 일자(YYYYMMDD)입니다.", "depth" : 0 }, { "element" : "cntg_hour", "name" : "체결시간", "type" : "String", "required" : "Y", "length" : "6", "description" : "해당 봉의 체결 시각(HHMMSS)입니다. 나스닥 종합(NAS@IXIC)은 미국 동부 시각으로 내려옵니다.", "depth" : 0 }, { "element" : "prpr", "name" : "지수", "type" : "Number", "required" : "Y", "length" : "14", "description" : "해당 봉 구간의 마지막 지수(종가)입니다.", "depth" : 0 }, { "element" : "oprc", "name" : "시가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "해당 봉 구간의 첫 체결 지수(시가)입니다.", "depth" : 0 }, { "element" : "hprc", "name" : "고가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "해당 봉 구간에서 가장 높았던 지수(고가)입니다.", "depth" : 0 }, { "element" : "lprc", "name" : "저가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "해당 봉 구간에서 가장 낮았던 지수(저가)입니다.", "depth" : 0 }, { "element" : "cntg_vol", "name" : "체결거래량", "type" : "Number", "required" : "Y", "length" : "12", "description" : "해당 봉 구간의 체결 거래량입니다.", "depth" : 0 } ] }, "requestExample" : "GET /market/v1/overseas/index/candles/minutes?iscd=NAS@IXIC&hour_cls_code=60", "responseExample" : "{\n \"data\": [\n {\n \"date\": \"20260928\",\n \"cntg_hour\": \"101530\",\n \"prpr\": 2483.40,\n \"oprc\": 2482.90,\n \"hprc\": 2483.80,\n \"lprc\": 2482.50,\n \"cntg_vol\": 182340\n }\n ],\n \"rsp_cd\": \"0000\",\n \"rsp_msg\": \"정상 처리 되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "해외지수 현재가 조회", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/market/v1/overseas/index/prices", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "해외지수 현재가 조회", "trs" : [ { "name" : "지수 현재가 조회 (해외)", "code" : "ohhts_1514_001r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "조회할 해외 지수의 코드입니다. (예: 나스닥 종합 NAS@IXIC)", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "DATA", "type" : "Object", "required" : "Y", "length" : "-", "description" : "해외지수 현재가 정보입니다.", "depth" : 0 }, { "element" : "kor_isnm", "name" : "한글종목명", "type" : "String", "required" : "Y", "length" : "65", "description" : "지수의 한글 명칭입니다.", "depth" : 0 }, { "element" : "stck_prpr", "name" : "현재지수", "type" : "Number", "required" : "Y", "length" : "13", "description" : "가장 최근 체결된 가격입니다.", "depth" : 0 }, { "element" : "prdy_clpr", "name" : "전일종가", "type" : "Number", "required" : "Y", "length" : "10", "description" : "전일 종가(전일 지수)입니다.", "depth" : 0 }, { "element" : "acml_tr_pbmn", "name" : "누적거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "장 시작부터 지금까지 체결된 거래대금을 모두 더한 값입니다. 해외지수에서는 0 으로 내려올 수 있습니다.", "depth" : 0 }, { "element" : "prdy_vrss", "name" : "전일대비", "type" : "Number", "required" : "Y", "length" : "13", "description" : "전일 대비 변화량입니다. 부호는 prdy_vrss_sign으로 판단합니다.", "depth" : 0 }, { "element" : "prdy_vrss_sign", "name" : "전일대비부호", "type" : "String", "required" : "Y", "length" : "2", "description" : "전일 대비 방향입니다.\n\"2\": 상승\n\"5\": 하락\n\"3\": 보합", "depth" : 0 }, { "element" : "prdy_ctrt", "name" : "전일대비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "전일 대비 등락률(%)입니다.", "depth" : 0 }, { "element" : "acml_vol", "name" : "누적거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "장 시작부터 지금까지 체결된 주식 수를 모두 더한 값입니다. 개별 체결 수량이 아닙니다.", "depth" : 0 }, { "element" : "tr_frmt_issu_cnt", "name" : "거래형성종목수", "type" : "Number", "required" : "Y", "length" : "13", "description" : "이 지수 구성 종목 중 거래가 형성된 종목 수입니다.", "depth" : 0 }, { "element" : "tr_frmt_ctrt", "name" : "거래형성대비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "거래형성종목수의 전일 대비 비율(%)입니다.", "depth" : 0 }, { "element" : "stck_last_tr_date", "name" : "최종거래일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "가장 최근 거래가 있었던 일자(YYYYMMDD)입니다.", "depth" : 0 }, { "element" : "mtrt_date", "name" : "만기일", "type" : "String", "required" : "Y", "length" : "8", "description" : "선물·옵션 연계 지수의 만기일(YYYYMMDD)입니다.", "depth" : 0 }, { "element" : "oprc", "name" : "시가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "당일 첫 체결 가격(시가)입니다.", "depth" : 0 }, { "element" : "oprc_hour", "name" : "시가시간", "type" : "String", "required" : "Y", "length" : "6", "description" : "시가가 형성된 시각(HHMMSS)입니다.", "depth" : 0 }, { "element" : "prdy_clpr_vrss_oprc", "name" : "전일종가대비시가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "전일 종가 대비 시가의 차이입니다.", "depth" : 0 }, { "element" : "prdy_clpr_vrss_oprc_rate", "name" : "전일종가대비시가비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "전일 종가 대비 시가의 비율(%)입니다.", "depth" : 0 }, { "element" : "hprc", "name" : "고가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "당일 장중 가장 높았던 체결 가격(고가)입니다.", "depth" : 0 }, { "element" : "hgpr_hour", "name" : "최고가시간", "type" : "String", "required" : "Y", "length" : "6", "description" : "고가가 형성된 시각(HHMMSS)입니다.", "depth" : 0 }, { "element" : "prdy_clpr_vrss_hgpr", "name" : "전일종가대비고가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "전일 종가 대비 고가의 차이입니다.", "depth" : 0 }, { "element" : "prdy_clpr_vrss_hgpr_rate", "name" : "전일종가대비고가비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "전일 종가 대비 고가의 비율(%)입니다.", "depth" : 0 }, { "element" : "lprc", "name" : "저가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "당일 장중 가장 낮았던 체결 가격(저가)입니다.", "depth" : 0 }, { "element" : "lwpr_hour", "name" : "최저가시간", "type" : "String", "required" : "Y", "length" : "6", "description" : "저가가 형성된 시각(HHMMSS)입니다.", "depth" : 0 }, { "element" : "prdy_clpr_vrss_lwpr", "name" : "전일종가대비저가", "type" : "Number", "required" : "Y", "length" : "13", "description" : "전일 종가 대비 저가의 차이입니다.", "depth" : 0 }, { "element" : "prdy_clpr_vrss_lwpr_rate", "name" : "전일종가대비저가비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "전일 종가 대비 저가의 비율(%)입니다.", "depth" : 0 }, { "element" : "ascn_issu_cnt", "name" : "상승종목수", "type" : "Number", "required" : "Y", "length" : "13", "description" : "이 지수 구성 종목 중 상승한 종목 수입니다.", "depth" : 0 }, { "element" : "down_issu_cnt", "name" : "하락종목수", "type" : "Number", "required" : "Y", "length" : "13", "description" : "이 지수 구성 종목 중 하락한 종목 수입니다.", "depth" : 0 }, { "element" : "stnr_issu_cnt", "name" : "보합종목수", "type" : "Number", "required" : "Y", "length" : "13", "description" : "이 지수 구성 종목 중 보합인 종목 수입니다.", "depth" : 0 }, { "element" : "uplm_issu_cnt", "name" : "상한종목수", "type" : "Number", "required" : "Y", "length" : "5", "description" : "이 지수 구성 종목 중 상한가에 도달한 종목 수입니다. 해외지수에서는 0 으로 내려올 수 있습니다.", "depth" : 0 }, { "element" : "lslm_issu_cnt", "name" : "하한종목수", "type" : "Number", "required" : "Y", "length" : "5", "description" : "이 지수 구성 종목 중 하한가에 도달한 종목 수입니다. 해외지수에서는 0 으로 내려올 수 있습니다.", "depth" : 0 }, { "element" : "52_week_hghs_nmix", "name" : "52주최고지수", "type" : "Number", "required" : "Y", "length" : "14", "description" : "최근 52주 중 최고 지수 값입니다.", "depth" : 0 }, { "element" : "52_week_hgpr_date", "name" : "52주최고가일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "52주 최고 지수가 기록된 일자(YYYYMMDD)입니다.", "depth" : 0 }, { "element" : "52_week_hgpr_rate", "name" : "52주최고가비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "현재 지수의 52주 최고 지수 대비 비율(%)입니다.", "depth" : 0 }, { "element" : "52_week_lwst_nmix", "name" : "52주최저지수", "type" : "Number", "required" : "Y", "length" : "14", "description" : "최근 52주 중 최저 지수 값입니다.", "depth" : 0 }, { "element" : "52_week_lwpr_date", "name" : "52주최저가일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "52주 최저 지수가 기록된 일자(YYYYMMDD)입니다.", "depth" : 0 }, { "element" : "52_week_lwpr_rate", "name" : "52주최저가비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "현재 지수의 52주 최저 지수 대비 비율(%)입니다.", "depth" : 0 } ] }, "requestExample" : "GET /market/v1/overseas/index/prices?iscd=NAS@IXIC", "responseExample" : "{\n \"data\": {\n \"kor_isnm\": \"코스피\",\n \"stck_prpr\": 2487.15,\n \"prdy_clpr\": 2471.50,\n \"acml_tr_pbmn\": 8123456789000,\n \"prdy_vrss\": 15.65,\n \"prdy_vrss_sign\": \"2\",\n \"prdy_ctrt\": 0.63,\n \"acml_vol\": 512345678,\n \"tr_frmt_issu_cnt\": 820,\n \"tr_frmt_ctrt\": 1.2,\n \"stck_last_tr_date\": \"20260928\",\n \"mtrt_date\": \"\",\n \"oprc\": 2475.00,\n \"oprc_hour\": \"090000\",\n \"prdy_clpr_vrss_oprc\": 3.50,\n \"prdy_clpr_vrss_oprc_rate\": 0.14,\n \"hprc\": 2491.30,\n \"hgpr_hour\": \"133512\",\n \"prdy_clpr_vrss_hgpr\": 19.80,\n \"prdy_clpr_vrss_hgpr_rate\": 0.80,\n \"lprc\": 2468.90,\n \"lwpr_hour\": \"090530\",\n \"prdy_clpr_vrss_lwpr\": -2.60,\n \"prdy_clpr_vrss_lwpr_rate\": -0.11,\n \"ascn_issu_cnt\": 540,\n \"down_issu_cnt\": 310,\n \"stnr_issu_cnt\": 70,\n \"uplm_issu_cnt\": 3,\n \"lslm_issu_cnt\": 1,\n \"52_week_hghs_nmix\": 2602.40,\n \"52_week_hgpr_date\": \"20260815\",\n \"52_week_hgpr_rate\": -4.43,\n \"52_week_lwst_nmix\": 2180.70,\n \"52_week_lwpr_date\": \"20260110\",\n \"52_week_lwpr_rate\": 14.05\n },\n \"rsp_cd\": \"0000\",\n \"rsp_msg\": \"정상 처리 되었습니다.\",\n \"tr_cont\": \"0\"\n}" } ] }, { "name" : "해외주식 현재가 조회", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/market/v1/overseas/prices", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "해외주식 한 종목의 현재가를 조회합니다.", "trs" : [ { "name" : "해외주식 현재가 조회", "code" : "ohhts_6000_001r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "mrkt_div_code", "name" : "시장 구분 코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "해외 시세는 \"OV\"를 넣습니다. (query string)", "depth" : 0 }, { "element" : "mrkt_cls_code", "name" : "거래소 구분 코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "거래소 구분입니다.\n\"OQ\": 나스닥\n\"NY\": 뉴욕\n\"AX\": 아멕스\n\"HK\": 홍콩증권거래소\n\"SH\": 상하이증권거래소\n\"SZ\": 심천증권거래소\n\"JP\": 도쿄증권거래소\n\n홍콩·상하이는 dely_rltm_cls_code 를 \"0\" 으로 보내면 오류(IGW50002)가 반환되며 \"1\"(지연)로 조회하십시오. (query string)", "depth" : 0 }, { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "16", "description" : "해외 종목 심볼을 입력합니다. (예: AAPL, 홍콩 00700) (query string)", "depth" : 0 }, { "element" : "dely_rltm_cls_code", "name" : "지연실시간구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "시세 종류입니다. \"0\": 실시간 \"1\": 지연. (query string)", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "현재가 정보", "type" : "Object", "required" : "Y", "length" : "-", "description" : "종목의 현재가 정보입니다.", "depth" : 0 }, { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "16", "description" : "요청한 종목 심볼입니다.", "depth" : 0 }, { "element" : "prpr", "name" : "현재가", "type" : "String", "required" : "Y", "length" : "14", "description" : "가장 최근 체결된 가격(현재가)입니다. 소수점 자릿수는 같은 응답의 dcpn_cnt(소수점수)로 확인하십시오.", "depth" : 0 }, { "element" : "acml_vol", "name" : "누적거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "장 시작부터 지금까지 체결된 주식 수를 모두 더한 값입니다. 개별 체결 수량이 아닙니다.", "depth" : 0 }, { "element" : "prdy_vrss_sign", "name" : "전일대비부호", "type" : "String", "required" : "Y", "length" : "1", "description" : "전일 대비 부호입니다.\n\"1\": 상한\n\"2\": 상승\n\"3\": 보합\n\"4\": 하한\n\"5\": 하락", "depth" : 0 }, { "element" : "prdy_clpr", "name" : "전일종가", "type" : "String", "required" : "Y", "length" : "14", "description" : "전일 종가입니다. 등락 계산의 기준이 되는 값입니다.", "depth" : 0 }, { "element" : "prdy_vol", "name" : "전일거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "전일 거래량입니다.", "depth" : 0 }, { "element" : "52_week_hgpr", "name" : "52주최고가", "type" : "String", "required" : "Y", "length" : "14", "description" : "최근 52주 동안의 최고가입니다.", "depth" : 0 }, { "element" : "52_week_lwpr", "name" : "52주최저가", "type" : "String", "required" : "Y", "length" : "14", "description" : "최근 52주 동안의 최저가입니다.", "depth" : 0 }, { "element" : "lstn_stcn", "name" : "상장주수", "type" : "Number", "required" : "Y", "length" : "19", "description" : "이 종목이 발행해 상장된 총 주식 수입니다.", "depth" : 0 }, { "element" : "oprc", "name" : "시가", "type" : "String", "required" : "Y", "length" : "14", "description" : "당일 첫 체결 가격(시가)입니다.", "depth" : 0 }, { "element" : "hprc", "name" : "고가", "type" : "String", "required" : "Y", "length" : "14", "description" : "당일 최고 체결 가격(고가)입니다.", "depth" : 0 }, { "element" : "lprc", "name" : "저가", "type" : "String", "required" : "Y", "length" : "14", "description" : "당일 최저 체결 가격(저가)입니다.", "depth" : 0 }, { "element" : "mxpr", "name" : "상한가", "type" : "String", "required" : "Y", "length" : "14", "description" : "당일 주문 가능한 가장 높은 가격(상한가)입니다. 미국(AAPL)과 홍콩(00700) 종목은 0 으로 내려옵니다.", "depth" : 0 }, { "element" : "llam", "name" : "하한가", "type" : "String", "required" : "Y", "length" : "14", "description" : "당일 주문 가능한 가장 낮은 가격(하한가)입니다. 미국(AAPL)과 홍콩(00700) 종목은 0 으로 내려옵니다.", "depth" : 0 }, { "element" : "avls", "name" : "시가총액", "type" : "Number", "required" : "Y", "length" : "19", "description" : "시세 조회 시점의 시가총액입니다.", "depth" : 0 }, { "element" : "eps", "name" : "EPS", "type" : "String", "required" : "Y", "length" : "11", "description" : "주당순이익(EPS)입니다.", "depth" : 0 }, { "element" : "prdy_vrss", "name" : "전일대비", "type" : "String", "required" : "Y", "length" : "14", "description" : "전일 종가 대비 가격 변동폭입니다.", "depth" : 0 }, { "element" : "prdy_ctrt", "name" : "전일대비율", "type" : "String", "required" : "Y", "length" : "11", "description" : "전일 대비 등락률(%)입니다.", "depth" : 0 }, { "element" : "bstp_cls_code", "name" : "업종구분코드", "type" : "String", "required" : "Y", "length" : "4", "description" : "업종 구분 코드입니다. 같은 응답의 bstp_lrdv_name(대분류명)·bstp_mddv_name(중분류명)·bstp_smdv_name(소분류명)에 업종 이름이 내려옵니다.", "depth" : 0 }, { "element" : "bstp_lrdv_name", "name" : "업종대분류명", "type" : "String", "required" : "Y", "length" : "80", "description" : "업종 대분류명입니다. (예: \"IT\")", "depth" : 0 }, { "element" : "bstp_mddv_name", "name" : "업종중분류명", "type" : "String", "required" : "Y", "length" : "80", "description" : "업종 중분류명입니다. (예: \"하드웨어 및 장비\")", "depth" : 0 }, { "element" : "bstp_smdv_name", "name" : "업종소분류명", "type" : "String", "required" : "Y", "length" : "80", "description" : "업종 소분류명입니다. 소분류가 없는 종목은 빈 값입니다.", "depth" : 0 }, { "element" : "dcpn_cnt", "name" : "소수점수", "type" : "Number", "required" : "Y", "length" : "2", "description" : "가격의 소수점 자릿수입니다.", "depth" : 0 }, { "element" : "shnu_aspr_unit", "name" : "매수호가단위", "type" : "String", "required" : "Y", "length" : "14", "description" : "매수 호가 단위 항목입니다. 미국 AAPL·홍콩 00700 종목에서는 0 으로 내려옵니다.", "depth" : 0 }, { "element" : "seln_aspr_unit", "name" : "매도호가단위", "type" : "String", "required" : "Y", "length" : "14", "description" : "매도 호가 단위 항목입니다. 미국 AAPL·홍콩 00700 종목에서는 0 으로 내려옵니다.", "depth" : 0 }, { "element" : "shnu_oder_qty_unit", "name" : "매수주문수량단위", "type" : "Number", "required" : "Y", "length" : "9", "description" : "매수 주문 수량 단위입니다. 종목마다 다릅니다(예: AAPL 1, 홍콩 00700 100).", "depth" : 0 }, { "element" : "seln_oder_qty_unit", "name" : "매도주문수량단위", "type" : "Number", "required" : "Y", "length" : "9", "description" : "매도 주문 수량 단위입니다. 종목마다 다릅니다(예: AAPL 1, 홍콩 00700 100).", "depth" : 0 }, { "element" : "crnc_code", "name" : "통화코드", "type" : "String", "required" : "Y", "length" : "4", "description" : "이 종목이 거래되는 통화입니다. ISO 통화 코드 세 자리입니다(예: 미국 USD, 홍콩 HKD).", "depth" : 0 }, { "element" : "kor_isnm", "name" : "한글종목명", "type" : "String", "required" : "Y", "length" : "65", "description" : "한글 종목명입니다.", "depth" : 0 }, { "element" : "tick_cls", "name" : "틱구분", "type" : "String", "required" : "Y", "length" : "4", "description" : "틱 구분입니다.", "depth" : 0 }, { "element" : "pbr", "name" : "PBR", "type" : "String", "required" : "Y", "length" : "9", "description" : "주가순자산비율(PBR)입니다.", "depth" : 0 }, { "element" : "per", "name" : "PER", "type" : "String", "required" : "Y", "length" : "9", "description" : "주가수익비율(PER)입니다.", "depth" : 0 }, { "element" : "bstp_kor_isnm", "name" : "업종한글종목명", "type" : "String", "required" : "Y", "length" : "100", "description" : "업종명입니다.", "depth" : 0 }, { "element" : "cas_trgt_issu_yn", "name" : "CAS대상종목여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "홍콩 단일가매매(CAS) 대상 종목 여부입니다.\n\"Y\": 대상\n\"N\": 비대상", "depth" : 0 }, { "element" : "vcm_stat_cls_code", "name" : "VCM상태구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "변동성 완화장치(VCM) 상태입니다.", "depth" : 0 }, { "element" : "eng_isnm", "name" : "영문종목명", "type" : "String", "required" : "Y", "length" : "65", "description" : "영문 종목명입니다.", "depth" : 0 }, { "element" : "sdpr", "name" : "기준가", "type" : "String", "required" : "Y", "length" : "14", "description" : "기준 가격 항목입니다. 등락 계산의 기준은 전일 종가(prdy_clpr)를 쓰십시오.", "depth" : 0 }, { "element" : "vcm_sta_hour", "name" : "VCM시작시간", "type" : "String", "required" : "Y", "length" : "6", "description" : "VCM 시작 시각입니다. HHMMSS 형식입니다.", "depth" : 0 }, { "element" : "vcm_fin_hour", "name" : "VCM종료시간", "type" : "String", "required" : "Y", "length" : "6", "description" : "VCM 종료 시각입니다. HHMMSS 형식입니다.", "depth" : 0 }, { "element" : "sell_only", "name" : "SELLONLY", "type" : "Number", "required" : "Y", "length" : "2", "description" : "매도만 가능한 종목인지 여부입니다.", "depth" : 0 }, { "element" : "issu_stat_cls_code", "name" : "종목상태구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "종목 상태 구분입니다.", "depth" : 0 }, { "element" : "cas_iep", "name" : "CASIEP", "type" : "String", "required" : "Y", "length" : "11", "description" : "단일가 매매(CAS) 구간의 예상 체결가입니다.", "depth" : 0 }, { "element" : "cas_iev", "name" : "CASIEV", "type" : "String", "required" : "Y", "length" : "11", "description" : "CAS 예상 체결량입니다.", "depth" : 0 }, { "element" : "etf_yn", "name" : "ETF여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "ETF 여부입니다.\n\"Y\": ETF\n\"N\": 일반 종목", "depth" : 0 }, { "element" : "lvrg", "name" : "레버리지", "type" : "String", "required" : "Y", "length" : "14", "description" : "레버리지 배수입니다. ETF 가 아닌 일반 종목(예: AAPL)은 \"0.0\" 으로 내려옵니다.", "depth" : 0 }, { "element" : "cas_trgt_issu", "name" : "CAS대상종목", "type" : "String", "required" : "Y", "length" : "1", "description" : "CAS 대상 종목 구분입니다.", "depth" : 0 }, { "element" : "cas_stat", "name" : "CAS상태", "type" : "String", "required" : "Y", "length" : "2", "description" : "CAS 진행 상태입니다.", "depth" : 0 }, { "element" : "cas_sdpr", "name" : "CAS기준가", "type" : "String", "required" : "Y", "length" : "14", "description" : "단일가 매매(CAS) 구간의 기준가입니다.", "depth" : 0 }, { "element" : "cas_mxpr", "name" : "CAS상한가", "type" : "String", "required" : "Y", "length" : "14", "description" : "단일가 매매(CAS) 구간의 상한가입니다.", "depth" : 0 }, { "element" : "cas_llam", "name" : "CAS하한가", "type" : "String", "required" : "Y", "length" : "14", "description" : "단일가 매매(CAS) 구간의 하한가입니다.", "depth" : 0 }, { "element" : "etf_type_code", "name" : "ETF유형코드", "type" : "String", "required" : "Y", "length" : "3", "description" : "ETF·ETN 유형 코드입니다. 일반 종목(AAPL, 홍콩 00700)은 빈 값으로 내려옵니다.", "depth" : 0 }, { "element" : "unch_prpr", "name" : "환산현재가", "type" : "String", "required" : "Y", "length" : "14", "description" : "현재가를 원화로 환산한 값입니다. 고시환율 조회(/forex/v1/rates)의 매매기준환율(deal_stnd_exrt)을 곱한 값입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 API 의 성공 응답 코드입니다.\n\"0000\": 정상 처리\n\n오류는 종류와 무관하게 HTTP 500 으로 반환되므로, 성공·실패는 HTTP 상태가 아니라 이 값으로 판정하십시오.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 담깁니다.\n\n오류 응답에는 data 와 tr_cont 가 담기지 않습니다. 오류일 때 본문은 rsp_cd·rsp_msg(일부 API 는 rsp_sub_msg 포함)로 이루어지므로, rsp_cd 를 먼저 확인한 뒤 data 를 읽으십시오.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "N", "length" : "200", "description" : "오류일 때 내려올 수 있는 상세 사유 항목입니다. 정상 응답에는 포함되지 않습니다.", "depth" : 0 } ] }, "requestExample" : "GET /market/v1/overseas/prices?mrkt_div_code=OV&mrkt_cls_code=OQ&iscd=AAPL&dely_rltm_cls_code=0\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": {\n \"iscd\": \"AAPL\",\n \"prpr\": \"326.5700\",\n \"acml_vol\": 0,\n \"prdy_vrss_sign\": \"3\",\n \"prdy_clpr\": \"326.5700\",\n \"prdy_vol\": 70011913,\n \"52_week_hgpr\": \"344.5699\",\n \"52_week_lwpr\": \"229.0200\",\n \"lstn_stcn\": 14594200000,\n \"oprc\": \"326.5700\",\n \"hprc\": \"326.5700\",\n \"lprc\": \"326.5700\",\n \"mxpr\": \"0.0000\",\n \"llam\": \"0.0000\",\n \"avls\": 4766027894,\n \"eps\": \"8.723\",\n \"prdy_vrss\": \"0.0000\",\n \"prdy_ctrt\": \"0.00\",\n \"bstp_cls_code\": \"2520\",\n \"bstp_lrdv_name\": \"IT\",\n \"bstp_mddv_name\": \"하드웨어 및 장비\",\n \"bstp_smdv_name\": \"\",\n \"dcpn_cnt\": 4,\n \"shnu_aspr_unit\": \"0.0000\",\n \"seln_aspr_unit\": \"0.0000\",\n \"shnu_oder_qty_unit\": 1,\n \"seln_oder_qty_unit\": 1,\n \"crnc_code\": \"USD\",\n \"kor_isnm\": \"애플\",\n \"tick_cls\": \"1\",\n \"pbr\": \"44.37\",\n \"per\": \"37.44\",\n \"bstp_kor_isnm\": \"\",\n \"cas_trgt_issu_yn\": \"N\",\n \"vcm_stat_cls_code\": \"N\",\n \"eng_isnm\": \"APPLE INC\",\n \"sdpr\": \"326.5700\",\n \"vcm_sta_hour\": \"000000\",\n \"vcm_fin_hour\": \"000000\",\n \"sell_only\": 0,\n \"issu_stat_cls_code\": \"N\",\n \"cas_iep\": \"0.0000\",\n \"cas_iev\": \"0\",\n \"etf_yn\": \"N\",\n \"lvrg\": \"0.0\",\n \"cas_trgt_issu\": \"\",\n \"cas_stat\": \"\",\n \"cas_sdpr\": \"0.0000\",\n \"cas_mxpr\": \"0.0000\",\n \"cas_llam\": \"0.0000\",\n \"etf_type_code\": \"\",\n \"unch_prpr\": \"437015.95\"\n },\n \"rsp_cd\": \"0000\",\n \"rsp_msg\": \"정상 처리 되었습니다.\"\n}" } ] }, { "name" : "해외주식 주간거래 현재가 조회", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/market/v1/overseas/prices/daytime", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "해외주식 한 종목의 주간거래 현재가를 조회합니다. 해외주식 현재가 조회(/market/v1/overseas/prices)와 같은 요청(시장 분류·거래소·종목·시세 종류)으로 호출합니다. 응답에는 주간거래의 현재가·전일 대비·누적 거래량·누적 거래대금이 내려옵니다.", "trs" : [ { "name" : "해외주식 주간거래 현재가 조회", "code" : "ohhts_6000_017r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "mrkt_div_code", "name" : "시장 구분 코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "해외 시세는 \"OV\"를 넣습니다. (query string)", "depth" : 0 }, { "element" : "mrkt_cls_code", "name" : "시장 구분 코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "거래소 구분입니다.\n\"OQ\": 나스닥\n\"NY\": 뉴욕\n\"AX\": 아멕스 (query string)", "depth" : 0 }, { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "16", "description" : "해외 종목 심볼을 입력합니다. (예: AAPL)\n\n(query string)", "depth" : 0 }, { "element" : "dely_rltm_cls_code", "name" : "지연실시간구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "시세 종류입니다.\n\"0\": 실시간\n\"1\": 지연\n\n (query string)", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "주간거래 현재가 정보", "type" : "Object", "required" : "Y", "length" : "-", "description" : "종목의 주간거래 현재가 정보입니다.", "depth" : 0 }, { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "16", "description" : "종목 코드입니다. 요청한 심볼이 그대로 돌아옵니다.", "depth" : 0 }, { "element" : "dytm_prpr", "name" : "주간현재가", "type" : "String", "required" : "Y", "length" : "14", "description" : "주간거래 현재가입니다. 해당 종목의 거래 통화 기준입니다.", "depth" : 0 }, { "element" : "dytm_prdy_vrss_sign", "name" : "주간전일대비부호", "type" : "String", "required" : "Y", "length" : "1", "description" : "전일 대비 부호입니다.\n\"1\": 상한\n\"2\": 상승\n\"3\": 보합\n\"4\": 하한\n\"5\": 하락", "depth" : 0 }, { "element" : "dytm_prdy_vrss", "name" : "주간전일대비", "type" : "String", "required" : "Y", "length" : "14", "description" : "주간거래 현재가의 전일 대비 값입니다.", "depth" : 0 }, { "element" : "dytm_prdy_ctrt", "name" : "주간전일대비율", "type" : "String", "required" : "Y", "length" : "11", "description" : "주간거래 현재가의 전일 대비율(%)입니다.", "depth" : 0 }, { "element" : "dytm_acml_vol", "name" : "주간누적거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "주간거래 누적 거래량입니다.", "depth" : 0 }, { "element" : "dytm_acml_tr_pbmn", "name" : "주간누적거래대금", "type" : "Number", "required" : "Y", "length" : "19", "description" : "주간거래 누적 거래대금입니다. 해당 종목의 거래 통화 기준입니다.", "depth" : 0 }, { "element" : "dytm_mkt_yn", "name" : "주간장여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "주간거래 시간대 여부를 나타내는 구분값입니다.", "depth" : 0 }, { "element" : "dytm_unch_prpr", "name" : "주간환산현재가", "type" : "String", "required" : "Y", "length" : "14", "description" : "주간거래 현재가를 원화로 환산한 값입니다. 환산에는 고시환율 조회(/forex/v1/rates)의 매매기준환율(deal_stnd_exrt)을 씁니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "5", "description" : "이 API 의 성공 응답 코드입니다.\n\"0000\": 정상 처리\n\n오류는 종류와 무관하게 HTTP 500 으로 반환되므로, 성공·실패는 HTTP 상태가 아니라 이 값으로 판정하십시오.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 이 값에 담깁니다.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "오류일 때 내려올 수 있는 상세 사유 항목입니다. 정상 응답에는 포함되지 않습니다.", "depth" : 0 } ] }, "requestExample" : "GET /market/v1/overseas/prices/daytime?mrkt_div_code=OV&mrkt_cls_code=OQ&iscd=AAPL&dely_rltm_cls_code=0\nauthorization: Bearer {access_token}", "responseExample" : "{\n \"data\": {\n \"iscd\": \"AAPL\",\n \"dytm_prpr\": \"340.4800\",\n \"dytm_prdy_vrss_sign\": \"2\",\n \"dytm_prdy_vrss\": \"0.5600\",\n \"dytm_prdy_ctrt\": \"0.16\",\n \"dytm_acml_vol\": 141046,\n \"dytm_acml_tr_pbmn\": 32355724,\n \"dytm_mkt_yn\": \"1\",\n \"dytm_unch_prpr\": \"456477.20\"\n },\n \"rsp_cd\": \"0000\",\n \"rsp_msg\": \"정상 처리 되었습니다.\"\n}" } ] }, { "name" : "해외주식 애프터장 현재가 조회", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/market/v1/overseas/prices/after", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "해외주식 한 종목의 애프터장 현재가를 조회합니다", "trs" : [ { "name" : "해외주식 애프터장 현재가 조회", "code" : "ohhts_6000_020r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "호출 단말의 MAC 주소입니다. 12자리로 넣습니다. 넣지 않으시면 요청이 거부됩니다.", "depth" : 0 } ], "body" : [ { "element" : "mrkt_div_code", "name" : "시장 구분 코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "해외 시세는 \"OV\"를 넣습니다. (query string)", "depth" : 0 }, { "element" : "mrkt_cls_code", "name" : "시장 구분 코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "거래소 구분입니다.\n\"OQ\": 나스닥\n\"NY\": 뉴욕\n\"AX\": 아멕스 (query string)", "depth" : 0 }, { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "16", "description" : "해외 종목 심볼을 입력합니다. (예: AAPL)\n\n(query string)", "depth" : 0 }, { "element" : "dely_rltm_cls_code", "name" : "지연실시간구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "시세 종류입니다.\n\"0\": 실시간\n\"1\": 지연\n (query string)", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "애프터장 현재가 정보", "type" : "Object", "required" : "Y", "length" : "-", "description" : "종목의 애프터장 현재가 정보입니다.", "depth" : 0 }, { "element" : "iscd", "name" : "종목 코드", "type" : "String", "required" : "Y", "length" : "16", "description" : "종목 코드입니다. 요청한 심볼이 그대로 돌아옵니다.", "depth" : 0 }, { "element" : "mkt_aft_prpr", "name" : "장후현재가", "type" : "String", "required" : "Y", "length" : "14", "description" : "애프터장 현재가입니다. 해당 종목의 거래 통화 기준입니다.", "depth" : 0 }, { "element" : "mkt_aft_prdy_vrss_sign", "name" : "장후전일대비부호", "type" : "String", "required" : "Y", "length" : "1", "description" : "전일 대비 부호입니다.\n\"1\": 상한\n\"2\": 상승\n\"3\": 보합\n\"4\": 하한\n\"5\": 하락", "depth" : 0 }, { "element" : "mkt_aft_prdy_vrss", "name" : "장후전일대비", "type" : "String", "required" : "Y", "length" : "14", "description" : "애프터장 현재가의 전일 대비 값입니다.", "depth" : 0 }, { "element" : "mkt_aft_prdy_ctrt", "name" : "장후전일대비율", "type" : "String", "required" : "Y", "length" : "11", "description" : "애프터장 현재가의 전일 대비율(%)입니다.", "depth" : 0 }, { "element" : "acml_vol", "name" : "누적거래량", "type" : "Number", "required" : "Y", "length" : "19", "description" : "장 시작부터 지금까지 체결된 주식 수를 모두 더한 값입니다. 개별 체결 수량이 아닙니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "5", "description" : "이 API 의 성공 응답 코드입니다.\n\"0000\": 정상 처리\n\n오류는 종류와 무관하게 HTTP 500 으로 반환되므로, 성공·실패는 HTTP 상태가 아니라 이 값으로 판정하십시오.", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지입니다. 오류일 때 원인이 이 값에 담깁니다.", "depth" : 0 }, { "element" : "rsp_sub_msg", "name" : "응답 상세 메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "오류일 때 내려올 수 있는 상세 사유 항목입니다. 정상 응답에는 포함되지 않습니다.", "depth" : 0 } ] }, "requestExample" : "GET /market/v1/overseas/prices/after?mrkt_div_code=OV&mrkt_cls_code=OQ&iscd=AAPL&dely_rltm_cls_code=0\nauthorization: Bearer {access_token}", "responseExample" : "{\n \"data\": {\n \"iscd\": \"AAPL\",\n \"mkt_aft_prpr\": \"340.4800\",\n \"mkt_aft_prdy_vrss_sign\": \"2\",\n \"mkt_aft_prdy_vrss\": \"0.5600\",\n \"mkt_aft_prdy_ctrt\": \"0.16\",\n \"acml_vol\": 141046\n },\n \"rsp_cd\": \"0000\",\n \"rsp_msg\": \"정상 처리 되었습니다.\"\n}" } ] }, { "name" : "환율 시세 조회", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/market/v1/overseas/fx/prices", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "원/달러, 원/엔, 원/위안, 원/유로와 달러 기준 주요 통화쌍의 시장 환율 시세를 조회합니다.", "trs" : [ { "name" : "환율 시세 조회", "code" : "ohhts_1684_001r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "MAC_ADDRESS 필수 입력", "depth" : 0 } ], "body" : [ { "element" : "iscd", "name" : "종목코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "통화쌍 코드입니다. 코드: 응답 종목명(isnm) 형식입니다.\n\n원화\nUSDKRWSMBS: 원/달러\nJPYKRWCOMP: 원/일본 엔\nCNYKRWCOMP: 한국 원/중국 위안\nEURKRWCOMP: 원/유로\n\n교차 환율\nEURUSDCOMP: 달러/유로\nUSDJPYCOMP: 일본 엔/달러\nEURJPYCOMP: 일본 엔/유로\nGBPUSDCOMP: 달러/영국 파운드\nUSDCHFCOMP: 스위스 프랑/달러\nUSDCADCOMP: 캐나다 달러/달러\nAUDUSDCOMP: 달러/호주 달러\nUSDHKDCOMP: 홍콩 달러/달러\nUSDSGDCOMP: 싱가폴 달러/달러\n(query string)", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "N", "length" : "1", "description" : "이 API는 연속조회를 지원하지 않으므로 넣지 않습니다. (query string)", "depth" : 0 }, { "element" : "tr_cont_key", "name" : "연속조회 키", "type" : "String", "required" : "N", "length" : "20", "description" : "이 API는 연속조회를 지원하지 않으므로 넣지 않습니다. (query string)", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "목록", "type" : "Object Array", "required" : "Y", "length" : "-", "description" : "조회 결과 배열입니다. 요청한 통화쌍 한 건이 내려옵니다.", "depth" : 0 }, { "element" : "iscd", "name" : "종목코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "조회한 통화쌍 코드입니다. 요청에 넣은 값과 같습니다.", "depth" : 0 }, { "element" : "mrkt_cls_code", "name" : "시장구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "통화쌍이 속한 시장 구분입니다.", "depth" : 0 }, { "element" : "isnm", "name" : "종목명", "type" : "String", "required" : "Y", "length" : "50", "description" : "통화쌍 이름입니다. (예: 원/달러)", "depth" : 0 }, { "element" : "date", "name" : "일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "시세 기준 일자입니다. YYYYMMDD 8자리.", "depth" : 0 }, { "element" : "prpr", "name" : "현재가", "type" : "Number", "required" : "Y", "length" : "12", "description" : "가장 최근 환율입니다. 소수점이 있을 수 있습니다.", "depth" : 0 }, { "element" : "prdy_vrss", "name" : "전일대비", "type" : "Number", "required" : "Y", "length" : "12", "description" : "전일 종가 대비 등락폭입니다.", "depth" : 0 }, { "element" : "prdy_vrss_sign", "name" : "전일대비부호", "type" : "String", "required" : "Y", "length" : "1", "description" : "등락 부호입니다.\n\"1\" 상한 · \"2\" 상승 · \"3\" 보합 · \"4\" 하한 · \"5\" 하락", "depth" : 0 }, { "element" : "prdy_ctrt", "name" : "전일대비율", "type" : "Number", "required" : "Y", "length" : "9", "description" : "전일 종가 대비 등락률입니다. 단위는 퍼센트.", "depth" : 0 }, { "element" : "oprc", "name" : "시가", "type" : "Number", "required" : "Y", "length" : "12", "description" : "당일 시가입니다.", "depth" : 0 }, { "element" : "hprc", "name" : "고가", "type" : "Number", "required" : "Y", "length" : "12", "description" : "당일 고가입니다.", "depth" : 0 }, { "element" : "lprc", "name" : "저가", "type" : "Number", "required" : "Y", "length" : "12", "description" : "당일 저가입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "5", "description" : "응답 코드", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "연속조회 여부", "depth" : 0 } ] }, "requestExample" : "GET /market/v1/overseas/fx/prices?iscd=USDKRWSMBS\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": [\n {\n \"iscd\": \"USDKRWSMBS\",\n \"mrkt_cls_code\": \"EN\",\n \"isnm\": \"원/달러\",\n \"date\": \"20261022\",\n \"prpr\": 1322.1,\n \"prdy_vrss\": -3.9,\n \"prdy_vrss_sign\": \"5\",\n \"prdy_ctrt\": -0.29,\n \"oprc\": 1327.5,\n \"hprc\": 1328.6,\n \"lprc\": 1321.2\n }\n ],\n \"rsp_cd\": \"0000\",\n \"rsp_msg\": \"정상 처리 되었습니다.\"\n}" } ] }, { "name" : "해외 원자재·달러인덱스 현재가 조회", "protocol" : "REST", "method" : "GET", "domain" : "", "url" : "/market/v1/overseas/commodities/prices", "format" : "JSON", "contentType" : "application/json; charset=utf-8", "description" : "금·원유 등 원자재(상품선물)와 달러인덱스의 현재 시세를 조회합니다. 시장 구분(mrkt_div_code)과 종목 코드(iscd)를 넣으면 현재가와 전일 대비 등락, 등락률, 누적 거래량, 당일 시가·고가·저가가 내려옵니다. 시장 브리핑이나 투자 지표 화면에 그대로 쓰실 수 있습니다. 종목은 한 번에 하나씩 조회합니다. mrkt_div_code 는 \"FN\"(원자재·상품선물) 또는 \"N\"(달러인덱스)이며, 두 값 모두 필수입니다.", "trs" : [ { "name" : "해외 원자재·달러인덱스 현재가 조회", "code" : "ohhts_1682_001r", "request" : { "header" : [ { "element" : "authorization", "name" : "인증 토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "OAuth 토큰이 필요한 API 경우 발급한 Access Token을 설정하기 위한 Request Header Parameter", "depth" : 0 }, { "element" : "mac_address", "name" : "사용자 MAC_ADDRESS", "type" : "String", "required" : "Y", "length" : "12", "description" : "MAC_ADDRESS 필수 입력", "depth" : 0 } ], "body" : [ { "element" : "mrkt_div_code", "name" : "시장 구분 코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "시장 구분입니다.\n\"FN\": 원자재(상품선물)\n\"N\": 달러인덱스 (query string)", "depth" : 0 }, { "element" : "iscd", "name" : "종목코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "종목 코드입니다. 거래소@심볼 형식이며, 시장 구분에 맞는 코드를 넣으십시오.\n\n[mrkt_div_code=FN] 귀금속\nCOM@GC: 금\nCOM@SI: 은\nNYM@PL: 백금\nNYM@PA: 팔라듐\n\n[FN] 비철금속\nCOM@HG: 구리\nLME@CDA: 전기동(3M)\nLME@ADY: 알루미늄 H/G(캐시)\nLME@NAA: NA 알루미늄(3M)\nLME@ZDY: 아연(캐시)\nLME@ZDA: 아연(3M)\nLME@NDY: 니켈(캐시)\nLME@NDA: 니켈(3M)\nLME@SDY: 주석(캐시)\nLME@SDA: 주석(3M)\nLME@PDY: 납(캐시)\nLME@PDA: 납(3M)\n\n[FN] 에너지\nNYM@CL: WTI 원유\nIPE@EB: 브렌트유\nSPT@DU: 두바이유\n\n[FN] 곡물\nCBT$ZC: 옥수수\nCBT$ZW: 소맥\nCBT$ZS: 대두\nCBT$ZM: 대두박\nCBT$ZL: 대두유\nCBT$ZO: 귀리\n\n[FN] 소프트 상품\nNYB@KC: 커피\nNYB@CC: 코코아\nNYB@SB: 설탕\nNYB@CT: 면화\n\n[FN] 지수선물\nCME@ES: E-mini S&P500 선물\nCME@NQ: E-mini 나스닥100 선물\n\n[mrkt_div_code=N] 달러인덱스\nETC@DXY00: 달러인덱스\n(query string)", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회 여부", "type" : "String", "required" : "N", "length" : "1", "description" : "이 API는 연속조회를 지원하지 않으므로 넣지 않습니다. (query string)", "depth" : 0 }, { "element" : "tr_cont_key", "name" : "연속조회 키", "type" : "String", "required" : "N", "length" : "20", "description" : "이 API는 연속조회를 지원하지 않으므로 넣지 않습니다. (query string)", "depth" : 0 } ] }, "response" : { "header" : [ { "element" : "content-type", "name" : "컨텐트 타입", "type" : "String", "required" : "Y", "length" : "100", "description" : "메리츠증권 제공 API를 호출한 후 Client로 응답하는 Response Header Parameter로 \"application/json; charset=utf-8\" 설정", "depth" : 0 } ], "body" : [ { "element" : "data", "name" : "목록", "type" : "Object Array", "required" : "Y", "length" : "-", "description" : "조회 결과 배열입니다. 요청한 종목 한 건이 내려옵니다.", "depth" : 0 }, { "element" : "iscd", "name" : "종목코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "조회한 종목 코드입니다. 요청에 넣은 값과 같습니다.", "depth" : 0 }, { "element" : "mrkt_cls_code", "name" : "시장구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "종목이 속한 시장 구분입니다.", "depth" : 0 }, { "element" : "isnm", "name" : "종목명", "type" : "String", "required" : "Y", "length" : "50", "description" : "종목명입니다.", "depth" : 0 }, { "element" : "date", "name" : "일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "시세 기준 일자입니다. YYYYMMDD 8자리.", "depth" : 0 }, { "element" : "prpr", "name" : "현재가", "type" : "Number", "required" : "Y", "length" : "12", "description" : "가장 최근 시세입니다. 원자재·달러인덱스 가격이므로 소수점이 있을 수 있습니다.", "depth" : 0 }, { "element" : "prdy_vrss", "name" : "전일대비", "type" : "Number", "required" : "Y", "length" : "12", "description" : "전일 종가 대비 등락폭입니다.", "depth" : 0 }, { "element" : "prdy_vrss_sign", "name" : "전일대비부호", "type" : "String", "required" : "Y", "length" : "1", "description" : "등락 부호입니다.\n\"1\" 상한 · \"2\" 상승 · \"3\" 보합 · \"4\" 하한 · \"5\" 하락", "depth" : 0 }, { "element" : "prdy_ctrt", "name" : "전일대비율", "type" : "Number", "required" : "Y", "length" : "9", "description" : "전일 종가 대비 등락률입니다. 단위는 퍼센트.", "depth" : 0 }, { "element" : "acml_vol", "name" : "누적거래량", "type" : "Number", "required" : "Y", "length" : "18", "description" : "당일 누적 거래량입니다. 거래량이 제공되지 않는 종목(달러인덱스, LME 비철금속, 두바이유 등)은 0입니다.", "depth" : 0 }, { "element" : "oprc", "name" : "시가", "type" : "Number", "required" : "Y", "length" : "12", "description" : "당일 시가입니다.", "depth" : 0 }, { "element" : "hprc", "name" : "고가", "type" : "Number", "required" : "Y", "length" : "12", "description" : "당일 고가입니다.", "depth" : 0 }, { "element" : "lprc", "name" : "저가", "type" : "Number", "required" : "Y", "length" : "12", "description" : "당일 저가입니다.", "depth" : 0 }, { "element" : "rsp_cd", "name" : "응답코드", "type" : "String", "required" : "Y", "length" : "5", "description" : "응답 코드", "depth" : 0 }, { "element" : "rsp_msg", "name" : "응답메시지", "type" : "String", "required" : "Y", "length" : "200", "description" : "응답 메시지", "depth" : 0 }, { "element" : "tr_cont", "name" : "연속조회여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "연속조회 여부", "depth" : 0 } ] }, "requestExample" : "GET /market/v1/overseas/commodities/prices?mrkt_div_code=FN&iscd=COM@GC\nauthorization: Bearer {access_token}\nmac_address: {mac_address}", "responseExample" : "{\n \"data\": [\n {\n \"iscd\": \"COM@GC\",\n \"mrkt_cls_code\": \"FN\",\n \"isnm\": \"금 26-12\",\n \"date\": \"20261021\",\n \"prpr\": 4150.0,\n \"prdy_vrss\": 7.4,\n \"prdy_vrss_sign\": \"2\",\n \"prdy_ctrt\": 0.17,\n \"acml_vol\": 143504,\n \"oprc\": 4143.4,\n \"hprc\": 4160.6,\n \"lprc\": 4122.3\n }\n ],\n \"rsp_cd\": \"0000\",\n \"rsp_msg\": \"정상 처리 되었습니다.\"\n}" } ] } ] }, { "name" : "(실시간) 국내주식", "apis" : [ { "name" : "(실시간) 국내주식 현재가 (SOR 통합)", "protocol" : "WEBSOCKET", "method" : "POST", "domain" : "wss://openapi.imeritz.com:29443", "url" : "/websocket", "format" : "JSON", "contentType" : "application/json", "description" : "국내주식 정규시장(KRX)과 대체거래소(NXT)의 체결을 하나로 합쳐 내려보내는 실시간 서비스입니다. 두 시장을 한 번에 보실 때 사용하십시오.\n\ntr_cd 에 \"ohhts_unt_cntg\", tr_key 에 종목 단축코드 여섯 자리(예: 005930)를 넣어 구독하십시오.\n\n항목 구성은 시장별 현재가와 같고 exch_code 가 하나 더 있습니다. 어느 시장에서 일어난 체결인지는 이 항목으로 가려내십시오.\n\n실시간 서비스는 접속점이 하나입니다. 접속하신 뒤 보내는 구독 메시지의 body 안 tr_cd 로 어떤 데이터를 받을지 정합니다.\n\n구독은 header 의 tr_type 에 \"1\", 해지는 같은 tr_cd·tr_key 에 \"2\" 를 넣어 보냅니다. header 의 token 에는 발급받은 접근토큰을 \"Bearer \" 를 붙여 넣으십시오. 접두어가 없으면 EGW00202 로 거절됩니다.\n\n내려오는 메시지는 header 와 body 로 나뉩니다. 한 접속에서 여러 종목·여러 서비스를 구독하셨다면 header 의 tr_cd·tr_key 로 어느 구독의 데이터인지 가려내십시오.", "trs" : [ { "name" : "실시간 주식 현재가 (SOR 통합)", "code" : "ohhts_unt_cntg", "request" : { "header" : [ ], "body" : [ { "element" : "header", "name" : "헤더부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "구독 메시지의 헤더입니다.", "depth" : 0 }, { "element" : "token", "name" : "접근토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "발급받은 접근토큰에 \"Bearer \" 를 붙여 넣습니다. 세션 한도를 넘기면 WSC00110 이 내려옵니다.", "depth" : 0 }, { "element" : "tr_type", "name" : "거래타입", "type" : "String", "required" : "Y", "length" : "1", "description" : "\"1\" 구독 등록 / \"2\" 구독 해지. 해지는 등록과 같은 tr_cd·tr_key 로 보냅니다.", "depth" : 0 }, { "element" : "body", "name" : "바디부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "구독 대상을 지정합니다.", "depth" : 0 }, { "element" : "tr_cd", "name" : "거래코드", "type" : "String", "required" : "Y", "length" : "20", "description" : "이 API 의 구독 코드입니다. \"ohhts_unt_cntg\" 를 넣으십시오.", "depth" : 0 }, { "element" : "tr_key", "name" : "단축종목코드", "type" : "String", "required" : "Y", "length" : "9", "description" : "구독할 종목의 단축코드 6자리입니다. 예) 005930", "depth" : 0 } ] }, "response" : { "header" : [ ], "body" : [ { "element" : "header", "name" : "헤더부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "어느 구독의 데이터인지 알려줍니다. 한 세션에서 여러 종목을 구독했을 때 이 값으로 구분하십시오.", "depth" : 0 }, { "element" : "tr_cd", "name" : "거래코드", "type" : "String", "required" : "Y", "length" : "20", "description" : "구독 요청에 넣은 tr_cd 가 그대로 옵니다.", "depth" : 0 }, { "element" : "tr_key", "name" : "단축종목코드", "type" : "String", "required" : "Y", "length" : "9", "description" : "구독 요청에 넣은 tr_key 가 그대로 옵니다.", "depth" : 0 }, { "element" : "body", "name" : "바디부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "KRX 와 대체거래소(NXT) 체결을 함께 받는 국내주식 시세입니다. 어느 거래소의 체결인지는 함께 오는 거래소코드(exch_code)로 가르십시오.", "depth" : 0 }, { "element" : "shrn_iscd", "name" : "단축종목코드", "type" : "String", "required" : "Y", "length" : "9", "description" : "구독한 종목의 단축코드입니다.", "depth" : 0 }, { "element" : "bsop_hour", "name" : "영업시간", "type" : "String", "required" : "Y", "length" : "6", "description" : "체결이 일어난 시각입니다. HHMMSS 6자리이며 한국시간 기준입니다.", "depth" : 0 }, { "element" : "hour_cls_code", "name" : "시간구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "장 구분입니다.\n\"0\": 장중\n\"B\": 장 개시 전 예상\n\"C\": 09시 이후 예상\n\"A\": 장 종료 후 예상\n\"D\": 시간외 단일가 예상", "depth" : 0 }, { "element" : "antc_nmix_cls_code", "name" : "예상지수구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "예상체결 여부를 나타내는 구분값입니다.", "depth" : 0 }, { "element" : "prpr", "name" : "현재가", "type" : "String", "required" : "Y", "length" : "11", "description" : "가장 최근 체결된 가격입니다. 이 메시지가 알리는 체결의 가격입니다.", "depth" : 0 }, { "element" : "prdy_vrss_sign", "name" : "전일대비부호", "type" : "String", "required" : "Y", "length" : "1", "description" : "전일 종가 대비 방향입니다. \"1\": 상한 \"2\": 상승 \"3\": 보합 \"4\": 하한 \"5\": 하락", "depth" : 0 }, { "element" : "prdy_vrss", "name" : "전일대비", "type" : "String", "required" : "Y", "length" : "11", "description" : "전일 종가와의 차이입니다.", "depth" : 0 }, { "element" : "prdy_ctrt", "name" : "전일대비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "전일 종가 대비 등락률(%)입니다.", "depth" : 0 }, { "element" : "oprc", "name" : "시가", "type" : "String", "required" : "Y", "length" : "11", "description" : "당일 첫 체결 가격입니다.", "depth" : 0 }, { "element" : "hprc", "name" : "고가", "type" : "String", "required" : "Y", "length" : "11", "description" : "당일 체결 중 가장 높았던 가격입니다.", "depth" : 0 }, { "element" : "lprc", "name" : "저가", "type" : "String", "required" : "Y", "length" : "11", "description" : "당일 체결 중 가장 낮았던 가격입니다.", "depth" : 0 }, { "element" : "cntg_cls_code", "name" : "체결구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "체결 유형입니다. \"1\": 매수 체결 · \"2\": 매도 체결. 값에 대응하는 이름은 통보에 함께 오지 않으므로 알 수 없는 값도 오류로 다루지 마십시오.", "depth" : 0 }, { "element" : "cntg_vol", "name" : "체결거래량", "type" : "String", "required" : "Y", "length" : "11", "description" : "이번 체결의 수량입니다. 누적이 아니라 건별 수량입니다.", "depth" : 0 }, { "element" : "acml_vol", "name" : "누적거래량", "type" : "String", "required" : "Y", "length" : "13", "description" : "누적 체결 수량입니다.", "depth" : 0 }, { "element" : "acml_tr_pbmn", "name" : "누적거래대금", "type" : "String", "required" : "Y", "length" : "13", "description" : "누적 체결 금액입니다.", "depth" : 0 }, { "element" : "wghn_avrg_stck_prc", "name" : "가중평균주식가격", "type" : "String", "required" : "Y", "length" : "11", "description" : "누적거래대금을 누적거래량으로 나눈 평균 단가입니다.", "depth" : 0 }, { "element" : "askp1", "name" : "매도호가1", "type" : "String", "required" : "Y", "length" : "11", "description" : "체결 시점의 최우선 매도호가입니다.", "depth" : 0 }, { "element" : "bidp1", "name" : "매수호가1", "type" : "String", "required" : "Y", "length" : "11", "description" : "체결 시점의 최우선 매수호가입니다.", "depth" : 0 }, { "element" : "askp_rsqn1", "name" : "매도호가잔량1", "type" : "String", "required" : "Y", "length" : "13", "description" : "최우선 매도호가에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "bidp_rsqn1", "name" : "매수호가잔량1", "type" : "String", "required" : "Y", "length" : "13", "description" : "최우선 매수호가에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "total_askp_rsqn", "name" : "총매도호가잔량", "type" : "String", "required" : "Y", "length" : "13", "description" : "호가창 전체의 매도 잔량 합입니다.", "depth" : 0 }, { "element" : "total_bidp_rsqn", "name" : "총매수호가잔량", "type" : "String", "required" : "Y", "length" : "13", "description" : "호가창 전체의 매수 잔량 합입니다.", "depth" : 0 }, { "element" : "rltv", "name" : "체결강도", "type" : "String", "required" : "Y", "length" : "9", "description" : "체결강도입니다.", "depth" : 0 }, { "element" : "shnu_rate", "name" : "매수비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "전체 체결 중 매수 체결이 차지하는 비율(%)입니다.", "depth" : 0 }, { "element" : "trht_yn", "name" : "거래정지여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "거래정지 여부입니다.\n\"Y\": 거래정지\n\"N\": 정상 거래", "depth" : 0 }, { "element" : "prdy_vrss_vol_rate", "name" : "전일대비거래량비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "전일 같은 시점의 누적거래량 대비 오늘 누적거래량의 비율(%)입니다.", "depth" : 0 }, { "element" : "prdy_smns_hour_vol_rate", "name" : "전일동일시간거래량비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "전일 같은 시간대의 거래량 대비 비율(%)입니다.", "depth" : 0 }, { "element" : "mkop_clcd", "name" : "신장운영구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "장 운영 상태를 나타내는 코드입니다. 값에 대응하는 이름은 통보에 함께 오지 않으므로 알 수 없는 값도 오류로 다루지 마십시오.", "depth" : 0 }, { "element" : "exch_code", "name" : "거래소코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "이번 체결이 이루어진 거래소입니다. 값에 대응하는 이름은 통보에 함께 오지 않습니다.", "depth" : 0 } ] }, "requestExample" : "{\n \"header\": {\n \"token\": \"Bearer {Token값}\",\n \"tr_type\": \"1\"\n },\n \"body\": {\n \"tr_cd\": \"ohhts_unt_cntg\",\n \"tr_key\": \"005930\"\n }\n}", "responseExample" : "{\n \"header\": {\n \"tr_cd\": \"ohhts_unt_cntg\",\n \"tr_key\": \"005930\"\n },\n \"body\": {\n \"shrn_iscd\": \"005930\",\n \"bsop_hour\": \"104304\",\n \"hour_cls_code\": \"0\",\n \"antc_nmix_cls_code\": \"1\",\n \"prpr\": \"265000\",\n \"prdy_vrss_sign\": \"2\",\n \"prdy_vrss\": \"3500\",\n \"prdy_ctrt\": \"1.34\",\n \"oprc\": \"269000\",\n \"hprc\": \"272000\",\n \"lprc\": \"262500\",\n \"cntg_cls_code\": \"1\",\n \"cntg_vol\": \"10\",\n \"acml_vol\": \"15219368\",\n \"acml_tr_pbmn\": \"4072752223250\",\n \"wghn_avrg_stck_prc\": \"267603\",\n \"askp1\": \"265500\",\n \"bidp1\": \"265000\",\n \"askp_rsqn1\": \"11611\",\n \"bidp_rsqn1\": \"71509\",\n \"total_askp_rsqn\": \"1399605\",\n \"total_bidp_rsqn\": \"726954\",\n \"rltv\": \"81.61\",\n \"shnu_rate\": \"0.00\",\n \"trht_yn\": \"N\",\n \"prdy_vrss_vol_rate\": \"49.98\",\n \"prdy_smns_hour_vol_rate\": \"145.90\",\n \"mkop_clcd\": \"20\",\n \"exch_code\": \"2\"\n }\n}" } ] }, { "name" : "(실시간) 국내주식 현재가 (KRX)", "protocol" : "WEBSOCKET", "method" : "POST", "domain" : "wss://openapi.imeritz.com:29443", "url" : "/websocket", "format" : "JSON", "contentType" : "application/json", "description" : "국내주식 정규시장(KRX)에서 체결이 일어날 때마다 그 체결의 가격·수량과 최우선 호가를 한 건씩 내려보내는 실시간 서비스입니다.\n\ntr_cd 에 \"ohhts_stck_cntg\", tr_key 에 종목 단축코드 여섯 자리(예: 005930)를 넣어 구독하십시오.\n\n조회 API 와 항목 이름이 다릅니다. 현재가는 prpr, 이번 체결의 수량은 cntg_vol, 장 시작부터의 누적 수량은 acml_vol 입니다. 전일 대비 금액 prdy_vrss 에는 부호가 붙지 않으므로 방향은 prdy_vrss_sign 으로 판단하십시오.\n\n실시간 서비스는 접속점이 하나입니다. 접속하신 뒤 보내는 구독 메시지의 body 안 tr_cd 로 어떤 데이터를 받을지 정합니다.\n\n구독은 header 의 tr_type 에 \"1\", 해지는 같은 tr_cd·tr_key 에 \"2\" 를 넣어 보냅니다. header 의 token 에는 발급받은 접근토큰을 \"Bearer \" 를 붙여 넣으십시오. 접두어가 없으면 EGW00202 로 거절됩니다.\n\n내려오는 메시지는 header 와 body 로 나뉩니다. 한 접속에서 여러 종목·여러 서비스를 구독하셨다면 header 의 tr_cd·tr_key 로 어느 구독의 데이터인지 가려내십시오.", "trs" : [ { "name" : "실시간 주식 현재가 (정규)", "code" : "ohhts_stck_cntg", "request" : { "header" : [ ], "body" : [ { "element" : "header", "name" : "헤더부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "구독 메시지의 헤더입니다.", "depth" : 0 }, { "element" : "token", "name" : "접근토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "발급받은 접근토큰에 \"Bearer \" 를 붙여 넣습니다. 세션 한도를 넘기면 WSC00110 이 내려옵니다.", "depth" : 0 }, { "element" : "tr_type", "name" : "거래타입", "type" : "String", "required" : "Y", "length" : "1", "description" : "\"1\" 구독 등록 / \"2\" 구독 해지. 해지는 등록과 같은 tr_cd·tr_key 로 보냅니다.", "depth" : 0 }, { "element" : "body", "name" : "바디부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "구독 대상을 지정합니다.", "depth" : 0 }, { "element" : "tr_cd", "name" : "거래코드", "type" : "String", "required" : "Y", "length" : "20", "description" : "이 API 의 구독 코드입니다. \"ohhts_stck_cntg\" 를 넣으십시오.\n허용되지 않는 tr_cd 는 WSC00106, tr_key 를 빼면 WSC00108, 빈 값이면 WSC00107 로 거절됩니다.", "depth" : 0 }, { "element" : "tr_key", "name" : "단축종목코드", "type" : "String", "required" : "Y", "length" : "9", "description" : "구독할 종목의 단축코드 6자리입니다. 예) 005930\n없는 코드나 자릿수가 다른 값을 넣으셔도 구독 응답은 정상(00000)으로 옵니다.", "depth" : 0 } ] }, "response" : { "header" : [ ], "body" : [ { "element" : "header", "name" : "헤더부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "어느 구독의 데이터인지 알려줍니다. 한 세션에서 여러 종목을 구독했을 때 이 값으로 구분하십시오.", "depth" : 0 }, { "element" : "tr_cd", "name" : "거래코드", "type" : "String", "required" : "Y", "length" : "20", "description" : "구독 요청에 넣은 tr_cd 가 그대로 옵니다.", "depth" : 0 }, { "element" : "tr_key", "name" : "단축종목코드", "type" : "String", "required" : "Y", "length" : "9", "description" : "구독 요청에 넣은 tr_key 가 그대로 옵니다.", "depth" : 0 }, { "element" : "body", "name" : "바디부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "KRX 체결 시세입니다. 건별 체결수량과 누적거래량·누적거래대금·최우선 호가가 담깁니다.", "depth" : 0 }, { "element" : "shrn_iscd", "name" : "단축종목코드", "type" : "String", "required" : "Y", "length" : "9", "description" : "구독한 종목의 단축코드입니다.", "depth" : 0 }, { "element" : "bsop_hour", "name" : "영업시간", "type" : "String", "required" : "Y", "length" : "6", "description" : "체결이 일어난 시각입니다. HHMMSS 6자리이며 한국시간 기준입니다.", "depth" : 0 }, { "element" : "hour_cls_code", "name" : "시간구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "장 구분입니다.\n\"0\": 장중\n\"B\": 장 개시 전 예상\n\"C\": 09시 이후 예상\n\"A\": 장 종료 후 예상\n\"D\": 시간외 단일가 예상", "depth" : 0 }, { "element" : "antc_nmix_cls_code", "name" : "예상지수구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "예상체결 여부를 나타내는 구분값입니다.", "depth" : 0 }, { "element" : "prpr", "name" : "현재가", "type" : "String", "required" : "Y", "length" : "11", "description" : "가장 최근 체결된 가격입니다. 이 메시지가 알리는 체결의 가격입니다.", "depth" : 0 }, { "element" : "prdy_vrss_sign", "name" : "전일대비부호", "type" : "String", "required" : "Y", "length" : "1", "description" : "전일 종가 대비 방향입니다. \"1\": 상한 \"2\": 상승 \"3\": 보합 \"4\": 하한 \"5\": 하락", "depth" : 0 }, { "element" : "prdy_vrss", "name" : "전일대비", "type" : "String", "required" : "Y", "length" : "11", "description" : "전일 종가와의 차이입니다.", "depth" : 0 }, { "element" : "prdy_ctrt", "name" : "전일대비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "전일 종가 대비 등락률(%)입니다.", "depth" : 0 }, { "element" : "oprc", "name" : "시가", "type" : "String", "required" : "Y", "length" : "11", "description" : "당일 첫 체결 가격입니다.", "depth" : 0 }, { "element" : "hprc", "name" : "고가", "type" : "String", "required" : "Y", "length" : "11", "description" : "당일 체결 중 가장 높았던 가격입니다.", "depth" : 0 }, { "element" : "lprc", "name" : "저가", "type" : "String", "required" : "Y", "length" : "11", "description" : "당일 체결 중 가장 낮았던 가격입니다.", "depth" : 0 }, { "element" : "cntg_cls_code", "name" : "체결구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "체결 유형입니다. \"1\": 매수 체결 · \"2\": 매도 체결. 값에 대응하는 이름은 통보에 함께 오지 않으므로 알 수 없는 값도 오류로 다루지 마십시오.", "depth" : 0 }, { "element" : "cntg_vol", "name" : "체결거래량", "type" : "String", "required" : "Y", "length" : "11", "description" : "이번 체결의 수량입니다. 누적이 아니라 건별 수량입니다.", "depth" : 0 }, { "element" : "acml_vol", "name" : "누적거래량", "type" : "String", "required" : "Y", "length" : "13", "description" : "누적 체결 수량입니다.", "depth" : 0 }, { "element" : "acml_tr_pbmn", "name" : "누적거래대금", "type" : "String", "required" : "Y", "length" : "13", "description" : "누적 체결 금액입니다.", "depth" : 0 }, { "element" : "wghn_avrg_stck_prc", "name" : "가중평균주식가격", "type" : "String", "required" : "Y", "length" : "11", "description" : "누적거래대금을 누적거래량으로 나눈 평균 단가입니다.", "depth" : 0 }, { "element" : "askp1", "name" : "매도호가1", "type" : "String", "required" : "Y", "length" : "11", "description" : "체결 시점의 최우선 매도호가입니다.", "depth" : 0 }, { "element" : "bidp1", "name" : "매수호가1", "type" : "String", "required" : "Y", "length" : "11", "description" : "체결 시점의 최우선 매수호가입니다.", "depth" : 0 }, { "element" : "askp_rsqn1", "name" : "매도호가잔량1", "type" : "String", "required" : "Y", "length" : "13", "description" : "최우선 매도호가에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "bidp_rsqn1", "name" : "매수호가잔량1", "type" : "String", "required" : "Y", "length" : "13", "description" : "최우선 매수호가에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "total_askp_rsqn", "name" : "총매도호가잔량", "type" : "String", "required" : "Y", "length" : "13", "description" : "호가창 전체의 매도 잔량 합입니다.", "depth" : 0 }, { "element" : "total_bidp_rsqn", "name" : "총매수호가잔량", "type" : "String", "required" : "Y", "length" : "13", "description" : "호가창 전체의 매수 잔량 합입니다.", "depth" : 0 }, { "element" : "rltv", "name" : "체결강도", "type" : "String", "required" : "Y", "length" : "9", "description" : "체결강도입니다.", "depth" : 0 }, { "element" : "shnu_rate", "name" : "매수비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "전체 체결 중 매수 체결이 차지하는 비율(%)입니다.", "depth" : 0 }, { "element" : "trht_yn", "name" : "거래정지여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "거래정지 여부입니다.\n\"Y\": 거래정지\n\"N\": 정상 거래", "depth" : 0 }, { "element" : "prdy_vrss_vol_rate", "name" : "전일대비거래량비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "전일 같은 시점의 누적거래량 대비 오늘 누적거래량의 비율(%)입니다.", "depth" : 0 }, { "element" : "prdy_smns_hour_vol_rate", "name" : "전일동일시간거래량비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "전일 같은 시간대의 거래량 대비 비율(%)입니다.", "depth" : 0 }, { "element" : "mkop_clcd", "name" : "신장운영구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "장 운영 상태를 나타내는 코드입니다. 값에 대응하는 이름은 통보에 함께 오지 않으므로 알 수 없는 값도 오류로 다루지 마십시오.", "depth" : 0 } ] }, "requestExample" : "{\n \"header\": {\n \"token\": \"Bearer {Token값}\",\n \"tr_type\": \"1\"\n },\n \"body\": {\n \"tr_cd\": \"ohhts_stck_cntg\",\n \"tr_key\": \"005930\"\n }\n}", "responseExample" : "{\n \"header\": {\n \"tr_cd\": \"ohhts_stck_cntg\",\n \"tr_key\": \"005930\"\n },\n \"body\": {\n \"shrn_iscd\": \"005930\",\n \"bsop_hour\": \"104304\",\n \"hour_cls_code\": \"0\",\n \"antc_nmix_cls_code\": \"1\",\n \"prpr\": \"265250\",\n \"prdy_vrss_sign\": \"2\",\n \"prdy_vrss\": \"3750\",\n \"prdy_ctrt\": \"1.43\",\n \"oprc\": \"270000\",\n \"hprc\": \"271000\",\n \"lprc\": \"262500\",\n \"cntg_cls_code\": \"1\",\n \"cntg_vol\": \"10\",\n \"acml_vol\": \"7190656\",\n \"acml_tr_pbmn\": \"1920226409250\",\n \"wghn_avrg_stck_prc\": \"267044\",\n \"askp1\": \"265500\",\n \"bidp1\": \"265000\",\n \"askp_rsqn1\": \"5819\",\n \"bidp_rsqn1\": \"44766\",\n \"total_askp_rsqn\": \"700734\",\n \"total_bidp_rsqn\": \"393927\",\n \"rltv\": \"79.12\",\n \"shnu_rate\": \"0.00\",\n \"trht_yn\": \"N\",\n \"prdy_vrss_vol_rate\": \"36.81\",\n \"prdy_smns_hour_vol_rate\": \"116.28\",\n \"mkop_clcd\": \"20\"\n }\n}" } ] }, { "name" : "(실시간) 국내주식 현재가 (NXT)", "protocol" : "WEBSOCKET", "method" : "POST", "domain" : "wss://openapi.imeritz.com:29443", "url" : "/websocket", "format" : "JSON", "contentType" : "application/json", "description" : "국내주식 대체거래소(NXT)에서 체결이 일어날 때마다 그 체결의 가격·수량과 최우선 호가를 한 건씩 내려보내는 실시간 서비스입니다. 같은 종목이라도 정규시장(KRX) 체결은 이 서비스로 오지 않으므로, 두 시장을 함께 보시려면 각각 구독하십시오.\n\ntr_cd 에 \"ohhts_nxt_cntg\", tr_key 에 종목 단축코드 여섯 자리(예: 005930)를 넣어 구독하십시오.\n\n항목 구성은 정규시장(KRX) 현재가와 같습니다. 누적거래량 acml_vol 은 이 시장에서 체결된 수량만 더한 값입니다.\n\n실시간 서비스는 접속점이 하나입니다. 접속하신 뒤 보내는 구독 메시지의 body 안 tr_cd 로 어떤 데이터를 받을지 정합니다.\n\n구독은 header 의 tr_type 에 \"1\", 해지는 같은 tr_cd·tr_key 에 \"2\" 를 넣어 보냅니다. header 의 token 에는 발급받은 접근토큰을 \"Bearer \" 를 붙여 넣으십시오. 접두어가 없으면 EGW00202 로 거절됩니다.\n\n내려오는 메시지는 header 와 body 로 나뉩니다. 한 접속에서 여러 종목·여러 서비스를 구독하셨다면 header 의 tr_cd·tr_key 로 어느 구독의 데이터인지 가려내십시오.", "trs" : [ { "name" : "실시간 주식 현재가 (NXT)", "code" : "ohhts_nxt_cntg", "request" : { "header" : [ ], "body" : [ { "element" : "header", "name" : "헤더부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "구독 메시지의 헤더입니다.", "depth" : 0 }, { "element" : "token", "name" : "접근토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "발급받은 접근토큰에 \"Bearer \" 를 붙여 넣습니다. 세션 한도를 넘기면 WSC00110 이 내려옵니다.", "depth" : 0 }, { "element" : "tr_type", "name" : "거래타입", "type" : "String", "required" : "Y", "length" : "1", "description" : "\"1\" 구독 등록 / \"2\" 구독 해지. 해지는 등록과 같은 tr_cd·tr_key 로 보냅니다.", "depth" : 0 }, { "element" : "body", "name" : "바디부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "구독 대상을 지정합니다.", "depth" : 0 }, { "element" : "tr_cd", "name" : "거래코드", "type" : "String", "required" : "Y", "length" : "20", "description" : "이 API 의 구독 코드입니다. \"ohhts_nxt_cntg\" 를 넣으십시오.", "depth" : 0 }, { "element" : "tr_key", "name" : "단축종목코드", "type" : "String", "required" : "Y", "length" : "9", "description" : "구독할 종목의 단축코드 6자리입니다. 예) 005930", "depth" : 0 } ] }, "response" : { "header" : [ ], "body" : [ { "element" : "header", "name" : "헤더부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "어느 구독의 데이터인지 알려줍니다. 한 세션에서 여러 종목을 구독했을 때 이 값으로 구분하십시오.", "depth" : 0 }, { "element" : "tr_cd", "name" : "거래코드", "type" : "String", "required" : "Y", "length" : "20", "description" : "구독 요청에 넣은 tr_cd 가 그대로 옵니다.", "depth" : 0 }, { "element" : "tr_key", "name" : "단축종목코드", "type" : "String", "required" : "Y", "length" : "9", "description" : "구독 요청에 넣은 tr_key 가 그대로 옵니다.", "depth" : 0 }, { "element" : "body", "name" : "바디부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "NXT 체결 시세입니다.", "depth" : 0 }, { "element" : "shrn_iscd", "name" : "단축종목코드", "type" : "String", "required" : "Y", "length" : "9", "description" : "구독한 종목의 단축코드입니다.", "depth" : 0 }, { "element" : "bsop_hour", "name" : "영업시간", "type" : "String", "required" : "Y", "length" : "6", "description" : "체결이 일어난 시각입니다. HHMMSS 6자리이며 한국시간 기준입니다.", "depth" : 0 }, { "element" : "hour_cls_code", "name" : "시간구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "장 구분입니다.\n\"0\": 장중\n\"B\": 장 개시 전 예상\n\"C\": 09시 이후 예상\n\"A\": 장 종료 후 예상\n\"D\": 시간외 단일가 예상", "depth" : 0 }, { "element" : "antc_nmix_cls_code", "name" : "예상지수구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "예상체결 여부를 나타내는 구분값입니다.", "depth" : 0 }, { "element" : "prpr", "name" : "현재가", "type" : "String", "required" : "Y", "length" : "11", "description" : "가장 최근 체결된 가격입니다. 이 메시지가 알리는 체결의 가격입니다.", "depth" : 0 }, { "element" : "prdy_vrss_sign", "name" : "전일대비부호", "type" : "String", "required" : "Y", "length" : "1", "description" : "전일 종가 대비 방향입니다. \"1\": 상한 \"2\": 상승 \"3\": 보합 \"4\": 하한 \"5\": 하락", "depth" : 0 }, { "element" : "prdy_vrss", "name" : "전일대비", "type" : "String", "required" : "Y", "length" : "11", "description" : "전일 종가와의 차이입니다.", "depth" : 0 }, { "element" : "prdy_ctrt", "name" : "전일대비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "전일 종가 대비 등락률(%)입니다.", "depth" : 0 }, { "element" : "oprc", "name" : "시가", "type" : "String", "required" : "Y", "length" : "11", "description" : "당일 첫 체결 가격입니다.", "depth" : 0 }, { "element" : "hprc", "name" : "고가", "type" : "String", "required" : "Y", "length" : "11", "description" : "당일 체결 중 가장 높았던 가격입니다.", "depth" : 0 }, { "element" : "lprc", "name" : "저가", "type" : "String", "required" : "Y", "length" : "11", "description" : "당일 체결 중 가장 낮았던 가격입니다.", "depth" : 0 }, { "element" : "cntg_cls_code", "name" : "체결구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "체결 유형입니다. \"1\": 매수 체결 · \"2\": 매도 체결. 값에 대응하는 이름은 통보에 함께 오지 않으므로 알 수 없는 값도 오류로 다루지 마십시오.", "depth" : 0 }, { "element" : "cntg_vol", "name" : "체결거래량", "type" : "String", "required" : "Y", "length" : "11", "description" : "이번 체결의 수량입니다. 누적이 아니라 건별 수량입니다.", "depth" : 0 }, { "element" : "acml_vol", "name" : "누적거래량", "type" : "String", "required" : "Y", "length" : "13", "description" : "누적 체결 수량입니다.", "depth" : 0 }, { "element" : "acml_tr_pbmn", "name" : "누적거래대금", "type" : "String", "required" : "Y", "length" : "13", "description" : "누적 체결 금액입니다.", "depth" : 0 }, { "element" : "wghn_avrg_stck_prc", "name" : "가중평균주식가격", "type" : "String", "required" : "Y", "length" : "11", "description" : "누적거래대금을 누적거래량으로 나눈 평균 단가입니다.", "depth" : 0 }, { "element" : "askp1", "name" : "매도호가1", "type" : "String", "required" : "Y", "length" : "11", "description" : "체결 시점의 최우선 매도호가입니다.", "depth" : 0 }, { "element" : "bidp1", "name" : "매수호가1", "type" : "String", "required" : "Y", "length" : "11", "description" : "체결 시점의 최우선 매수호가입니다.", "depth" : 0 }, { "element" : "askp_rsqn1", "name" : "매도호가잔량1", "type" : "String", "required" : "Y", "length" : "13", "description" : "최우선 매도호가에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "bidp_rsqn1", "name" : "매수호가잔량1", "type" : "String", "required" : "Y", "length" : "13", "description" : "최우선 매수호가에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "total_askp_rsqn", "name" : "총매도호가잔량", "type" : "String", "required" : "Y", "length" : "13", "description" : "호가창 전체의 매도 잔량 합입니다.", "depth" : 0 }, { "element" : "total_bidp_rsqn", "name" : "총매수호가잔량", "type" : "String", "required" : "Y", "length" : "13", "description" : "호가창 전체의 매수 잔량 합입니다.", "depth" : 0 }, { "element" : "rltv", "name" : "체결강도", "type" : "String", "required" : "Y", "length" : "9", "description" : "체결강도입니다.", "depth" : 0 }, { "element" : "shnu_rate", "name" : "매수비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "전체 체결 중 매수 체결이 차지하는 비율(%)입니다.", "depth" : 0 }, { "element" : "trht_yn", "name" : "거래정지여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "거래정지 여부입니다.\n\"Y\": 거래정지\n\"N\": 정상 거래", "depth" : 0 }, { "element" : "prdy_vrss_vol_rate", "name" : "전일대비거래량비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "전일 같은 시점의 누적거래량 대비 오늘 누적거래량의 비율(%)입니다.", "depth" : 0 }, { "element" : "prdy_smns_hour_vol_rate", "name" : "전일동일시간거래량비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "전일 같은 시간대의 거래량 대비 비율(%)입니다.", "depth" : 0 }, { "element" : "mkop_clcd", "name" : "신장운영구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "장 운영 상태를 나타내는 코드입니다. 값에 대응하는 이름은 통보에 함께 오지 않으므로 알 수 없는 값도 오류로 다루지 마십시오.", "depth" : 0 } ] }, "requestExample" : "{\n \"header\": {\n \"token\": \"Bearer {Token값}\",\n \"tr_type\": \"1\"\n },\n \"body\": {\n \"tr_cd\": \"ohhts_nxt_cntg\",\n \"tr_key\": \"005930\"\n }\n}", "responseExample" : "{\n \"header\": {\n \"tr_cd\": \"ohhts_nxt_cntg\",\n \"tr_key\": \"005930\"\n },\n \"body\": {\n \"shrn_iscd\": \"005930\",\n \"bsop_hour\": \"104304\",\n \"hour_cls_code\": \"0\",\n \"antc_nmix_cls_code\": \"1\",\n \"prpr\": \"265500\",\n \"prdy_vrss_sign\": \"2\",\n \"prdy_vrss\": \"4000\",\n \"prdy_ctrt\": \"1.53\",\n \"oprc\": \"269000\",\n \"hprc\": \"272000\",\n \"lprc\": \"262500\",\n \"cntg_cls_code\": \"1\",\n \"cntg_vol\": \"10\",\n \"acml_vol\": \"8028606\",\n \"acml_tr_pbmn\": \"2152497701750\",\n \"wghn_avrg_stck_prc\": \"268103\",\n \"askp1\": \"265500\",\n \"bidp1\": \"265000\",\n \"askp_rsqn1\": \"5876\",\n \"bidp_rsqn1\": \"26770\",\n \"total_askp_rsqn\": \"700448\",\n \"total_bidp_rsqn\": \"333015\",\n \"rltv\": \"83.77\",\n \"shnu_rate\": \"0.00\",\n \"trht_yn\": \"N\",\n \"prdy_vrss_vol_rate\": \"73.55\",\n \"prdy_smns_hour_vol_rate\": \"189.16\",\n \"mkop_clcd\": \"20\"\n }\n}" } ] }, { "name" : "(실시간) 국내주식 현재가 (시간외단일가)", "protocol" : "WEBSOCKET", "method" : "POST", "domain" : "wss://openapi.imeritz.com:29443", "url" : "/websocket", "format" : "JSON", "contentType" : "application/json", "description" : "국내주식 시간외 단일가 시간대(장 종료 뒤)의 체결을 내려보내는 실시간 서비스입니다.", "trs" : [ { "name" : "실시간 주식 현재가 (시간외단일가)", "code" : "ohhts_ovtp_cntg", "request" : { "header" : [ ], "body" : [ { "element" : "header", "name" : "헤더부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "구독 메시지의 헤더입니다.", "depth" : 0 }, { "element" : "token", "name" : "접근토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "발급받은 접근토큰에 \"Bearer \" 를 붙여 넣습니다. 세션 한도를 넘기면 WSC00110 이 내려옵니다.", "depth" : 0 }, { "element" : "tr_type", "name" : "거래타입", "type" : "String", "required" : "Y", "length" : "1", "description" : "\"1\" 구독 등록 / \"2\" 구독 해지. 해지는 등록과 같은 tr_cd·tr_key 로 보냅니다.", "depth" : 0 }, { "element" : "body", "name" : "바디부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "구독 대상을 지정합니다.", "depth" : 0 }, { "element" : "tr_cd", "name" : "거래코드", "type" : "String", "required" : "Y", "length" : "20", "description" : "이 API 의 구독 코드입니다. \"ohhts_ovtp_cntg\" 를 넣으십시오.", "depth" : 0 }, { "element" : "tr_key", "name" : "단축종목코드", "type" : "String", "required" : "Y", "length" : "9", "description" : "구독할 종목의 단축코드 6자리입니다. 예) 005930", "depth" : 0 } ] }, "response" : { "header" : [ ], "body" : [ { "element" : "header", "name" : "헤더부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "어느 구독의 데이터인지 알려줍니다. 한 세션에서 여러 종목을 구독했을 때 이 값으로 구분하십시오.", "depth" : 0 }, { "element" : "tr_cd", "name" : "거래코드", "type" : "String", "required" : "Y", "length" : "20", "description" : "구독 요청에 넣은 tr_cd 가 그대로 옵니다.", "depth" : 0 }, { "element" : "tr_key", "name" : "단축종목코드", "type" : "String", "required" : "Y", "length" : "9", "description" : "구독 요청에 넣은 tr_key 가 그대로 옵니다.", "depth" : 0 }, { "element" : "body", "name" : "바디부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "시간외 단일가로 체결된 국내주식 시세입니다.", "depth" : 0 }, { "element" : "shrn_iscd", "name" : "단축종목코드", "type" : "String", "required" : "Y", "length" : "9", "description" : "구독한 종목의 단축코드입니다.", "depth" : 0 }, { "element" : "bsop_hour", "name" : "영업시간", "type" : "String", "required" : "Y", "length" : "6", "description" : "체결이 일어난 시각입니다. HHMMSS 6자리이며 한국시간 기준입니다.", "depth" : 0 }, { "element" : "hour_cls_code", "name" : "시간구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "장 구분입니다.\n\"0\": 장중\n\"B\": 장 개시 전 예상\n\"C\": 09시 이후 예상\n\"A\": 장 종료 후 예상\n\"D\": 시간외 단일가 예상", "depth" : 0 }, { "element" : "antc_nmix_cls_code", "name" : "예상지수구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "예상체결 여부를 나타내는 구분값입니다.", "depth" : 0 }, { "element" : "prpr", "name" : "현재가", "type" : "String", "required" : "Y", "length" : "11", "description" : "가장 최근 체결된 가격입니다. 이 메시지가 알리는 체결의 가격입니다.", "depth" : 0 }, { "element" : "prdy_vrss_sign", "name" : "전일대비부호", "type" : "String", "required" : "Y", "length" : "1", "description" : "전일 종가 대비 방향입니다.", "depth" : 0 }, { "element" : "prdy_vrss", "name" : "전일대비", "type" : "String", "required" : "Y", "length" : "11", "description" : "전일 종가와의 차이입니다.", "depth" : 0 }, { "element" : "prdy_ctrt", "name" : "전일대비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "전일 종가 대비 등락률(%)입니다.", "depth" : 0 }, { "element" : "oprc", "name" : "시가", "type" : "String", "required" : "Y", "length" : "11", "description" : "당일 첫 체결 가격입니다.", "depth" : 0 }, { "element" : "hprc", "name" : "고가", "type" : "String", "required" : "Y", "length" : "11", "description" : "당일 체결 중 가장 높았던 가격입니다.", "depth" : 0 }, { "element" : "lprc", "name" : "저가", "type" : "String", "required" : "Y", "length" : "11", "description" : "당일 체결 중 가장 낮았던 가격입니다.", "depth" : 0 }, { "element" : "cntg_cls_code", "name" : "체결구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "체결 유형입니다.", "depth" : 0 }, { "element" : "cntg_vol", "name" : "체결거래량", "type" : "String", "required" : "Y", "length" : "11", "description" : "이번 체결의 수량입니다. 누적이 아니라 건별 수량입니다.", "depth" : 0 }, { "element" : "acml_vol", "name" : "누적거래량", "type" : "String", "required" : "Y", "length" : "13", "description" : "누적 체결 수량입니다.", "depth" : 0 }, { "element" : "acml_tr_pbmn", "name" : "누적거래대금", "type" : "String", "required" : "Y", "length" : "13", "description" : "누적 체결 금액입니다.", "depth" : 0 }, { "element" : "wghn_avrg_stck_prc", "name" : "가중평균주식가격", "type" : "String", "required" : "Y", "length" : "11", "description" : "누적거래대금을 누적거래량으로 나눈 평균 단가입니다.", "depth" : 0 }, { "element" : "askp1", "name" : "매도호가1", "type" : "String", "required" : "Y", "length" : "11", "description" : "체결 시점의 최우선 매도호가입니다.", "depth" : 0 }, { "element" : "bidp1", "name" : "매수호가1", "type" : "String", "required" : "Y", "length" : "11", "description" : "체결 시점의 최우선 매수호가입니다.", "depth" : 0 }, { "element" : "askp_rsqn1", "name" : "매도호가잔량1", "type" : "String", "required" : "Y", "length" : "13", "description" : "최우선 매도호가에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "bidp_rsqn1", "name" : "매수호가잔량1", "type" : "String", "required" : "Y", "length" : "13", "description" : "최우선 매수호가에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "total_askp_rsqn", "name" : "총매도호가잔량", "type" : "String", "required" : "Y", "length" : "13", "description" : "호가창 전체의 매도 잔량 합입니다.", "depth" : 0 }, { "element" : "total_bidp_rsqn", "name" : "총매수호가잔량", "type" : "String", "required" : "Y", "length" : "13", "description" : "호가창 전체의 매수 잔량 합입니다.", "depth" : 0 }, { "element" : "rltv", "name" : "체결강도", "type" : "String", "required" : "Y", "length" : "9", "description" : "체결강도입니다.", "depth" : 0 }, { "element" : "shnu_rate", "name" : "매수비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "전체 체결 중 매수 체결이 차지하는 비율(%)입니다.", "depth" : 0 }, { "element" : "trht_yn", "name" : "거래정지여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "거래정지 여부입니다.\n\"Y\": 거래정지\n\"N\": 정상 거래", "depth" : 0 }, { "element" : "prdy_vrss_vol_rate", "name" : "전일대비거래량비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "전일 같은 시점의 누적거래량 대비 오늘 누적거래량의 비율(%)입니다.", "depth" : 0 }, { "element" : "prdy_smns_hour_vol_rate", "name" : "전일동일시간거래량비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "전일 같은 시간대의 거래량 대비 비율(%)입니다.", "depth" : 0 } ] }, "requestExample" : "{\n \"header\": {\n \"token\": \"Bearer {Token값}\",\n \"tr_type\": \"1\"\n },\n \"body\": {\n \"tr_cd\": \"ohhts_ovtp_cntg\",\n \"tr_key\": \"005930\"\n }\n}", "responseExample" : "{\n \"header\": {\n \"tr_cd\": \"ohhts_ovtp_cntg\",\n \"tr_key\": \"005930\"\n },\n \"body\": {\n \"shrn_iscd\": \"005930\",\n \"bsop_hour\": \"110925\",\n \"hour_cls_code\": \"0\",\n \"antc_nmix_cls_code\": \"1\",\n \"prpr\": \"267000\",\n \"prdy_vrss_sign\": \"2\",\n \"prdy_vrss\": \"5500\",\n \"prdy_ctrt\": \"2.10\",\n \"oprc\": \"270000\",\n \"hprc\": \"271000\",\n \"lprc\": \"262500\",\n \"cntg_cls_code\": \"1\",\n \"cntg_vol\": \"37\",\n \"acml_vol\": \"8016819\",\n \"acml_tr_pbmn\": \"2140348970750\",\n \"wghn_avrg_stck_prc\": \"266982\",\n \"askp1\": \"267500\",\n \"bidp1\": \"267000\",\n \"askp_rsqn1\": \"55220\",\n \"bidp_rsqn1\": \"7800\",\n \"total_askp_rsqn\": \"1198306\",\n \"total_bidp_rsqn\": \"288273\",\n \"rltv\": \"83.12\",\n \"shnu_rate\": \"0.00\",\n \"trht_yn\": \"N\",\n \"prdy_vrss_vol_rate\": \"41.04\",\n \"prdy_smns_hour_vol_rate\": \"115.95\"\n }\n}" } ] }, { "name" : "(실시간) 국내주식 호가", "protocol" : "WEBSOCKET", "method" : "POST", "domain" : "wss://openapi.imeritz.com:29443", "url" : "/websocket", "format" : "JSON", "contentType" : "application/json", "description" : "국내주식 정규시장의 호가창이 바뀔 때마다 매도·매수 10단계 호가와 잔량을 내려보내는 실시간 서비스입니다.\n\ntr_cd 에 \"ohhts_stck_aspr\", tr_key 에 종목 단축코드 여섯 자리(예: 005930)를 넣어 구독하십시오.\n\n호가는 askp1~askp10(매도)·bidp1~bidp10(매수), 잔량은 askp_rsqn1~10·bidp_rsqn1~10 입니다. 단일가 시간대에는 예상체결 항목(antc_cnpr·antc_cnqn·antc_vol)에 값이 담깁니다.\n\n실시간 서비스는 접속점이 하나입니다. 접속하신 뒤 보내는 구독 메시지의 body 안 tr_cd 로 어떤 데이터를 받을지 정합니다.\n\n구독은 header 의 tr_type 에 \"1\", 해지는 같은 tr_cd·tr_key 에 \"2\" 를 넣어 보냅니다. header 의 token 에는 발급받은 접근토큰을 \"Bearer \" 를 붙여 넣으십시오. 접두어가 없으면 EGW00202 로 거절됩니다.\n\n내려오는 메시지는 header 와 body 로 나뉩니다. 한 접속에서 여러 종목·여러 서비스를 구독하셨다면 header 의 tr_cd·tr_key 로 어느 구독의 데이터인지 가려내십시오.", "trs" : [ { "name" : "실시간 주식 호가 (정규)", "code" : "ohhts_stck_aspr", "request" : { "header" : [ ], "body" : [ { "element" : "header", "name" : "헤더부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "구독 메시지의 헤더입니다.", "depth" : 0 }, { "element" : "token", "name" : "접근토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "발급받은 접근토큰에 \"Bearer \" 를 붙여 넣습니다. 세션 한도를 넘기면 WSC00110 이 내려옵니다.", "depth" : 0 }, { "element" : "tr_type", "name" : "거래타입", "type" : "String", "required" : "Y", "length" : "1", "description" : "\"1\" 구독 등록 / \"2\" 구독 해지. 해지는 등록과 같은 tr_cd·tr_key 로 보냅니다.", "depth" : 0 }, { "element" : "body", "name" : "바디부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "구독 대상을 지정합니다.", "depth" : 0 }, { "element" : "tr_cd", "name" : "거래코드", "type" : "String", "required" : "Y", "length" : "20", "description" : "이 API 의 구독 코드입니다. \"ohhts_stck_aspr\" 를 넣으십시오.", "depth" : 0 }, { "element" : "tr_key", "name" : "단축종목코드", "type" : "String", "required" : "Y", "length" : "9", "description" : "구독할 종목의 단축코드 6자리입니다. 예) 005930", "depth" : 0 } ] }, "response" : { "header" : [ ], "body" : [ { "element" : "header", "name" : "헤더부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "어느 구독의 데이터인지 알려줍니다. 한 세션에서 여러 종목을 구독했을 때 이 값으로 구분하십시오.", "depth" : 0 }, { "element" : "tr_cd", "name" : "거래코드", "type" : "String", "required" : "Y", "length" : "20", "description" : "구독 요청에 넣은 tr_cd 가 그대로 옵니다.", "depth" : 0 }, { "element" : "tr_key", "name" : "단축종목코드", "type" : "String", "required" : "Y", "length" : "9", "description" : "구독 요청에 넣은 tr_key 가 그대로 옵니다.", "depth" : 0 }, { "element" : "body", "name" : "바디부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "호가 데이터입니다. 매도·매수 10단계 호가와 잔량이 담깁니다.", "depth" : 0 }, { "element" : "shrn_iscd", "name" : "단축종목코드", "type" : "String", "required" : "Y", "length" : "9", "description" : "구독한 종목의 단축코드입니다.", "depth" : 0 }, { "element" : "bsop_hour", "name" : "영업시간", "type" : "String", "required" : "Y", "length" : "6", "description" : "호가가 갱신된 시각입니다. HHMMSS 6자리, 한국시간입니다.", "depth" : 0 }, { "element" : "hour_cls_code", "name" : "시간구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "장 구분입니다.\n\"0\": 장중\n\"B\": 장 개시 전 예상\n\"C\": 09시 이후 예상\n\"A\": 장 종료 후 예상\n\"D\": 시간외 단일가 예상", "depth" : 0 }, { "element" : "askp1", "name" : "매도호가1", "type" : "String", "required" : "Y", "length" : "11", "description" : "1번째 매도호가입니다. askp1 이 최우선(가장 낮은) 매도호가입니다.", "depth" : 0 }, { "element" : "askp2", "name" : "매도호가2", "type" : "String", "required" : "Y", "length" : "11", "description" : "2번째 매도호가입니다.", "depth" : 0 }, { "element" : "askp3", "name" : "매도호가3", "type" : "String", "required" : "Y", "length" : "11", "description" : "3번째 매도호가입니다.", "depth" : 0 }, { "element" : "askp4", "name" : "매도호가4", "type" : "String", "required" : "Y", "length" : "11", "description" : "4번째 매도호가입니다.", "depth" : 0 }, { "element" : "askp5", "name" : "매도호가5", "type" : "String", "required" : "Y", "length" : "11", "description" : "5번째 매도호가입니다.", "depth" : 0 }, { "element" : "askp6", "name" : "매도호가6", "type" : "String", "required" : "Y", "length" : "11", "description" : "6번째 매도호가입니다.", "depth" : 0 }, { "element" : "askp7", "name" : "매도호가7", "type" : "String", "required" : "Y", "length" : "11", "description" : "7번째 매도호가입니다.", "depth" : 0 }, { "element" : "askp8", "name" : "매도호가8", "type" : "String", "required" : "Y", "length" : "11", "description" : "8번째 매도호가입니다.", "depth" : 0 }, { "element" : "askp9", "name" : "매도호가9", "type" : "String", "required" : "Y", "length" : "11", "description" : "9번째 매도호가입니다.", "depth" : 0 }, { "element" : "askp10", "name" : "매도호가10", "type" : "String", "required" : "Y", "length" : "11", "description" : "10번째 매도호가입니다.", "depth" : 0 }, { "element" : "bidp1", "name" : "매수호가1", "type" : "String", "required" : "Y", "length" : "11", "description" : "1번째 매수호가입니다. bidp1 이 최우선(가장 높은) 매수호가입니다.", "depth" : 0 }, { "element" : "bidp2", "name" : "매수호가2", "type" : "String", "required" : "Y", "length" : "11", "description" : "2번째 매수호가입니다.", "depth" : 0 }, { "element" : "bidp3", "name" : "매수호가3", "type" : "String", "required" : "Y", "length" : "11", "description" : "3번째 매수호가입니다.", "depth" : 0 }, { "element" : "bidp4", "name" : "매수호가4", "type" : "String", "required" : "Y", "length" : "11", "description" : "4번째 매수호가입니다.", "depth" : 0 }, { "element" : "bidp5", "name" : "매수호가5", "type" : "String", "required" : "Y", "length" : "11", "description" : "5번째 매수호가입니다.", "depth" : 0 }, { "element" : "bidp6", "name" : "매수호가6", "type" : "String", "required" : "Y", "length" : "11", "description" : "6번째 매수호가입니다.", "depth" : 0 }, { "element" : "bidp7", "name" : "매수호가7", "type" : "String", "required" : "Y", "length" : "11", "description" : "7번째 매수호가입니다.", "depth" : 0 }, { "element" : "bidp8", "name" : "매수호가8", "type" : "String", "required" : "Y", "length" : "11", "description" : "8번째 매수호가입니다.", "depth" : 0 }, { "element" : "bidp9", "name" : "매수호가9", "type" : "String", "required" : "Y", "length" : "11", "description" : "9번째 매수호가입니다.", "depth" : 0 }, { "element" : "bidp10", "name" : "매수호가10", "type" : "String", "required" : "Y", "length" : "11", "description" : "10번째 매수호가입니다.", "depth" : 0 }, { "element" : "askp_rsqn1", "name" : "매도호가잔량1", "type" : "String", "required" : "Y", "length" : "13", "description" : "askp1 에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "askp_rsqn2", "name" : "매도호가잔량2", "type" : "String", "required" : "Y", "length" : "13", "description" : "askp2 에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "askp_rsqn3", "name" : "매도호가잔량3", "type" : "String", "required" : "Y", "length" : "13", "description" : "askp3 에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "askp_rsqn4", "name" : "매도호가잔량4", "type" : "String", "required" : "Y", "length" : "13", "description" : "askp4 에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "askp_rsqn5", "name" : "매도호가잔량5", "type" : "String", "required" : "Y", "length" : "13", "description" : "askp5 에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "askp_rsqn6", "name" : "매도호가잔량6", "type" : "String", "required" : "Y", "length" : "13", "description" : "askp6 에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "askp_rsqn7", "name" : "매도호가잔량7", "type" : "String", "required" : "Y", "length" : "13", "description" : "askp7 에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "askp_rsqn8", "name" : "매도호가잔량8", "type" : "String", "required" : "Y", "length" : "13", "description" : "askp8 에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "askp_rsqn9", "name" : "매도호가잔량9", "type" : "String", "required" : "Y", "length" : "13", "description" : "askp9 에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "askp_rsqn10", "name" : "매도호가잔량10", "type" : "String", "required" : "Y", "length" : "13", "description" : "askp10 에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "bidp_rsqn1", "name" : "매수호가잔량1", "type" : "String", "required" : "Y", "length" : "13", "description" : "bidp1 에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "bidp_rsqn2", "name" : "매수호가잔량2", "type" : "String", "required" : "Y", "length" : "13", "description" : "bidp2 에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "bidp_rsqn3", "name" : "매수호가잔량3", "type" : "String", "required" : "Y", "length" : "13", "description" : "bidp3 에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "bidp_rsqn4", "name" : "매수호가잔량4", "type" : "String", "required" : "Y", "length" : "13", "description" : "bidp4 에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "bidp_rsqn5", "name" : "매수호가잔량5", "type" : "String", "required" : "Y", "length" : "13", "description" : "bidp5 에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "bidp_rsqn6", "name" : "매수호가잔량6", "type" : "String", "required" : "Y", "length" : "13", "description" : "bidp6 에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "bidp_rsqn7", "name" : "매수호가잔량7", "type" : "String", "required" : "Y", "length" : "13", "description" : "bidp7 에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "bidp_rsqn8", "name" : "매수호가잔량8", "type" : "String", "required" : "Y", "length" : "13", "description" : "bidp8 에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "bidp_rsqn9", "name" : "매수호가잔량9", "type" : "String", "required" : "Y", "length" : "13", "description" : "bidp9 에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "bidp_rsqn10", "name" : "매수호가잔량10", "type" : "String", "required" : "Y", "length" : "13", "description" : "bidp10 에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "total_askp_rsqn", "name" : "총매도호가잔량", "type" : "String", "required" : "Y", "length" : "13", "description" : "10단계 매도 잔량의 합입니다.", "depth" : 0 }, { "element" : "total_bidp_rsqn", "name" : "총매수호가잔량", "type" : "String", "required" : "Y", "length" : "13", "description" : "10단계 매수 잔량의 합입니다.", "depth" : 0 }, { "element" : "total_askp_rsqn_icdc", "name" : "총매도호가잔량증감", "type" : "String", "required" : "Y", "length" : "13", "description" : "직전 호가 대비 총매도잔량의 증감입니다.", "depth" : 0 }, { "element" : "total_bidp_rsqn_icdc", "name" : "총매수호가잔량증감", "type" : "String", "required" : "Y", "length" : "13", "description" : "직전 호가 대비 총매수잔량의 증감입니다.", "depth" : 0 }, { "element" : "ovtm_total_askp_rsqn", "name" : "시간외총매도호가잔량", "type" : "String", "required" : "Y", "length" : "13", "description" : "시간외 매도 잔량의 합입니다.", "depth" : 0 }, { "element" : "ovtm_total_bidp_rsqn", "name" : "시간외총매수호가잔량", "type" : "String", "required" : "Y", "length" : "13", "description" : "시간외 매수 잔량의 합입니다.", "depth" : 0 }, { "element" : "ovtm_total_askp_rsqn_icdc", "name" : "시간외총매도호가잔량증감", "type" : "String", "required" : "Y", "length" : "13", "description" : "직전 대비 시간외 매도잔량 증감입니다.", "depth" : 0 }, { "element" : "ovtm_total_bidp_rsqn_icdc", "name" : "시간외총매수호가잔량증감", "type" : "String", "required" : "Y", "length" : "13", "description" : "직전 대비 시간외 매수잔량 증감입니다.", "depth" : 0 }, { "element" : "antc_cnpr", "name" : "예상체결가", "type" : "String", "required" : "Y", "length" : "11", "description" : "지금 체결된다면 형성될 가격입니다. 실제 체결가가 아닙니다.", "depth" : 0 }, { "element" : "antc_cntg_vrss_sign", "name" : "예상체결대비부호", "type" : "String", "required" : "Y", "length" : "1", "description" : "예상체결가의 전일 종가 대비 방향입니다. \"1\": 상한 \"2\": 상승 \"3\": 보합 \"4\": 하한 \"5\": 하락.", "depth" : 0 }, { "element" : "antc_cntg_vrss", "name" : "예상체결대비", "type" : "String", "required" : "Y", "length" : "11", "description" : "예상체결가와 전일 종가의 차이입니다. 방향은 부호 필드로 확인합니다.", "depth" : 0 }, { "element" : "antc_cntg_prdy_ctrt", "name" : "예상체결전일대비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "예상체결가 기준 등락률(%)입니다.", "depth" : 0 }, { "element" : "antc_cnqn", "name" : "예상체결수량", "type" : "String", "required" : "Y", "length" : "12", "description" : "예상 체결 수량입니다.", "depth" : 0 }, { "element" : "antc_vol", "name" : "예상거래량", "type" : "String", "required" : "Y", "length" : "13", "description" : "예상 체결 기준 누적 거래량입니다.", "depth" : 0 }, { "element" : "acml_vol", "name" : "누적거래량", "type" : "String", "required" : "Y", "length" : "13", "description" : "누적 체결 수량입니다.", "depth" : 0 }, { "element" : "stck_deal_cls_code", "name" : "매매구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "매매 구분입니다.", "depth" : 0 }, { "element" : "wghn_avrg_stck_prc", "name" : "가중평균주식가격", "type" : "String", "required" : "Y", "length" : "11", "description" : "누적거래대금을 누적거래량으로 나눈 평균 단가입니다.", "depth" : 0 } ] }, "requestExample" : "{\n \"header\": {\n \"token\": \"Bearer {Token값}\",\n \"tr_type\": \"1\"\n },\n \"body\": {\n \"tr_cd\": \"ohhts_stck_aspr\",\n \"tr_key\": \"005930\"\n }\n}", "responseExample" : "{\n \"header\": {\n \"tr_cd\": \"ohhts_stck_aspr\",\n \"tr_key\": \"005930\"\n },\n \"body\": {\n \"shrn_iscd\": \"005930\",\n \"bsop_hour\": \"110926\",\n \"hour_cls_code\": \"0\",\n \"askp1\": \"100200\",\n \"askp2\": \"100300\",\n \"askp3\": \"100400\",\n \"askp4\": \"100500\",\n \"askp5\": \"100600\",\n \"askp6\": \"100700\",\n \"askp7\": \"100800\",\n \"askp8\": \"100900\",\n \"askp9\": \"101000\",\n \"askp10\": \"101100\",\n \"bidp1\": \"100000\",\n \"bidp2\": \"99900\",\n \"bidp3\": \"99800\",\n \"bidp4\": \"99700\",\n \"bidp5\": \"99600\",\n \"bidp6\": \"99500\",\n \"bidp7\": \"99400\",\n \"bidp8\": \"99300\",\n \"bidp9\": \"99200\",\n \"bidp10\": \"99100\",\n \"askp_rsqn1\": \"1037\",\n \"askp_rsqn2\": \"1074\",\n \"askp_rsqn3\": \"1111\",\n \"askp_rsqn4\": \"1148\",\n \"askp_rsqn5\": \"1185\",\n \"askp_rsqn6\": \"1222\",\n \"askp_rsqn7\": \"1259\",\n \"askp_rsqn8\": \"1296\",\n \"askp_rsqn9\": \"1333\",\n \"askp_rsqn10\": \"1370\",\n \"bidp_rsqn1\": \"941\",\n \"bidp_rsqn2\": \"982\",\n \"bidp_rsqn3\": \"1023\",\n \"bidp_rsqn4\": \"1064\",\n \"bidp_rsqn5\": \"1105\",\n \"bidp_rsqn6\": \"1146\",\n \"bidp_rsqn7\": \"1187\",\n \"bidp_rsqn8\": \"1228\",\n \"bidp_rsqn9\": \"1269\",\n \"bidp_rsqn10\": \"1310\",\n \"total_askp_rsqn\": \"1199507\",\n \"total_bidp_rsqn\": \"288237\",\n \"total_askp_rsqn_icdc\": \"0\",\n \"total_bidp_rsqn_icdc\": \"0\",\n \"ovtm_total_askp_rsqn\": \"0\",\n \"ovtm_total_bidp_rsqn\": \"104464\",\n \"ovtm_total_askp_rsqn_icdc\": \"0\",\n \"ovtm_total_bidp_rsqn_icdc\": \"0\",\n \"antc_cnpr\": \"270000\",\n \"antc_cntg_vrss_sign\": \"2\",\n \"antc_cntg_vrss\": \"8500\",\n \"antc_cntg_prdy_ctrt\": \"3.25\",\n \"antc_cnqn\": \"-50\",\n \"antc_vol\": \"415397\",\n \"acml_vol\": \"8016978\",\n \"stck_deal_cls_code\": \"\",\n \"wghn_avrg_stck_prc\": \"266982\"\n }\n}" } ] }, { "name" : "(실시간) 국내주식 호가 (시간외단일가)", "protocol" : "WEBSOCKET", "method" : "POST", "domain" : "wss://openapi.imeritz.com:29443", "url" : "/websocket", "format" : "JSON", "contentType" : "application/json", "description" : "국내주식 시간외 단일가 시간대의 호가창을 내려보내는 실시간 서비스입니다.", "trs" : [ { "name" : "실시간 주식 호가 (시간외단일가)", "code" : "ohhts_ovtp_aspr", "request" : { "header" : [ ], "body" : [ { "element" : "header", "name" : "헤더부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "구독 메시지의 헤더입니다.", "depth" : 0 }, { "element" : "token", "name" : "접근토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "발급받은 접근토큰에 \"Bearer \" 를 붙여 넣습니다. 세션 한도를 넘기면 WSC00110 이 내려옵니다.", "depth" : 0 }, { "element" : "tr_type", "name" : "거래타입", "type" : "String", "required" : "Y", "length" : "1", "description" : "\"1\" 구독 등록 / \"2\" 구독 해지. 해지는 등록과 같은 tr_cd·tr_key 로 보냅니다.", "depth" : 0 }, { "element" : "body", "name" : "바디부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "구독 대상을 지정합니다.", "depth" : 0 }, { "element" : "tr_cd", "name" : "거래코드", "type" : "String", "required" : "Y", "length" : "20", "description" : "이 API 의 구독 코드입니다. \"ohhts_ovtp_aspr\" 를 넣으십시오.", "depth" : 0 }, { "element" : "tr_key", "name" : "단축종목코드", "type" : "String", "required" : "Y", "length" : "9", "description" : "구독할 종목의 단축코드 6자리입니다. 예) 005930", "depth" : 0 } ] }, "response" : { "header" : [ ], "body" : [ { "element" : "header", "name" : "헤더부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "어느 구독의 데이터인지 알려줍니다. 한 세션에서 여러 종목을 구독했을 때 이 값으로 구분하십시오.", "depth" : 0 }, { "element" : "tr_cd", "name" : "거래코드", "type" : "String", "required" : "Y", "length" : "20", "description" : "구독 요청에 넣은 tr_cd 가 그대로 옵니다.", "depth" : 0 }, { "element" : "tr_key", "name" : "단축종목코드", "type" : "String", "required" : "Y", "length" : "9", "description" : "구독 요청에 넣은 tr_key 가 그대로 옵니다.", "depth" : 0 }, { "element" : "body", "name" : "바디부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "시간외 단일가의 호가 데이터입니다.", "depth" : 0 }, { "element" : "shrn_iscd", "name" : "단축종목코드", "type" : "String", "required" : "Y", "length" : "9", "description" : "구독한 종목의 단축코드입니다.", "depth" : 0 }, { "element" : "bsop_hour", "name" : "영업시간", "type" : "String", "required" : "Y", "length" : "6", "description" : "호가가 갱신된 시각입니다. HHMMSS 6자리, 한국시간입니다.", "depth" : 0 }, { "element" : "hour_cls_code", "name" : "시간구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "장 구분입니다.\n\"0\": 장중\n\"B\": 장 개시 전 예상\n\"C\": 09시 이후 예상\n\"A\": 장 종료 후 예상\n\"D\": 시간외 단일가 예상", "depth" : 0 }, { "element" : "askp1", "name" : "매도호가1", "type" : "String", "required" : "Y", "length" : "11", "description" : "1번째 매도호가입니다. askp1 이 최우선(가장 낮은) 매도호가입니다.", "depth" : 0 }, { "element" : "askp2", "name" : "매도호가2", "type" : "String", "required" : "Y", "length" : "11", "description" : "2번째 매도호가입니다.", "depth" : 0 }, { "element" : "askp3", "name" : "매도호가3", "type" : "String", "required" : "Y", "length" : "11", "description" : "3번째 매도호가입니다.", "depth" : 0 }, { "element" : "askp4", "name" : "매도호가4", "type" : "String", "required" : "Y", "length" : "11", "description" : "4번째 매도호가입니다.", "depth" : 0 }, { "element" : "askp5", "name" : "매도호가5", "type" : "String", "required" : "Y", "length" : "11", "description" : "5번째 매도호가입니다.", "depth" : 0 }, { "element" : "askp6", "name" : "매도호가6", "type" : "String", "required" : "Y", "length" : "11", "description" : "6번째 매도호가입니다.", "depth" : 0 }, { "element" : "askp7", "name" : "매도호가7", "type" : "String", "required" : "Y", "length" : "11", "description" : "7번째 매도호가입니다.", "depth" : 0 }, { "element" : "askp8", "name" : "매도호가8", "type" : "String", "required" : "Y", "length" : "11", "description" : "8번째 매도호가입니다.", "depth" : 0 }, { "element" : "askp9", "name" : "매도호가9", "type" : "String", "required" : "Y", "length" : "11", "description" : "9번째 매도호가입니다.", "depth" : 0 }, { "element" : "askp10", "name" : "매도호가10", "type" : "String", "required" : "Y", "length" : "11", "description" : "10번째 매도호가입니다.", "depth" : 0 }, { "element" : "bidp1", "name" : "매수호가1", "type" : "String", "required" : "Y", "length" : "11", "description" : "1번째 매수호가입니다. bidp1 이 최우선(가장 높은) 매수호가입니다.", "depth" : 0 }, { "element" : "bidp2", "name" : "매수호가2", "type" : "String", "required" : "Y", "length" : "11", "description" : "2번째 매수호가입니다.", "depth" : 0 }, { "element" : "bidp3", "name" : "매수호가3", "type" : "String", "required" : "Y", "length" : "11", "description" : "3번째 매수호가입니다.", "depth" : 0 }, { "element" : "bidp4", "name" : "매수호가4", "type" : "String", "required" : "Y", "length" : "11", "description" : "4번째 매수호가입니다.", "depth" : 0 }, { "element" : "bidp5", "name" : "매수호가5", "type" : "String", "required" : "Y", "length" : "11", "description" : "5번째 매수호가입니다.", "depth" : 0 }, { "element" : "bidp6", "name" : "매수호가6", "type" : "String", "required" : "Y", "length" : "11", "description" : "6번째 매수호가입니다.", "depth" : 0 }, { "element" : "bidp7", "name" : "매수호가7", "type" : "String", "required" : "Y", "length" : "11", "description" : "7번째 매수호가입니다.", "depth" : 0 }, { "element" : "bidp8", "name" : "매수호가8", "type" : "String", "required" : "Y", "length" : "11", "description" : "8번째 매수호가입니다.", "depth" : 0 }, { "element" : "bidp9", "name" : "매수호가9", "type" : "String", "required" : "Y", "length" : "11", "description" : "9번째 매수호가입니다.", "depth" : 0 }, { "element" : "bidp10", "name" : "매수호가10", "type" : "String", "required" : "Y", "length" : "11", "description" : "10번째 매수호가입니다.", "depth" : 0 }, { "element" : "askp_rsqn1", "name" : "매도호가잔량1", "type" : "String", "required" : "Y", "length" : "13", "description" : "askp1 에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "askp_rsqn2", "name" : "매도호가잔량2", "type" : "String", "required" : "Y", "length" : "13", "description" : "askp2 에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "askp_rsqn3", "name" : "매도호가잔량3", "type" : "String", "required" : "Y", "length" : "13", "description" : "askp3 에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "askp_rsqn4", "name" : "매도호가잔량4", "type" : "String", "required" : "Y", "length" : "13", "description" : "askp4 에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "askp_rsqn5", "name" : "매도호가잔량5", "type" : "String", "required" : "Y", "length" : "13", "description" : "askp5 에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "askp_rsqn6", "name" : "매도호가잔량6", "type" : "String", "required" : "Y", "length" : "13", "description" : "askp6 에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "askp_rsqn7", "name" : "매도호가잔량7", "type" : "String", "required" : "Y", "length" : "13", "description" : "askp7 에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "askp_rsqn8", "name" : "매도호가잔량8", "type" : "String", "required" : "Y", "length" : "13", "description" : "askp8 에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "askp_rsqn9", "name" : "매도호가잔량9", "type" : "String", "required" : "Y", "length" : "13", "description" : "askp9 에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "askp_rsqn10", "name" : "매도호가잔량10", "type" : "String", "required" : "Y", "length" : "13", "description" : "askp10 에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "bidp_rsqn1", "name" : "매수호가잔량1", "type" : "String", "required" : "Y", "length" : "13", "description" : "bidp1 에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "bidp_rsqn2", "name" : "매수호가잔량2", "type" : "String", "required" : "Y", "length" : "13", "description" : "bidp2 에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "bidp_rsqn3", "name" : "매수호가잔량3", "type" : "String", "required" : "Y", "length" : "13", "description" : "bidp3 에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "bidp_rsqn4", "name" : "매수호가잔량4", "type" : "String", "required" : "Y", "length" : "13", "description" : "bidp4 에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "bidp_rsqn5", "name" : "매수호가잔량5", "type" : "String", "required" : "Y", "length" : "13", "description" : "bidp5 에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "bidp_rsqn6", "name" : "매수호가잔량6", "type" : "String", "required" : "Y", "length" : "13", "description" : "bidp6 에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "bidp_rsqn7", "name" : "매수호가잔량7", "type" : "String", "required" : "Y", "length" : "13", "description" : "bidp7 에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "bidp_rsqn8", "name" : "매수호가잔량8", "type" : "String", "required" : "Y", "length" : "13", "description" : "bidp8 에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "bidp_rsqn9", "name" : "매수호가잔량9", "type" : "String", "required" : "Y", "length" : "13", "description" : "bidp9 에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "bidp_rsqn10", "name" : "매수호가잔량10", "type" : "String", "required" : "Y", "length" : "13", "description" : "bidp10 에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "total_askp_rsqn", "name" : "총매도호가잔량", "type" : "String", "required" : "Y", "length" : "13", "description" : "10단계 매도 잔량의 합입니다.", "depth" : 0 }, { "element" : "total_bidp_rsqn", "name" : "총매수호가잔량", "type" : "String", "required" : "Y", "length" : "13", "description" : "10단계 매수 잔량의 합입니다.", "depth" : 0 }, { "element" : "total_askp_rsqn_icdc", "name" : "총매도호가잔량증감", "type" : "String", "required" : "Y", "length" : "13", "description" : "직전 호가 대비 총매도잔량의 증감입니다.", "depth" : 0 }, { "element" : "total_bidp_rsqn_icdc", "name" : "총매수호가잔량증감", "type" : "String", "required" : "Y", "length" : "13", "description" : "직전 호가 대비 총매수잔량의 증감입니다.", "depth" : 0 }, { "element" : "ovtm_total_askp_rsqn", "name" : "시간외총매도호가잔량", "type" : "String", "required" : "Y", "length" : "13", "description" : "시간외 매도 잔량의 합입니다.", "depth" : 0 }, { "element" : "ovtm_total_bidp_rsqn", "name" : "시간외총매수호가잔량", "type" : "String", "required" : "Y", "length" : "13", "description" : "시간외 매수 잔량의 합입니다.", "depth" : 0 }, { "element" : "ovtm_total_askp_rsqn_icdc", "name" : "시간외총매도호가잔량증감", "type" : "String", "required" : "Y", "length" : "13", "description" : "직전 대비 시간외 매도잔량 증감입니다.", "depth" : 0 }, { "element" : "ovtm_total_bidp_rsqn_icdc", "name" : "시간외총매수호가잔량증감", "type" : "String", "required" : "Y", "length" : "13", "description" : "직전 대비 시간외 매수잔량 증감입니다.", "depth" : 0 }, { "element" : "antc_cnpr", "name" : "예상체결가", "type" : "String", "required" : "Y", "length" : "11", "description" : "지금 체결된다면 형성될 가격입니다. 실제 체결가가 아닙니다.", "depth" : 0 }, { "element" : "antc_cntg_vrss_sign", "name" : "예상체결대비부호", "type" : "String", "required" : "Y", "length" : "1", "description" : "예상체결가의 전일 종가 대비 방향입니다. \"1\": 상한 \"2\": 상승 \"3\": 보합 \"4\": 하한 \"5\": 하락.", "depth" : 0 }, { "element" : "antc_cntg_vrss", "name" : "예상체결대비", "type" : "String", "required" : "Y", "length" : "11", "description" : "예상체결가와 전일 종가의 차이입니다. 방향은 부호 필드로 확인합니다.", "depth" : 0 }, { "element" : "antc_cntg_prdy_ctrt", "name" : "예상체결전일대비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "예상체결가 기준 등락률(%)입니다.", "depth" : 0 }, { "element" : "antc_cnqn", "name" : "예상체결수량", "type" : "String", "required" : "Y", "length" : "12", "description" : "예상 체결 수량입니다.", "depth" : 0 }, { "element" : "antc_vol", "name" : "예상거래량", "type" : "String", "required" : "Y", "length" : "13", "description" : "예상 체결 기준 누적 거래량입니다.", "depth" : 0 }, { "element" : "acml_vol", "name" : "누적거래량", "type" : "String", "required" : "Y", "length" : "13", "description" : "누적 체결 수량입니다.", "depth" : 0 }, { "element" : "stck_deal_cls_code", "name" : "매매구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "매매 구분입니다.", "depth" : 0 }, { "element" : "wghn_avrg_stck_prc", "name" : "가중평균주식가격", "type" : "String", "required" : "Y", "length" : "11", "description" : "누적거래대금을 누적거래량으로 나눈 평균 단가입니다.", "depth" : 0 } ] }, "requestExample" : "{\n \"header\": {\n \"token\": \"Bearer {Token값}\",\n \"tr_type\": \"1\"\n },\n \"body\": {\n \"tr_cd\": \"ohhts_ovtp_aspr\",\n \"tr_key\": \"005930\"\n }\n}", "responseExample" : "{\n \"header\": {\n \"tr_cd\": \"ohhts_ovtp_aspr\",\n \"tr_key\": \"005930\"\n },\n \"body\": {\n \"shrn_iscd\": \"005930\",\n \"bsop_hour\": \"134219\",\n \"hour_cls_code\": \"0\",\n \"askp1\": \"265500\",\n \"askp2\": \"266000\",\n \"askp3\": \"266500\",\n \"askp4\": \"267000\",\n \"askp5\": \"267500\",\n \"askp6\": \"268000\",\n \"askp7\": \"268500\",\n \"askp8\": \"269000\",\n \"askp9\": \"269500\",\n \"askp10\": \"270000\",\n \"bidp1\": \"265000\",\n \"bidp2\": \"264500\",\n \"bidp3\": \"264000\",\n \"bidp4\": \"263500\",\n \"bidp5\": \"263000\",\n \"bidp6\": \"262500\",\n \"bidp7\": \"262000\",\n \"bidp8\": \"261500\",\n \"bidp9\": \"261000\",\n \"bidp10\": \"260500\",\n \"askp_rsqn1\": \"27782\",\n \"askp_rsqn2\": \"53625\",\n \"askp_rsqn3\": \"18998\",\n \"askp_rsqn4\": \"39268\",\n \"askp_rsqn5\": \"31647\",\n \"askp_rsqn6\": \"68885\",\n \"askp_rsqn7\": \"63542\",\n \"askp_rsqn8\": \"108487\",\n \"askp_rsqn9\": \"158019\",\n \"askp_rsqn10\": \"317211\",\n \"bidp_rsqn1\": \"60791\",\n \"bidp_rsqn2\": \"34967\",\n \"bidp_rsqn3\": \"39556\",\n \"bidp_rsqn4\": \"47624\",\n \"bidp_rsqn5\": \"66757\",\n \"bidp_rsqn6\": \"46410\",\n \"bidp_rsqn7\": \"60005\",\n \"bidp_rsqn8\": \"40239\",\n \"bidp_rsqn9\": \"34560\",\n \"bidp_rsqn10\": \"43332\",\n \"total_askp_rsqn\": \"887464\",\n \"total_bidp_rsqn\": \"474241\",\n \"total_askp_rsqn_icdc\": \"0\",\n \"total_bidp_rsqn_icdc\": \"5\",\n \"ovtm_total_askp_rsqn\": \"0\",\n \"ovtm_total_bidp_rsqn\": \"104464\",\n \"ovtm_total_askp_rsqn_icdc\": \"0\",\n \"ovtm_total_bidp_rsqn_icdc\": \"0\",\n \"antc_cnpr\": \"270000\",\n \"antc_cntg_vrss_sign\": \"2\",\n \"antc_cntg_vrss\": \"8500\",\n \"antc_cntg_prdy_ctrt\": \"3.25\",\n \"antc_cnqn\": \"-50\",\n \"antc_vol\": \"415397\",\n \"acml_vol\": \"11999304\",\n \"stck_deal_cls_code\": \"\",\n \"wghn_avrg_stck_prc\": \"267164\"\n }\n}" } ] }, { "name" : "(실시간) 국내주식 시간외예상체결가", "protocol" : "WEBSOCKET", "method" : "POST", "domain" : "wss://openapi.imeritz.com:29443", "url" : "/websocket", "format" : "JSON", "contentType" : "application/json", "description" : "국내주식 시간외 단일가의 예상 체결가를 내려보내는 실시간 서비스입니다. 아직 체결된 값이 아니라 그 시점의 예상값이므로, 확정 체결은 시간외 단일가 현재가(ohhts_ovtp_cntg)로 받으십시오.\n\ntr_cd 에 \"ohhts_ovan_cntg\", tr_key 에 종목 단축코드 여섯 자리(예: 005930)를 넣어 구독하십시오.\n\n실시간 서비스는 접속점이 하나입니다. 접속하신 뒤 보내는 구독 메시지의 body 안 tr_cd 로 어떤 데이터를 받을지 정합니다.\n\n구독은 header 의 tr_type 에 \"1\", 해지는 같은 tr_cd·tr_key 에 \"2\" 를 넣어 보냅니다. header 의 token 에는 발급받은 접근토큰을 \"Bearer \" 를 붙여 넣으십시오. 접두어가 없으면 EGW00202 로 거절됩니다.\n\n내려오는 메시지는 header 와 body 로 나뉩니다. 한 접속에서 여러 종목·여러 서비스를 구독하셨다면 header 의 tr_cd·tr_key 로 어느 구독의 데이터인지 가려내십시오.", "trs" : [ { "name" : "실시간 주식 예상체결 (시간외단일가)", "code" : "ohhts_ovan_cntg", "request" : { "header" : [ ], "body" : [ { "element" : "header", "name" : "헤더부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "구독 메시지의 헤더입니다.", "depth" : 0 }, { "element" : "token", "name" : "접근토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "발급받은 접근토큰에 \"Bearer \" 를 붙여 넣습니다. 세션 한도를 넘기면 WSC00110 이 내려옵니다.", "depth" : 0 }, { "element" : "tr_type", "name" : "거래타입", "type" : "String", "required" : "Y", "length" : "1", "description" : "\"1\" 구독 등록 / \"2\" 구독 해지. 해지는 등록과 같은 tr_cd·tr_key 로 보냅니다.", "depth" : 0 }, { "element" : "body", "name" : "바디부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "구독 대상을 지정합니다.", "depth" : 0 }, { "element" : "tr_cd", "name" : "거래코드", "type" : "String", "required" : "Y", "length" : "20", "description" : "이 API 의 구독 코드입니다. \"ohhts_ovan_cntg\" 를 넣으십시오.", "depth" : 0 }, { "element" : "tr_key", "name" : "단축종목코드", "type" : "String", "required" : "Y", "length" : "9", "description" : "구독할 종목의 단축코드 6자리입니다. 예) 005930", "depth" : 0 } ] }, "response" : { "header" : [ ], "body" : [ { "element" : "header", "name" : "헤더부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "어느 구독의 데이터인지 알려줍니다. 한 세션에서 여러 종목을 구독했을 때 이 값으로 구분하십시오.", "depth" : 0 }, { "element" : "tr_cd", "name" : "거래코드", "type" : "String", "required" : "Y", "length" : "20", "description" : "구독 요청에 넣은 tr_cd 가 그대로 옵니다.", "depth" : 0 }, { "element" : "tr_key", "name" : "단축종목코드", "type" : "String", "required" : "Y", "length" : "9", "description" : "구독 요청에 넣은 tr_key 가 그대로 옵니다.", "depth" : 0 }, { "element" : "body", "name" : "바디부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "시간외 단일가 구간의 예상체결가 시세입니다.", "depth" : 0 }, { "element" : "shrn_iscd", "name" : "단축종목코드", "type" : "String", "required" : "Y", "length" : "9", "description" : "구독한 종목의 단축코드입니다.", "depth" : 0 }, { "element" : "bsop_hour", "name" : "영업시간", "type" : "String", "required" : "Y", "length" : "6", "description" : "체결이 일어난 시각입니다. HHMMSS 6자리이며 한국시간 기준입니다.", "depth" : 0 }, { "element" : "hour_cls_code", "name" : "시간구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "장 구분입니다.\n\"0\": 장중\n\"B\": 장 개시 전 예상\n\"C\": 09시 이후 예상\n\"A\": 장 종료 후 예상\n\"D\": 시간외 단일가 예상", "depth" : 0 }, { "element" : "antc_nmix_cls_code", "name" : "예상지수구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "예상체결 여부 구분입니다.", "depth" : 0 }, { "element" : "prpr", "name" : "현재가", "type" : "String", "required" : "Y", "length" : "11", "description" : "가장 최근 체결된 가격입니다. 이 메시지가 알리는 체결의 가격입니다.", "depth" : 0 }, { "element" : "prdy_vrss_sign", "name" : "전일대비부호", "type" : "String", "required" : "Y", "length" : "1", "description" : "전일 종가 대비 방향입니다.", "depth" : 0 }, { "element" : "prdy_vrss", "name" : "전일대비", "type" : "String", "required" : "Y", "length" : "11", "description" : "전일 종가와의 차이입니다.", "depth" : 0 }, { "element" : "prdy_ctrt", "name" : "전일대비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "전일 종가 대비 등락률(%)입니다.", "depth" : 0 }, { "element" : "oprc", "name" : "시가", "type" : "String", "required" : "Y", "length" : "11", "description" : "당일 첫 체결 가격입니다.", "depth" : 0 }, { "element" : "hprc", "name" : "고가", "type" : "String", "required" : "Y", "length" : "11", "description" : "당일 체결 중 가장 높았던 가격입니다.", "depth" : 0 }, { "element" : "lprc", "name" : "저가", "type" : "String", "required" : "Y", "length" : "11", "description" : "당일 체결 중 가장 낮았던 가격입니다.", "depth" : 0 }, { "element" : "cntg_cls_code", "name" : "체결구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "체결 유형입니다.", "depth" : 0 }, { "element" : "cntg_vol", "name" : "체결거래량", "type" : "String", "required" : "Y", "length" : "11", "description" : "이번 체결의 수량입니다. 누적이 아니라 건별 수량입니다.", "depth" : 0 }, { "element" : "acml_vol", "name" : "누적거래량", "type" : "String", "required" : "Y", "length" : "13", "description" : "누적 체결 수량입니다.", "depth" : 0 }, { "element" : "acml_tr_pbmn", "name" : "누적거래대금", "type" : "String", "required" : "Y", "length" : "13", "description" : "누적 체결 금액입니다.", "depth" : 0 }, { "element" : "wghn_avrg_stck_prc", "name" : "가중평균주식가격", "type" : "String", "required" : "Y", "length" : "11", "description" : "누적거래대금을 누적거래량으로 나눈 평균 단가입니다.", "depth" : 0 }, { "element" : "askp1", "name" : "매도호가1", "type" : "String", "required" : "Y", "length" : "11", "description" : "체결 시점의 최우선 매도호가입니다.", "depth" : 0 }, { "element" : "bidp1", "name" : "매수호가1", "type" : "String", "required" : "Y", "length" : "11", "description" : "체결 시점의 최우선 매수호가입니다.", "depth" : 0 }, { "element" : "askp_rsqn1", "name" : "매도호가잔량1", "type" : "String", "required" : "Y", "length" : "13", "description" : "최우선 매도호가에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "bidp_rsqn1", "name" : "매수호가잔량1", "type" : "String", "required" : "Y", "length" : "13", "description" : "최우선 매수호가에 남아 있는 수량입니다.", "depth" : 0 }, { "element" : "total_askp_rsqn", "name" : "총매도호가잔량", "type" : "String", "required" : "Y", "length" : "13", "description" : "호가창 전체의 매도 잔량 합입니다.", "depth" : 0 }, { "element" : "total_bidp_rsqn", "name" : "총매수호가잔량", "type" : "String", "required" : "Y", "length" : "13", "description" : "호가창 전체의 매수 잔량 합입니다.", "depth" : 0 }, { "element" : "rltv", "name" : "체결강도", "type" : "String", "required" : "Y", "length" : "9", "description" : "체결강도입니다.", "depth" : 0 }, { "element" : "shnu_rate", "name" : "매수비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "전체 체결 중 매수 체결이 차지하는 비율(%)입니다.", "depth" : 0 }, { "element" : "trht_yn", "name" : "거래정지여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "거래정지 여부입니다.\n\"Y\": 거래정지\n\"N\": 정상 거래", "depth" : 0 }, { "element" : "prdy_vrss_vol_rate", "name" : "전일대비거래량비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "전일 같은 시점의 누적거래량 대비 오늘 누적거래량의 비율(%)입니다.", "depth" : 0 }, { "element" : "prdy_smns_hour_vol_rate", "name" : "전일동일시간거래량비율", "type" : "String", "required" : "Y", "length" : "9", "description" : "전일 같은 시간대의 거래량 대비 비율(%)입니다.", "depth" : 0 } ] }, "requestExample" : "{\n \"header\": {\n \"token\": \"Bearer {Token값}\",\n \"tr_type\": \"1\"\n },\n \"body\": {\n \"tr_cd\": \"ohhts_ovan_cntg\",\n \"tr_key\": \"005930\"\n }\n}", "responseExample" : "{\n \"header\": {\n \"tr_cd\": \"ohhts_ovan_cntg\",\n \"tr_key\": \"005930\"\n },\n \"body\": {\n \"shrn_iscd\": \"005930\",\n \"bsop_hour\": \"110925\",\n \"hour_cls_code\": \"0\",\n \"antc_nmix_cls_code\": \"1\",\n \"prpr\": \"267000\",\n \"prdy_vrss_sign\": \"2\",\n \"prdy_vrss\": \"5500\",\n \"prdy_ctrt\": \"2.10\",\n \"oprc\": \"270000\",\n \"hprc\": \"271000\",\n \"lprc\": \"262500\",\n \"cntg_cls_code\": \"1\",\n \"cntg_vol\": \"37\",\n \"acml_vol\": \"8016819\",\n \"acml_tr_pbmn\": \"2140348970750\",\n \"wghn_avrg_stck_prc\": \"266982\",\n \"askp1\": \"267500\",\n \"bidp1\": \"267000\",\n \"askp_rsqn1\": \"55220\",\n \"bidp_rsqn1\": \"7800\",\n \"total_askp_rsqn\": \"1198306\",\n \"total_bidp_rsqn\": \"288273\",\n \"rltv\": \"83.12\",\n \"shnu_rate\": \"0.00\",\n \"trht_yn\": \"N\",\n \"prdy_vrss_vol_rate\": \"41.04\",\n \"prdy_smns_hour_vol_rate\": \"115.95\"\n }\n}" } ] }, { "name" : "(실시간) 주문 접수 통보", "protocol" : "WEBSOCKET", "method" : "POST", "domain" : "wss://openapi.imeritz.com:29443", "url" : "/websocket", "format" : "JSON", "contentType" : "application/json", "description" : "내 계좌에 주문이 접수될 때마다 그 사실을 알려주는 실시간 서비스입니다. 어느 경로로 낸 주문이든 접수되면 통보가 옵니다.\n\ntr_cd 에 \"ohhts_cntg_infr\" 를 넣어 구독하십시오. 이 서비스의 구독 요청에는 종목을 지정하는 tr_key 가 없습니다. 계좌에서 일어나는 접수를 모두 받으시고, 필요한 종목은 받으신 뒤 stnd_iscd 로 걸러내십시오.\n\n체결이 아니라 접수 사실만 알립니다. 수량·가격 항목은 접수 기준인 tlms_aspr_qty·aspr_prc 이며, 체결 수량·단가는 주문 체결 통보(ohhts_cntg_rslt)로 옵니다. 정정·취소 접수인지는 rctf_cncl_cls_code 와 orgl_oder_no 로 판단하십시오.\n\n실시간 서비스는 접속점이 하나입니다. 접속하신 뒤 보내는 구독 메시지의 body 안 tr_cd 로 어떤 데이터를 받을지 정합니다.\n\n구독은 header 의 tr_type 에 \"1\", 해지는 같은 tr_cd·tr_key 에 \"2\" 를 넣어 보냅니다. header 의 token 에는 발급받은 접근토큰을 \"Bearer \" 를 붙여 넣으십시오. 접두어가 없으면 EGW00202 로 거절됩니다.\n\n내려오는 메시지는 header 와 body 로 나뉩니다. 한 접속에서 여러 종목·여러 서비스를 구독하셨다면 header 의 tr_cd·tr_key 로 어느 구독의 데이터인지 가려내십시오.", "trs" : [ { "name" : "실시간 주문 접수 통보", "code" : "ohhts_cntg_infr", "request" : { "header" : [ ], "body" : [ { "element" : "header", "name" : "헤더부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "구독 메시지의 헤더입니다.", "depth" : 0 }, { "element" : "token", "name" : "접근토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "발급받은 접근토큰에 \"Bearer \" 를 붙여 넣습니다. 세션 한도를 넘기면 WSC00110 이 내려옵니다.", "depth" : 0 }, { "element" : "tr_type", "name" : "거래타입", "type" : "String", "required" : "Y", "length" : "1", "description" : "\"1\" 구독 등록 / \"2\" 구독 해지. 해지는 등록과 같은 tr_cd·tr_key 로 보냅니다.", "depth" : 0 }, { "element" : "body", "name" : "바디부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "구독 대상을 지정합니다.", "depth" : 0 }, { "element" : "tr_cd", "name" : "거래코드", "type" : "String", "required" : "Y", "length" : "20", "description" : "이 API 의 구독 코드입니다. \"ohhts_cntg_infr\" 를 넣으십시오. tr_key 는 넣지 않아도 됩니다.", "depth" : 0 } ] }, "response" : { "header" : [ ], "body" : [ { "element" : "header", "name" : "헤더부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "어느 구독의 통보인지 알려줍니다. 이 API 는 종목을 지정하지 않으므로 거래코드로 접수 통보임을 확인하십시오.", "depth" : 0 }, { "element" : "tr_cd", "name" : "거래코드", "type" : "String", "required" : "Y", "length" : "20", "description" : "구독 요청에 넣은 tr_cd 가 그대로 옵니다.", "depth" : 0 }, { "element" : "tr_key", "name" : "사용자ID", "type" : "String", "required" : "Y", "length" : "20", "description" : "주문 접수 통보의 대상 사용자 ID 입니다. 구독 요청에 넣지 않아도 됩니다.\n구독이 받아들여졌는지는 rsp_cd 가 \"00000\" 인지로 확인하십시오.", "depth" : 0 }, { "element" : "body", "name" : "바디부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "주문 접수 통보 내용입니다.", "depth" : 0 }, { "element" : "user_id", "name" : "사용자ID", "type" : "String", "required" : "Y", "length" : "20", "description" : "통보 대상 사용자 ID 입니다. 응답 헤더의 tr_key 와 같은 값입니다.", "depth" : 0 }, { "element" : "aspr_cond_clcd", "name" : "호가조건구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "호가 조건입니다.", "depth" : 0 }, { "element" : "aspr_rfus_reas_code", "name" : "호가거부사유코드", "type" : "String", "required" : "Y", "length" : "4", "description" : "주문이 거부된 사유 코드입니다.", "depth" : 0 }, { "element" : "aspr_type_code", "name" : "호가유형코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "호가 유형입니다. \"1\": 시장가 \"2\": 지정가", "depth" : 0 }, { "element" : "deal_cls_code", "name" : "매매구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "매도·매수 구분입니다.\n\"1\": 매도\n\"2\": 매수", "depth" : 0 }, { "element" : "crdt_cls_code", "name" : "신용구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "신용 구분 코드입니다. 값에 대응하는 이름은 통보에 함께 오지 않습니다.\n\n결제 재원을 구체적으로 구분하셔야 하면 같은 주문번호로 주문내역 조회(/trading/v1/orders/history)의 crdt_oder_cls_code 를 확인하십시오.", "depth" : 0 }, { "element" : "frml_ovtm_cls_code", "name" : "정규시간외구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "정규장·시간외 구분입니다. \"0\": 해당 없음 \"1\": 정규장 \"2\": 장 개시 전 시간외 종가", "depth" : 0 }, { "element" : "acno", "name" : "계좌번호", "type" : "String", "required" : "Y", "length" : "8", "description" : "주문이 접수된 계좌번호입니다. 토큰에 매핑된 계좌입니다.", "depth" : 0 }, { "element" : "asno", "name" : "계좌일련번호", "type" : "String", "required" : "Y", "length" : "2", "description" : "계좌일련번호입니다.", "depth" : 0 }, { "element" : "acnm", "name" : "계좌명", "type" : "String", "required" : "Y", "length" : "40", "description" : "계좌 예금주명입니다.", "depth" : 0 }, { "element" : "aspr_prc", "name" : "호가가격", "type" : "String", "required" : "Y", "length" : "11", "description" : "주문 단가입니다.", "depth" : 0 }, { "element" : "tlms_aspr_qty", "name" : "전문호가수량", "type" : "String", "required" : "Y", "length" : "12", "description" : "주문 수량입니다.", "depth" : 0 }, { "element" : "loan_date", "name" : "대출일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "대출일자입니다.", "depth" : 0 }, { "element" : "loan_dtl_type_code", "name" : "대출상세유형코드", "type" : "String", "required" : "Y", "length" : "4", "description" : "대출 상세 유형. 0000 보통(무대출)·0101 자기융자·0102 유통융자·0103 자기대주·0104 유통대주·0201~0204 예탁(주식·채권·집합투자·장외파생)·0211~0214 예탁유통(상동)·0301 매도증권담보대출·0302 수익증권환매·0303 ELS환매자금대출·0401~0404 소액(주식·채권·수익증권·ELS)·0501 공모주청약·0502 ELS청약·0503 주식매입·0601 매입자금대출·0701 초단기대출·0801 CMA담보대출·6201 슈퍼365(재활용)·7201 담보대여·8201 양도담보·9201 대출(대여)", "depth" : 0 }, { "element" : "mbcr_oder_time", "name" : "회원사주문시각", "type" : "String", "required" : "Y", "length" : "9", "description" : "증권사가 주문을 접수한 시각입니다. HHMMSSmmm 9자리입니다.", "depth" : 0 }, { "element" : "oder_date", "name" : "주문일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "주문 일자입니다. YYYYMMDD 8자리입니다.", "depth" : 0 }, { "element" : "oder_no", "name" : "주문번호", "type" : "String", "required" : "Y", "length" : "10", "description" : "주문번호입니다. 접수·체결 통보를 잇는 키입니다.", "depth" : 0 }, { "element" : "orgl_oder_no", "name" : "원주문번호", "type" : "String", "required" : "Y", "length" : "10", "description" : "정정·취소 주문이면 원주문의 번호입니다.", "depth" : 0 }, { "element" : "rctf_cncl_cls_code", "name" : "정정취소구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "이 통보가 어떤 주문에 대한 것인지 나타냅니다.\n\"1\": 신규(원주문)\n\"2\": 정정\n\"3\": 취소\n정정·취소이면 원주문 번호가 orgl_oder_no 에 옵니다.", "depth" : 0 }, { "element" : "stnd_iscd", "name" : "표준종목코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "표준 종목코드(ISIN)입니다. 예) 삼성전자 \"KR7005930003\".", "depth" : 0 }, { "element" : "iscd_name", "name" : "종목명", "type" : "String", "required" : "Y", "length" : "40", "description" : "종목의 한글 이름입니다.", "depth" : 0 }, { "element" : "svc_id", "name" : "서비스ID", "type" : "String", "required" : "Y", "length" : "11", "description" : "통보를 구분하는 서비스 식별 값입니다.", "depth" : 0 }, { "element" : "pros_srno", "name" : "처리일련번호", "type" : "String", "required" : "Y", "length" : "10", "description" : "처리 일련번호입니다.", "depth" : 0 }, { "element" : "deal_mgri_indc_no", "name" : "매매운용지시번호", "type" : "String", "required" : "Y", "length" : "12", "description" : "매매 운용 지시 번호입니다.", "depth" : 0 }, { "element" : "sbsn_clcd", "name" : "대용구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "대용 여부입니다.", "depth" : 0 }, { "element" : "trst_dcsh_id", "name" : "자사주신고서ID", "type" : "String", "required" : "Y", "length" : "5", "description" : "자사주 매매 신고서 식별자입니다.", "depth" : 0 }, { "element" : "loan_srno", "name" : "대출일련번호", "type" : "String", "required" : "Y", "length" : "2", "description" : "대출 일련번호입니다.", "depth" : 0 } ] }, "requestExample" : "{\n \"header\": {\n \"token\": \"Bearer {Token값}\",\n \"tr_type\": \"1\"\n },\n \"body\": {\n \"tr_cd\": \"ohhts_cntg_infr\"\n }\n}", "responseExample" : "{\n \"header\": {\n \"tr_cd\": \"ohhts_cntg_infr\",\n \"tr_key\": \"sample_user\"\n },\n \"body\": {\n \"user_id\": \"sample_user\",\n \"aspr_cond_clcd\": \"0\",\n \"aspr_rfus_reas_code\": \"0000\",\n \"aspr_type_code\": \"2\",\n \"deal_cls_code\": \"2\",\n \"crdt_cls_code\": \"\",\n \"frml_ovtm_cls_code\": \"1\",\n \"acno\": \"12345678\",\n \"asno\": \"01\",\n \"acnm\": \"홍길동\",\n \"aspr_prc\": \"00000266000\",\n \"tlms_aspr_qty\": \"000000000001\",\n \"loan_date\": \"\",\n \"loan_dtl_type_code\": \"0000\",\n \"mbcr_oder_time\": \"131453864\",\n \"oder_date\": \"20260827\",\n \"oder_no\": \"0000000141\",\n \"orgl_oder_no\": \"\",\n \"rctf_cncl_cls_code\": \"1\",\n \"stnd_iscd\": \"KR7005930003\",\n \"iscd_name\": \"삼성전자\",\n \"svc_id\": \"NTRODP11301\",\n \"pros_srno\": \"0\",\n \"deal_mgri_indc_no\": \"\",\n \"sbsn_clcd\": \"0\",\n \"trst_dcsh_id\": \"0\",\n \"loan_srno\": \"0\"\n }\n}" } ] }, { "name" : "(실시간) 주문 체결 통보", "protocol" : "WEBSOCKET", "method" : "POST", "domain" : "wss://openapi.imeritz.com:29443", "url" : "/websocket", "format" : "JSON", "contentType" : "application/json", "description" : "내 계좌의 주문이 체결될 때마다 체결 가격·수량을 알려주는 실시간 서비스입니다. 한 주문이 여러 번에 나뉘어 체결되면 그때마다 한 건씩 옵니다.\n\ntr_cd 에 \"ohhts_cntg_rslt\" 를 넣어 구독하십시오. 이 서비스의 구독 요청에는 종목을 지정하는 tr_key 가 없습니다. 계좌에서 일어나는 체결을 모두 받으시고, 필요한 종목은 받으신 뒤 stnd_iscd 로 걸러내십시오.\n\n체결 가격은 cntg_prc, 체결 수량은 cntg_qty 입니다. 주문 접수 통보의 aspr_prc·tlms_aspr_qty 와는 이름도 뜻도 다르므로 같은 항목으로 묶어 쓰지 마십시오. 어느 주문의 체결인지는 oder_no 로 잇습니다.\n\n실시간 서비스는 접속점이 하나입니다. 접속하신 뒤 보내는 구독 메시지의 body 안 tr_cd 로 어떤 데이터를 받을지 정합니다.\n\n구독은 header 의 tr_type 에 \"1\", 해지는 같은 tr_cd·tr_key 에 \"2\" 를 넣어 보냅니다. header 의 token 에는 발급받은 접근토큰을 \"Bearer \" 를 붙여 넣으십시오. 접두어가 없으면 EGW00202 로 거절됩니다.\n\n내려오는 메시지는 header 와 body 로 나뉩니다. 한 접속에서 여러 종목·여러 서비스를 구독하셨다면 header 의 tr_cd·tr_key 로 어느 구독의 데이터인지 가려내십시오.", "trs" : [ { "name" : "실시간 주문 체결 통보", "code" : "ohhts_cntg_rslt", "request" : { "header" : [ ], "body" : [ { "element" : "header", "name" : "헤더부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "구독 메시지의 헤더입니다.", "depth" : 0 }, { "element" : "token", "name" : "접근토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "발급받은 접근토큰에 \"Bearer \" 를 붙여 넣습니다. 세션 한도를 넘기면 WSC00110 이 내려옵니다.", "depth" : 0 }, { "element" : "tr_type", "name" : "거래타입", "type" : "String", "required" : "Y", "length" : "1", "description" : "\"1\" 구독 등록 / \"2\" 구독 해지. 해지는 등록과 같은 tr_cd·tr_key 로 보냅니다.", "depth" : 0 }, { "element" : "body", "name" : "바디부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "구독 대상을 지정합니다.", "depth" : 0 }, { "element" : "tr_cd", "name" : "거래코드", "type" : "String", "required" : "Y", "length" : "20", "description" : "이 API 의 구독 코드입니다. \"ohhts_cntg_rslt\" 를 넣으십시오. tr_key 는 넣지 않아도 됩니다.", "depth" : 0 } ] }, "response" : { "header" : [ ], "body" : [ { "element" : "header", "name" : "헤더부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "어느 구독의 통보인지 알려줍니다. 체결 통보는 종목을 지정하지 않으므로 거래코드 값으로 구분하십시오.", "depth" : 0 }, { "element" : "tr_cd", "name" : "거래코드", "type" : "String", "required" : "Y", "length" : "20", "description" : "구독 요청에 넣은 tr_cd 가 그대로 옵니다.", "depth" : 0 }, { "element" : "tr_key", "name" : "사용자ID", "type" : "String", "required" : "Y", "length" : "20", "description" : "주문 체결 통보의 대상 사용자 ID 입니다. 구독 요청에 넣지 않아도 됩니다.\n구독이 받아들여졌는지는 rsp_cd 가 \"00000\" 인지로 확인하십시오.", "depth" : 0 }, { "element" : "body", "name" : "바디부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "주문 체결 통보 내용입니다.", "depth" : 0 }, { "element" : "user_id", "name" : "사용자ID", "type" : "String", "required" : "Y", "length" : "20", "description" : "통보 대상 사용자 ID 입니다. 응답 헤더의 tr_key 와 같은 값입니다.", "depth" : 0 }, { "element" : "cntg_date", "name" : "체결일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "체결 일자입니다. YYYYMMDD 8자리입니다.", "depth" : 0 }, { "element" : "cntg_pros_time", "name" : "체결처리시각", "type" : "String", "required" : "Y", "length" : "9", "description" : "체결 처리 시각입니다. HHMMSSmmm 9자리입니다.", "depth" : 0 }, { "element" : "cntg_type_code", "name" : "체결유형코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "체결 유형 코드입니다. 값에 대응하는 이름은 통보에 함께 오지 않습니다.", "depth" : 0 }, { "element" : "deal_cls_code", "name" : "매매구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "매도·매수 구분입니다.\n\"1\": 매도\n\"2\": 매수", "depth" : 0 }, { "element" : "crdt_cls_code", "name" : "신용구분코드", "type" : "String", "required" : "Y", "length" : "2", "description" : "신용 구분 코드입니다. 값에 대응하는 이름은 통보에 함께 오지 않습니다.\n\n결제 재원을 구체적으로 구분하셔야 하면 같은 주문번호로 주문내역 조회(/trading/v1/orders/history)의 crdt_oder_cls_code 를 확인하십시오.", "depth" : 0 }, { "element" : "frml_ovtm_cls_code", "name" : "정규시간외구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "정규장·시간외 구분입니다. \"0\": 해당 없음 \"1\": 정규장 \"2\": 장 개시 전 시간외 종가", "depth" : 0 }, { "element" : "acno", "name" : "계좌번호", "type" : "String", "required" : "Y", "length" : "8", "description" : "주문이 접수된 계좌번호입니다. 토큰에 매핑된 계좌입니다.", "depth" : 0 }, { "element" : "asno", "name" : "계좌일련번호", "type" : "String", "required" : "Y", "length" : "2", "description" : "계좌일련번호입니다.", "depth" : 0 }, { "element" : "acnm", "name" : "계좌명", "type" : "String", "required" : "Y", "length" : "40", "description" : "계좌 예금주명입니다.", "depth" : 0 }, { "element" : "cntg_prc", "name" : "체결가격", "type" : "String", "required" : "Y", "length" : "11", "description" : "체결된 가격입니다.", "depth" : 0 }, { "element" : "cntg_qty", "name" : "체결수량", "type" : "String", "required" : "Y", "length" : "12", "description" : "이번에 체결된 수량입니다.", "depth" : 0 }, { "element" : "fmsc_cntg_prc", "name" : "원월물체결가격", "type" : "String", "required" : "Y", "length" : "11", "description" : "파생 스프레드 거래의 원월물 체결가격입니다.", "depth" : 0 }, { "element" : "nmsc_cntg_prc", "name" : "근월물체결가격", "type" : "String", "required" : "Y", "length" : "11", "description" : "파생 스프레드 거래의 근월물 체결가격입니다.", "depth" : 0 }, { "element" : "loan_date", "name" : "대출일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "대출일자입니다.", "depth" : 0 }, { "element" : "loan_dtl_type_code", "name" : "대출상세유형코드", "type" : "String", "required" : "Y", "length" : "4", "description" : "대출 상세 유형. 0000 보통(무대출)·0101 자기융자·0102 유통융자·0103 자기대주·0104 유통대주·0201~0204 예탁(주식·채권·집합투자·장외파생)·0211~0214 예탁유통(상동)·0301 매도증권담보대출·0302 수익증권환매·0303 ELS환매자금대출·0401~0404 소액(주식·채권·수익증권·ELS)·0501 공모주청약·0502 ELS청약·0503 주식매입·0601 매입자금대출·0701 초단기대출·0801 CMA담보대출·6201 슈퍼365(재활용)·7201 담보대여·8201 양도담보·9201 대출(대여)", "depth" : 0 }, { "element" : "oder_no", "name" : "주문번호", "type" : "String", "required" : "Y", "length" : "10", "description" : "주문번호입니다. 접수·체결 통보를 잇는 키입니다.", "depth" : 0 }, { "element" : "orgl_oder_no", "name" : "원주문번호", "type" : "String", "required" : "Y", "length" : "10", "description" : "정정·취소 주문이면 원주문의 번호입니다.", "depth" : 0 }, { "element" : "stnd_iscd", "name" : "표준종목코드", "type" : "String", "required" : "Y", "length" : "12", "description" : "표준 종목코드(ISIN)입니다. 예) 삼성전자 \"KR7005930003\".", "depth" : 0 }, { "element" : "iscd_name", "name" : "종목명", "type" : "String", "required" : "Y", "length" : "40", "description" : "종목의 한글 이름입니다.", "depth" : 0 }, { "element" : "svc_id", "name" : "서비스ID", "type" : "String", "required" : "Y", "length" : "11", "description" : "통보를 구분하는 서비스 식별 값입니다.", "depth" : 0 }, { "element" : "pros_srno", "name" : "처리일련번호", "type" : "String", "required" : "Y", "length" : "10", "description" : "처리 일련번호입니다.", "depth" : 0 }, { "element" : "deal_mgri_indc_no", "name" : "매매운용지시번호", "type" : "String", "required" : "Y", "length" : "12", "description" : "매매 운용 지시 번호입니다.", "depth" : 0 }, { "element" : "sbsn_clcd", "name" : "대용구분코드", "type" : "String", "required" : "Y", "length" : "1", "description" : "대용 여부입니다.", "depth" : 0 }, { "element" : "loan_srno", "name" : "대출일련번호", "type" : "String", "required" : "Y", "length" : "2", "description" : "대출 일련번호입니다.", "depth" : 0 }, { "element" : "sbtr_byng_acbk_amt", "name" : "차감매입장부금액", "type" : "String", "required" : "Y", "length" : "11", "description" : "차감된 매입 장부금액입니다.", "depth" : 0 }, { "element" : "fllr", "name" : "예비항목", "type" : "String", "required" : "Y", "length" : "15", "description" : "예비 영역입니다.", "depth" : 0 } ] }, "requestExample" : "{\n \"header\": {\n \"token\": \"Bearer {Token값}\",\n \"tr_type\": \"1\"\n },\n \"body\": {\n \"tr_cd\": \"ohhts_cntg_rslt\"\n }\n}", "responseExample" : "{\n \"header\": {\n \"tr_cd\": \"ohhts_cntg_rslt\",\n \"tr_key\": \"sample_user\"\n },\n \"body\": {\n \"user_id\": \"sample_user\",\n \"cntg_date\": \"20260827\",\n \"cntg_pros_time\": \"132357640\",\n \"cntg_type_code\": \"\",\n \"deal_cls_code\": \"2\",\n \"crdt_cls_code\": \"\",\n \"frml_ovtm_cls_code\": \"1\",\n \"acno\": \"12345678\",\n \"asno\": \"01\",\n \"acnm\": \"홍길동\",\n \"cntg_prc\": \"00000117600\",\n \"cntg_qty\": \"000000000001\",\n \"fmsc_cntg_prc\": \"00000000000\",\n \"nmsc_cntg_prc\": \"00000000000\",\n \"loan_date\": \"\",\n \"loan_dtl_type_code\": \"0000\",\n \"oder_no\": \"0000000185\",\n \"orgl_oder_no\": \"\",\n \"stnd_iscd\": \"KR7247540008\",\n \"iscd_name\": \"에코프로비엠\",\n \"svc_id\": \"TTRTDP21301\",\n \"pros_srno\": \"0\",\n \"deal_mgri_indc_no\": \"\",\n \"sbsn_clcd\": \"0\",\n \"loan_srno\": \"0\",\n \"sbtr_byng_acbk_amt\": \"0\",\n \"fllr\": \"\"\n }\n}" } ] } ] }, { "name" : "(실시간) 해외주식", "apis" : [ { "name" : "(실시간) 해외주식 호가", "protocol" : "WEBSOCKET", "method" : "POST", "domain" : "wss://openapi.imeritz.com:29443", "url" : "/websocket", "format" : "JSON", "contentType" : "application/json", "description" : "해외주식의 호가창이 바뀔 때마다 매도·매수 10단계 호가와 잔량을 내려보내는 실시간 서비스입니다.\n\ntr_cd 에 \"ohhts_exst_aspr\", tr_key 에 @(예: \"OQ@NVDA\")를 넣어 구독하십시오. 거래소코드는 해외 거래소 조회(/reference/v1/overseas/exchanges)의 ovrs_stck_exch_idno 와 같은 체계입니다.\n\n잔량 항목 이름이 국내 호가와 다릅니다. 매수 잔량은 shnu_aspr_rsqn1~10, 매도 잔량은 seln_aspr_rsqn1~10 이며 국내에서 쓰는 bidp_rsqn·askp_rsqn 은 오지 않습니다. 시각은 현지(acpl_date·acpl_hour)와 한국(korea_date·korea_hour)이 함께 옵니다.\n\n실시간 서비스는 접속점이 하나입니다. 접속하신 뒤 보내는 구독 메시지의 body 안 tr_cd 로 어떤 데이터를 받을지 정합니다.\n\n구독은 header 의 tr_type 에 \"1\", 해지는 같은 tr_cd·tr_key 에 \"2\" 를 넣어 보냅니다. header 의 token 에는 발급받은 접근토큰을 \"Bearer \" 를 붙여 넣으십시오. 접두어가 없으면 EGW00202 로 거절됩니다.\n\n내려오는 메시지는 header 와 body 로 나뉩니다. 한 접속에서 여러 종목·여러 서비스를 구독하셨다면 header 의 tr_cd·tr_key 로 어느 구독의 데이터인지 가려내십시오.", "trs" : [ { "name" : "실시간 해외주식 호가", "code" : "ohhts_exst_aspr", "request" : { "header" : [ ], "body" : [ { "element" : "header", "name" : "헤더부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "구독 메시지의 헤더입니다.", "depth" : 0 }, { "element" : "token", "name" : "접근토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "발급받은 접근토큰에 \"Bearer \" 를 붙여 넣습니다. 세션 한도를 넘기면 WSC00110 이 내려옵니다.", "depth" : 0 }, { "element" : "tr_type", "name" : "거래타입", "type" : "String", "required" : "Y", "length" : "1", "description" : "\"1\" 구독 등록 / \"2\" 구독 해지. 해지는 등록과 같은 tr_cd·tr_key 로 보냅니다.", "depth" : 0 }, { "element" : "body", "name" : "바디부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "구독 대상을 지정합니다.", "depth" : 0 }, { "element" : "tr_cd", "name" : "거래코드", "type" : "String", "required" : "Y", "length" : "20", "description" : "이 API 의 구독 코드입니다. \"ohhts_exst_aspr\" 를 넣으십시오.", "depth" : 0 }, { "element" : "tr_key", "name" : "종목코드", "type" : "String", "required" : "Y", "length" : "19", "description" : "구독할 종목을 거래소코드@종목코드 로 넣습니다. 예) \"OQ@NVDA\"\n거래소코드는 /reference/v1/overseas/exchanges 의 ovrs_stck_exch_idno 와 같은 체계입니다. \"OQ\" 나스닥 · \"NY\" 뉴욕 · \"AX\" 아멕스 · \"HK\" 홍콩 · \"JP\" 도쿄.", "depth" : 0 } ] }, "response" : { "header" : [ ], "body" : [ { "element" : "header", "name" : "헤더부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "어느 구독의 데이터인지 알려줍니다. 한 세션에서 여러 종목을 구독했을 때 이 값으로 구분하십시오.", "depth" : 0 }, { "element" : "tr_cd", "name" : "거래코드", "type" : "String", "required" : "Y", "length" : "20", "description" : "구독 요청에 넣은 tr_cd 가 그대로 옵니다.", "depth" : 0 }, { "element" : "tr_key", "name" : "종목코드", "type" : "String", "required" : "Y", "length" : "19", "description" : "구독 요청에 넣은 tr_key 가 그대로 옵니다.", "depth" : 0 }, { "element" : "body", "name" : "바디부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "해외주식 호가 데이터입니다.", "depth" : 0 }, { "element" : "iscd", "name" : "종목코드", "type" : "String", "required" : "Y", "length" : "19", "description" : "구독한 종목입니다.", "depth" : 0 }, { "element" : "dely_yn", "name" : "지연여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "\"1\" 지연 시세 · \"0\" 실시간 시세입니다.", "depth" : 0 }, { "element" : "acpl_date", "name" : "현지일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "현지 기준 일자입니다. YYYYMMDD 8자리입니다.", "depth" : 0 }, { "element" : "acpl_hour", "name" : "현지시간", "type" : "String", "required" : "Y", "length" : "6", "description" : "현지 기준 시각입니다. HHMMSS 6자리입니다.", "depth" : 0 }, { "element" : "korea_date", "name" : "한국일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "이 호가가 갱신된 한국 기준 일자입니다. 현지 기준 일자는 같은 메시지의 acpl_date 를 쓰십시오.", "depth" : 0 }, { "element" : "korea_hour", "name" : "한국시간", "type" : "String", "required" : "Y", "length" : "6", "description" : "한국 기준 시각입니다. HHMMSS 6자리입니다.", "depth" : 0 }, { "element" : "shnu_aspr_total_rsqn", "name" : "매수호가총잔량", "type" : "String", "required" : "Y", "length" : "12", "description" : "10단계 매수 잔량의 합입니다.", "depth" : 0 }, { "element" : "seln_aspr_total_rsqn", "name" : "매도호가총잔량", "type" : "String", "required" : "Y", "length" : "12", "description" : "10단계 매도 잔량의 합입니다.", "depth" : 0 }, { "element" : "bidp1", "name" : "매수호가1", "type" : "String", "required" : "Y", "length" : "18", "description" : "1번째 매수호가입니다. bidp1 이 최우선입니다.", "depth" : 0 }, { "element" : "askp1", "name" : "매도호가1", "type" : "String", "required" : "Y", "length" : "18", "description" : "1번째 매도호가입니다. askp1 이 최우선입니다.", "depth" : 0 }, { "element" : "shnu_aspr_rsqn1", "name" : "매수호가잔량1", "type" : "String", "required" : "Y", "length" : "12", "description" : "bidp1 의 잔량입니다.", "depth" : 0 }, { "element" : "seln_aspr_rsqn1", "name" : "매도호가잔량1", "type" : "String", "required" : "Y", "length" : "12", "description" : "askp1 의 잔량입니다.", "depth" : 0 }, { "element" : "bidp2", "name" : "매수호가2", "type" : "String", "required" : "Y", "length" : "18", "description" : "2번째 매수호가입니다.", "depth" : 0 }, { "element" : "askp2", "name" : "매도호가2", "type" : "String", "required" : "Y", "length" : "18", "description" : "2번째 매도호가입니다.", "depth" : 0 }, { "element" : "shnu_aspr_rsqn2", "name" : "매수호가잔량2", "type" : "String", "required" : "Y", "length" : "12", "description" : "bidp2 의 잔량입니다.", "depth" : 0 }, { "element" : "seln_aspr_rsqn2", "name" : "매도호가잔량2", "type" : "String", "required" : "Y", "length" : "12", "description" : "askp2 의 잔량입니다.", "depth" : 0 }, { "element" : "bidp3", "name" : "매수호가3", "type" : "String", "required" : "Y", "length" : "18", "description" : "3번째 매수호가입니다.", "depth" : 0 }, { "element" : "askp3", "name" : "매도호가3", "type" : "String", "required" : "Y", "length" : "18", "description" : "3번째 매도호가입니다.", "depth" : 0 }, { "element" : "shnu_aspr_rsqn3", "name" : "매수호가잔량3", "type" : "String", "required" : "Y", "length" : "12", "description" : "bidp3 의 잔량입니다.", "depth" : 0 }, { "element" : "seln_aspr_rsqn3", "name" : "매도호가잔량3", "type" : "String", "required" : "Y", "length" : "12", "description" : "askp3 의 잔량입니다.", "depth" : 0 }, { "element" : "bidp4", "name" : "매수호가4", "type" : "String", "required" : "Y", "length" : "18", "description" : "4번째 매수호가입니다.", "depth" : 0 }, { "element" : "askp4", "name" : "매도호가4", "type" : "String", "required" : "Y", "length" : "18", "description" : "4번째 매도호가입니다.", "depth" : 0 }, { "element" : "shnu_aspr_rsqn4", "name" : "매수호가잔량4", "type" : "String", "required" : "Y", "length" : "12", "description" : "bidp4 의 잔량입니다.", "depth" : 0 }, { "element" : "seln_aspr_rsqn4", "name" : "매도호가잔량4", "type" : "String", "required" : "Y", "length" : "12", "description" : "askp4 의 잔량입니다.", "depth" : 0 }, { "element" : "bidp5", "name" : "매수호가5", "type" : "String", "required" : "Y", "length" : "18", "description" : "5번째 매수호가입니다.", "depth" : 0 }, { "element" : "askp5", "name" : "매도호가5", "type" : "String", "required" : "Y", "length" : "18", "description" : "5번째 매도호가입니다.", "depth" : 0 }, { "element" : "shnu_aspr_rsqn5", "name" : "매수호가잔량5", "type" : "String", "required" : "Y", "length" : "12", "description" : "bidp5 의 잔량입니다.", "depth" : 0 }, { "element" : "seln_aspr_rsqn5", "name" : "매도호가잔량5", "type" : "String", "required" : "Y", "length" : "12", "description" : "askp5 의 잔량입니다.", "depth" : 0 }, { "element" : "bidp6", "name" : "매수호가6", "type" : "String", "required" : "Y", "length" : "18", "description" : "6번째 매수호가입니다.", "depth" : 0 }, { "element" : "askp6", "name" : "매도호가6", "type" : "String", "required" : "Y", "length" : "18", "description" : "6번째 매도호가입니다.", "depth" : 0 }, { "element" : "shnu_aspr_rsqn6", "name" : "매수호가잔량6", "type" : "String", "required" : "Y", "length" : "12", "description" : "bidp6 의 잔량입니다.", "depth" : 0 }, { "element" : "seln_aspr_rsqn6", "name" : "매도호가잔량6", "type" : "String", "required" : "Y", "length" : "12", "description" : "askp6 의 잔량입니다.", "depth" : 0 }, { "element" : "bidp7", "name" : "매수호가7", "type" : "String", "required" : "Y", "length" : "18", "description" : "7번째 매수호가입니다.", "depth" : 0 }, { "element" : "askp7", "name" : "매도호가7", "type" : "String", "required" : "Y", "length" : "18", "description" : "7번째 매도호가입니다.", "depth" : 0 }, { "element" : "shnu_aspr_rsqn7", "name" : "매수호가잔량7", "type" : "String", "required" : "Y", "length" : "12", "description" : "bidp7 의 잔량입니다.", "depth" : 0 }, { "element" : "seln_aspr_rsqn7", "name" : "매도호가잔량7", "type" : "String", "required" : "Y", "length" : "12", "description" : "askp7 의 잔량입니다.", "depth" : 0 }, { "element" : "bidp8", "name" : "매수호가8", "type" : "String", "required" : "Y", "length" : "18", "description" : "8번째 매수호가입니다.", "depth" : 0 }, { "element" : "askp8", "name" : "매도호가8", "type" : "String", "required" : "Y", "length" : "18", "description" : "8번째 매도호가입니다.", "depth" : 0 }, { "element" : "shnu_aspr_rsqn8", "name" : "매수호가잔량8", "type" : "String", "required" : "Y", "length" : "12", "description" : "bidp8 의 잔량입니다.", "depth" : 0 }, { "element" : "seln_aspr_rsqn8", "name" : "매도호가잔량8", "type" : "String", "required" : "Y", "length" : "12", "description" : "askp8 의 잔량입니다.", "depth" : 0 }, { "element" : "bidp9", "name" : "매수호가9", "type" : "String", "required" : "Y", "length" : "18", "description" : "9번째 매수호가입니다.", "depth" : 0 }, { "element" : "askp9", "name" : "매도호가9", "type" : "String", "required" : "Y", "length" : "18", "description" : "9번째 매도호가입니다.", "depth" : 0 }, { "element" : "shnu_aspr_rsqn9", "name" : "매수호가잔량9", "type" : "String", "required" : "Y", "length" : "12", "description" : "bidp9 의 잔량입니다.", "depth" : 0 }, { "element" : "seln_aspr_rsqn9", "name" : "매도호가잔량9", "type" : "String", "required" : "Y", "length" : "12", "description" : "askp9 의 잔량입니다.", "depth" : 0 }, { "element" : "bidp10", "name" : "매수호가10", "type" : "String", "required" : "Y", "length" : "18", "description" : "10번째 매수호가입니다.", "depth" : 0 }, { "element" : "askp10", "name" : "매도호가10", "type" : "String", "required" : "Y", "length" : "18", "description" : "10번째 매도호가입니다.", "depth" : 0 }, { "element" : "shnu_aspr_rsqn10", "name" : "매수호가잔량10", "type" : "String", "required" : "Y", "length" : "12", "description" : "bidp10 의 잔량입니다.", "depth" : 0 }, { "element" : "seln_aspr_rsqn10", "name" : "매도호가잔량10", "type" : "String", "required" : "Y", "length" : "12", "description" : "askp10 의 잔량입니다.", "depth" : 0 }, { "element" : "bidp_total_rsqn_icdc", "name" : "매수총잔량증감", "type" : "String", "required" : "Y", "length" : "12", "description" : "직전 호가 대비 매수 총잔량의 증감입니다.", "depth" : 0 }, { "element" : "askp_total_rsqn_icdc", "name" : "매도총잔량증감", "type" : "String", "required" : "Y", "length" : "12", "description" : "직전 호가 대비 매도 총잔량의 증감입니다.", "depth" : 0 } ] }, "requestExample" : "{\n \"header\": {\n \"token\": \"Bearer {Token값}\",\n \"tr_type\": \"1\"\n },\n \"body\": {\n \"tr_cd\": \"ohhts_exst_aspr\",\n \"tr_key\": \"OQ@NVDA\"\n }\n}", "responseExample" : "{\n \"header\": {\n \"tr_cd\": \"ohhts_exst_aspr\",\n \"tr_key\": \"OQ@NVDA\"\n },\n \"body\": {\n \"iscd\": \"OQ@NVDA\",\n \"dely_yn\": \"1\",\n \"acpl_date\": \"20260827\",\n \"acpl_hour\": \"003955\",\n \"korea_date\": \"20260827\",\n \"korea_hour\": \"133955\",\n \"shnu_aspr_total_rsqn\": \"2074\",\n \"seln_aspr_total_rsqn\": \"908\",\n \"bidp1\": \"221.1100\",\n \"askp1\": \"221.1300\",\n \"shnu_aspr_rsqn1\": \"88\",\n \"seln_aspr_rsqn1\": \"100\",\n \"bidp2\": \"221.1000\",\n \"askp2\": \"221.1400\",\n \"shnu_aspr_rsqn2\": \"424\",\n \"seln_aspr_rsqn2\": \"25\",\n \"bidp3\": \"221.0800\",\n \"askp3\": \"221.1500\",\n \"shnu_aspr_rsqn3\": \"23\",\n \"seln_aspr_rsqn3\": \"5\",\n \"bidp4\": \"221.0700\",\n \"askp4\": \"221.1600\",\n \"shnu_aspr_rsqn4\": \"849\",\n \"seln_aspr_rsqn4\": \"55\",\n \"bidp5\": \"221.0600\",\n \"askp5\": \"221.1700\",\n \"shnu_aspr_rsqn5\": \"28\",\n \"seln_aspr_rsqn5\": \"57\",\n \"bidp6\": \"221.0500\",\n \"askp6\": \"221.1800\",\n \"shnu_aspr_rsqn6\": \"434\",\n \"seln_aspr_rsqn6\": \"70\",\n \"bidp7\": \"221.0400\",\n \"askp7\": \"221.1900\",\n \"shnu_aspr_rsqn7\": \"156\",\n \"seln_aspr_rsqn7\": \"100\",\n \"bidp8\": \"221.0300\",\n \"askp8\": \"221.2000\",\n \"shnu_aspr_rsqn8\": \"22\",\n \"seln_aspr_rsqn8\": \"409\",\n \"bidp9\": \"221.0200\",\n \"askp9\": \"221.2100\",\n \"shnu_aspr_rsqn9\": \"1\",\n \"seln_aspr_rsqn9\": \"67\",\n \"bidp10\": \"221.0100\",\n \"askp10\": \"221.2200\",\n \"shnu_aspr_rsqn10\": \"49\",\n \"seln_aspr_rsqn10\": \"20\",\n \"bidp_total_rsqn_icdc\": \"-56\",\n \"askp_total_rsqn_icdc\": \"0\"\n }\n}" } ] }, { "name" : "(실시간) 해외주식 현재가 (주간거래)", "protocol" : "WEBSOCKET", "method" : "POST", "domain" : "wss://openapi.imeritz.com:29443", "url" : "/websocket", "format" : "JSON", "contentType" : "application/json", "description" : "해외주식 주간거래(한국 낮 시간대에 열리는 시장) 체결을 내려보내는 실시간 서비스입니다. 같은 종목이라도 정규장 체결은 이 서비스로 오지 않으므로 시간대에 맞는 서비스를 구독하십시오.\n\ntr_cd 에 \"ohhts_exst_cntd\", tr_key 에 @(예: \"OQ@NVDA\")를 넣어 구독하십시오.\n\n항목 이름이 국내 실시간과 다릅니다. 종목코드는 iscd, 전일대비 부호는 vrss_sign, 등락률은 rsfl_rt 이며 국내에서 쓰는 shrn_iscd·prdy_vrss_sign·prdy_ctrt 는 오지 않습니다. 지연 시세 여부는 dely_yn 으로 확인하십시오.\n\n실시간 서비스는 접속점이 하나입니다. 접속하신 뒤 보내는 구독 메시지의 body 안 tr_cd 로 어떤 데이터를 받을지 정합니다.\n\n구독은 header 의 tr_type 에 \"1\", 해지는 같은 tr_cd·tr_key 에 \"2\" 를 넣어 보냅니다. header 의 token 에는 발급받은 접근토큰을 \"Bearer \" 를 붙여 넣으십시오. 접두어가 없으면 EGW00202 로 거절됩니다.\n\n내려오는 메시지는 header 와 body 로 나뉩니다. 한 접속에서 여러 종목·여러 서비스를 구독하셨다면 header 의 tr_cd·tr_key 로 어느 구독의 데이터인지 가려내십시오.", "trs" : [ { "name" : "실시간 해외주식 현재가 (주간거래)", "code" : "ohhts_exst_cntd", "request" : { "header" : [ ], "body" : [ { "element" : "header", "name" : "헤더부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "구독 메시지의 헤더입니다.", "depth" : 0 }, { "element" : "token", "name" : "접근토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "발급받은 접근토큰에 \"Bearer \" 를 붙여 넣습니다. 세션 한도를 넘기면 WSC00110 이 내려옵니다.", "depth" : 0 }, { "element" : "tr_type", "name" : "거래타입", "type" : "String", "required" : "Y", "length" : "1", "description" : "\"1\" 구독 등록 / \"2\" 구독 해지. 해지는 등록과 같은 tr_cd·tr_key 로 보냅니다.", "depth" : 0 }, { "element" : "body", "name" : "바디부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "구독 대상을 지정합니다.", "depth" : 0 }, { "element" : "tr_cd", "name" : "거래코드", "type" : "String", "required" : "Y", "length" : "20", "description" : "이 API 의 구독 코드입니다. \"ohhts_exst_cntd\" 를 넣으십시오.", "depth" : 0 }, { "element" : "tr_key", "name" : "종목코드", "type" : "String", "required" : "Y", "length" : "19", "description" : "구독할 종목을 거래소코드@종목코드 로 넣습니다. 예) \"OQ@NVDA\"\n거래소코드는 /reference/v1/overseas/exchanges 의 ovrs_stck_exch_idno 와 같은 체계입니다. \"OQ\" 나스닥 · \"NY\" 뉴욕 · \"AX\" 아멕스 · \"HK\" 홍콩 · \"JP\" 도쿄.", "depth" : 0 } ] }, "response" : { "header" : [ ], "body" : [ { "element" : "header", "name" : "헤더부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "어느 구독의 데이터인지 알려줍니다. 한 세션에서 여러 종목을 구독했을 때 이 값으로 구분하십시오.", "depth" : 0 }, { "element" : "tr_cd", "name" : "거래코드", "type" : "String", "required" : "Y", "length" : "20", "description" : "구독 요청에 넣은 tr_cd 가 그대로 옵니다.", "depth" : 0 }, { "element" : "tr_key", "name" : "종목코드", "type" : "String", "required" : "Y", "length" : "19", "description" : "구독 요청에 넣은 tr_key 가 그대로 옵니다.", "depth" : 0 }, { "element" : "body", "name" : "바디부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "시세 데이터입니다.", "depth" : 0 }, { "element" : "iscd", "name" : "종목코드", "type" : "String", "required" : "Y", "length" : "19", "description" : "구독한 종목입니다.", "depth" : 0 }, { "element" : "dely_yn", "name" : "지연여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "\"1\" 지연 시세 · \"0\" 실시간 시세입니다.", "depth" : 0 }, { "element" : "acpl_bsop_date", "name" : "현지영업일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "현지 영업일입니다. YYYYMMDD 8자리입니다.", "depth" : 0 }, { "element" : "acpl_date", "name" : "현지일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "체결이 일어난 현지 일자입니다.", "depth" : 0 }, { "element" : "acpl_hour", "name" : "현지시간", "type" : "String", "required" : "Y", "length" : "6", "description" : "체결이 일어난 현지 시각입니다. HHMMSS 6자리입니다.", "depth" : 0 }, { "element" : "korea_date", "name" : "한국일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "같은 체결의 한국 기준 일자입니다.", "depth" : 0 }, { "element" : "korea_hour", "name" : "한국시간", "type" : "String", "required" : "Y", "length" : "6", "description" : "같은 체결의 한국 기준 시각입니다.", "depth" : 0 }, { "element" : "oprc", "name" : "시가", "type" : "String", "required" : "Y", "length" : "18", "description" : "해당 세션의 첫 체결 가격입니다.", "depth" : 0 }, { "element" : "hprc", "name" : "고가", "type" : "String", "required" : "Y", "length" : "18", "description" : "해당 세션 중 가장 높았던 체결 가격입니다.", "depth" : 0 }, { "element" : "lprc", "name" : "저가", "type" : "String", "required" : "Y", "length" : "18", "description" : "해당 세션 중 가장 낮았던 체결 가격입니다.", "depth" : 0 }, { "element" : "prpr", "name" : "현재가", "type" : "String", "required" : "Y", "length" : "18", "description" : "가장 최근 체결된 가격입니다.", "depth" : 0 }, { "element" : "vrss_sign", "name" : "전일대비부호", "type" : "String", "required" : "Y", "length" : "1", "description" : "전일 종가 대비 방향입니다.", "depth" : 0 }, { "element" : "prdy_vrss", "name" : "전일대비", "type" : "String", "required" : "Y", "length" : "18", "description" : "전일 종가와의 차이입니다.", "depth" : 0 }, { "element" : "rsfl_rt", "name" : "등락률", "type" : "String", "required" : "Y", "length" : "12", "description" : "전일 종가 대비 등락률(%)입니다.", "depth" : 0 }, { "element" : "bidp", "name" : "매수호가", "type" : "String", "required" : "Y", "length" : "18", "description" : "체결 시점의 최우선 매수호가입니다.", "depth" : 0 }, { "element" : "shnu_aspr_rsqn", "name" : "매수호가잔량", "type" : "String", "required" : "Y", "length" : "12", "description" : "최우선 매수호가의 잔량입니다.", "depth" : 0 }, { "element" : "askp", "name" : "매도호가", "type" : "String", "required" : "Y", "length" : "18", "description" : "체결 시점의 최우선 매도호가입니다.", "depth" : 0 }, { "element" : "seln_aspr_rsqn", "name" : "매도호가잔량", "type" : "String", "required" : "Y", "length" : "12", "description" : "최우선 매도호가의 잔량입니다.", "depth" : 0 }, { "element" : "cnqn", "name" : "체결량", "type" : "String", "required" : "Y", "length" : "12", "description" : "이번 체결의 수량입니다.", "depth" : 0 }, { "element" : "acml_vol", "name" : "누적거래량", "type" : "String", "required" : "Y", "length" : "12", "description" : "해당 세션의 누적 체결 수량입니다.", "depth" : 0 }, { "element" : "acml_tr_pbmn", "name" : "누적거래대금", "type" : "String", "required" : "Y", "length" : "18", "description" : "해당 세션의 누적 체결 금액입니다.", "depth" : 0 }, { "element" : "mkt_cls", "name" : "장구분", "type" : "String", "required" : "Y", "length" : "1", "description" : "장 구분입니다.", "depth" : 0 }, { "element" : "shnu_acml_cnqn", "name" : "매수누적체결량", "type" : "String", "required" : "Y", "length" : "12", "description" : "누적 매수 체결 수량입니다.", "depth" : 0 }, { "element" : "seln_acml_cnqn", "name" : "매도누적체결량", "type" : "String", "required" : "Y", "length" : "12", "description" : "누적 매도 체결 수량입니다.", "depth" : 0 }, { "element" : "rltv", "name" : "체결강도", "type" : "String", "required" : "Y", "length" : "12", "description" : "매수 체결량을 매도 체결량으로 나눈 비율(%)입니다.", "depth" : 0 }, { "element" : "prdy_vrss_oprc_rate", "name" : "시가대비율", "type" : "String", "required" : "Y", "length" : "12", "description" : "시가 대비 현재가의 등락률(%)입니다.", "depth" : 0 }, { "element" : "prdy_vrss_hprc_rate", "name" : "고가대비율", "type" : "String", "required" : "Y", "length" : "12", "description" : "고가 대비 현재가의 등락률(%)입니다.", "depth" : 0 }, { "element" : "prdy_vrss_lprc_rate", "name" : "저가대비율", "type" : "String", "required" : "Y", "length" : "12", "description" : "저가 대비 현재가의 등락률(%)입니다.", "depth" : 0 } ] }, "requestExample" : "{\n \"header\": {\n \"token\": \"Bearer {Token값}\",\n \"tr_type\": \"1\"\n },\n \"body\": {\n \"tr_cd\": \"ohhts_exst_cntd\",\n \"tr_key\": \"OQ@NVDA\"\n }\n}", "responseExample" : "{\n \"header\": {\n \"tr_cd\": \"ohhts_exst_cntd\",\n \"tr_key\": \"OQ@NVDA\"\n },\n \"body\": {\n \"iscd\": \"OQ@NVDA\",\n \"dely_yn\": \"1\",\n \"acpl_bsop_date\": \"20260827\",\n \"acpl_date\": \"20260827\",\n \"acpl_hour\": \"003955\",\n \"korea_date\": \"20260827\",\n \"korea_hour\": \"133955\",\n \"oprc\": \"212.6400\",\n \"hprc\": \"213.6000\",\n \"lprc\": \"209.2300\",\n \"prpr\": \"221.1100\",\n \"vrss_sign\": \"2\",\n \"prdy_vrss\": \"11.4500\",\n \"rsfl_rt\": \"5.46\",\n \"bidp\": \"221.1100\",\n \"shnu_aspr_rsqn\": \"144\",\n \"askp\": \"221.1300\",\n \"seln_aspr_rsqn\": \"100\",\n \"cnqn\": \"28\",\n \"acml_vol\": \"1652980\",\n \"acml_tr_pbmn\": \"364322395\",\n \"mkt_cls\": \"4\",\n \"shnu_acml_cnqn\": \"27858444\",\n \"seln_acml_cnqn\": \"62469619\",\n \"rltv\": \"44.60\",\n \"prdy_vrss_oprc_rate\": \"-0.19\",\n \"prdy_vrss_hprc_rate\": \"0.26\",\n \"prdy_vrss_lprc_rate\": \"-1.79\"\n }\n}" } ] }, { "name" : "(실시간) 해외주식 현재가 (정규장)", "protocol" : "WEBSOCKET", "method" : "POST", "domain" : "wss://openapi.imeritz.com:29443", "url" : "/websocket", "format" : "JSON", "contentType" : "application/json", "description" : "해외주식 정규장 체결을 내려보내는 실시간 서비스입니다. 주간거래와 애프터마켓 체결은 각각 다른 서비스로 오므로 보시려는 시간대에 맞는 tr_cd 를 구독하십시오.\n\ntr_cd 에 \"ohhts_exst_cntg\", tr_key 에 @(예: \"OQ@NVDA\")를 넣어 구독하십시오.\n\n항목 이름이 국내 실시간과 다릅니다. 종목코드는 iscd, 전일대비 부호는 vrss_sign, 등락률은 rsfl_rt 이며 국내에서 쓰는 shrn_iscd·prdy_vrss_sign·prdy_ctrt 는 오지 않습니다. 지연 시세 여부는 dely_yn 으로 확인하십시오.\n\n실시간 서비스는 접속점이 하나입니다. 접속하신 뒤 보내는 구독 메시지의 body 안 tr_cd 로 어떤 데이터를 받을지 정합니다.\n\n구독은 header 의 tr_type 에 \"1\", 해지는 같은 tr_cd·tr_key 에 \"2\" 를 넣어 보냅니다. header 의 token 에는 발급받은 접근토큰을 \"Bearer \" 를 붙여 넣으십시오. 접두어가 없으면 EGW00202 로 거절됩니다.\n\n내려오는 메시지는 header 와 body 로 나뉩니다. 한 접속에서 여러 종목·여러 서비스를 구독하셨다면 header 의 tr_cd·tr_key 로 어느 구독의 데이터인지 가려내십시오.", "trs" : [ { "name" : "실시간 해외주식 현재가 (미국 정규장)", "code" : "ohhts_exst_cntg", "request" : { "header" : [ ], "body" : [ { "element" : "header", "name" : "헤더부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "구독 메시지의 헤더입니다.", "depth" : 0 }, { "element" : "token", "name" : "접근토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "발급받은 접근토큰에 \"Bearer \" 를 붙여 넣습니다. 세션 한도를 넘기면 WSC00110 이 내려옵니다.", "depth" : 0 }, { "element" : "tr_type", "name" : "거래타입", "type" : "String", "required" : "Y", "length" : "1", "description" : "\"1\" 구독 등록 / \"2\" 구독 해지. 해지는 등록과 같은 tr_cd·tr_key 로 보냅니다.", "depth" : 0 }, { "element" : "body", "name" : "바디부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "구독 대상을 지정합니다.", "depth" : 0 }, { "element" : "tr_cd", "name" : "거래코드", "type" : "String", "required" : "Y", "length" : "20", "description" : "이 API 의 구독 코드입니다. \"ohhts_exst_cntg\" 를 넣으십시오.", "depth" : 0 }, { "element" : "tr_key", "name" : "종목코드", "type" : "String", "required" : "Y", "length" : "19", "description" : "구독할 종목을 거래소코드@종목코드 로 넣습니다. 예) \"OQ@NVDA\"\n거래소코드는 /reference/v1/overseas/exchanges 의 ovrs_stck_exch_idno 와 같은 체계입니다. \"OQ\" 나스닥 · \"NY\" 뉴욕 · \"AX\" 아멕스 · \"HK\" 홍콩 · \"JP\" 도쿄.", "depth" : 0 } ] }, "response" : { "header" : [ ], "body" : [ { "element" : "header", "name" : "헤더부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "어느 구독의 데이터인지 알려줍니다. 한 세션에서 여러 종목을 구독했을 때 이 값으로 구분하십시오.", "depth" : 0 }, { "element" : "tr_cd", "name" : "거래코드", "type" : "String", "required" : "Y", "length" : "20", "description" : "구독 요청에 넣은 tr_cd 가 그대로 옵니다.", "depth" : 0 }, { "element" : "tr_key", "name" : "종목코드", "type" : "String", "required" : "Y", "length" : "19", "description" : "구독 요청에 넣은 tr_key 가 그대로 옵니다.", "depth" : 0 }, { "element" : "body", "name" : "바디부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "시세 데이터입니다.", "depth" : 0 }, { "element" : "iscd", "name" : "종목코드", "type" : "String", "required" : "Y", "length" : "19", "description" : "구독한 종목입니다.", "depth" : 0 }, { "element" : "dely_yn", "name" : "지연여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "\"1\" 지연 시세 · \"0\" 실시간 시세입니다.", "depth" : 0 }, { "element" : "acpl_bsop_date", "name" : "현지영업일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "현지 영업일입니다. YYYYMMDD 8자리입니다.", "depth" : 0 }, { "element" : "acpl_date", "name" : "현지일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "체결이 일어난 현지 일자입니다.", "depth" : 0 }, { "element" : "acpl_hour", "name" : "현지시간", "type" : "String", "required" : "Y", "length" : "6", "description" : "체결이 일어난 현지 시각입니다. HHMMSS 6자리입니다.", "depth" : 0 }, { "element" : "korea_date", "name" : "한국일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "같은 체결의 한국 기준 일자입니다.", "depth" : 0 }, { "element" : "korea_hour", "name" : "한국시간", "type" : "String", "required" : "Y", "length" : "6", "description" : "같은 체결의 한국 기준 시각입니다.", "depth" : 0 }, { "element" : "oprc", "name" : "시가", "type" : "String", "required" : "Y", "length" : "18", "description" : "해당 세션의 첫 체결 가격입니다.", "depth" : 0 }, { "element" : "hprc", "name" : "고가", "type" : "String", "required" : "Y", "length" : "18", "description" : "해당 세션 중 가장 높았던 체결 가격입니다.", "depth" : 0 }, { "element" : "lprc", "name" : "저가", "type" : "String", "required" : "Y", "length" : "18", "description" : "해당 세션 중 가장 낮았던 체결 가격입니다.", "depth" : 0 }, { "element" : "prpr", "name" : "현재가", "type" : "String", "required" : "Y", "length" : "18", "description" : "가장 최근 체결된 가격입니다.", "depth" : 0 }, { "element" : "vrss_sign", "name" : "전일대비부호", "type" : "String", "required" : "Y", "length" : "1", "description" : "전일 종가 대비 방향입니다.", "depth" : 0 }, { "element" : "prdy_vrss", "name" : "전일대비", "type" : "String", "required" : "Y", "length" : "18", "description" : "전일 종가와의 차이입니다.", "depth" : 0 }, { "element" : "rsfl_rt", "name" : "등락률", "type" : "String", "required" : "Y", "length" : "12", "description" : "전일 종가 대비 등락률(%)입니다.", "depth" : 0 }, { "element" : "bidp", "name" : "매수호가", "type" : "String", "required" : "Y", "length" : "18", "description" : "체결 시점의 최우선 매수호가입니다.", "depth" : 0 }, { "element" : "shnu_aspr_rsqn", "name" : "매수호가잔량", "type" : "String", "required" : "Y", "length" : "12", "description" : "최우선 매수호가의 잔량입니다.", "depth" : 0 }, { "element" : "askp", "name" : "매도호가", "type" : "String", "required" : "Y", "length" : "18", "description" : "체결 시점의 최우선 매도호가입니다.", "depth" : 0 }, { "element" : "seln_aspr_rsqn", "name" : "매도호가잔량", "type" : "String", "required" : "Y", "length" : "12", "description" : "최우선 매도호가의 잔량입니다.", "depth" : 0 }, { "element" : "cnqn", "name" : "체결량", "type" : "String", "required" : "Y", "length" : "12", "description" : "이번 체결의 수량입니다.", "depth" : 0 }, { "element" : "acml_vol", "name" : "누적거래량", "type" : "String", "required" : "Y", "length" : "12", "description" : "해당 세션의 누적 체결 수량입니다.", "depth" : 0 }, { "element" : "acml_tr_pbmn", "name" : "누적거래대금", "type" : "String", "required" : "Y", "length" : "18", "description" : "해당 세션의 누적 체결 금액입니다.", "depth" : 0 }, { "element" : "mkt_cls", "name" : "장구분", "type" : "String", "required" : "Y", "length" : "1", "description" : "장 구분입니다.", "depth" : 0 }, { "element" : "shnu_acml_cnqn", "name" : "매수누적체결량", "type" : "String", "required" : "Y", "length" : "12", "description" : "누적 매수 체결 수량입니다.", "depth" : 0 }, { "element" : "seln_acml_cnqn", "name" : "매도누적체결량", "type" : "String", "required" : "Y", "length" : "12", "description" : "누적 매도 체결 수량입니다.", "depth" : 0 }, { "element" : "rltv", "name" : "체결강도", "type" : "String", "required" : "Y", "length" : "12", "description" : "매수 체결량을 매도 체결량으로 나눈 비율(%)입니다.", "depth" : 0 }, { "element" : "prdy_vrss_oprc_rate", "name" : "시가대비율", "type" : "String", "required" : "Y", "length" : "12", "description" : "시가 대비 현재가의 등락률(%)입니다.", "depth" : 0 }, { "element" : "prdy_vrss_hprc_rate", "name" : "고가대비율", "type" : "String", "required" : "Y", "length" : "12", "description" : "고가 대비 현재가의 등락률(%)입니다.", "depth" : 0 }, { "element" : "prdy_vrss_lprc_rate", "name" : "저가대비율", "type" : "String", "required" : "Y", "length" : "12", "description" : "저가 대비 현재가의 등락률(%)입니다.", "depth" : 0 } ] }, "requestExample" : "{\n \"header\": {\n \"token\": \"Bearer {Token값}\",\n \"tr_type\": \"1\"\n },\n \"body\": {\n \"tr_cd\": \"ohhts_exst_cntg\",\n \"tr_key\": \"OQ@NVDA\"\n }\n}", "responseExample" : "{\n \"header\": {\n \"tr_cd\": \"ohhts_exst_cntg\",\n \"tr_key\": \"OQ@NVDA\"\n },\n \"body\": {\n \"iscd\": \"OQ@NVDA\",\n \"dely_yn\": \"1\",\n \"acpl_bsop_date\": \"20260827\",\n \"acpl_date\": \"20260827\",\n \"acpl_hour\": \"003955\",\n \"korea_date\": \"20260827\",\n \"korea_hour\": \"133955\",\n \"oprc\": \"212.6400\",\n \"hprc\": \"213.6000\",\n \"lprc\": \"209.2300\",\n \"prpr\": \"221.1100\",\n \"vrss_sign\": \"2\",\n \"prdy_vrss\": \"11.4500\",\n \"rsfl_rt\": \"5.46\",\n \"bidp\": \"221.1100\",\n \"shnu_aspr_rsqn\": \"144\",\n \"askp\": \"221.1300\",\n \"seln_aspr_rsqn\": \"100\",\n \"cnqn\": \"28\",\n \"acml_vol\": \"1652980\",\n \"acml_tr_pbmn\": \"364322395\",\n \"mkt_cls\": \"4\",\n \"shnu_acml_cnqn\": \"27858444\",\n \"seln_acml_cnqn\": \"62469619\",\n \"rltv\": \"44.60\",\n \"prdy_vrss_oprc_rate\": \"-0.19\",\n \"prdy_vrss_hprc_rate\": \"0.26\",\n \"prdy_vrss_lprc_rate\": \"-1.79\"\n }\n}" } ] }, { "name" : "(실시간) 해외주식 현재가 (After)", "protocol" : "WEBSOCKET", "method" : "POST", "domain" : "wss://openapi.imeritz.com:29443", "url" : "/websocket", "format" : "JSON", "contentType" : "application/json", "description" : "해외주식 애프터마켓(정규장 종료 뒤) 체결을 내려보내는 실시간 서비스입니다. 정규장 체결은 이 서비스로 오지 않습니다.\n\ntr_cd 에 \"ohhts_exst_cnta\", tr_key 에 @(예: \"OQ@NVDA\")를 넣어 구독하십시오.\n\n항목 이름이 국내 실시간과 다릅니다. 종목코드는 iscd, 전일대비 부호는 vrss_sign, 등락률은 rsfl_rt 입니다. 애프터마켓에서는 체결이 뜸할 수 있으므로 데이터가 오지 않는 동안을 접속 끊김으로 보지 마십시오.\n\n실시간 서비스는 접속점이 하나입니다. 접속하신 뒤 보내는 구독 메시지의 body 안 tr_cd 로 어떤 데이터를 받을지 정합니다.\n\n구독은 header 의 tr_type 에 \"1\", 해지는 같은 tr_cd·tr_key 에 \"2\" 를 넣어 보냅니다. header 의 token 에는 발급받은 접근토큰을 \"Bearer \" 를 붙여 넣으십시오. 접두어가 없으면 EGW00202 로 거절됩니다.\n\n내려오는 메시지는 header 와 body 로 나뉩니다. 한 접속에서 여러 종목·여러 서비스를 구독하셨다면 header 의 tr_cd·tr_key 로 어느 구독의 데이터인지 가려내십시오.", "trs" : [ { "name" : "실시간 해외주식 현재가 (장후)", "code" : "ohhts_exst_cnta", "request" : { "header" : [ ], "body" : [ { "element" : "header", "name" : "헤더부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "구독 메시지의 헤더입니다.", "depth" : 0 }, { "element" : "token", "name" : "접근토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "발급받은 접근토큰에 \"Bearer \" 를 붙여 넣습니다. 세션 한도를 넘기면 WSC00110 이 내려옵니다.", "depth" : 0 }, { "element" : "tr_type", "name" : "거래타입", "type" : "String", "required" : "Y", "length" : "1", "description" : "\"1\" 구독 등록 / \"2\" 구독 해지. 해지는 등록과 같은 tr_cd·tr_key 로 보냅니다.", "depth" : 0 }, { "element" : "body", "name" : "바디부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "구독 대상을 지정합니다.", "depth" : 0 }, { "element" : "tr_cd", "name" : "거래코드", "type" : "String", "required" : "Y", "length" : "20", "description" : "이 API 의 구독 코드입니다. \"ohhts_exst_cnta\" 를 넣으십시오.", "depth" : 0 }, { "element" : "tr_key", "name" : "종목코드", "type" : "String", "required" : "Y", "length" : "19", "description" : "구독할 종목을 거래소코드@종목코드 로 넣습니다. 예) \"OQ@NVDA\"\n거래소코드는 /reference/v1/overseas/exchanges 의 ovrs_stck_exch_idno 와 같은 체계입니다. \"OQ\" 나스닥 · \"NY\" 뉴욕 · \"AX\" 아멕스 · \"HK\" 홍콩 · \"JP\" 도쿄.", "depth" : 0 } ] }, "response" : { "header" : [ ], "body" : [ { "element" : "header", "name" : "헤더부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "어느 구독의 데이터인지 알려줍니다. 한 세션에서 여러 종목을 구독했을 때 이 값으로 구분하십시오.", "depth" : 0 }, { "element" : "tr_cd", "name" : "거래코드", "type" : "String", "required" : "Y", "length" : "20", "description" : "구독 요청에 넣은 tr_cd 가 그대로 옵니다.", "depth" : 0 }, { "element" : "tr_key", "name" : "종목코드", "type" : "String", "required" : "Y", "length" : "19", "description" : "구독 요청에 넣은 tr_key 가 그대로 옵니다.", "depth" : 0 }, { "element" : "body", "name" : "바디부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "시세 데이터입니다.", "depth" : 0 }, { "element" : "iscd", "name" : "종목코드", "type" : "String", "required" : "Y", "length" : "19", "description" : "구독한 종목입니다.", "depth" : 0 }, { "element" : "dely_yn", "name" : "지연여부", "type" : "String", "required" : "Y", "length" : "1", "description" : "\"1\" 지연 시세 · \"0\" 실시간 시세입니다.", "depth" : 0 }, { "element" : "acpl_bsop_date", "name" : "현지영업일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "현지 영업일입니다. YYYYMMDD 8자리입니다.", "depth" : 0 }, { "element" : "acpl_date", "name" : "현지일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "체결이 일어난 현지 일자입니다.", "depth" : 0 }, { "element" : "acpl_hour", "name" : "현지시간", "type" : "String", "required" : "Y", "length" : "6", "description" : "체결이 일어난 현지 시각입니다. HHMMSS 6자리입니다.", "depth" : 0 }, { "element" : "korea_date", "name" : "한국일자", "type" : "String", "required" : "Y", "length" : "8", "description" : "같은 체결의 한국 기준 일자입니다.", "depth" : 0 }, { "element" : "korea_hour", "name" : "한국시간", "type" : "String", "required" : "Y", "length" : "6", "description" : "같은 체결의 한국 기준 시각입니다.", "depth" : 0 }, { "element" : "oprc", "name" : "시가", "type" : "String", "required" : "Y", "length" : "18", "description" : "해당 세션의 첫 체결 가격입니다.", "depth" : 0 }, { "element" : "hprc", "name" : "고가", "type" : "String", "required" : "Y", "length" : "18", "description" : "해당 세션 중 가장 높았던 체결 가격입니다.", "depth" : 0 }, { "element" : "lprc", "name" : "저가", "type" : "String", "required" : "Y", "length" : "18", "description" : "해당 세션 중 가장 낮았던 체결 가격입니다.", "depth" : 0 }, { "element" : "prpr", "name" : "현재가", "type" : "String", "required" : "Y", "length" : "18", "description" : "가장 최근 체결된 가격입니다.", "depth" : 0 }, { "element" : "vrss_sign", "name" : "전일대비부호", "type" : "String", "required" : "Y", "length" : "1", "description" : "전일 종가 대비 방향입니다.", "depth" : 0 }, { "element" : "prdy_vrss", "name" : "전일대비", "type" : "String", "required" : "Y", "length" : "18", "description" : "전일 종가와의 차이입니다.", "depth" : 0 }, { "element" : "rsfl_rt", "name" : "등락률", "type" : "String", "required" : "Y", "length" : "12", "description" : "전일 종가 대비 등락률(%)입니다.", "depth" : 0 }, { "element" : "bidp", "name" : "매수호가", "type" : "String", "required" : "Y", "length" : "18", "description" : "체결 시점의 최우선 매수호가입니다.", "depth" : 0 }, { "element" : "shnu_aspr_rsqn", "name" : "매수호가잔량", "type" : "String", "required" : "Y", "length" : "12", "description" : "최우선 매수호가의 잔량입니다.", "depth" : 0 }, { "element" : "askp", "name" : "매도호가", "type" : "String", "required" : "Y", "length" : "18", "description" : "체결 시점의 최우선 매도호가입니다.", "depth" : 0 }, { "element" : "seln_aspr_rsqn", "name" : "매도호가잔량", "type" : "String", "required" : "Y", "length" : "12", "description" : "최우선 매도호가의 잔량입니다.", "depth" : 0 }, { "element" : "cnqn", "name" : "체결량", "type" : "String", "required" : "Y", "length" : "12", "description" : "이번 체결의 수량입니다.", "depth" : 0 }, { "element" : "acml_vol", "name" : "누적거래량", "type" : "String", "required" : "Y", "length" : "12", "description" : "해당 세션의 누적 체결 수량입니다.", "depth" : 0 }, { "element" : "acml_tr_pbmn", "name" : "누적거래대금", "type" : "String", "required" : "Y", "length" : "18", "description" : "해당 세션의 누적 체결 금액입니다.", "depth" : 0 }, { "element" : "mkt_cls", "name" : "장구분", "type" : "String", "required" : "Y", "length" : "1", "description" : "장 구분입니다.", "depth" : 0 }, { "element" : "shnu_acml_cnqn", "name" : "매수누적체결량", "type" : "String", "required" : "Y", "length" : "12", "description" : "누적 매수 체결 수량입니다.", "depth" : 0 }, { "element" : "seln_acml_cnqn", "name" : "매도누적체결량", "type" : "String", "required" : "Y", "length" : "12", "description" : "누적 매도 체결 수량입니다.", "depth" : 0 }, { "element" : "rltv", "name" : "체결강도", "type" : "String", "required" : "Y", "length" : "12", "description" : "매수 체결량을 매도 체결량으로 나눈 비율(%)입니다.", "depth" : 0 }, { "element" : "prdy_vrss_oprc_rate", "name" : "시가대비율", "type" : "String", "required" : "Y", "length" : "12", "description" : "시가 대비 현재가의 등락률(%)입니다.", "depth" : 0 }, { "element" : "prdy_vrss_hprc_rate", "name" : "고가대비율", "type" : "String", "required" : "Y", "length" : "12", "description" : "고가 대비 현재가의 등락률(%)입니다.", "depth" : 0 }, { "element" : "prdy_vrss_lprc_rate", "name" : "저가대비율", "type" : "String", "required" : "Y", "length" : "12", "description" : "저가 대비 현재가의 등락률(%)입니다.", "depth" : 0 } ] }, "requestExample" : "{\n \"header\": {\n \"token\": \"Bearer {Token값}\",\n \"tr_type\": \"1\"\n },\n \"body\": {\n \"tr_cd\": \"ohhts_exst_cnta\",\n \"tr_key\": \"OQ@NVDA\"\n }\n}", "responseExample" : "{\n \"header\": {\n \"tr_cd\": \"ohhts_exst_cnta\",\n \"tr_key\": \"OQ@NVDA\"\n },\n \"body\": {\n \"iscd\": \"OQ@NVDA\",\n \"dely_yn\": \"1\",\n \"acpl_bsop_date\": \"20260827\",\n \"acpl_date\": \"20260827\",\n \"acpl_hour\": \"003955\",\n \"korea_date\": \"20260827\",\n \"korea_hour\": \"133955\",\n \"oprc\": \"212.6400\",\n \"hprc\": \"213.6000\",\n \"lprc\": \"209.2300\",\n \"prpr\": \"221.1100\",\n \"vrss_sign\": \"2\",\n \"prdy_vrss\": \"11.4500\",\n \"rsfl_rt\": \"5.46\",\n \"bidp\": \"221.1100\",\n \"shnu_aspr_rsqn\": \"144\",\n \"askp\": \"221.1300\",\n \"seln_aspr_rsqn\": \"100\",\n \"cnqn\": \"28\",\n \"acml_vol\": \"1652980\",\n \"acml_tr_pbmn\": \"364322395\",\n \"mkt_cls\": \"4\",\n \"shnu_acml_cnqn\": \"27858444\",\n \"seln_acml_cnqn\": \"62469619\",\n \"rltv\": \"44.60\",\n \"prdy_vrss_oprc_rate\": \"-0.19\",\n \"prdy_vrss_hprc_rate\": \"0.26\",\n \"prdy_vrss_lprc_rate\": \"-1.79\"\n }\n}" } ] }, { "name" : "(실시간) 해외주식 주문 접수·체결 통보", "protocol" : "WEBSOCKET", "method" : "POST", "domain" : "wss://openapi.imeritz.com:29443", "url" : "/websocket", "format" : "JSON", "contentType" : "application/json", "description" : "내 계좌의 해외주식 주문이 접수·정정·취소되거나 체결될 때 통보를 받습니다.", "trs" : [ { "name" : "실시간 해외주식 주문 접수·체결 통보", "code" : "ohhts_cntg_exst", "request" : { "header" : [ ], "body" : [ { "element" : "header", "name" : "헤더부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "구독 메시지의 헤더입니다.", "depth" : 0 }, { "element" : "token", "name" : "접근토큰", "type" : "String", "required" : "Y", "length" : "1000", "description" : "발급받은 접근토큰에 \"Bearer \" 를 붙여 넣습니다. 세션 한도를 넘기면 WSC00110 이 내려옵니다.", "depth" : 0 }, { "element" : "tr_type", "name" : "거래타입", "type" : "String", "required" : "Y", "length" : "1", "description" : "\"1\" 구독 등록 / \"2\" 구독 해지. 해지는 등록과 같은 tr_cd·tr_key 로 보냅니다.", "depth" : 0 }, { "element" : "body", "name" : "바디부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "구독 대상을 지정합니다.", "depth" : 0 }, { "element" : "tr_cd", "name" : "거래코드", "type" : "String", "required" : "Y", "length" : "20", "description" : "이 API 의 구독 코드입니다. \"ohhts_cntg_exst\" 를 넣으십시오.", "depth" : 0 } ] }, "response" : { "header" : [ ], "body" : [ { "element" : "header", "name" : "헤더부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "어느 구독의 데이터인지 알려줍니다. 한 세션에서 여러 종목을 구독했을 때 이 값으로 구분하십시오.", "depth" : 0 }, { "element" : "tr_cd", "name" : "거래코드", "type" : "String", "required" : "Y", "length" : "20", "description" : "구독 요청에 넣은 tr_cd 가 그대로 옵니다.", "depth" : 0 }, { "element" : "tr_key", "name" : "사용자ID", "type" : "String", "required" : "Y", "length" : "20", "description" : "접근토큰의 사용자 ID 입니다. 통보를 받는 사용자를 나타냅니다.", "depth" : 0 }, { "element" : "body", "name" : "바디부", "type" : "Object", "required" : "Y", "length" : "-", "description" : "주문 통보 내용입니다.", "depth" : 0 }, { "element" : "user_id", "name" : "사용자ID", "type" : "String", "required" : "Y", "length" : "-", "description" : "통보 대상 사용자 ID 입니다.", "depth" : 0 }, { "element" : "acnm", "name" : "계좌명", "type" : "String", "required" : "Y", "length" : "-", "description" : "계좌 예금주명입니다.", "depth" : 0 }, { "element" : "pros_srno", "name" : "처리일련번호", "type" : "String", "required" : "Y", "length" : "-", "description" : "처리 일련번호입니다.", "depth" : 0 }, { "element" : "svc_id", "name" : "서비스ID", "type" : "String", "required" : "Y", "length" : "-", "description" : "통보를 구분하는 식별 값입니다.", "depth" : 0 }, { "element" : "acno", "name" : "계좌번호", "type" : "String", "required" : "Y", "length" : "-", "description" : "주문이 접수된 계좌번호입니다. 토큰에 매핑된 계좌입니다.", "depth" : 0 }, { "element" : "asno", "name" : "계좌일련번호", "type" : "String", "required" : "Y", "length" : "-", "description" : "계좌일련번호입니다.", "depth" : 0 }, { "element" : "stnd_iscd", "name" : "표준종목코드", "type" : "String", "required" : "Y", "length" : "-", "description" : "표준 종목코드(ISIN)입니다. 예) \"US89458T4031\".", "depth" : 0 }, { "element" : "iscd_name", "name" : "종목명", "type" : "String", "required" : "Y", "length" : "-", "description" : "종목의 이름입니다.", "depth" : 0 }, { "element" : "iscd", "name" : "종목코드", "type" : "String", "required" : "Y", "length" : "-", "description" : "심볼과 거래소를 점으로 이은 종목 코드입니다. 예) \"TGL.OQ\".", "depth" : 0 }, { "element" : "ovrs_stck_mrkt_cls_code", "name" : "해외주식시장구분코드", "type" : "String", "required" : "Y", "length" : "-", "description" : "해외주식 시장 구분입니다. 예) \"01\".", "depth" : 0 }, { "element" : "symb", "name" : "심볼", "type" : "String", "required" : "Y", "length" : "-", "description" : "종목 심볼입니다. 예) \"TGL\".", "depth" : 0 }, { "element" : "ovrs_exch_vndr_idno", "name" : "해외거래소벤더식별번호", "type" : "String", "required" : "Y", "length" : "-", "description" : "거래소 코드입니다. 주문 API 의 ovrs_exch_vndr_idno 와 같은 값입니다. 예) \"0537\"(나스닥).", "depth" : 0 }, { "element" : "crcd", "name" : "통화코드", "type" : "String", "required" : "Y", "length" : "-", "description" : "거래 통화입니다. 예) \"USD\".", "depth" : 0 }, { "element" : "byov_unit_qty", "name" : "매수단위수량", "type" : "String", "required" : "Y", "length" : "-", "description" : "매수 주문 단위 수량입니다.", "depth" : 0 }, { "element" : "seln_unit_qty", "name" : "매도단위수량", "type" : "String", "required" : "Y", "length" : "-", "description" : "매도 주문 단위 수량입니다.", "depth" : 0 }, { "element" : "dcpn_loeq_ciph", "name" : "소수점이하자릿수", "type" : "String", "required" : "Y", "length" : "-", "description" : "가격의 소수점 이하 자릿수입니다. 예) \"0004\".", "depth" : 0 }, { "element" : "oder_date", "name" : "주문일자", "type" : "String", "required" : "Y", "length" : "-", "description" : "주문 일자입니다. YYYYMMDD 8자리입니다.", "depth" : 0 }, { "element" : "oder_no", "name" : "주문번호", "type" : "String", "required" : "Y", "length" : "-", "description" : "주문번호입니다. 접수·체결 통보를 잇는 키입니다.", "depth" : 0 }, { "element" : "orgl_oder_no", "name" : "원주문번호", "type" : "String", "required" : "Y", "length" : "-", "description" : "정정·취소 주문이면 원주문의 번호입니다.", "depth" : 0 }, { "element" : "mbcr_oder_time", "name" : "회원사주문시각", "type" : "String", "required" : "Y", "length" : "-", "description" : "증권사가 주문을 접수한 시각입니다. HHMMSSmmm 9자리입니다.", "depth" : 0 }, { "element" : "deal_cls_code", "name" : "매매구분코드", "type" : "String", "required" : "Y", "length" : "-", "description" : "매도·매수 구분입니다.", "depth" : 0 }, { "element" : "rctf_cncl_cls_code", "name" : "정정취소구분코드", "type" : "String", "required" : "Y", "length" : "-", "description" : "주문 종류입니다. 신규 \"1\" · 정정 \"2\" · 취소 \"3\".", "depth" : 0 }, { "element" : "aspr_prc", "name" : "호가가격", "type" : "String", "required" : "Y", "length" : "-", "description" : "주문 가격입니다. 예) \".688\".", "depth" : 0 }, { "element" : "tlms_aspr_qty", "name" : "전문호가수량", "type" : "String", "required" : "Y", "length" : "-", "description" : "주문 수량입니다.", "depth" : 0 }, { "element" : "aspr_cond_clcd", "name" : "호가조건구분코드", "type" : "String", "required" : "Y", "length" : "-", "description" : "호가 조건 구분입니다. 예) \"0\".", "depth" : 0 }, { "element" : "aspr_type_code", "name" : "호가유형코드", "type" : "String", "required" : "Y", "length" : "-", "description" : "호가 유형입니다. 예) \"2\".", "depth" : 0 }, { "element" : "aspr_rfus_reas_code", "name" : "호가거부사유코드", "type" : "String", "required" : "Y", "length" : "-", "description" : "주문이 거부된 사유 코드입니다.", "depth" : 0 }, { "element" : "cntg_date", "name" : "체결일자", "type" : "String", "required" : "Y", "length" : "-", "description" : "체결 일자입니다. YYYYMMDD 8자리입니다.", "depth" : 0 }, { "element" : "cntg_pros_time", "name" : "체결처리시각", "type" : "String", "required" : "Y", "length" : "-", "description" : "체결 처리 시각입니다. HHMMSSmmm 9자리입니다.", "depth" : 0 }, { "element" : "cntg_prc", "name" : "체결가격", "type" : "String", "required" : "Y", "length" : "-", "description" : "체결된 가격입니다.", "depth" : 0 }, { "element" : "cntg_qty", "name" : "체결수량", "type" : "String", "required" : "Y", "length" : "-", "description" : "이번에 체결된 수량입니다.", "depth" : 0 }, { "element" : "rfus_reas", "name" : "거부사유", "type" : "String", "required" : "Y", "length" : "-", "description" : "거부 사유입니다.", "depth" : 0 }, { "element" : "rsln_able_yn", "name" : "재매도가능여부", "type" : "String", "required" : "Y", "length" : "-", "description" : "재매도 가능 여부입니다. 예) \"Y\".", "depth" : 0 }, { "element" : "loan_date", "name" : "대출일자", "type" : "String", "required" : "Y", "length" : "-", "description" : "대출일자입니다.", "depth" : 0 }, { "element" : "nw_loan_srno", "name" : "신대출일련번호", "type" : "String", "required" : "Y", "length" : "-", "description" : "신 대출 일련번호입니다.", "depth" : 0 }, { "element" : "loan_dtl_type_code", "name" : "대출상세유형코드", "type" : "String", "required" : "Y", "length" : "-", "description" : "대출 상세 유형입니다.", "depth" : 0 }, { "element" : "crdt_adup_oder_yn", "name" : "신용합산주문여부", "type" : "String", "required" : "Y", "length" : "-", "description" : "신용 합산 주문 여부입니다.", "depth" : 0 } ] }, "requestExample" : "{\n \"header\": {\n \"token\": \"Bearer {Token값}\",\n \"tr_type\": \"1\"\n },\n \"body\": {\n \"tr_cd\": \"ohhts_cntg_exst\"\n }\n}", "responseExample" : "{\n \"header\": {\n \"tr_cd\": \"ohhts_cntg_exst\",\n \"tr_key\": \"hong1234\"\n },\n \"body\": {\n \"user_id\": \"hong1234\",\n \"acnm\": \"홍길동\",\n \"pros_srno\": \"0\",\n \"svc_id\": \"OVSMEM20001\",\n \"acno\": \"12345678\",\n \"asno\": \"01\",\n \"stnd_iscd\": \"US89458T4031\",\n \"iscd_name\": \"트레저 글로벌\",\n \"iscd\": \"TGL.OQ\",\n \"ovrs_stck_mrkt_cls_code\": \"01\",\n \"symb\": \"TGL\",\n \"ovrs_exch_vndr_idno\": \"0537\",\n \"crcd\": \"USD\",\n \"byov_unit_qty\": \"000000000000000001\",\n \"seln_unit_qty\": \"000000000000000001\",\n \"dcpn_loeq_ciph\": \"0004\",\n \"oder_date\": \"20261014\",\n \"oder_no\": \"1741315\",\n \"orgl_oder_no\": \"0\",\n \"mbcr_oder_time\": \"204144000\",\n \"deal_cls_code\": \"1\",\n \"rctf_cncl_cls_code\": \"1\",\n \"aspr_prc\": \".688\",\n \"tlms_aspr_qty\": \"1\",\n \"aspr_cond_clcd\": \"0\",\n \"aspr_type_code\": \"2\",\n \"aspr_rfus_reas_code\": \"\",\n \"cntg_date\": \"\",\n \"cntg_pros_time\": \"000\",\n \"cntg_prc\": \"0.0000\",\n \"cntg_qty\": \"0\",\n \"rfus_reas\": \"\",\n \"rsln_able_yn\": \"Y\",\n \"loan_date\": \"\",\n \"nw_loan_srno\": \"0000000000\",\n \"loan_dtl_type_code\": \"\",\n \"crdt_adup_oder_yn\": \"\"\n }\n}\n\n{\n \"header\": {\n \"tr_cd\": \"ohhts_cntg_exst\",\n \"tr_key\": \"hong1234\"\n },\n \"body\": {\n \"user_id\": \"hong1234\",\n \"acnm\": \"홍길동\",\n \"pros_srno\": \"0\",\n \"svc_id\": \"OVSMEM20007\",\n \"acno\": \"12345678\",\n \"asno\": \"01\",\n \"stnd_iscd\": \"US89458T4031\",\n \"iscd_name\": \"트레저 글로벌\",\n \"iscd\": \"TGL.OQ\",\n \"ovrs_stck_mrkt_cls_code\": \"01\",\n \"symb\": \"TGL\",\n \"ovrs_exch_vndr_idno\": \"0537\",\n \"crcd\": \"USD\",\n \"byov_unit_qty\": \"000000000000000001\",\n \"seln_unit_qty\": \"000000000000000001\",\n \"dcpn_loeq_ciph\": \"0004\",\n \"oder_date\": \"20261014\",\n \"oder_no\": \"1741315\",\n \"orgl_oder_no\": \"0\",\n \"mbcr_oder_time\": \"204144000\",\n \"deal_cls_code\": \"1\",\n \"rctf_cncl_cls_code\": \"1\",\n \"aspr_prc\": \".688\",\n \"tlms_aspr_qty\": \"1\",\n \"aspr_cond_clcd\": \"0\",\n \"aspr_type_code\": \"2\",\n \"aspr_rfus_reas_code\": \"\",\n \"cntg_date\": \"20261014\",\n \"cntg_pros_time\": \"204144000\",\n \"cntg_prc\": \"0.6883\",\n \"cntg_qty\": \"1\",\n \"rfus_reas\": \"\",\n \"rsln_able_yn\": \"Y\",\n \"loan_date\": \"\",\n \"nw_loan_srno\": \"0000000000\",\n \"loan_dtl_type_code\": \"\",\n \"crdt_adup_oder_yn\": \"\"\n }\n}" } ] } ] } ] }