Home이용 안내API 레퍼런스변경 내역
API 레퍼런스

주문 리워드 내역 조회

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

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

Request Header

필드필수설명
X-COINONE-PAYLOADtrueRequest body object -> JSON string -> base64
X-COINONE-SIGNATUREtrueHMAC(X-COINONE-PAYLOAD, SECRET_KEY, SHA512).hexdigest()

Request Body

필드타입필수설명
access_tokenStringtrue사용자의 액세스 토큰
nonceStringtrueUUID nonce
* 예: "022f53b2-8b2f-40c6-8e51-b594f562ee83")
from_tsNumberfalse조회 시작 시점 타임스탬프 (UTC)
* unit of time: second
to_tsNumberfalse조회 종료 시점 타임스탬프 (UTC)
* unit of time: second

Response Body

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

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

string

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