출금 수수료 정책 변경 관련 Open API 응답 필드 추가 안내
16 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)
※ 배포 상황에 따라 일정이 변경될 수 있습니다.
상세 스펙은 적용 시점에 공식 개발자 문서에 반영될 예정입니다.
감사합니다.
