역사 주문 조회

엔드포인트: /v1/futures/orders/history

요청 매개변수

필수

메서드: GET

예시

Bash

curl -X GET "https://oapi.websea.com/v1/futures/orders/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 정순
limit	아니요	int	20	반환할 레코드 수. 기본값: 20, 최대값: 100
is_full	아니요	int	1	증거금 모드: 1 격리 증거금, 2 교차 증거금

응답 매개변수

매개변수	필수 여부	타입	예시	설명
errno	예	int	0	상태 코드
errmsg	예	string	success	상태 메시지
result	예	array	예시 참조	결과 데이터

결과 필드

매개변수	필수 여부	타입	예시	설명
order_id	예	string	11535	주문 ID
ctime	예	int	1576746253	주문 생성 시간 (Unix 타임스탬프)
symbol	예	string	EOS-USDT	거래쌍
price	예	string	14	주문 가격
price_avg	예	string	15	평균 체결 가격
lever_rate	예	int	10	레버리지 배수
amount	예	string	150	주문 수량
deal_amount	예	string	100	체결 수량
type	예	string	buy-limit	주문 유형
status	예	int	3	주문 상태 (1=대기 중, 2=부분 체결, 3=체결 완료, 4=취소 중, 5=부분 취소됨, 6=취소됨)
contract_type	예	string	open	포지션 작업: 포지션 오픈은 open, 포지션 종료는 close
profit	예	string	10	총 손익

응답 예시

JSON

{
    "errno": 0,
    "errmsg": "success",
    "result": [
        {
            "order_id": "11535",
            "ctime": 1576746253,
            "symbol": "EOS-USDT",
            "price": "14",
            "price_avg": "15",
            "lever_rate": 10,
            "amount": "150",
            "deal_amount": "100",
            "type": "buy-limit",
            "status": 3,
            "contract_type": "open",
            "profit": "10"
        }
    ]
}