注文履歴の照会

エンドポイント: /v1/spot/orders/history

リクエスト認証

必要

リクエストメソッド: GET

例

Bash

curl -X GET "https://oapi.websea.com/v1/spot/orders/history?symbol=BTC-USDT&limit=20" \
  -H "Token: YOUR_TOKEN" \
  -H "Nonce: 1700000000_abcd1" \
  -H "Signature: GENERATED_SIGNATURE"

リクエストパラメータ

パラメータ名	必須	型	例	説明
symbol	いいえ	string		取引ペア（特定の取引ペアのみ取得する場合は必須。指定しない場合はすべての取引ペアを取得）
from	いいえ	int	122	照会開始注文番号（order_sn）
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。

レスポンスパラメータ

パラメータ名	必須	型	例	説明
errno	はい	int	0	ステータスコード
errmsg	はい	string	success	ステータスメッセージ
result	はい	list	例を参照	リスト

result パラメータの説明

パラメータ名	必須	型	例	説明
order_id	はい	integer		注文ID
order_sn	はい	string		注文番号
symbol	はい	string		取引ペア
ctime	はい	string		注文日時
type	はい	int	1	注文タイプ：1=成行、2=指値
side	はい	string	buy	売買方向：buy（買い）、sell（売り）
price	はい	String		価格：成行注文（type=1）の場合は 0
number	はい	String	3.12	注文数量：成行買い（type=1, side=buy）の場合は 0
total_price	はい	String		注文総額：成行売り（type=1, side=sell）の場合は 0
deal_number	はい	String		約定済み数量
deal_price	はい	String		約定平均価格
status	はい	int	1	ステータス：1=未約定、2=一部約定、3=約定済み、4=キャンセル処理中、5=一部キャンセル、6=キャンセル済み

レスポンス例

JSON

{
    "errno":0,
    "errmsg":"success",
    "result":[
        {
            "order_id":121,
            "order_sn":"BL123456789987523",
            "symbol":"MCO-BTC",
            "ctime":"2018-10-02 10:33:33",
            "type":"2",
            "side":"buy",
            "price":"0.123456",
            "number":"1.0000",
            "total_price":"0.123456",
            "deal_number":"0.00000",
            "deal_price":"0.00000",
            "status":1
        },
        {
            "order_id":122,
            "order_sn":"SL123456789987523",
            "symbol":"MCO-BTC",
            "ctime":"2018-10-02 10:33:33",
            "type":"2",
            "side":"sell",
            "price":"0.123456",
            "number":"1.0000",
            "total_price":"0.123456",
            "deal_number":"0.00000",
            "deal_price":"0.00000",
            "status":1
        },
        {
            "order_id":123,
            "order_sn":"BM123456789987523",
            "symbol":"MCO-BTC",
            "ctime":"2018-10-02 10:33:33",
            "type":"1",
            "side":"buy",
            "price":"0",
            "number":"0",
            "total_price":"1",
            "deal_number":"0.00000",
            "deal_price":"0.00000",
            "status":1
        },
        {
            "order_id":124,
            "order_sn":"SM123456789987523",
            "symbol":"MCO-BTC",
            "ctime":"2018-10-02 10:33:33",
            "type":"1",
            "side":"sell",
            "price":"0",
            "number":"1.0000",
            "total_price":"0",
            "deal_number":"0.00000",
            "deal_price":"0.00000",
            "status":1
        }
    ]
}