---
updatedAt: 2026-06-30T08:03:44.000Z
agentTools:
  projectIndex: https://apidocs.bithumb.com/llms.txt
---

# 개별 주문 조회

개별 주문 내역을 조회합니다.

<Callout icon="📌" theme="warning">
  #### 입력 규칙

  `uuid` 또는 `client_order_id` 중 하나 이상을 반드시 전달해야 하며, 두 값을 모두 전달한 경우 `uuid`를 기준으로 조회합니다.
</Callout>

<Callout icon="📘" theme="info">
  #### 안내 사항

  기존에는 자전거래 가능성이 있을 경우 주문이 접수되지 않았으나, **개선 후**에는 주문 접수 후 체결 단계에서 자전거래를 감지해 충돌하는 신규 주문 수량만 취소됩니다. 자세한 내용은 [공지사항](https://apidocs.bithumb.com/changelog/%EC%97%85%EB%8D%B0%EC%9D%B4%ED%8A%B8-open-api-%EC%A3%BC%EB%AC%B8-%EA%B4%80%EB%A0%A8-%EC%9E%90%EC%A0%84%EA%B1%B0%EB%9E%98-%EB%B0%A9%EC%A7%80-%EC%8B%9C%EC%8A%A4%ED%85%9C-%EA%B3%A0%EB%8F%84%ED%99%94-%EC%95%88%EB%82%B4)을 참고하세요.

  응답 항목 "자전거래 방지 유형" `stp_type`, "취소유형" `cancel_type`, "취소 주문 고유 ID" `canceling_uuid`가 신규 추가되었으며, 2026년 5월 7일 서비스 배포 이후 요청된 주문에 한하여 `stp_type` 필드가 필수 출력됩니다.
</Callout>

## `ioc`, `fok`, `post_only` 주문의 상태

* `ioc`, `fok` 주문은 미체결 대기(`wait`) 상태로 존재하지 않습니다. 조회 시 항상 `done` 또는 `cancel` 상태로 반환됩니다.
* `post_only` 주문은 Maker 가격으로 등록된 경우에만 `wait` 상태로 존재하며, Taker 가격이면 `cancel` 상태로 반환됩니다.
* 자세한 동작은 [주문 요청](https://apidocs.bithumb.com/reference/주문-요청) 페이지를 참고하세요.

# 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": {
    "/order": {
      "get": {
        "summary": "개별 주문 조회",
        "description": "개별 주문 내역을 조회합니다.",
        "operationId": "개별-주문-조회",
        "parameters": [
          {
            "name": "Authorization",
            "in": "header",
            "description": "Authorization token (JWT)",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "uuid",
            "in": "query",
            "description": "주문의 고유 ID",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "client_order_id",
            "schema": {
              "type": "string"
            },
            "description": "서버에서 부여하는 주문 ID(`uuid`)와 별도로 주문 생성 시 사용자가 직접 지정한 고유 ID\n\n- 허용 문자: 영문 대/소문자, 숫자, -, _\n- 길이: 1–36자"
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": {
                      "uuid": "C0101000000001799231",
                      "side": "bid",
                      "ord_type": "limit",
                      "price": "83000000",
                      "state": "done",
                      "market": "KRW-BTC",
                      "created_at": "2024-07-09T16:32:23+09:00",
                      "volume": "1",
                      "remaining_volume": "0",
                      "reserved_fee": "207500",
                      "remaining_fee": "0",
                      "paid_fee": "207500",
                      "locked": "0",
                      "executed_volume": "1",
                      "executed_funds": "83000000",
                      "trades_count": 1,
                      "stp_type": "cancel_taker",
                      "trades": [
                        {
                          "market": "KRW-BTC",
                          "uuid": "C0101000000001713006",
                          "price": "83000000",
                          "volume": "1",
                          "funds": "83000000",
                          "side": "bid",
                          "created_at": "2024-07-09T16:32:23+09:00"
                        }
                      ]
                    }
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "uuid": {
                      "type": "string",
                      "example": "C0101000000001799231",
                      "description": "주문의 고유 ID"
                    },
                    "client_order_id": {
                      "type": "string",
                      "description": "서버에서 부여하는 주문 ID(`uuid`)와 별도로 주문 생성 시 사용자가 직접 지정한 고유 ID"
                    },
                    "side": {
                      "type": "string",
                      "example": "bid",
                      "description": "주문 종류\n- `bid`: 매수\n- `ask`: 매도",
                      "enum": [
                        "bid",
                        "ask"
                      ]
                    },
                    "ord_type": {
                      "type": "string",
                      "example": "limit",
                      "description": "주문 유형\n- `limit`: 지정가\n- `price`: 시장가(매수)\n- `market`: 시장가(매도)\n- `best`: 최유리 지정가(현재 원화 마켓에서만 지원)",
                      "enum": [
                        "limit",
                        "price",
                        "market",
                        "best"
                      ]
                    },
                    "price": {
                      "type": "string",
                      "example": "83000000",
                      "description": "주문 가격"
                    },
                    "state": {
                      "type": "string",
                      "example": "done",
                      "description": "주문 상태\n- `wait`: 체결 대기 \n- `watch`: 주문 대기\n- `done`: 주문 처리 완료\n- `cancel`: 주문 취소",
                      "enum": [
                        "wait",
                        "watch",
                        "done",
                        "cancel"
                      ]
                    },
                    "market": {
                      "type": "string",
                      "example": "KRW-BTC",
                      "description": "거래 대상 페어의 고유 심볼\n\n예시) KRW-BTC",
                      "default": ""
                    },
                    "created_at": {
                      "type": "string",
                      "example": "2024-07-09T16:32:23+09:00",
                      "description": "주문 생성 시각",
                      "format": "date-time"
                    },
                    "volume": {
                      "type": "string",
                      "example": "1",
                      "description": "사용자가 입력한 주문 수량"
                    },
                    "remaining_volume": {
                      "type": "string",
                      "example": "0",
                      "description": "체결 후 남은 주문 수량"
                    },
                    "reserved_fee": {
                      "type": "string",
                      "example": "207500",
                      "description": "예약된 수수료. 매수 주문은 기준통화 단위, 매도 주문은 0.\n\n예시) KRW-DOGE는 KRW, BTC-DOGE는 BTC"
                    },
                    "remaining_fee": {
                      "type": "string",
                      "example": "0",
                      "description": "미사용 예약 수수료. 매수 주문은 기준통화 단위, 매도 주문은 0.\n\n예시) KRW-DOGE는 KRW, BTC-DOGE는 BTC"
                    },
                    "paid_fee": {
                      "type": "string",
                      "example": "207500",
                      "description": "체결 수수료 누적 합계. 기준통화 단위.\n\n예시) KRW-DOGE는 KRW, BTC-DOGE는 BTC"
                    },
                    "locked": {
                      "type": "string",
                      "example": "0",
                      "description": "거래에 사용 중인 금액. 매수 주문은 기준통화 금액, 매도 주문은 주문통화 수량.\n\n예시) KRW-DOGE 매수는 KRW, 매도는 DOGE"
                    },
                    "executed_volume": {
                      "type": "string",
                      "example": "1",
                      "description": "체결된 수량"
                    },
                    "executed_funds": {
                      "type": "string",
                      "description": "체결된 총 금액"
                    },
                    "trades_count": {
                      "type": "integer",
                      "example": 1,
                      "description": "해당 주문의 체결 건수"
                    },
                    "trades": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "market": {
                            "type": "string",
                            "example": "KRW-BTC",
                            "description": "거래 대상 페어의 고유 심볼\n\n예시) KRW-BTC"
                          },
                          "uuid": {
                            "type": "string",
                            "example": "C0101000000001713006",
                            "description": "체결의 고유 ID"
                          },
                          "price": {
                            "type": "string",
                            "example": "83000000",
                            "description": "체결 가격"
                          },
                          "volume": {
                            "type": "string",
                            "example": "1",
                            "description": "체결 수량"
                          },
                          "funds": {
                            "type": "string",
                            "example": "83000000",
                            "description": "체결 금액"
                          },
                          "side": {
                            "type": "string",
                            "example": "bid",
                            "description": "체결 종류\n- `bid`: 매수\n- `ask`: 매도",
                            "enum": [
                              "bid",
                              "ask"
                            ]
                          },
                          "created_at": {
                            "type": "string",
                            "example": "2024-07-09T16:32:23+09:00",
                            "description": "체결 시각",
                            "format": "date-time"
                          }
                        }
                      },
                      "description": "체결 내역 "
                    },
                    "stp_type": {
                      "type": "string",
                      "description": "자전거래 방지 처리 유형\n- `cancel_taker`: 자전거래 감지 시 taker(신규 주문) 취소",
                      "enum": [
                        "cancel_taker"
                      ],
                      "default": "cancel_taker"
                    },
                    "cancel_type": {
                      "type": "string",
                      "description": "취소 유형\n- `stp_cancel`: 자전거래 감지에 의한 취소\n- `user_cancel`: 사용자 취소\n- `admin_cancel`: 관리자 취소\n- `tif_cancel`: 주문 처리 조건에 의한 취소",
                      "enum": [
                        "stp_cancel",
                        "user_cancel",
                        "admin_cancel",
                        "tif_cancel"
                      ]
                    },
                    "canceling_uuid": {
                      "type": "string",
                      "description": "`cancel_type`이 `stp_cancel`인 경우, 해당 주문을 취소시킨 반대 주문의 고유 ID"
                    },
                    "time_in_force": {
                      "type": "string",
                      "description": "주문 처리 조건\n- `ioc`: 즉시 체결 가능한 수량만 체결하고, 나머지는 취소합니다.\n- `fok`: 전체 수량이 즉시 체결 가능할 때만 체결하고, 아니면 전량 취소합니다.\n- `post_only`: 호가창에 등록되는 maker 주문일 때만 허용하며, 즉시 체결될 수 있는 주문일 경우 취소합니다.",
                      "enum": [
                        "ioc",
                        "fok",
                        "post_only"
                      ]
                    }
                  },
                  "required": [
                    "uuid",
                    "side",
                    "ord_type",
                    "price",
                    "state",
                    "market",
                    "created_at",
                    "volume",
                    "remaining_volume",
                    "reserved_fee",
                    "remaining_fee",
                    "paid_fee",
                    "locked",
                    "executed_volume",
                    "executed_funds",
                    "trades_count",
                    "trades"
                  ]
                }
              }
            }
          },
          "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",
                          "example": "error name",
                          "description": "에러명"
                        },
                        "message": {
                          "type": "string",
                          "example": "error message",
                          "description": "에러 메시지"
                        }
                      }
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          },
          "401": {
            "description": "401",
            "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": "에러명"
                        },
                        "message": {
                          "type": "string",
                          "description": "에러 메시지"
                        }
                      }
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "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": "에러명"
                        },
                        "message": {
                          "type": "string",
                          "description": "에러 메시지"
                        }
                      }
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          }
        },
        "deprecated": false,
        "x-readme": {
          "code-samples": [
            {
              "language": "javascript",
              "code": "  const jwt = require('jsonwebtoken');\n  const { v4: uuidv4 } = require('uuid');\n  const crypto = require('crypto');\n  const axios = require('axios')\n\n  const accessKey = '발급받은 API KEY'\n  const secretKey = '발급받은 SECRET KEY'\n  const apiUrl = 'https://api.bithumb.com'\n\n  // Set API parameters\n  // uuid 또는 client_order_id 중 하나를 사용\n  // 두 값이 모두 전달된 경우, uuid를 기준으로 조회\n  const params = {\n      uuid: 'C0295000000000100020',\n      // client_order_id: 'my-client-order-id-001'  // 필요 시 주석 해제\n  }\n\n  // 인코딩 없이 query string 생성\n  const query = Object.entries(params)\n      .map(([key, value]) => `${key}=${value}`)\n      .join('&')\n\n  // Generate access token\n  const alg = 'SHA512'\n  const hash = crypto.createHash(alg)\n  const queryHash = hash.update(query, 'utf-8').digest('hex')\n  const payload = {\n      access_key: accessKey,\n      nonce: uuidv4(),\n      timestamp: Date.now(),\n      query_hash: queryHash,\n      query_hash_alg: alg\n  }\n  const jwtToken = jwt.sign(payload, secretKey)\n  const config = {\n      headers: {\n          Authorization: `Bearer ${jwtToken}`\n      }\n  }\n\n  // Call API\n  axios.get(apiUrl + '/v1/order?' + 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\n  import jwt\n  import uuid\n  import hashlib\n  import time\n  import requests\n\n  accessKey = '발급받은 API KEY'\n  secretKey = '발급받은 SECRET KEY'\n  apiUrl = 'https://api.bithumb.com'\n\n  # Set API parameters\n  param = dict( uuid='C0295000000000100020' )\n\n  # client_order_id (선택)\n  # param['client_order_id'] = 'my-client-order-id-001'\n\n  # Generate access token\n  query = '&'.join([f'{k}={v}' for k, v in param.items()])\n  hash = hashlib.sha512()\n  hash.update(query.encode('utf-8'))\n  query_hash = hash.hexdigest()\n  payload = {\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  }\n  jwt_token = jwt.encode(payload, secretKey)\n  authorization_token = 'Bearer {}'.format(jwt_token)\n  headers = {\n    'Authorization': authorization_token\n  }\n\n  try:\n      # Call API\n      response = requests.get(apiUrl + '/v1/order?' + query, headers=headers)\n      # handle to success or fail\n      print(response.status_code)\n      print(response.json())\n  except Exception as err:\n      # handle exception\n      print(err)"
            },
            {
              "language": "java",
              "code": "  package com.example.sample;\n\n  // https://mvnrepository.com/artifact/com.auth0/java-jwt\n  import com.auth0.jwt.JWT;\n  import com.auth0.jwt.algorithms.Algorithm;\n  // https://mvnrepository.com/artifact/org.apache.httpcomponents/httpclient\n  import org.apache.http.client.methods.CloseableHttpResponse;\n  import org.apache.http.client.methods.HttpGet;\n  import org.apache.http.impl.client.CloseableHttpClient;\n  import org.apache.http.impl.client.HttpClients;\n  import org.apache.http.util.EntityUtils;\n\n  import java.math.BigInteger;\n  import java.nio.charset.StandardCharsets;\n  import java.security.MessageDigest;\n  import java.security.NoSuchAlgorithmException;\n  import java.util.ArrayList;\n  import java.util.List;\n  import java.util.UUID;\n\n  public class GETArgs {\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 (URL 인코딩 없이 수동 조합)\n          List<String> queryParts = new ArrayList<>();\n          queryParts.add(\"uuid=C0295000000000100020\");\n\n          // client_order_id는 선택 - 필요 시 아래 주석 해제\n          // queryParts.add(\"client_order_id=my-client-order-id-001\");\n\n          String query = String.join(\"&\", queryParts);\n\n          // Generate access token\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/order?\" + 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  }"
            }
          ],
          "samples-languages": [
            "javascript",
            "python",
            "java"
          ]
        }
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": false,
    "proxy-enabled": false
  },
  "x-readme-fauxas": true
}
```