--- updatedAt: 2026-09-08T09:59:42.000Z agentTools: projectIndex: https://docs.coinone.co.kr/llms.txt --- # 가상자산 입금 주소 조회 입금가능한 가상자산의 입금주소 조회 ## Request Header | Headers | Required/ Optional | Description | | :------------------ | :----------------- | :------------------------------------------------------- | | X-COINONE-PAYLOAD | Required | Request body object -> JSON string -> base64 | | X-COINONE-SIGNATURE | Required | HMAC(X-COINONE-PAYLOAD, SECRET\_KEY, SHA512).hexdigest() | ## Request Body | field | type | required/optional | description | | ------------- | ---------------- | ----------------- | ------------------------------------------------------ | | access\_token | string | required | 사용자의 액세스 토큰 (access token) | | nonce | string | required | UUID nonce (예: "022f53b2-8b2f-40c6-8e51-b594f562ee83") | | currencies | array of strings | optional | 주소를 조회하려는 자산의 심볼 입력, 미입력시 전체응답 | ## Response Body ### 해당 가상자산이 입금 불가한 경우 리스트에서 제외됩니다. | Key | Type | Description | | :------------------- | :------------- | :-------------------------------- | | result | String | 정상 반환 시 success, 에러 코드 반환 시 error | | error\_code | NumberString | error 발생 시 에러코드 반환, 성공인 경우 0 반환 | | deposit\_addresses | Array\[Object] | 배열 형태의 가상자산 입금주소 정보 | | - currency | String | 가상자산 심볼 (예: BTC) | | - address | String | 입금주소 | | - secondary\_address | String? | memo, tag와 같은 2차주소, 없을경우 null로 응답 | # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "private-api", "version": "1.7" }, "servers": [ { "url": "https://api.coinone.co.kr" } ], "security": [ {} ], "paths": { "/v2.1/account/deposit_address": { "post": { "summary": "가상자산 입금 주소 조회", "description": "입금가능한 가상자산의 입금주소 조회", "operationId": "virtual-asset-deposit-address", "parameters": [ { "name": "X-COINONE-PAYLOAD", "in": "header", "description": "Request body object -> JSON string -> base64", "required": true, "schema": { "type": "string" } }, { "name": "X-COINONE-SIGNATURE", "in": "header", "description": "HMAC(X-COINONE-PAYLOAD, SECRET_KEY, SHA512).hexdigest()", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "access_token", "nonce" ], "properties": { "access_token": { "type": "string", "description": "사용자의 액세스 토큰 (access token)" }, "nonce": { "type": "string", "description": "UUID nonce (예: \"022f53b2-8b2f-40c6-8e51-b594f562ee83\")" }, "currencies": { "type": "array", "description": "주소를 조회하려는 자산의 심볼 입력, 미입력시 전체응답", "items": { "type": "string" } } } } } } }, "responses": { "200": { "description": "200", "content": { "application/json": { "examples": { "Result": { "value": "{\n \"result\": \"success\",\n \"error_code\": \"0\",\n \"deposit_addresses\": [\n {\n \"currency\": \"BTC\",\n \"address\": \"btc_address\",\n \"secondary_address\": null\n },\n {\n \"currency\": \"ETH\",\n \"address\": \"eth_address\",\n \"secondary_address\": \"memo1\"\n },\n {\n \"currency\": \"XRP\",\n \"address\": \"xrp_address\",\n \"secondary_address\": \"189072\"\n }\n ]\n}" } }, "schema": { "type": "object", "properties": { "result": { "type": "string", "example": "success" }, "error_code": { "type": "string", "example": "0" }, "deposit_addresses": { "type": "array", "items": { "type": "object", "properties": { "currency": { "type": "string", "example": "BTC" }, "address": { "type": "string", "example": "btc_address" }, "secondary_address": {} } } } } } } } } }, "deprecated": false, "x-readme": { "code-samples": [ { "language": "python", "code": "import base64\nimport hashlib\nimport hmac\nimport json\nimport uuid\nimport httplib2\n\nACCESS_TOKEN = '{access token}'\nSECRET_KEY = bytes('{secret key}', 'utf-8')\n\n\ndef get_encoded_payload(payload):\n payload['nonce'] = str(uuid.uuid4())\n\n dumped_json = json.dumps(payload)\n encoded_json = base64.b64encode(bytes(dumped_json, 'utf-8'))\n return encoded_json\n\n\ndef get_signature(encoded_payload):\n signature = hmac.new(SECRET_KEY, encoded_payload, hashlib.sha512)\n return signature.hexdigest()\n\n\ndef get_response(action, payload):\n url = '{}{}'.format('https://api.coinone.co.kr/', action)\n\n encoded_payload = get_encoded_payload(payload)\n\n headers = {\n 'Content-type': 'application/json',\n 'X-COINONE-PAYLOAD': encoded_payload,\n 'X-COINONE-SIGNATURE': get_signature(encoded_payload),\n }\n\n http = httplib2.Http()\n response, content = http.request(url, 'POST', headers=headers)\n\n return content\n\n\nprint(get_response(action='/v2.1/account/deposit_address', payload={\n 'access_token': ACCESS_TOKEN,\n}))\n" }, { "language": "java", "code": "package main;\n\nimport com.fasterxml.jackson.core.JsonProcessingException;\nimport com.fasterxml.jackson.databind.ObjectMapper;\n\nimport javax.crypto.Mac;\nimport javax.crypto.spec.SecretKeySpec;\nimport java.io.IOException;\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.security.InvalidKeyException;\nimport java.security.NoSuchAlgorithmException;\nimport java.util.Base64;\nimport java.util.UUID;\n\npublic class FindAllTradeFee {\n private static final String ENDPOINT = \"https://api.coinone.co.kr/v2.1/account/deposit_address\";\n private static final String ACCESS_TOKEN = \"{accessToken}\";\n private static final String SECRET_KEY = \"{secretKey}\";\n private static final ObjectMapper om = new ObjectMapper();\n\n record Payload(String access_token, String nonce){}\n\n public static void main(String[] args) {\n var nonce = UUID.randomUUID().toString();\n var payload = new Payload(ACCESS_TOKEN, nonce);\n var base64EncodedPayload = makeBase64EncodedPayload(payload);\n var signature = makeSignature(base64EncodedPayload);\n\n\n try {\n var client = HttpClient.newBuilder().build();\n var body = om.writeValueAsString(payload);\n var request = HttpRequest.newBuilder()\n .uri(URI.create(ENDPOINT))\n .header(\"Content-type\", \"application/json\")\n .header(\"X-COINONE-PAYLOAD\", base64EncodedPayload)\n .header(\"X-COINONE-SIGNATURE\", signature)\n .POST(HttpRequest.BodyPublishers.ofString(body))\n .build();\n var response = client.send(request, HttpResponse.BodyHandlers.ofString());\n System.out.println(response.body());\n } catch (InterruptedException | IOException e) {\n throw new RuntimeException(e);\n }\n\n }\n\n private static String makeBase64EncodedPayload(Payload payload) {\n try {\n var bytesPayload = om.writeValueAsBytes(payload);\n return Base64.getEncoder().encodeToString(bytesPayload);\n } catch (JsonProcessingException e) {\n throw new RuntimeException(e);\n }\n }\n private static String makeSignature(String base64EncodedPayload) {\n try {\n var mac = Mac.getInstance(\"HmacSHA512\");\n var keySpec = new SecretKeySpec(SECRET_KEY.getBytes(), \"HmacSHA512\");\n mac.init(keySpec);\n var messageDigest = mac.doFinal(base64EncodedPayload.getBytes());\n var sb = new StringBuilder();\n for (byte b : messageDigest) {\n sb.append(String.format(\"%02x\", b));\n }\n return sb.toString();\n } catch (NoSuchAlgorithmException | InvalidKeyException e) {\n throw new RuntimeException(e);\n }\n }\n}" }, { "language": "kotlin", "code": "package main\n\nimport com.fasterxml.jackson.core.JsonProcessingException\nimport com.fasterxml.jackson.databind.ObjectMapper\nimport java.io.IOException\nimport java.net.URI\nimport java.net.http.HttpClient\nimport java.net.http.HttpRequest\nimport java.net.http.HttpResponse\nimport java.security.InvalidKeyException\nimport java.security.NoSuchAlgorithmException\nimport java.util.*\nimport javax.crypto.Mac\nimport javax.crypto.spec.SecretKeySpec\n\nobject FindAllTradeFee {\n private const val ENDPOINT = \"https://api.coinone.co.kr/v2.1/account/deposit_address\"\n private const val ACCESS_TOKEN = \"{accessToken}\"\n private const val SECRET_KEY = \"{secretKey}\"\n private val om = ObjectMapper()\n internal data class Payload(val access_token: String, val nonce: String)\n\n @JvmStatic\n fun main(args: Array) {\n val nonce = UUID.randomUUID().toString()\n val payload = Payload(ACCESS_TOKEN, nonce)\n val base64EncodedPayload = makeBase64EncodedPayload(payload)\n val signature = makeSignature(base64EncodedPayload)\n try {\n val client = HttpClient.newBuilder().build()\n val body = om.writeValueAsString(payload)\n val request = HttpRequest.newBuilder()\n .uri(URI.create(ENDPOINT))\n .header(\"Content-type\", \"application/json\")\n .header(\"X-COINONE-PAYLOAD\", base64EncodedPayload)\n .header(\"X-COINONE-SIGNATURE\", signature)\n .POST(HttpRequest.BodyPublishers.ofString(body))\n .build()\n val response = client.send(request, HttpResponse.BodyHandlers.ofString())\n println(response.body())\n } catch (e: InterruptedException) {\n throw RuntimeException(e)\n } catch (e: IOException) {\n throw RuntimeException(e)\n }\n }\n\n private fun makeBase64EncodedPayload(payload: Payload): String {\n return try {\n val bytesPayload = om.writeValueAsBytes(payload)\n Base64.getEncoder().encodeToString(bytesPayload)\n } catch (e: JsonProcessingException) {\n throw RuntimeException(e)\n }\n }\n\n private fun makeSignature(base64EncodedPayload: String): String {\n return try {\n val mac = Mac.getInstance(\"HmacSHA512\")\n val keySpec = SecretKeySpec(SECRET_KEY.toByteArray(), \"HmacSHA512\")\n mac.init(keySpec)\n val messageDigest = mac.doFinal(base64EncodedPayload.toByteArray())\n val sb = StringBuilder()\n for (b in messageDigest) {\n sb.append(String.format(\"%02x\", b))\n }\n sb.toString()\n } catch (e: NoSuchAlgorithmException) {\n throw RuntimeException(e)\n } catch (e: InvalidKeyException) {\n throw RuntimeException(e)\n }\n }\n}" }, { "language": "javascript", "code": "const request = require('request');\nconst crypto = require('crypto');\nconst { v4: uuidv4 } = require('uuid');\n\n\nconst ACCESS_TOKEN = \"{accessToken}\"\nconst SECRET_KEY = \"{secretKey}\"\n\nconst payload = {\n access_token: ACCESS_TOKEN,\n nonce: uuidv4()\n};\n\nconst encodedPayload = Buffer.from(JSON.stringify(payload)).toString('base64');\nconst signature = crypto.createHmac('sha512', SECRET_KEY).update(encodedPayload).digest('hex');\nconst options = {\n url: 'https://api.coinone.co.kr/v2.1/account/deposit_address',\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json',\n 'X-COINONE-PAYLOAD': encodedPayload,\n 'X-COINONE-SIGNATURE': signature,\n },\n body: JSON.stringify(payload),\n};\n\nrequest(options, (error, response, body) => {\n if (error) throw new Error(error);\n console.log(body);\n});" }, { "language": "go", "code": "package main\n\nimport (\n\t\"crypto/hmac\"\n\t\"crypto/sha512\"\n\t\"encoding/base64\"\n\t\"encoding/json\"\n\t\"fmt\"\n\t\"github.com/google/uuid\"\n\t\"io\"\n\t\"net/http\"\n\t\"strings\"\n)\n\nconst (\n\taccessToken = \"{access token}\"\n\tsecretKey = \"{secret key}\"\n)\n\nfunc getEncodedPayload(payload map[string]interface{}) string {\n\tpayload[\"nonce\"] = uuid.New().String()\n\n\tdumpedJSON, _ := json.Marshal(payload)\n\treturn base64.StdEncoding.EncodeToString(dumpedJSON)\n}\n\nfunc getSignature(encodedPayload string) string {\n\th := hmac.New(sha512.New, []byte(secretKey))\n\th.Write([]byte(encodedPayload))\n\treturn fmt.Sprintf(\"%x\", h.Sum(nil))\n}\n\nfunc getResponse(action string, payload map[string]interface{}) ([]byte, error) {\n\turl := fmt.Sprintf(\"https://api.coinone.co.kr%s\", action)\n\n\tencodedPayload := getEncodedPayload(payload)\n\n\treq, err := http.NewRequest(\"POST\", url, strings.NewReader(\"\"))\n\tif err != nil {\n\t\treturn nil, err\n\t}\n\n\treq.Header.Set(\"Content-Type\", \"application/json\")\n\treq.Header.Set(\"X-COINONE-PAYLOAD\", encodedPayload)\n\treq.Header.Set(\"X-COINONE-SIGNATURE\", getSignature(encodedPayload))\n\n\tclient := &http.Client{}\n\tresp, err := client.Do(req)\n\tif err != nil {\n\t\treturn nil, err\n\t}\n\tdefer resp.Body.Close()\n\n\tbody, err := io.ReadAll(resp.Body)\n\tif err != nil {\n\t\treturn nil, err\n\t}\n\n\treturn body, nil\n}\n\nfunc main() {\n\tresponse, err := getResponse(\"/v2.1/account/deposit_address\", map[string]interface{}{\n\t\t\"access_token\": accessToken,\n\t})\n\tif err != nil {\n\t\tfmt.Println(\"Error:\", err)\n\t\treturn\n\t}\n\n\tfmt.Println(string(response))\n}" } ], "samples-languages": [ "python", "java", "kotlin", "javascript", "go" ] } } } }, "x-readme": { "headers": [], "explorer-enabled": false, "proxy-enabled": true }, "x-readme-fauxas": true } ```