첫 API 호출하기

API Key 발급과 인증 구현이 완료되었다면, 아래 코드를 복사하여 바로 첫 API를 호출해볼 수 있습니다.

사전 준비

Open API 사용 승인 완료 → API Key 발급

app_key, secret_key 준비 완료

JWT 생성 방법 이해 → 인증 헤더 만들기

서명 생성 방법 이해 → 요청 서명 만들기

계좌 잔고 조회

Python

필요 라이브러리: pip install PyJWT requests

JavaScript

필요 라이브러리: npm install jsonwebtoken

cURL

응답 예시

{
  "status": "success",
  "code": 200,
  "data": {
    "accountNo": "000-00-000001",
    "balance": 1000000,
    "availableBalance": 950000,
    "currency": "KRW"
  }
}

주문 생성

ORDER 권한 필요

주문 생성은 주문 권한 API Key가 필요합니다.

Python

응답 예시

{
  "status": "success",
  "code": 201,
  "data": {
    "orderId": "ORD-2026-0001234",
    "stockCd": "USDKRW",
    "side": "BUY",
    "type": "LIMIT",
    "qty": 1000,
    "price": 1350.50,
    "status": "PENDING",
    "createdAt": "2026-03-05T14:30:00.000Z"
  }
}

에러가 발생한다면?

에러	원인	해결
`OA_001`	유효하지 않은 API Key (401)	`app_key` 확인
`OA_002`	만료된 API Key (401)	API Key 재발급
`OA_003`	JWT 서명 검증 실패 (401)	`secret_key` 확인
`OA_004`	요청 서명(X-Signature) 유효하지 않음 (401)	디버깅 체크리스트
`OA_005`	요청 시각(X-Timestamp) 유효 시간 초과 (401)	시스템 시간 NTP 동기화 (±60초)
`OA_006`	필수 인증 헤더 누락 (400)	요청 헤더 확인
`OA_007`	API 권한 없음 (403)	API Key 권한 확인

← 이전: 요청 서명 만들기
다음: REST API 연동 →

사전 준비#

계좌 잔고 조회#

Python#

JavaScript#

cURL#

주문 생성#

Python#

에러가 발생한다면?#

사전 준비

계좌 잔고 조회

Python

JavaScript

cURL

주문 생성

Python

에러가 발생한다면?