--- updatedAt: 2026-04-22T07:07:21.000Z agentTools: projectIndex: https://apidocs.bithumb.com/llms.txt --- # 원화 입금 리스트 조회 원화 입금 목록을 조회합니다. # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "open_api_public", "version": "2.1.5" }, "servers": [ { "url": "https://api.bithumb.com/v1" } ], "security": [ {} ], "paths": { "/deposits/krw": { "get": { "summary": "원화 입금 리스트 조회", "description": "원화 입금 목록을 조회합니다.", "operationId": "원화-입금-리스트-조회", "parameters": [ { "name": "state", "in": "query", "description": "입금 상태\n- `PROCESSING` : 처리 중\n- `ACCEPTED` : 완료\n- `CANCELLED` : 취소됨", "schema": { "type": "string" } }, { "name": "uuids", "in": "query", "description": "입금 고유 ID 목록", "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "txids", "in": "query", "description": "입금 TXID의 목록", "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "page", "in": "query", "description": "페이지 수 (default: 1)", "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "limit", "in": "query", "description": "개수 제한(max 100)", "schema": { "type": "integer", "format": "int32", "default": 100 } }, { "name": "order_by", "in": "query", "description": "조회 결과 정렬 방식\n- `asc`: 오래된 주문 순\n- `desc`: 최신 주문 순(default)", "schema": { "type": "string", "default": "desc", "enum": [ "asc", "desc" ] } }, { "name": "Authorization", "in": "header", "description": "Authorization token (JWT)", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "200", "content": { "application/json": { "examples": { "Result": { "value": "\n {\n \"type\": \"deposit\",\n \"uuid\": \"15371593\",\n \"currency\": \"KRW\",\n \"txid\": \"1596126\",\n \"state\": \"ACCEPTED\",\n \"created_at\": \"2024-07-06T15:14:37+09:00\",\n \"done_at\": \"2024-07-08T15:19:40+09:00\",\n \"amount\": \"20000\",\n \"fee\": \"0\",\n \"transaction_type\": \"default\"\n },\n {\n \"type\": \"deposit\",\n \"uuid\": \"15371592\",\n \"currency\": \"KRW\",\n \"txid\": \"1596125\",\n \"state\": \"ACCEPTED\",\n \"created_at\": \"2024-07-06T15:14:06+09:00\",\n \"done_at\": \"2024-07-08T15:19:39+09:00\",\n \"amount\": \"10000\",\n \"fee\": \"0\",\n \"transaction_type\": \"default\"\n }\n]" } }, "schema": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "description": "입출금 종류", "example": "deposit" }, "uuid": { "type": "string", "description": "입금의 고유 ID", "example": "15371593" }, "currency": { "type": "string", "description": "화폐 심볼\n\n예시) BTC", "example": "KRW" }, "txid": { "type": "string", "description": "입금의 트랜잭션 ID", "example": "1596126" }, "state": { "type": "string", "description": "입금 상태\n- `PROCESSING`: 처리 중\n- `ACCEPTED`: 완료\n- `CANCELLED`: 취소됨", "example": "ACCEPTED" }, "created_at": { "type": "string", "description": "입금 생성 시각", "example": "2024-07-06T15:14:37+09:00", "format": "date-time" }, "done_at": { "type": "string", "description": "입금 완료 시각", "example": "2024-07-08T15:19:40+09:00", "format": "date-time" }, "amount": { "type": "string", "description": "입금 수량", "example": "20000" }, "fee": { "type": "string", "description": "입금 수수료", "example": "0" }, "transaction_type": { "type": "string", "description": "입금 유형\n- `default`: 일반입금", "example": "default" } } } } } } }, "400": { "description": "400", "content": { "application/json": { "examples": { "Result": { "value": "{\n \"error\": {\n \"name\": \"error name\",\n \"message\": \"error message\"\n }\n}" } }, "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "name": { "type": "string", "description": "에러명", "example": "error name" }, "message": { "type": "string", "example": "error message", "description": "에러 메시지" } } } }, "required": [ "error" ] } } } } }, "deprecated": false, "x-readme": { "code-samples": [ { "language": "javascript", "code": "const jwt = require('jsonwebtoken');\nconst { v4: uuidv4 } = require('uuid');\nconst crypto = require('crypto');\nconst querystring = require('querystring');\nconst axios = require('axios')\n\nconst accessKey = '발급받은 API KEY'\nconst secretKey = '발급받은 SECRET KEY'\nconst apiUrl = 'https://api.bithumb.com'\n\n// Set API parameters\nvar query = 'limit=100&page=1&order_by=desc'\nconst uuids = [\n '15371593', '15371592'\n]\nconst uuid_query = uuids.map(uuid => `uuids[]=${uuid}`).join('&')\nquery = uuid_query ? query + \"&\" + uuid_query : query\n\n// Generate access token\nconst alg = 'SHA512'\nconst hash = crypto.createHash(alg)\nconst queryHash = hash.update(query, 'utf-8').digest('hex')\nconst payload = {\n access_key: accessKey,\n nonce: uuidv4(),\n timestamp: Date.now(),\n query_hash: queryHash,\n query_hash_alg: alg\n}\nconst jwtToken = jwt.sign(payload, secretKey)\nconst config = {\n headers: {\n Authorization: `Bearer ${jwtToken}`\n }\n}\n\n// Call API\naxios.get(apiUrl + '/v1/deposits/krw?' + query, config)\n .then((response) => {\n // handle to success\n console.log('status: ', response.status)\n console.log('data: ', response.data)\n })\n .catch((error) => {\n // handle to fail\n console.log(error.response.status)\n console.log(error.response.data)\n })" }, { "language": "python", "code": "# Python 3\n# pip3 installl pyJwt\nimport jwt \nimport uuid\nimport hashlib\nimport time\nfrom urllib.parse import urlencode\nimport requests\n\naccessKey = '발급받은 API KEY'\nsecretKey = '발급받은 SECRET KEY'\napiUrl = 'https://api.bithumb.com'\n\n# Set API parameters\nparam = dict( limit=100, page=1, order_by='desc' )\nuuids = [\n '15371593', '15371592'\n]\nquery = urlencode(param)\nuuid_query = '&'.join([f'uuids[]={uuid}' for uuid in uuids])\nquery = query + \"&\" + uuid_query\n\n# Generate access token\nhash = hashlib.sha512()\nhash.update(query.encode())\nquery_hash = hash.hexdigest()\npayload = {\n 'access_key': accessKey,\n 'nonce': str(uuid.uuid4()),\n 'timestamp': round(time.time() * 1000), \n 'query_hash': query_hash,\n 'query_hash_alg': 'SHA512',\n} \njwt_token = jwt.encode(payload, secretKey)\nauthorization_token = 'Bearer {}'.format(jwt_token)\nheaders = {\n 'Authorization': authorization_token\n}\n\ntry:\n # Call API\n response = requests.get(apiUrl + '/v1/deposits/krw?' + query, headers=headers)\n # handle to success or fail\n print(response.status_code)\n print(response.json())\nexcept Exception as err:\n # handle exception\n print(err)\n" }, { "language": "java", "code": "package com.example.sample;\n\n// https://mvnrepository.com/artifact/com.auth0/java-jwt\n\nimport com.auth0.jwt.JWT;\nimport com.auth0.jwt.algorithms.Algorithm;\n// https://mvnrepository.com/artifact/org.apache.httpcomponents/httpclient\nimport org.apache.http.NameValuePair;\nimport org.apache.http.client.methods.CloseableHttpResponse;\nimport org.apache.http.client.methods.HttpGet;\nimport org.apache.http.client.utils.URLEncodedUtils;\nimport org.apache.http.impl.client.CloseableHttpClient;\nimport org.apache.http.impl.client.HttpClients;\nimport org.apache.http.message.BasicNameValuePair;\nimport org.apache.http.util.EntityUtils;\n\nimport java.math.BigInteger;\nimport java.nio.charset.StandardCharsets;\nimport java.security.MessageDigest;\nimport java.security.NoSuchAlgorithmException;\nimport java.util.ArrayList;\nimport java.util.List;\nimport java.util.UUID;\nimport java.util.stream.Collectors;\n\npublic class GETArgsArray {\n\n public static void main(String[] args) throws NoSuchAlgorithmException {\n String accessKey = \"발급받은 API KEY\";\n String secretKey = \"발급받은 SECRET KEY\";\n String apiUrl = \"https://api.bithumb.com\";\n\n // Set API parameters\n List queryParams = new ArrayList<>();\n queryParams.add(new BasicNameValuePair(\"limit\", \"100\"));\n queryParams.add(new BasicNameValuePair(\"page\", \"1\"));\n queryParams.add(new BasicNameValuePair(\"order_by\", \"desc\"));\n List uuids = new ArrayList<>();\n uuids.add(\"15371593\");\n uuids.add(\"15371592\");\n String uuidQuery = uuids.stream().map(uuid -> \"uuids[]=\" + uuid).collect(Collectors.joining(\"&\"));\n\n // Generate access token\n String query = URLEncodedUtils.format(queryParams, StandardCharsets.UTF_8);\n if (uuidQuery.isEmpty()) {\n query = query + \"&\" + uuidQuery;\n }\n MessageDigest md = MessageDigest.getInstance(\"SHA-512\");\n md.update(query.getBytes(StandardCharsets.UTF_8));\n String queryHash = String.format(\"%0128x\", new BigInteger(1, md.digest()));\n Algorithm algorithm = Algorithm.HMAC256(secretKey);\n String jwtToken = JWT.create()\n .withClaim(\"access_key\", accessKey)\n .withClaim(\"nonce\", UUID.randomUUID().toString())\n .withClaim(\"timestamp\", System.currentTimeMillis())\n .withClaim(\"query_hash\", queryHash)\n .withClaim(\"query_hash_alg\", \"SHA512\")\n .sign(algorithm);\n String authenticationToken = \"Bearer \" + jwtToken;\n\n // Call API\n final HttpGet httpRequest = new HttpGet(apiUrl + \"/v1/deposits/krw?\" + query);\n httpRequest.addHeader(\"Authorization\", authenticationToken);\n\n try (CloseableHttpClient client = HttpClients.createDefault();\n CloseableHttpResponse response = client.execute(httpRequest)) {\n // handle to response\n int httpStatus = response.getStatusLine().getStatusCode();\n String responseBody = EntityUtils.toString(response.getEntity(), StandardCharsets.UTF_8);\n System.out.println(httpStatus);\n System.out.println(responseBody);\n } catch (Exception e) {\n throw new RuntimeException(e);\n }\n }\n}\n" } ], "samples-languages": [ "javascript", "python", "java" ] } } } }, "x-readme": { "headers": [], "explorer-enabled": false, "proxy-enabled": false }, "x-readme-fauxas": true } ```