역사 계획 주문 조회
엔드포인트: /v1/futures/plan/history
요청 매개변수
필수
메서드: GET
예시
Bash
curl -X GET "https://oapi.websea.com/v1/futures/plan/history?symbol=EOS-USDT&limit=20" \
-H "Token: YOUR_TOKEN" \
-H "Nonce: 1700000000_abcd1" \
-H "Signature: GENERATED_SIGNATURE"
쿼리 매개변수
| 매개변수 | 필수 여부 | 타입 | 예시 | 설명 |
|---|---|---|---|---|
| symbol | 아니요 | string | EOS-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 | 예 | array | 예시 참조 | 결과 데이터 |
결과 필드
| 매개변수 | 필수 여부 | 타입 | 예시 | 설명 |
|---|---|---|---|---|
| order_id | 예 | string | BG5000181583375122413SZXEIX | 주문 ID |
| ctime | 예 | int | 1576746253 | 주문 생성 시간 (Unix 타임스탬프) |
| symbol | 예 | string | ETH-USDT | 거래쌍 |
| price | 예 | string | 1 | 주문 가격 |
| lever_rate | 예 | int | 10 | 레버리지 배수 |
| amount | 예 | string | 10 | 주문 수량 |
| type | 예 | string | buy-limit | 주문 유형 |
| trigger_sign | 예 | string | 0 | 트리거 조건: 1 ≥ 트리거 가격, 2 ≤ 트리거 가격 |
| trigger_price | 예 | string | 10 | 트리거 가격 |
| stop_profit_price | 예 | string | 15 | 이익실현 가격 |
| stop_loss_price | 예 | string | 10 | 손실제한 가격 |
| implement_status | 예 | int | 3 | 실행 상태 (0=대기 중, 1=주문 중, 2=부분 실행됨, 3=전체 실행됨, 4=실행 실패, 5=취소됨) |
| tactics_deal | 예 | string | 10 | 체결 수량 |
응답 예시
JSON
{
"errno": 0,
"errmsg": "success",
"result": [
{
"order_id": "BG5000181583375122413SZXEIX",
"ctime": 1576746253,
"symbol": "ETH-USDT",
"price": "1",
"lever_rate": 10,
"amount": "10",
"type": "buy-limit",
"trigger_sign": "0",
"trigger_price": "10",
"stop_profit_price": "15",
"stop_loss_price": "10",
"implement_status": 3,
"tactics_deal": "10"
}
]
}