모의투자 Key는 넥스트증권 API에서 로그인 후 모의투자탭에서 확인할 수 있어요.
아래 항목은 처음부터 다 읽을 필요는 없습니다. 실제로 호출하다가 필요할 때 참고하면 좋습니다.
모든 요청에 Authorization: Bearer와 요청 추적용 X-Next-Request-Id가 필요합니다. 추적 ID를 빠뜨리면 400 request-id-required가 반환되며, 보낸 값이 응답과 에러의 requestId로 그대로 돌아옵니다. 계좌·자산, 주문 카테고리는 X-Next-Account-Id가 추가로 필요합니다.
API 그룹 단위로 초당 요청 수가 제한됩니다. 초과 시 429가 반환되며, 응답 헤더의 X-RateLimit-Remaining, Retry-After로 재시도 시점을 확인할 수 있습니다.
모든 에러는 { error: { type, code, message, requestId } } 형태의 공통 envelope으로 반환됩니다. 전체 목록은 상태·에러 코드 페이지를 참고하세요.