요청 본문 필드 필드 타입 필수 설명
X-Next-Request-Id string 필수 요청 추적 ID (누락 시 400 request-id-required). 응답과 에러 envelope 의 requestId 로 반환된다
grant_type string 필수 client_credentials 고정
client_id string 필수 발급받은 client_id
client_secret string 필수
마켓
시세 조회 (현재가·호가·등락) GET /v1/market/quotes
시세 조회 (현재가·호가·등락)
요청 파라미터 필드 타입 필수 설명
symbols string 필수 종목 심볼(쉼표로 다종목 가능)
X-Next-Request-Id string 필수 요청 추적 ID (누락 시 400 request-id-required). 응답과 에러 envelope 의 requestId 로 반환된다
마켓
캔들 조회 GET /v1/market/candles
캔들 조회
요청 파라미터 필드 타입 필수 설명
symbol string 필수 종목 심볼
interval string 필수 봉 주기. 1d 의 하루는 KST 자정이 아니라 거래일(정규장) 경계
from string 선택 시작 시각(생략 시 자동). ISO 8601 · KST — 오프셋 생략 시 KST 로 간주
to string 선택 종료 시각(생략 시 현재). ISO 8601 · KST — 오프셋 생략 시 KST 로 간주
요청 파라미터 필드 타입 필수 설명
base string 필수 기준 통화 — ISO 4217
quote string 필수 상대 통화 — ISO 4217 (필수 — 코어와 동일하게 base·quote 둘 다 required)
X-Next-Request-Id string 필수 요청 추적 ID (누락 시 400 request-id-required). 응답과 에러 envelope 의 requestId 로 반환된다
마켓
거래소 운영 정보 GET /v1/market/calendar
거래소 운영 정보
요청 파라미터 필드 타입 필수 설명
from string 선택 조회 시작일 — YYYY-MM-DD, 거래소 현지(ET) 기준. 생략 시 오늘
to string 선택 조회 종료일 — 생략 시 from 과 동일(당일). 최대 1년
market string 선택 시장 구분
X-Next-Request-Id string 필수
종목
종목 목록 조회 GET /v1/instruments
종목 목록 조회
요청 파라미터 필드 타입 필수 설명
type string 선택 자산 구분 필터. 생략 시 전체
search string 선택 심볼/종목명 검색어
tradable string 선택 거래 가능 상태 필터(쉼표로 다중 지정) — 부록 B 참조
dayMarketTradable boolean 선택 주간거래(DAY) 가능 종목만 필터
요청 파라미터 필드 타입 필수 설명
symbol string 필수 종목 심볼
X-Next-Request-Id string 필수 요청 추적 ID (누락 시 400 request-id-required). 응답과 에러 envelope 의 requestId 로 반환된다
계좌·자산
계좌 조회 GET /v1/account
계좌 조회
요청 파라미터 필드 타입 필수 설명
X-Next-Request-Id string 필수 요청 추적 ID (누락 시 400 request-id-required). 응답과 에러 envelope 의 requestId 로 반환된다
응답 필드 필드 타입 필수 설명
accountId string 필수
currency string 필수
계좌·자산
보유 주식 조회 GET /v1/account/holdings
보유 주식 조회
요청 파라미터 필드 타입 필수 설명
X-Next-Request-Id string 필수 요청 추적 ID (누락 시 400 request-id-required). 응답과 에러 envelope 의 requestId 로 반환된다
응답 필드 필드 타입 필수 설명
currency string 필수 통화 — USD
holdings Holding[]
요청 파라미터 필드 타입 필수 설명
X-Next-Request-Id string 필수 요청 추적 ID (누락 시 400 request-id-required). 응답과 에러 envelope 의 requestId 로 반환된다
응답 필드 필드 타입 필수 설명
accountId string 필수
currency string 필수
주문
주문 미리보기 POST /v1/orders/preview
주문 미리보기
요청 본문 필드 필드 타입 필수 설명
X-Next-Request-Id string 필수 요청 추적 ID (누락 시 400 request-id-required). 응답과 에러 envelope 의 requestId 로 반환된다
symbol string 필수 종목 심볼
side string 필수 매매 구분
orderType string 필수
주문
주문 목록 조회 GET /v1/orders
주문 목록 조회
요청 파라미터 필드 타입 필수 설명
status string 선택 상태 필터 — OPEN(진행 중) · CLOSED(종결)
market string 선택 시장구분 — US
symbol string 선택 종목 심볼
from string 선택 조회 시작 — ISO 8601 · KST (오프셋 생략 시 KST 로 간주)
주문
주문 생성 POST /v1/orders
주문 생성
요청 본문 필드 필드 타입 필수 설명
X-Next-Request-Id string 필수 요청 추적 ID (누락 시 400 request-id-required). 응답과 에러 envelope 의 requestId 로 반환된다
symbol string 필수 종목 심볼
side string 필수 매매 구분
orderType string 필수 주문 유형(가격 축) — MARKET=시장가, LIMIT=지정가(limitPrice 필수). VWAP·TWAP 는 알고리즘 주문(실거래 전용). 개장·마감 동시호가는 별도 값이 아니라 timeInForce=OPG/CLS 조합으로 지정한다 (부록 C 직교 축)
주문
주문 상세 조회 GET /v1/orders/{orderId}
주문 상세 조회
요청 파라미터 필드 타입 필수 설명
orderId string 필수
X-Next-Request-Id string 필수 요청 추적 ID (누락 시 400 request-id-required). 응답과 에러 envelope 의 requestId 로 반환된다
주문
주문 취소 DEL /v1/orders/{orderId}
주문 취소
요청 파라미터 필드 타입 필수 설명
orderId string 필수
X-Next-Request-Id string 필수 요청 추적 ID (누락 시 400 request-id-required). 응답과 에러 envelope 의 requestId 로 반환된다
주문
체결 내역 조회 GET /v1/orders/fills
체결 내역 조회
요청 파라미터 필드 타입 필수 설명
orderId string 선택 주문 ID — 특정 주문의 체결만
symbol string 선택
from string 선택 조회 시작 — ISO 8601 · KST (오프셋 생략 시 KST 로 간주)
to string 선택 조회 종료 — ISO 8601 · KST
발급받은 client_secret
응답 필드 필드 타입 필수 설명
access_token string 필수
token_type string 필수
expires_in integer 필수
에러 응답 유형 상태 사유
400 실패 — validation
401 실패 — authentication
403 실패 — permission
404 실패 — not_found
429 실패 — rate_limit
500 실패 — server
에러 응답 필드 (공통) 필드 타입 필수 설명
type string 필수 에러 분류 — HTTP 상태와 1:1 매핑 (validation=400, authentication=401, permission=403, not_found=404, conflict=409, locked=423, business_rule=422, rate_limit=429, server=500)
code string 필수 프로그램 분기용 안정 코드(kebab-case). 전체 목록은 문서 루트 x-error-codes 참조
message string 필수 사용자 표시용 메시지 — {placeholder} 는 data 값으로 치환돼 내려간다
param string 선택 검증 실패한 파라미터명(해당 시)
requestId string 선택 X-Next-Request-Id 헤더와 동일한 요청 추적 ID
data object 선택 메시지 placeholder 치환 값 등 부가 정보
docUrl string 필수 해당 에러코드 문서 URL
curl https://next-openapi-api-dev.tripleauth.com/v1/oauth/token \ --request POST \ --header 'X-Next-Request-Id: cf171974-5c5b-401b-8709-0266efb0730c' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --data 'grant_type=client_credentials&client_id=pk_test_demo&client_secret=sk_test_demo_secret'
필수
에러 응답 유형 상태 사유
400 실패 — validation
401 실패 — authentication
403 실패 — permission
404 실패 — not_found
429 실패 — rate_limit
500 실패 — server
에러 응답 필드 (공통) 필드 타입 필수 설명
type string 필수 에러 분류 — HTTP 상태와 1:1 매핑 (validation=400, authentication=401, permission=403, not_found=404, conflict=409, locked=423, business_rule=422, rate_limit=429, server=500)
code string 필수 프로그램 분기용 안정 코드(kebab-case). 전체 목록은 문서 루트 x-error-codes 참조
message string 필수 사용자 표시용 메시지 — {placeholder} 는 data 값으로 치환돼 내려간다
param string 선택 검증 실패한 파라미터명(해당 시)
requestId string 선택 X-Next-Request-Id 헤더와 동일한 요청 추적 ID
data object 선택 메시지 placeholder 치환 값 등 부가 정보
docUrl string 필수 해당 에러코드 문서 URL
curl 'https://next-openapi-api-dev.tripleauth.com/v1/market/quotes?symbols=AAPL,TSLA,MSFT' \ --header 'Authorization: Bearer {access_token}' \ --header 'X-Next-Request-Id: 9f2e51c4-4caa-4e8c-aacc-2b19b9f494c1'
limit integer 선택 최대 개수(기본 500, 최대 1000)
sessions string 선택 세션 필터(쉼표로 다세션 가능, 기본 REGULAR). 한국 낮 시간대는 DAY(주간거래) 세션이라 기본값으로는 빈 candles 일 수 있다 — 주간거래 봉이 필요하면 DAY 를 명시
cursor string 선택 다음 페이지 커서 — 이전 응답의 nextCursor
X-Next-Request-Id string 필수 요청 추적 ID (누락 시 400 request-id-required). 응답과 에러 envelope 의 requestId 로 반환된다
응답 필드 필드 타입 필수 설명
symbol string 필수
interval string 필수
candles Candle[] 필수
nextCursor string 선택 다음 페이지 커서 — 없으면 마지막 페이지. from(또는 cursor) 지정 조회에서만 제공
에러 응답 유형 상태 사유
400 실패 — validation
401 실패 — authentication
403 실패 — permission
404 실패 — not_found
429 실패 — rate_limit
500 실패 — server
에러 응답 필드 (공통) 필드 타입 필수 설명
type string 필수 에러 분류 — HTTP 상태와 1:1 매핑 (validation=400, authentication=401, permission=403, not_found=404, conflict=409, locked=423, business_rule=422, rate_limit=429, server=500)
code string 필수 프로그램 분기용 안정 코드(kebab-case). 전체 목록은 문서 루트 x-error-codes 참조
message string 필수 사용자 표시용 메시지 — {placeholder} 는 data 값으로 치환돼 내려간다
param string 선택 검증 실패한 파라미터명(해당 시)
requestId string 선택 X-Next-Request-Id 헤더와 동일한 요청 추적 ID
data object 선택 메시지 placeholder 치환 값 등 부가 정보
docUrl string 필수 해당 에러코드 문서 URL
curl 'https://next-openapi-api-dev.tripleauth.com/v1/market/candles?symbol=AAPL&interval=1d&from=2026-06-20T09:00:00+09:00&to=2026-06-27T09:00:00&limit=500&sessions=REGULAR,AFTER&cursor={cursor}' \ --header 'Authorization: Bearer {access_token}' \ --header 'X-Next-Request-Id: 7c326f1e-7e75-4ced-9632-3315ca1d5395'
타입
필수
설명
baseCurrency string 필수 기준 통화 — ISO 4217
quoteCurrency string 필수 상대 통화 — ISO 4217
askRate number 필수 외화 매수 시 적용 환율 — 고객이 기준 통화(USD)를 살 때
bidRate number 필수 외화 매도 시 적용 환율 — 고객이 기준 통화(USD)를 팔 때
requestedAt string 필수 조회 기준 시각 — ISO 8601 · KST
에러 응답 유형 상태 사유
400 실패 — validation
401 실패 — authentication
403 실패 — permission
404 실패 — not_found
429 실패 — rate_limit
500 실패 — server
에러 응답 필드 (공통) 필드 타입 필수 설명
type string 필수 에러 분류 — HTTP 상태와 1:1 매핑 (validation=400, authentication=401, permission=403, not_found=404, conflict=409, locked=423, business_rule=422, rate_limit=429, server=500)
code string 필수 프로그램 분기용 안정 코드(kebab-case). 전체 목록은 문서 루트 x-error-codes 참조
message string 필수 사용자 표시용 메시지 — {placeholder} 는 data 값으로 치환돼 내려간다
param string 선택 검증 실패한 파라미터명(해당 시)
requestId string 선택 X-Next-Request-Id 헤더와 동일한 요청 추적 ID
data object 선택 메시지 placeholder 치환 값 등 부가 정보
docUrl string 필수 해당 에러코드 문서 URL
curl 'https://next-openapi-api-dev.tripleauth.com/v1/market/exchange-rate?base=USD"e=KRW' \ --header 'Authorization: Bearer {access_token}' \ --header 'X-Next-Request-Id: 516a6e0b-0202-4d0e-b32d-7ba6c0fae582'
요청 추적 ID (누락 시 400 request-id-required). 응답과 에러 envelope 의 requestId 로 반환된다
에러 응답 유형 상태 사유
400 실패 — validation
401 실패 — authentication
403 실패 — permission
429 실패 — rate_limit
500 실패 — server
에러 응답 필드 (공통) 필드 타입 필수 설명
type string 필수 에러 분류 — HTTP 상태와 1:1 매핑 (validation=400, authentication=401, permission=403, not_found=404, conflict=409, locked=423, business_rule=422, rate_limit=429, server=500)
code string 필수 프로그램 분기용 안정 코드(kebab-case). 전체 목록은 문서 루트 x-error-codes 참조
message string 필수 사용자 표시용 메시지 — {placeholder} 는 data 값으로 치환돼 내려간다
param string 선택 검증 실패한 파라미터명(해당 시)
requestId string 선택 X-Next-Request-Id 헤더와 동일한 요청 추적 ID
data object 선택 메시지 placeholder 치환 값 등 부가 정보
docUrl string 필수 해당 에러코드 문서 URL
curl 'https://next-openapi-api-dev.tripleauth.com/v1/market/calendar?from=2026-06-25&to=2026-06-30&market=US' \ --header 'Authorization: Bearer {access_token}' \ --header 'X-Next-Request-Id: 75ef763d-a10c-4a86-b42f-0beec6052da6'
limit integer 선택 최대 개수(기본 100, 최대 500)
X-Next-Request-Id string 필수 요청 추적 ID (누락 시 400 request-id-required). 응답과 에러 envelope 의 requestId 로 반환된다
응답 필드 필드 타입 필수 설명
instruments Instrument[] 필수
에러 응답 유형 상태 사유
400 실패 — validation
401 실패 — authentication
403 실패 — permission
429 실패 — rate_limit
500 실패 — server
에러 응답 필드 (공통) 필드 타입 필수 설명
type string 필수 에러 분류 — HTTP 상태와 1:1 매핑 (validation=400, authentication=401, permission=403, not_found=404, conflict=409, locked=423, business_rule=422, rate_limit=429, server=500)
code string 필수 프로그램 분기용 안정 코드(kebab-case). 전체 목록은 문서 루트 x-error-codes 참조
message string 필수 사용자 표시용 메시지 — {placeholder} 는 data 값으로 치환돼 내려간다
param string 선택 검증 실패한 파라미터명(해당 시)
requestId string 선택 X-Next-Request-Id 헤더와 동일한 요청 추적 ID
data object 선택 메시지 placeholder 치환 값 등 부가 정보
docUrl string 필수 해당 에러코드 문서 URL
curl 'https://next-openapi-api-dev.tripleauth.com/v1/instruments?type=COMMON_STOCK&search=AAPL&tradable=TRADABLE,SELL_ONLY&dayMarketTradable=true&limit=100' \ --header 'Authorization: Bearer {access_token}' \ --header 'X-Next-Request-Id: d5dbb5b2-7e92-4eb2-9b3e-327b952b2d7f'
type string 필수 자산 구분 — COMMON_STOCK · PREFERRED_STOCK · DR · ETF
exchange string 선택 거래소 코드 (MIC)
tradable string 필수 거래 가능 상태(부록 B) — TRADABLE · SELL_ONLY · BUY_ONLY · SUSPENDED
dayMarketTradable boolean 필수 주간거래(DAY) 가능 여부 — false 면 세션이 열려 있어도 주문 불가 (부록 A 참조)
에러 응답 유형 상태 사유
400 실패 — validation
401 실패 — authentication
403 실패 — permission
404 실패 — not_found
429 실패 — rate_limit
500 실패 — server
에러 응답 필드 (공통) 필드 타입 필수 설명
type string 필수 에러 분류 — HTTP 상태와 1:1 매핑 (validation=400, authentication=401, permission=403, not_found=404, conflict=409, locked=423, business_rule=422, rate_limit=429, server=500)
code string 필수 프로그램 분기용 안정 코드(kebab-case). 전체 목록은 문서 루트 x-error-codes 참조
message string 필수 사용자 표시용 메시지 — {placeholder} 는 data 값으로 치환돼 내려간다
param string 선택 검증 실패한 파라미터명(해당 시)
requestId string 선택 X-Next-Request-Id 헤더와 동일한 요청 추적 ID
data object 선택 메시지 placeholder 치환 값 등 부가 정보
docUrl string 필수 해당 에러코드 문서 URL
curl https://next-openapi-api-dev.tripleauth.com/v1/instruments/AAPL \ --header 'Authorization: Bearer {access_token}' \ --header 'X-Next-Request-Id: 34e65dd6-fdd3-46ae-85da-c38b7fbfb38b'
통화 — USD. v1 은 미국 주식 전용이라 고정이나, 향후 확장을 위해 필드로 명시
requestedAt string 필수 조회 기준 시각(계좌서버 질의 시점) — ISO 8601 · KST
에러 응답 유형 상태 사유
400 실패 — validation
401 실패 — authentication
403 실패 — permission
404 실패 — not_found
429 실패 — rate_limit
500 실패 — server
에러 응답 필드 (공통) 필드 타입 필수 설명
type string 필수 에러 분류 — HTTP 상태와 1:1 매핑 (validation=400, authentication=401, permission=403, not_found=404, conflict=409, locked=423, business_rule=422, rate_limit=429, server=500)
code string 필수 프로그램 분기용 안정 코드(kebab-case). 전체 목록은 문서 루트 x-error-codes 참조
message string 필수 사용자 표시용 메시지 — {placeholder} 는 data 값으로 치환돼 내려간다
param string 선택 검증 실패한 파라미터명(해당 시)
requestId string 선택 X-Next-Request-Id 헤더와 동일한 요청 추적 ID
data object 선택 메시지 placeholder 치환 값 등 부가 정보
docUrl string 필수 해당 에러코드 문서 URL
curl https://next-openapi-api-dev.tripleauth.com/v1/account \ --header 'Authorization: Bearer {access_token}' \ --header 'X-Next-Request-Id: 881ef774-a4da-4679-98ff-830dd7cddce2'
필수
보유 종목 목록 — 없으면 빈 배열
requestedAt string 필수 조회 기준 시각 — ISO 8601 · KST
에러 응답 유형 상태 사유
400 실패 — validation
401 실패 — authentication
403 실패 — permission
429 실패 — rate_limit
500 실패 — server
에러 응답 필드 (공통) 필드 타입 필수 설명
type string 필수 에러 분류 — HTTP 상태와 1:1 매핑 (validation=400, authentication=401, permission=403, not_found=404, conflict=409, locked=423, business_rule=422, rate_limit=429, server=500)
code string 필수 프로그램 분기용 안정 코드(kebab-case). 전체 목록은 문서 루트 x-error-codes 참조
message string 필수 사용자 표시용 메시지 — {placeholder} 는 data 값으로 치환돼 내려간다
param string 선택 검증 실패한 파라미터명(해당 시)
requestId string 선택 X-Next-Request-Id 헤더와 동일한 요청 추적 ID
data object 선택 메시지 placeholder 치환 값 등 부가 정보
docUrl string 필수 해당 에러코드 문서 URL
curl https://next-openapi-api-dev.tripleauth.com/v1/account/holdings \ --header 'Authorization: Bearer {access_token}' \ --header 'X-Next-Account-Id: {account_id}' \ --header 'X-Next-Request-Id: 561fb2f5-dea4-46f1-b7fa-2821b225f28a'
buyingPower number 필수 주문 가능 금액
requestedAt string 필수 조회 기준 시각 — ISO 8601 · KST
에러 응답 유형 상태 사유
400 실패 — validation
401 실패 — authentication
403 실패 — permission
404 실패 — not_found
429 실패 — rate_limit
500 실패 — server
에러 응답 필드 (공통) 필드 타입 필수 설명
type string 필수 에러 분류 — HTTP 상태와 1:1 매핑 (validation=400, authentication=401, permission=403, not_found=404, conflict=409, locked=423, business_rule=422, rate_limit=429, server=500)
code string 필수 프로그램 분기용 안정 코드(kebab-case). 전체 목록은 문서 루트 x-error-codes 참조
message string 필수 사용자 표시용 메시지 — {placeholder} 는 data 값으로 치환돼 내려간다
param string 선택 검증 실패한 파라미터명(해당 시)
requestId string 선택 X-Next-Request-Id 헤더와 동일한 요청 추적 ID
data object 선택 메시지 placeholder 치환 값 등 부가 정보
docUrl string 필수 해당 에러코드 문서 URL
curl https://next-openapi-api-dev.tripleauth.com/v1/account/buying-power \ --header 'Authorization: Bearer {access_token}' \ --header 'X-Next-Account-Id: {account_id}' \ --header 'X-Next-Request-Id: ccab2b65-1262-4d30-9879-d49008acb70e'
주문 유형(가격 축) — MARKET=시장가, LIMIT=지정가(limitPrice 필수). VWAP·TWAP 는 알고리즘 주문(실거래 전용). 개장·마감 동시호가는 별도 값이 아니라 timeInForce=OPG/CLS 조합으로 지정한다 (부록 C 직교 축)
quantity number 필수 주문 수량 (소수주 가능)
limitPrice number 선택 지정가 (orderType=LIMIT 일 때 필수)
timeInForce string 선택 주문 조건(유효기간 축) — DAY=당일, IOC=즉시 체결 후 잔량 취소, FOK=전량 아니면 취소, OPG=개장 동시호가, CLS=마감 동시호가. 기본 DAY. VWAP/TWAP 는 DAY 만 허용(부록 C.3)
clientOrderId string 필수 클라이언트 주문 고유 ID(UUID 권장, 최대 64자) — 필수. 멱등성 키: 같은 ID 재전송 시 중복 접수되지 않는다. 미리보기는 body 공유를 위해 받되 값을 사용하지 않는다
응답 필드 필드 타입 필수 설명
valid boolean 필수 주문 가능 여부 — false 면 rejectReason 확인
market string 필수 시장구분 — US
currency string 필수 통화 — USD
estimatedQuantity number 필수 예상 주문 수량 — 수량 주문은 입력값 그대로(금액 주문 지원 시 산출 수량)
estimatedPrice number 필수 예상 체결 단가 — 시장가는 현재가 기준 추정, 지정가는 주문 가격
orderAmount number 필수 주문 금액 — 수량 × 단가
estimatedFee number 필수 예상 수수료 — 모의투자(Paper)는 0(정책 확정). 코어(실거래) 연동 시 실값
estimatedTax number 필수 예상 세금 — 모의투자(Paper)는 0(정책 확정). 코어(실거래) 연동 시 실값
estimatedTotal number 필수 예상 총액 — 매수: 주문금액+수수료+세금 / 매도: 수령 예상액(주문금액-수수료-세금)
rejectReason string 선택 거부 사유 — 주문 가능하면 null
에러 응답 유형 상태 사유
400 실패 — validation
401 실패 — authentication
403 실패 — permission
404 실패 — not_found
422 실패 — business_rule
429 실패 — rate_limit
500 실패 — server
에러 응답 필드 (공통) 필드 타입 필수 설명
type string 필수 에러 분류 — HTTP 상태와 1:1 매핑 (validation=400, authentication=401, permission=403, not_found=404, conflict=409, locked=423, business_rule=422, rate_limit=429, server=500)
code string 필수 프로그램 분기용 안정 코드(kebab-case). 전체 목록은 문서 루트 x-error-codes 참조
message string 필수 사용자 표시용 메시지 — {placeholder} 는 data 값으로 치환돼 내려간다
param string 선택 검증 실패한 파라미터명(해당 시)
requestId string 선택 X-Next-Request-Id 헤더와 동일한 요청 추적 ID
data object 선택 메시지 placeholder 치환 값 등 부가 정보
docUrl string 필수 해당 에러코드 문서 URL
curl https://next-openapi-api-dev.tripleauth.com/v1/orders/preview \ --request POST \ --header 'Authorization: Bearer {access_token}' \ --header 'X-Next-Account-Id: {account_id}' \ --header 'X-Next-Request-Id: 628ecc1b-224e-4150-85fb-868226f70ee4' \ --header 'Content-Type: application/json' \ --data '{ "symbol": "AAPL", "side": "BUY", "orderType": "LIMIT", "quantity": 10, "limitPrice": 225, "timeInForce": "DAY", "clientOrderId": "0c1a4e9e-6c2f-4d3a-9f1b-2e8c5a7d4b01", "market": "US" }'
to string 선택 조회 종료 — ISO 8601 · KST
limit integer 선택 최대 개수(기본 100, 최대 500)
cursor string 선택 다음 페이지 커서 — 이전 응답의 nextCursor
X-Next-Request-Id string 필수 요청 추적 ID (누락 시 400 request-id-required). 응답과 에러 envelope 의 requestId 로 반환된다
응답 필드 필드 타입 필수 설명
orders OrderDetailResponse[] 필수 주문 목록 — 주문 상세와 동일 구조
nextCursor string 선택 다음 페이지 커서 — 없으면 마지막 페이지
에러 응답 유형 상태 사유
400 실패 — validation
401 실패 — authentication
403 실패 — permission
429 실패 — rate_limit
500 실패 — server
에러 응답 필드 (공통) 필드 타입 필수 설명
type string 필수 에러 분류 — HTTP 상태와 1:1 매핑 (validation=400, authentication=401, permission=403, not_found=404, conflict=409, locked=423, business_rule=422, rate_limit=429, server=500)
code string 필수 프로그램 분기용 안정 코드(kebab-case). 전체 목록은 문서 루트 x-error-codes 참조
message string 필수 사용자 표시용 메시지 — {placeholder} 는 data 값으로 치환돼 내려간다
param string 선택 검증 실패한 파라미터명(해당 시)
requestId string 선택 X-Next-Request-Id 헤더와 동일한 요청 추적 ID
data object 선택 메시지 placeholder 치환 값 등 부가 정보
docUrl string 필수 해당 에러코드 문서 URL
curl 'https://next-openapi-api-dev.tripleauth.com/v1/orders?status={status}&market={market}&symbol=AAPL&from={from}&to={to}&limit=100&cursor={cursor}' \ --header 'Authorization: Bearer {access_token}' \ --header 'X-Next-Account-Id: {account_id}' \ --header 'X-Next-Request-Id: e6022ea8-cde3-4196-88e7-1e8a5c7f22df'
quantity number 필수 주문 수량 (소수주 가능)
limitPrice number 선택 지정가 (orderType=LIMIT 일 때 필수)
timeInForce string 선택 주문 조건(유효기간 축) — DAY=당일, IOC=즉시 체결 후 잔량 취소, FOK=전량 아니면 취소, OPG=개장 동시호가, CLS=마감 동시호가. 기본 DAY. VWAP/TWAP 는 DAY 만 허용(부록 C.3)
clientOrderId string 필수 클라이언트 주문 고유 ID(UUID 권장, 최대 64자) — 필수. 멱등성 키: 같은 ID 재전송 시 중복 접수되지 않는다. 미리보기는 body 공유를 위해 받되 값을 사용하지 않는다
응답 필드 필드 타입 필수 설명
orderId string 필수 주문 ID — 서버 생성. 이후 조회·취소에 사용
market string 필수 시장구분 — US
status string 필수 주문 상태 — SUBMITTED(접수 완료·체결 대기), PARTIALLY_FILLED(일부 체결), PENDING_CANCEL(취소 요청 접수·아직 미확정 — 원주문이 체결될 수 있으므로 재주문 금지), FILLED(전량 체결), CANCELED(취소 확정: 사용자 요청·거래소·정정), EXPIRED(유효기간 만료 또는 DAY 주문 장 마감; 부분체결분은 filledQuantity 에 유지), REJECTED(거부: 사유는 rejectReason)
requestedAt string 필수 접수 시각 — ISO 8601 · KST
에러 응답 유형 상태 사유
400 실패 — validation
401 실패 — authentication
403 실패 — permission
404 실패 — not_found
409 실패 — conflict
422 실패 — business_rule
423 실패 — locked
429 실패 — rate_limit
500 실패 — server
에러 응답 필드 (공통) 필드 타입 필수 설명
type string 필수 에러 분류 — HTTP 상태와 1:1 매핑 (validation=400, authentication=401, permission=403, not_found=404, conflict=409, locked=423, business_rule=422, rate_limit=429, server=500)
code string 필수 프로그램 분기용 안정 코드(kebab-case). 전체 목록은 문서 루트 x-error-codes 참조
message string 필수 사용자 표시용 메시지 — {placeholder} 는 data 값으로 치환돼 내려간다
param string 선택 검증 실패한 파라미터명(해당 시)
requestId string 선택 X-Next-Request-Id 헤더와 동일한 요청 추적 ID
data object 선택 메시지 placeholder 치환 값 등 부가 정보
docUrl string 필수 해당 에러코드 문서 URL
curl https://next-openapi-api-dev.tripleauth.com/v1/orders \ --request POST \ --header 'Authorization: Bearer {access_token}' \ --header 'X-Next-Account-Id: {account_id}' \ --header 'X-Next-Request-Id: 222b5be8-5829-4890-8ae3-c700f674a95d' \ --header 'Content-Type: application/json' \ --data '{ "symbol": "AAPL", "side": "BUY", "orderType": "LIMIT", "quantity": 10, "limitPrice": 225, "timeInForce": "DAY", "clientOrderId": "0c1a4e9e-6c2f-4d3a-9f1b-2e8c5a7d4b01", "market": "US" }'
requestId string 선택 클라이언트 주문 ID (요청의 clientOrderId. 필수화 이전 주문은 null 가능)
orderType string 필수 주문 유형(가격 축) — MARKET · LIMIT
timeInForce string 필수 주문 조건(유효기간 축) — DAY · IOC · FOK · OPG · CLS
status string 필수 주문 상태 — SUBMITTED(접수 완료·체결 대기), PARTIALLY_FILLED(일부 체결), PENDING_CANCEL(취소 요청 접수·아직 미확정 — 원주문이 체결될 수 있으므로 재주문 금지), FILLED(전량 체결), CANCELED(취소 확정: 사용자 요청·거래소·정정), EXPIRED(유효기간 만료 또는 DAY 주문 장 마감; 부분체결분은 filledQuantity 에 유지), REJECTED(거부: 사유는 rejectReason)
quantity number 필수 주문 수량 — 금액 주문은 산출된 수량
filledQuantity number 필수 체결 수량 — 미체결 시 0
limitPrice number 선택 지정가 — 지정가 계열만
avgFillPrice number 선택 평균 체결 단가 — 체결분이 있을 때
session string 선택 주문 접수 시점의 세션(부록 A) — PRE · REGULAR · AFTER · DAY · CLOSED. 필드 도입(v1.2) 이전 주문은 null(허용 확정)
rejectReason string 선택 거부 사유 — 거부 상태일 때
requestedAt string 필수 접수 시각 — ISO 8601 · KST
updatedAt string 필수 최종 변경 시각 — ISO 8601 · KST
에러 응답 유형 상태 사유
400 실패 — validation
401 실패 — authentication
403 실패 — permission
404 실패 — not_found
429 실패 — rate_limit
500 실패 — server
에러 응답 필드 (공통) 필드 타입 필수 설명
type string 필수 에러 분류 — HTTP 상태와 1:1 매핑 (validation=400, authentication=401, permission=403, not_found=404, conflict=409, locked=423, business_rule=422, rate_limit=429, server=500)
code string 필수 프로그램 분기용 안정 코드(kebab-case). 전체 목록은 문서 루트 x-error-codes 참조
message string 필수 사용자 표시용 메시지 — {placeholder} 는 data 값으로 치환돼 내려간다
param string 선택 검증 실패한 파라미터명(해당 시)
requestId string 선택 X-Next-Request-Id 헤더와 동일한 요청 추적 ID
data object 선택 메시지 placeholder 치환 값 등 부가 정보
docUrl string 필수 해당 에러코드 문서 URL
curl 'https://next-openapi-api-dev.tripleauth.com/v1/orders/{orderId}' \ --header 'Authorization: Bearer {access_token}' \ --header 'X-Next-Account-Id: {account_id}' \ --header 'X-Next-Request-Id: 98fbcbbc-7e9b-4430-ba01-fb13fdfb21f7'
status string 필수 주문 상태 — 보통 PENDING_CANCEL(취소 처리 중, 부록 D). 원주문이 체결될 수 있으므로 확정 전 재주문 금지
requestedAt string 필수 취소 요청 시각 — ISO 8601 · KST
에러 응답 유형 상태 사유
400 실패 — validation
401 실패 — authentication
403 실패 — permission
404 실패 — not_found
409 실패 — conflict
429 실패 — rate_limit
500 실패 — server
에러 응답 필드 (공통) 필드 타입 필수 설명
type string 필수 에러 분류 — HTTP 상태와 1:1 매핑 (validation=400, authentication=401, permission=403, not_found=404, conflict=409, locked=423, business_rule=422, rate_limit=429, server=500)
code string 필수 프로그램 분기용 안정 코드(kebab-case). 전체 목록은 문서 루트 x-error-codes 참조
message string 필수 사용자 표시용 메시지 — {placeholder} 는 data 값으로 치환돼 내려간다
param string 선택 검증 실패한 파라미터명(해당 시)
requestId string 선택 X-Next-Request-Id 헤더와 동일한 요청 추적 ID
data object 선택 메시지 placeholder 치환 값 등 부가 정보
docUrl string 필수 해당 에러코드 문서 URL
curl 'https://next-openapi-api-dev.tripleauth.com/v1/orders/{orderId}' \ --request DELETE \ --header 'Authorization: Bearer {access_token}' \ --header 'X-Next-Account-Id: {account_id}' \ --header 'X-Next-Request-Id: 98ae1b52-5204-4776-8d06-f709f1dcbfab'
limit integer 선택 최대 개수(기본 100, 최대 500)
cursor string 선택 다음 페이지 커서 — 이전 응답의 nextCursor
X-Next-Request-Id string 필수 요청 추적 ID (누락 시 400 request-id-required). 응답과 에러 envelope 의 requestId 로 반환된다
응답 필드 필드 타입 필수 설명
fills FillDto[] 필수
nextCursor string 선택 다음 페이지 커서 — 없으면 마지막 페이지
에러 응답 유형 상태 사유
400 실패 — validation
401 실패 — authentication
403 실패 — permission
429 실패 — rate_limit
500 실패 — server
에러 응답 필드 (공통) 필드 타입 필수 설명
type string 필수 에러 분류 — HTTP 상태와 1:1 매핑 (validation=400, authentication=401, permission=403, not_found=404, conflict=409, locked=423, business_rule=422, rate_limit=429, server=500)
code string 필수 프로그램 분기용 안정 코드(kebab-case). 전체 목록은 문서 루트 x-error-codes 참조
message string 필수 사용자 표시용 메시지 — {placeholder} 는 data 값으로 치환돼 내려간다
param string 선택 검증 실패한 파라미터명(해당 시)
requestId string 선택 X-Next-Request-Id 헤더와 동일한 요청 추적 ID
data object 선택 메시지 placeholder 치환 값 등 부가 정보
docUrl string 필수 해당 에러코드 문서 URL
curl 'https://next-openapi-api-dev.tripleauth.com/v1/orders/fills?orderId={orderId}&symbol={symbol}&from={from}&to={to}&limit=100&cursor={cursor}' \ --header 'Authorization: Bearer {access_token}' \ --header 'X-Next-Account-Id: {account_id}' \ --header 'X-Next-Request-Id: 241b7d34-7a2d-40f2-b78d-aece7a39239b'