미체결 주문 조회
엔드포인트: /v1/futures/orders/open
요청 매개변수
필수
메서드: GET
예시
Bash
curl -X GET "https://oapi.websea.com/v1/futures/orders/open?symbol=ETH-USDT&limit=20" \
-H "Token: YOUR_TOKEN" \
-H "Nonce: 1700000000_abcd1" \
-H "Signature: GENERATED_SIGNATURE"
쿼리 매개변수
| 매개변수 | 필수 여부 | 타입 | 예시 | 설명 |
|---|---|---|---|---|
| symbol | 아니요 | string | ETH-USDT | 거래쌍. 특정 심볼을 조회할 때 필수이며, 생략 시 모든 심볼을 조회합니다. |
| from | 아니요 | int | 122 | 페이지네이션을 위한 시작 order_id |
| direct | 아니요 | string | prev | 조회 방향. 기본값: prev (시간/ID 역순); next (시간/ID 정순). 예시 시퀀스: 1,2,3,4,5. from=4일 때, prev는 3,2,1을 반환하고 next는 5를 반환합니다. |
| limit | 아니요 | int | 20 | 반환할 레코드 수. 기본값: 20, 최대값: 100 |
| is_full | 아니요 | int | 1 | 증거금 모드: 1 격리 증거금, 2 교차 증거금 |
응답 매개변수
| 매개변수 | 필수 여부 | 타입 | 예시 | 설명 |
|---|---|---|---|---|
| errno | 예 | int | 0 | 상태 코드 |
| errmsg | 예 | string | success | 상태 메시지 |
| result | 예 | object | 예시 참조 | 결과 데이터 |
결과 필드
| 매개변수 | 필수 여부 | 타입 | 예시 | 설명 |
|---|---|---|---|---|
| order_id | 예 | string | BG5000181583375122413SZXEIX | 주문 ID |
| ctime | 예 | int | 1576746253 | 주문 생성 시간 (Unix 타임스탬프) |
| symbol | 예 | string | ETH-USDT | 거래쌍 |
| price | 예 | string | 1 | 주문 가격 |
| price_avg | 예 | string | 0 | 평균 체결 가격 |
| lever_rate | 예 | int | 10 | 레버리지 배수 |
| amount | 예 | string | 10 | 주문 수량 |
| deal_amount | 예 | string | 0 | 체결 수량 |
| type | 예 | string | buy-limit | 주문 유형 |
| status | 예 | int | 1 | 주문 상태 (1=대기 중, 2=부분 체결, 3=체결 완료, 4=취소 중, 5=부분 취소됨, 6=취소됨) |
| contract_type | 예 | string | open | 포지션 작업: 포지션 오픈은 open, 포지션 종료는 close |
| trigger_price | 예 | string | 1 | 트리거 가격 |
| stop_profit_price | 예 | string | 15 | 이익실현 가격 |
| stop_loss_price | 예 | string | 10 | 손실제한 가격 |
응답 예시
JSON
{
"errno": 0,
"errmsg": "success",
"result": [
{
"order_id": "BG5000181583375122413SZXEIX",
"ctime": 1576746253,
"symbol": "ETH-USDT",
"price": "1",
"price_avg": "0",
"lever_rate": 10,
"amount": "10",
"deal_amount": "0",
"type": "buy-limit",
"status": 1,
"contract_type": "open",
"trigger_price": "1",
"stop_profit_price": "15",
"stop_loss_price": "10"
}
]
}