출금 수수료 정책 변경 관련 Open API 응답 필드 추가 안내
3 days ago
안녕하세요. 당신의 안전한 금융 파트너, 빗썸입니다.
일부 가상자산 종목에 대한 출금 수수료 정책이 변경됨에 따라, 출금 관련 API 응답에서 정률(%) 기준 수수료 정보를 보다 명확하게 제공하기 위해 일부 응답 필드가 추가됩니다.
이번 변경은 기존 필드 삭제 없이 신규 필드가 추가되는 방식으로 적용됩니다. 다만 수수료 정책에 따라 기존 수수료 필드가 null로 반환될 수 있으므로, 연동 중인 고객께서는 신규 필드를 함께 확인할 수 있도록 로직을 점검해 주시기 바랍니다.
■ 변경 내용
: 정률(%) 기준 수수료가 적용되는 자산에 대해 수수료율 및 최소/최대 수수료 관련 응답 필드가 추가됩니다.
| 구분 | 적용 버전 | 현행(AS-IS) | 변경(TO-BE) |
|---|---|---|---|
GET /v1/withdraws/chance | v2.1.0, v2.1.5 | 건당 금액 기준 수수료(withdraw_fee) 중심 제공 | 정률(%) 기준 수수료 자산에 대해 withdraw_rate, withdraw_fee_min, withdraw_fee_max 추가 |
GET /v2/fee/inout/{currency} | v2.1.5 | 입출금 수수료 기본 정보 제공 | 정률(%) 기준 수수료 자산에 대해 withdraw_rate, withdraw_fee_min, withdraw_fee_max 추가 |
※ 필드명은 동일하나, 실제 응답 경로는 엔드포인트별 객체 구조에 따라 다를 수 있습니다.
■ 주요 변경 사항
- 출금 가능 정보(
GET /v1/withdraws/chance)
- 아래 필드가 추가됩니다.
withdraw_ratewithdraw_fee_minwithdraw_fee_max
| 구분 | 반환 값 |
|---|---|
| 건당 금액 기준 수수료 적용 자산 | withdraw_fee 반환 / withdraw_rate, withdraw_fee_min, withdraw_fee_max → null |
| 정률(%) 기준 수수료 적용 자산 | withdraw_rate 반환 / withdraw_fee, withdraw_fee_min, withdraw_fee_max → null |
| 정률(%) 기준 수수료 + 최소/최대 수수료 적용 자산 | withdraw_rate, withdraw_fee_min, withdraw_fee_max 반환 / withdraw_fee → null |
- 입출금 수수료 조회(
GET /v2/fee/inout/{currency})
- 아래 필드가 추가됩니다.
withdraw_ratewithdraw_fee_minwithdraw_fee_max
| 구분 | 반환 값 |
|---|---|
| 건당 금액 기준 수수료 적용 자산 | withdraw_fee_quantity 반환 / withdraw_rate, withdraw_fee_min, withdraw_fee_max → null |
| 정률(%) 기준 수수료 적용 자산 | withdraw_rate 반환 / withdraw_fee_quantity, withdraw_fee_min, withdraw_fee_max → null |
| 정률(%) 기준 수수료 + 최소/최대 수수료 적용 자산 | withdraw_rate, withdraw_fee_min, withdraw_fee_max 반환 / withdraw_fee_quantity → null |
■ 정률(%) 수수료 적용 방식
정률 기준 수수료가 적용되는 자산의 경우, 실제 출금 수수료는 출금 수량에 수수료율을 곱하여 계산됩니다.
- 예: 수수료율이 1%인 경우
withdraw_rate=0.01 - 최소 수수료 또는 최대 수수료가 설정된 경우, 계산된 수수료가 해당 범위를 벗어나면 각각 최소 수수료 또는 최대 수수료가 적용됩니다.
■ 적용 일시 및 대상
적용 일시: 2026년 5월 11일 오전 10시 이후
적용 대상: Open API (v2.1.0, v2.1.5)
※ 배포 상황에 따라 일정이 변경될 수 있습니다.
상세 스펙은 적용 시점에 공식 개발자 문서에 반영될 예정입니다.
감사합니다.