현재 포지션 조회

엔드포인트: /v1/futures/position

요청 매개변수

필수

메서드: GET

예시

Bash

curl -X GET "https://oapi.websea.com/v1/futures/position?symbol=ETH-USDT&is_full=1" \
  -H "Token: YOUR_TOKEN" \
  -H "Nonce: 1700000000_abcd1" \
  -H "Signature: GENERATED_SIGNATURE"

쿼리 매개변수

매개변수	필수 여부	타입	예시	설명
symbol	아니요	string	ETH-USDT	거래쌍. 생략 시 모든 포지션이 반환됩니다.
is_full	아니요	int	1	증거금 모드: 1 격리 증거금, 2 교차 증거금

응답 매개변수

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

결과 필드

매개변수	필수 여부	타입	예시	설명
type	예	int	1	포지션 방향: 1 롱(매수), 2 숏(매도)
symbol	예	string	ETH-USDT	거래쌍
lever_rate	예	int	10	레버리지 배수
amount	예	string	10	포지션 수량
profit	예	string	10	실현 손익
open_price_avg	예	string	0.3	평균 진입 가격
bood	예	string	6	동결 증거금 (USDT)
contract_frozen	예	string	5	동결 계약 수
settle_rate	예	string	0.1	현재 펀딩/정산 수수료
equity	예	string	3.4	계정 자산 (USDT)
avail	예	string	20	사용 가능한 잔액 (USDT)
bond_rate	예	string	1.1	증거금 비율
liquidation_price	예	string	0.9	청산 가격
avail_amount	예	string	50	종료 가능한 수량 (계약 수)
un_profit	예	string	0	미실현 손익

응답 예시

JSON

{
    "errno": 0,
    "errmsg": "success",
    "result": [
        {
            "type": 1,
            "symbol": "ETH-USDT",
            "lever_rate": 10,
            "amount": "10",
            "profit": "10",
            "open_price_avg": "0.3",
            "bood": "6",
            "contract_frozen": "5",
            "settle_rate": "0.1",
            "equity": "3.4",
            "avail": "20",
            "bond_rate": "1.1",
            "liquidation_price": "0.9",
            "avail_amount": "50",
            "un_profit": "0"
        }
    ]
}