입금 주소 생성 요청

입금 주소 생성은 비동기 방식으로 동작합니다. API 호출 시점의 입금 주소 생성 완료 여부에 따라 아래 두가지 응답을 반환할 수 있습니다.

최초 API 요청 직후 반환되는 응답은 주소 생성 요청의 접수 성공 여부를 반환하며, 응답은 success, message 필드만 반환됩니다. 해당 응답은 API 추가 호출 시 주소 생성이 완료되기 이전까지 반환됩니다.
비동기 방식으로 주소 생성이 완료된 이후 API 호출 시 "currency", "net_type", "deposit_address"를 포함하는 생성된 주소 정보가 반환됩니다. 해당 정보는 통화당 최초 1회 생성 되며, 이후 생성 요청의 응답으로는 기존에 생성된 주소 정보가 반환됩니다.

일정 시간이 지난 후에도 입금 주소가 정상적으로 생성되지 않는 경우, 시간 간격을 두고 이 API를 다시 호출해주시기 바랍니다.

POST API에 대한 Form 방식 요청은 2022년 3월 1일부로 지원이 종료되었습니다.

Form 방식 지원 종료에 따라 Urlencoded Form 방식으로 전송하는 POST 요청에 대한 정상적인 동작을 보장하지 않습니다. 반드시 JSON 형식으로 요청 본문(Body)을 전송해주시기 바랍니다.

Revision History

반영 버전	반영 일자	변경 사항
-	2023-05-22	네트워크 타입(net_type) 필드 추가

Rate Limit

초당 최대 30회 호출할 수 있습니다. 계정단위로 측정되며 [Exchange 기본 그룹] 내에서 요청 가능 횟수를 공유합니다.

API Key Permission

인증이 필요한 API로, [입금하기] 권한이 설정된 API Key를 사용해야 합니다.
권한 오류(out_of_scope) 오류가 발생한다면, API Key 관리 메뉴에서 권한 설정을 확인해주세요.