공통 규약

아래 항목은 처음부터 다 읽을 필요는 없습니다. 실제로 호출하다가 필요할 때 참고하면 좋습니다.

모든 요청은Authorization: Bearer {access_token}이 필수이며, 계좌·주문 카테고리는X-Next-Account-Id가 추가로 필요합니다. 요청 추적용X-Request-IdId는 선택이며, 에러 응답의requestId와와 동일한 값이 반환됩니다.

환경(Sandbox/Live)은 헤더로 구분하지 않습니다. 발급받은 키의prefix(pk_test_/pk_live_)로 게이트웨이가 자동 판단합니다.

Rate Limit은 API Key 단위로 측정되며, 요청 종류에 따라 한도가 다릅니다.

대상	한도
조회 (GET)	초당 30회
주문 (POST/DELETE)	초당 5회
인증 `/v1/oauth/token`	초당 5회

모든 에러 응답은 아래 형식으로 반환됩니다.

RESPONSE

{
"error": {
"requestId": "req_01HXYZ...",
"code": "trade-limit-exceeded",
"message": "일일 거래 한도를 초과했습니다.",
"data": {
"dailyLimit": "1000.00",
"attempted": "1050.00"
}
}
}