---
updatedAt: 2026-07-09T08:43:27.000Z
agentTools:
  projectIndex: https://apidocs.bithumb.com/llms.txt
---

# 주문 요청

주문을 요청합니다.

<Callout icon="📌" theme="warning">

  #### 입력 규칙

  * 지정가 주문: price와 volume 모두 필요
  * 시장가 매수: price(총 금액) 필요
  * 시장가 매도: volume 필요

</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`이 신규 추가되었으며, 2026년 5월 7일 서비스 배포 이후 요청된 주문에 한하여 `stp_type` 필드가 필수 출력됩니다.

</Callout>

## 주문 처리 조건(`time_in_force`)

<Accordion title="IOC / FOK / Post-Only / best 동작 상세">
  ### IOC (Immediate Or Cancel)

  즉시 체결 가능한 수량만 체결하고, 미체결 잔량은 즉시 취소합니다.

  * 체결 가능 수량 있음: 가능한 수량만 체결하고 잔량 즉시 취소. **부분 체결도`done`(체결 완료)으로 처리됩니다.**
  * 체결 가능 수량 없음: 주문 전체 즉시 취소.
  * 어떤 경우에도 미체결 대기(`wait`) 상태로 주문이 남지 않습니다.

  ### FOK (Fill Or Kill)

  주문 수량 전체를 즉시 체결할 수 있을 때만 체결하며, 그렇지 않으면 주문 전체를 즉시 취소합니다.

  * 전량 즉시 체결 가능: 전체 수량 체결 처리.
  * 전량 체결 불가(부분 체결 포함): 주문 전체 즉시 취소. **부분 체결 없음.**
  * 어떤 경우에도 미체결 대기(`wait`) 상태로 주문이 남지 않습니다.

  ### Post-Only

  Maker 주문으로만 등록되며, Taker 체결 가격일 경우 주문이 취소됩니다.

  * Taker 가격(즉시 체결되는 가격): 주문 즉시 취소(`state: cancel`).
  * Maker 가격(호가창에 등록되는 가격): 미체결 대기(`state: wait`)로 등록. 주문 취소 API로 취소 가능합니다.
  * `limit` 주문에서만 사용 가능합니다. `best` 주문에서는 사용할 수 없습니다.

  ### best + IOC / FOK

  `best` 주문은 매수 시 매도 1호가, 매도 시 매수 1호가에 **자동으로 주문 가격이 설정**됩니다.

  * `ioc`: 해당 단일 호가에서 즉시 체결 가능한 수량만 체결하고 잔량 취소.
  * `fok`: 해당 단일 호가에서 전량 즉시 체결이 가능할 때만 체결하며, 그렇지 않으면 전체 취소.
</Accordion>

### 시나리오별 최종 상태

| 시나리오                          | 최종 `state` |
| ----------------------------- | ---------- |
| `ioc`: 전량 체결                  | `done`     |
| `ioc`: 일부 체결(잔량 즉시 취소)        | `done`     |
| `ioc`: 체결 없음(전체 즉시 취소)        | `cancel`   |
| `fok`: 전량 체결                  | `done`     |
| `fok`: 전량 체결 불가(전체 즉시 취소)     | `cancel`   |
| `post_only`: Taker 가격(즉시 취소)  | `cancel`   |
| `post_only`: Maker 가격(호가창 등록) | `wait`     |

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "bithumb_api_v2",
    "version": "2.0.0"
  },
  "servers": [
    {
      "url": "https://api.bithumb.com/v2"
    }
  ],
  "security": [
    {}
  ],
  "paths": {
    "/orders": {
      "post": {
        "summary": "주문 요청",
        "description": "주문을 요청합니다.",
        "operationId": "주문-요청",
        "parameters": [
          {
            "name": "Authorization",
            "in": "header",
            "description": "Authorization token (JWT)",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "market",
                  "side",
                  "order_type"
                ],
                "properties": {
                  "market": {
                    "type": "string",
                    "description": "거래 대상 페어의 고유 심볼\n\n예시) KRW-BTC",
                    "x-readme-id": "0.0"
                  },
                  "side": {
                    "type": "string",
                    "description": "주문 종류\n- `bid`: 매수\n- `ask`: 매도",
                    "x-readme-id": "0.1",
                    "enum": [
                      "bid",
                      "ask"
                    ]
                  },
                  "price": {
                    "type": "string",
                    "description": "주문 가격(지정가 주문, 시장가 매수 주문 시 필수)\n- 지정가 주문: 주문 단가\n- 시장가 매수 주문: 주문 총액",
                    "x-readme-id": "0.3"
                  },
                  "volume": {
                    "type": "string",
                    "description": "주문 수량(지정가 주문, 시장가 매도 주문 시 필수)",
                    "x-readme-id": "0.4"
                  },
                  "order_type": {
                    "type": "string",
                    "description": "주문 유형(구 `ord_type`)\n- `limit`: 지정가\n- `price`: 시장가(매수)\n- `market`: 시장가(매도)\n- `best`: 최유리 지정가(현재 원화 마켓에서만 지원)",
                    "x-readme-id": "0.2",
                    "enum": [
                      "limit",
                      "price",
                      "market",
                      "best"
                    ]
                  },
                  "client_order_id": {
                    "type": "string",
                    "description": "서버에서 부여하는 주문 ID(`order_id`)와 별도로 주문 생성 시 사용자가 직접 지정하는 고유 ID\n\n- 허용 문자: 영문 대/소문자, 숫자, -, _\n- 길이: 1–36자"
                  },
                  "time_in_force": {
                    "type": "string",
                    "description": "주문 처리 조건(현재 원화 마켓에서만 지원)\n- `ioc`: 즉시 체결 가능한 수량만 체결하고, 나머지는 취소합니다.\n- `fok`: 전체 수량이 즉시 체결 가능할 때만 체결하고, 아니면 전량 취소합니다.\n- `post_only`: 호가창에 등록되는 maker 주문일 때만 허용하며, 즉시 체결될 수 있는 주문일 경우 취소합니다.\n\n**유의사항**\n- `limit`, `best` 주문에서만 사용할 수 있습니다.\n- `limit` 주문: 선택 입력, `ioc`, `fok`, `post_only` 사용 가능\n- `best` 주문: 필수 입력, `ioc`, `fok`만 사용 가능",
                    "enum": [
                      "ioc",
                      "fok",
                      "post_only"
                    ]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "201",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": {
                      "order_id": "C0101000000001799653",
                      "market": "KRW-BTC",
                      "side": "bid",
                      "order_type": "limit",
                      "time_in_force": "ioc",
                      "created_at": "2024-07-14T13:35:41+09:00",
                      "stp_type": "cancel_taker"
                    }
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "order_id": {
                      "type": "string",
                      "description": "주문의 고유 ID(구 `uuid`)"
                    },
                    "market": {
                      "type": "string",
                      "example": "KRW-BTC",
                      "description": "거래 대상 페어의 고유 심볼\n\n예시) KRW-BTC"
                    },
                    "side": {
                      "type": "string",
                      "example": "bid",
                      "description": "주문 종류\n- `bid`: 매수\n- `ask`: 매도",
                      "enum": [
                        "bid",
                        "ask"
                      ]
                    },
                    "order_type": {
                      "type": "string",
                      "example": "limit",
                      "description": "주문 유형(구 `ord_type`)\n- `limit`: 지정가\n- `price`: 시장가(매수)\n- `market`: 시장가(매도)\n- `best`: 최유리 지정가(현재 원화 마켓에서만 지원)",
                      "enum": [
                        "limit",
                        "price",
                        "market",
                        "best"
                      ]
                    },
                    "created_at": {
                      "type": "string",
                      "example": "2024-07-14T13:35:41+09:00",
                      "description": "주문 생성 시각",
                      "format": "date-time"
                    },
                    "client_order_id": {
                      "type": "string",
                      "description": "서버에서 부여하는 주문 ID(`order_id`)와 별도로 주문 생성 시 사용자가 직접 지정한 고유 ID"
                    },
                    "stp_type": {
                      "type": "string",
                      "description": "자전거래 방지 처리 유형\n- `cancel_taker`: 자전거래 감지 시 taker(신규 주문) 취소",
                      "enum": [
                        "cancel_taker"
                      ],
                      "default": "cancel_taker"
                    },
                    "time_in_force": {
                      "type": "string",
                      "description": "주문 처리 조건\n- `ioc`: 즉시 체결 가능한 수량만 체결하고, 나머지는 취소합니다.\n- `fok`: 전체 수량이 즉시 체결 가능할 때만 체결하고, 아니면 전량 취소합니다.\n- `post_only`: 호가창에 등록되는 maker 주문일 때만 허용하며, 즉시 체결될 수 있는 주문일 경우 취소합니다.",
                      "enum": [
                        "ioc",
                        "fok",
                        "post_only"
                      ]
                    }
                  },
                  "required": [
                    "order_id",
                    "market",
                    "side",
                    "order_type",
                    "created_at"
                  ]
                }
              }
            }
          },
          "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": "에러 메시지"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false,
        "x-readme": {
          "code-samples": [
            {
              "language": "javascript",
              "name": "",
              "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    const requestBody = {\n        market: 'KRW-BTC',\n        side: 'bid',\n        order_type: 'limit',\n        price: 84000000,\n        volume: 0.001,\n        time_in_force: 'ioc', \n        client_order_id: 'my-order-001'  // 사용자 지정 주문 ID (선택)\n    }\n\n    // Generate access token\n    const query = Object.entries(requestBody)\n        .map(([key, value]) => `${key}=${value}`)\n        .join('&')\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            'Content-Type': 'application/json'\n        }\n    }\n\n    // Call API\n    axios.post(apiUrl + '/v2/orders', requestBody, 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",
              "name": "",
              "code": "  # Python 3\n  # pip3 install pyJwt\n  import jwt\n  import uuid\n  import hashlib\n  import time\n  import requests\n  import json\n\n  accessKey = '발급받은 API KEY'\n  secretKey = '발급받은 SECRET KEY'\n  apiUrl = 'https://api.bithumb.com'\n\n  # Set API parameters\n  requestBody = dict(\n      market='KRW-BTC',\n      side='bid',\n      order_type='limit',\n      price=84000000,\n      volume=0.001,\n      time_in_force='ioc',\n      client_order_id='my-order-001'  # 사용자 지정 주문 ID (선택)\n  )\n\n  # Generate access token\n  query = '&'.join([f'{k}={v}' for k, v in requestBody.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      'Content-Type': 'application/json'\n  }\n\n  try:\n      # Call API\n      response = requests.post(apiUrl + '/v2/orders', data=json.dumps(requestBody), 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",
              "name": "",
              "code": "  public class POSTArgs {\n\n      public static void main(String[] args) throws NoSuchAlgorithmException, IOException {\n          String accessKey = \"발급받은 API KEY\";\n          String secretKey = \"발급받은 SECRET KEY\";\n          String apiUrl = \"https://api.bithumb.com\";\n\n          // Set API parameters\n          Map<String, Object> requestBody = new LinkedHashMap<>();\n          requestBody.put(\"market\", \"KRW-BTC\");\n          requestBody.put(\"side\", \"bid\");\n          requestBody.put(\"order_type\", \"limit\");\n          requestBody.put(\"price\", 84000000);\n          requestBody.put(\"volume\", 0.001);\n          requestBody.put(\"time_in_force\", \"ioc\");\n          requestBody.put(\"client_order_id\", \"my-order-001\");  // 사용자 지정 주문 ID (선택)\n\n          // Generate access token\n          String query = requestBody.entrySet().stream()\n                  .map(entry -> entry.getKey() + \"=\" + entry.getValue())\n                  .collect(Collectors.joining(\"&\"));\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 HttpPost httpRequest = new HttpPost(apiUrl + \"/v2/orders\");\n          httpRequest.addHeader(\"Authorization\", authenticationToken);\n          httpRequest.addHeader(\"Content-type\", \"application/json\");\n          httpRequest.setEntity(new StringEntity(new ObjectMapper().writeValueAsString(requestBody), StandardCharsets.UTF_8));\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": true
  },
  "x-readme-fauxas": true
}
```