現在のポジションの照会

エンドポイント: /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	はい	object	例を参照	レスポンス結果

resultパラメータの説明

パラメータ名	必須	型	例	説明
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"
    }]
}