現在の未約定注文の照会
エンドポイント: /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 | 取引ペア(特定の取引ペアのみ取得する場合は必須。指定しない場合はすべての取引ペアを取得) | |
| from | いいえ | string | BL786401542840282676 | 照会開始注文ID(order_id) |
| direct | いいえ | string | prev | 照会方向(デフォルトは prev)。prev:過去方向(ID降順)、next:未来方向(ID昇順)。(例:1, 2, 3, 4, 5 のリストで from=4 の場合、prev は 3, 2, 1、next は 5 を取得) |
| limit | いいえ | int | 20 | 1ページあたりの取得件数。デフォルト20、最大100。 |
| is_full | いいえ | int | 1 | マージンモード:1=分離マージン(逐倉), 2=全資産マージン(全倉) |
レスポンスパラメータ
| パラメータ名 | 必須 | 型 | 例 | 説明 |
|---|---|---|---|---|
| errno | はい | int | 0 | ステータスコード |
| errmsg | はい | string | success | ステータスメッセージ |
| result | はい | object | 例を参照 | レスポンス結果 |
resultパラメータの説明
| パラメータ名 | 必須 | 型 | 例 | 説明 |
|---|---|---|---|---|
| order_id | はい | string | BG5000181583375122413SZXEIX | 注文番号 |
| ctime | はい | int | 1576746253 | 注文日時 |
| 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"
}
]
}