post https://api.coinone.co.kr/v2.1/event/order-reward/history
수령한 리워드 내역 정보 조회 (최근일부터 역순 조회, 기간내 최대 30일치 조회 가능)
Request Header
| 필드 | 필수 | 설명 |
|---|---|---|
| X-COINONE-PAYLOAD | true | Request body object -> JSON string -> base64 |
| X-COINONE-SIGNATURE | true | HMAC(X-COINONE-PAYLOAD, SECRET_KEY, SHA512).hexdigest() |
Request Body
| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
| access_token | String | true | 사용자의 액세스 토큰 |
| nonce | String | true | UUID nonce * 예: "022f53b2-8b2f-40c6-8e51-b594f562ee83") |
| from_ts | Number | false | 조회 시작 시점 타임스탬프 (UTC) * unit of time: second |
| to_ts | Number | false | 조회 종료 시점 타임스탬프 (UTC) * unit of time: second |
Response Body
| 필드 | 타입 | 설명 |
|---|---|---|
| result | String | 정상 처리 시 "success", 에러 발생 시 "error" 반환 |
| error_code | String | 정상 처리 시 "0", 에러 발생 시 에러코드 "0" 이 아닌 값 반환 |
| rewards | Array[Object] | 배열 형태의 일별 리워드 보상 내역 |
| - applied_at | Number | 리워드 보상 적용 타임스탬프 (UTC) * unit of time: second |
| - reward_amount | String | 리워드 수령 대 금액 |
| - net_reward_amount | String | 순 리워드 수령 금액 (세금 제외) |
| - deposit_status | String | 입금 상태 (PENDING, COMPLETE) |
| - details | Array[Object] | 배열 형태의 종목별 리워드 상세 내역 |
| - quote_currency | String | 마켓 기준 통화 |
| - target_currency | String | 주문 통화 |
| - daily_reward_amount | String | 종목별 일 지급 리워드 금액 |
| - received_reward_amount | String | 수령 리워드 금 |
| - score | String | 내 점수 |
| - total_score | String | 전체 점수 |
| - contribution_ratio | String | 기여도 |