post
https://api.bithumb.com/trade/btc_withdrawal
가상자산 출금 신청 기능을 제공합니다. 원화 출금 API는 v1.2.0에서는 제공하지 않습니다.
422 오류 처리 — travel_rule_consent_required
travel_rule_consent_required출금 대상 거래소로 최초 출금을 시도할 때 트래블룰 이행에 필요한 개인정보 처리 동의를 완료하지 않은 경우 이 오류를 반환합니다.
거래소 권역별 필요한 동의 항목
| 권역 | 필요한 동의 항목 |
|---|---|
| 국내 소재 거래소 | 개인정보 제3자 제공 동의 |
| 국외 소재 거래소 | 개인정보 제3자 제공 동의 + 개인정보 국외이전 동의 |
consent_url에 접속해 동의를 완료한 후 출금 요청을 다시 시도하세요. 빗썸은 웹사이트와 앱에서만 동의를 수집하며, 동의 없이는 출금을 처리하지 않습니다. 한 번 동의를 완료하면 동일 거래소에 대해 재동의를 요청하지 않습니다. 자세한 내용은 공지사항을 참고하세요.
Request Headers
| 요청 변수 | 설명 | 타입 |
|---|---|---|
| api-client-type | Api-Sign 생성 시 구분자 유형 "0" : Ascii Code 0 (기본값) "1" : Ascii Code 1 "2" : ";" (semicolon) | String/선택 |
| Api-Key | 사용자 API Key | String/필수 |
| Api-Nonce | 현재의 시간을 밀리초(millisecond, ms)로 표현한 값 (예 : "1655280216476") | String/필수 |
| Api-Sign | End Point + Request Parameter + Api-Nonce + 사용자 Secret Key를 조합하여 인코딩한 값\ [상세 가이드 링크] | String/필수 |
Request Parameters
| 요청 변수 | 설명 | 타입 - 외부 출금 | 타입 - 내부 출금 |
|---|---|---|---|
| units | 출금하고자 하는 코인 수량 | Float/필수 | Float/필수 |
| address | 코인 별 출금 주소 (1차 주소) | String/필수 | String/필수 |
| destination | XRP 출금 시 Destination Tag | Integer 2차 주소가 있는 코인인 경우에만 필수 | Integer 2차 주소가 있는 코인인 경우에만 필수 |
| destination | STEEM 출금 시 입금 메모 | Integer 2차 주소가 있는 코인인 경우에만 필수 | Integer 2차 주소가 있는 코인인 경우에만 필수 |
| currency | 가상자산 영문 코드 기본값 : BTC | String/필수 | String/필수 |
| net_type | 출금 네트워크 영문 코드 미 전달시 기준 네트워크 사용 | String | String |
| exchange_name | 출금 거래소명. 영문으로 입력. | String/필수 | |
| cust_type_cd | 수취자의 개인/법인 여부(개인 01 ,법인 02) | String/필수 | |
| ko_name | 개인 수취 정보_국문 성명 | String/필수 | |
| en_name | 개인 수취 정보_영문 성명 | String/필수 |
이용안내
- 개인/법인 여부(cust_type_cd)는 수취자의 개인/법인 여부를 의미합니다.
Response
| 필드 | 설명 | 타입 |
|---|---|---|
| status | 결과 상태 코드 (정상: 0000, 그 외 에러 코드 참조) | String |
