주문 리워드 내역 조회

수령한 리워드 내역 정보 조회 (최근일부터 역순 조회, 기간내 최대 30일치 조회 가능)

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

요청 제한: 주문 외 Private API 전체 합산 초당 80회 · 포트폴리오 기준 · 자세히 보기

Request Header

헤더필수설명
X-COINONE-PAYLOAD필수Request body object -> JSON string -> base64
X-COINONE-SIGNATURE필수HMAC(X-COINONE-PAYLOAD, SECRET_KEY, SHA512).hexdigest()

Request Body

필드타입필수설명
access_tokenString필수사용자의 액세스 토큰
nonceString필수UUID nonce
* 예: "022f53b2-8b2f-40c6-8e51-b594f562ee83")
from_tsNumber선택조회 시작 시점 타임스탬프 (UTC)
unit of time: second
미입력 시 시작 시점 제한 없음
to_tsNumber선택조회 종료 시점 타임스탬프 (UTC)
unit of time: second
미입력 시 현재 시점

Response Body

필드타입설명
resultString정상 처리 시 "success", 에러 발생 시 "error" 반환
error_codeString정상 처리 시 "0", 에러 발생 시 에러코드 "0" 이 아닌 값 반환
rewardsArray[Object]배열 형태의 일별 리워드 보상 내역
rewards[].applied_atNumber리워드 보상 적용 타임스탬프 (UTC)
* unit of time: second
rewards[].reward_amountString리워드 수령 대 금액
rewards[].net_reward_amountString순 리워드 수령 금액 (세금 제외)
rewards[].deposit_statusString입금 상태 (PENDING, COMPLETE)
rewards[].detailsArray[Object]배열 형태의 종목별 리워드 상세 내역
rewards[].quote_currencyString마켓 기준 통화
rewards[].target_currencyString주문 통화
rewards[].daily_reward_amountString종목별 일 지급 리워드 금액
rewards[].received_reward_amountString수령 리워드 금
rewards[].scoreString내 점수
rewards[].total_scoreString전체 점수
rewards[].contribution_ratioString기여도
Body Params
string
required

사용자의 액세스 토큰 (access token)

string
required

UUID nonce (예: "022f53b2-8b2f-40c6-8e51-b594f562ee83")

int64
Defaults to null

조회 종료 시점 타임스탬프 (UTC) * unit of time: second (예: 1749513600)
미입력 시 현재 시점

int64
Defaults to null

조회 시작 시점 타임스탬프 (UTC) * unit of time: second (예: 1746835200)
미입력 시 시작 시점 제한 없음

Headers
string
required

Request body object -> JSON string -> base64

string
required

HMAC(X-COINONE-PAYLOAD, SECRET_KEY, SHA512).hexdigest()

Response

Language
LoadingLoading…
Response
Choose an example:
application/json