注文履歴リストの照会

エンドポイント: /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		取引ペア（特定の取引ペアのみ取得する場合は必須。指定しない場合はすべての取引ペアを取得）
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	11535	注文番号
ctime	はい	int	1576746253	注文日時
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"
        }
    ]
}