순서

Markdown으로 보기

Order 엔드포인트는 거래 허가가 필요합니다.

주문

1POST /v1/private/order/place
2Content-Type: application/json

요청 매개변수:

매개변수유형필수설명
symbolstring상징
typestringLIMIT / MARKET
sidestringBUY / SELL
positionSidestring아니BOTH / LONG / SHORT, 기본 BOTH
pricestring조건부 필수지가가 주문에 필수
quantitystring조건부 필수양. 생략할 수 있습니다 closePosition=true
timeInForcestring아니GTC / IOC / FOK, 기본 GTC
reduceOnlybool아니리듀얼 전용, 기본 false
makerOnlybool아니메이커 전용 기본 false
closePositionbool아니전체 포지션을 닫으세요, 기본값 false
clientOrderIdstring아니클라이언트 정의 주문 ID
placeTypestring아니주문 배치 유형 마커
priceTypeint32아니BBO 가격 유형: 0 명시된 가격, 1 상대방 가격 1, 2 상대방 가격 5, 3 동면 가격 1, 4 동면 가격 5

요청 예시:

1{
2 "symbol": "BTCUSDT",
3 "type": "LIMIT",
4 "side": "BUY",
5 "price": "85000",
6 "quantity": "0.1",
7 "timeInForce": "GTC",
8 "makerOnly": true,
9 "clientOrderId": "ext-1772710377808-001"
10}

응답 필드:

필드유형설명
orderIdstring서버 주문 ID
clientOrderIdstring클라이언트 정의 주문 ID
statusstring명령 현황
timestampint64타임스탬프

배치 주문

1POST /v1/private/order/batch-place
2Content-Type: application/json

본문 요청:

1{
2 "orders": [
3 {
4 "symbol": "BTCUSDT",
5 "type": "LIMIT",
6 "side": "BUY",
7 "price": "85000",
8 "quantity": "0.1",
9 "clientOrderId": "ext-buy-001"
10 }
11 ]
12}

응답 필드:

필드유형설명
successCountint32성공 주문 수
failedCountint32실패한 주문 수
results[]array각 순서별 결과

배치 조건 순서

1POST /v1/private/order/place-condition
2Content-Type: application/json

요청 매개변수:

매개변수유형필수설명
symbolstring상징
typestringSTOP_MARKET / TAKE_PROFIT_MARKET / STOP_LIMIT / TAKE_PROFIT_LIMIT / TRAILING_STOP
sidestringBUY / SELL
positionSidestring아니BOTH / LONG / SHORT
pricestring조건부 필수STOP_LIMIT / TAKE_PROFIT_LIMIT에 필수
quantitystring조건부 필수양. 생략할 수 있습니다 closePosition=true
timeInForcestring아니GTC / IOC / FOK / GTE_GTC
reduceOnlybool아니리듀얼 전용
clientOrderIdstring아니클라이언트 정의 주문 ID
stopPricestring조건부 필수트리거 가격
workingTypestring아니MARK_PRICE / CONTRACT_PRICE, 기본 CONTRACT_PRICE
priceProtectbool아니가격 보호가 활성화되는지 여부
activatePricestring조건부 필수트레일링 주문 활성화 가격
callbackRatestring조건부 필수트레일링 오더 콜백 비율
closePositionbool아니전체 위치를 닫아라

응답 필드:

필드유형설명
conditionIdstring조건 순서 ID
conditionStatusstring조건 순서 상태
timestampint64타임스탬프

배치 전략 순서

1POST /v1/private/order/place-strategy
2Content-Type: application/json

요청 매개변수:

매개변수유형필수설명
strategyTypestringOTOCO / OTO / OCO
subOrderListarray하위 목 목록

subOrderList[]의 필드는 대부분 일반 순서와 조건 순서와 동일하며, 추가적인 종속 필드가 있습니다:

매개변수유형설명
strategySubIdint64하위 명령 ID
firstDrivenIdint64첫 운전 명령 신분증은 0 의존 없음을 의미합니다
firstDrivenOnstring첫 번째 트리거 조건
firstTriggerstring첫 번째 트리거 작용
secondDrivenIdint64두 번째 운전 명령 신분증
secondDrivenOnstring두 번째 트리거 조건
secondTriggerstring두 번째 트리거 액션

응답 필드:

필드유형설명
strategyIdstring전략 ID
strategyStatusstring전략 현황
timestampint64타임스탬프

단일 순서 쿼리

1GET /v1/private/order?symbol=BTCUSDT&orderId=2022543809547603968

요청 매개변수:

매개변수유형필수설명
symbolstring상징
orderIdstring아니서버 주문 ID
clientOrderIdstring아니클라이언트 정의 주문 ID

orderIdclientOrderId 중 적어도 하나는 제공되어야 합니다. 두 조건이 모두 제공되면 서버는 두 조건 모두에서 정확한 매칭을 수행합니다.

현재 노멀 명령

1GET /v1/private/order/current?symbol=BTCUSDT

요청 매개변수:

매개변수유형필수설명
symbolstring아니상징
limitint32아니반품 횟수 제한
lastOrderIdint64아니커서 필드

응답 필드:

필드유형설명
list[]array현재 정상 순서 목록
totalint32백작

현재 상태 명령

1GET /v1/private/order/current-condition?symbol=BTCUSDT

요청 매개변수:

매개변수유형필수설명
symbolstring아니상징

역사적 정상 기사단

1GET /v1/private/order/history?symbol=BTCUSDT&page=1&pageSize=20

요청 매개변수:

매개변수유형필수설명
symbolstring아니상징
orderIdstring아니정확한 순서 ID 필터
clientOrderIdstring아니정확한 고객 주문 ID 필터
typeint32아니주문 유형 필터: 1 한도, 2 시장
sideint32아니측면 필터: 1 사고, 2 팔 수 있습니다
statusint32아니상태 필터
startTimeint64아니시작 시간
endTimeint64아니종말
pageint64아니페이지 번호, 기본 1
pageSizeint64아니페이지당 항목 수, 기본 20

역사적 상태 명령

1GET /v1/private/order/history-condition?symbol=BTCUSDT&page=1&pageSize=20

요청 매개변수:

매개변수유형필수설명
symbolstring아니상징
sideint32아니측면 필터: 1 사고, 2 팔 수 있습니다
statusint32아니상태 필터
startTimeint64아니시작 시간
endTimeint64아니종말
pageint64아니페이지 번호, 기본 1
pageSizeint64아니페이지당 항목 수, 기본 20

무역 기록

1GET /v1/private/order/trades?symbol=BTCUSDT&page=1&pageSize=20

요청 매개변수:

매개변수유형필수설명
symbolstring아니상징
orderIdstring아니주문 ID 필터
startTimeint64아니시작 시간
endTimeint64아니종말
pageint64아니페이지 번호, 기본 1
pageSizeint64아니페이지당 항목 수, 기본 20

응답 필드:

필드유형설명
list[].fillIdstring필 디테일 ID
list[].tradeIdstring거래 기록 ID
list[].orderIdstring주문 ID
list[].symbolstring상징
list[].sidestring사이드
list[].roleTypestringmaker / taker
list[].pricestring채워진 가격
list[].quantitystring채워진 수량
list[].tradeValuestring무역 가치
list[].handlingFeestring처리 수수료
list[].realizedPnlstring실현된 PnL
list[].positionSidestring포지션 사이드
list[].createdAtint64거래 시간
totalint64총 집단

주문 취소

1POST /v1/private/order/cancel
2Content-Type: application/json

본문 요청:

1{
2 "symbol": "BTCUSDT",
3 "orderId": "2022543809547603968"
4}

clientOrderId 주문 취소에도 사용할 수 있습니다.

명령 개정

1POST /v1/private/order/move
2Content-Type: application/json

본문 요청:

1{
2 "symbol": "BTCUSDT",
3 "orderId": "2022543809547603968",
4 "price": "85100",
5 "quantity": "0.2"
6}

quantity 는 수정 후 최종 총 주문 수량이지 남은 수량이 아닙니다.

배치 수정 명령

1POST /v1/private/order/batch-move
2Content-Type: application/json

본문 요청:

1{
2 "symbol": "BTCUSDT",
3 "orders": [
4 {
5 "orderId": "2022543809547603968",
6 "price": "85100",
7 "quantity": "0.2"
8 }
9 ]
10}

주문 취소 배치

1POST /v1/private/order/batch-cancel
2Content-Type: application/json

본문 요청:

1{
2 "orders": [
3 {
4 "symbol": "BTCUSDT",
5 "orderId": "2022543809547603968"
6 }
7 ]
8}

모두 취소하기

1POST /v1/private/order/batch-cancel-all
2Content-Type: application/json

요청 매개변수:

매개변수유형필수설명
symbolstring아니상징
cancelTypeint32아니0 모든 일반 주문, 1 제한 주문만, 2 모든 조건 주문입니다. 기본 0

일반 주문에 대한 취소 전부는 비동기식으로 허용됩니다. 최종 상태는 WebSocket ORDER_TRADE_UPDATE 또는 쿼리 엔드포인트에 의해 결정되어야 합니다.

조건 취소 명령

1POST /v1/private/order/cancel-condition
2Content-Type: application/json

본문 요청:

1{
2 "symbol": "BTCUSDT",
3 "conditionId": "2022543809547603968"
4}

전략 순서 세부사항

1GET /v1/private/order/strategy?strategyId=2022543809547603968

응답 필드:

필드유형설명
strategyIdstring전략 ID
strategyTypestringOTOCO / OTO / OCO
strategyStatusstringWORKING / ALL_DONE / CANCELLED
bookTimeint64생성 시간
subOrders[]array하위 주문 세부 정보
updateTimeint64업데이트 시간