Query Historical Plan Orders

Endpoint: /v1/futures/plan/history

Request Parameters

Required

Method: GET

Example

Bash

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

Query Parameters

Parameter	Required	Type	Example	Description
symbol	No	string	EOS-USDT	Trading pair. If omitted, all trading pairs will be returned
from	No	int	122	Starting order_id for pagination
direct	No	string	prev	Query direction. Default: prev (backward by time/ID); next (forward by time/ID). Example: 1,2,3,4,5. With from=4, prev returns 3,2,1; next returns 5
limit	No	int	20	Number of records to return. Default: 20, Maximum: 100
is_full	No	int	1	Margin mode: 1 isolated margin, 2 cross margin

Response Parameters

Parameter	Required	Type	Example	Description
errno	Yes	int	0	Status code
errmsg	Yes	string	success	Status message
result	Yes	array	See example	Result data

Result Fields

Parameter	Required	Type	Example	Description
order_id	Yes	string	BG5000181583375122413SZXEIX	Order ID
ctime	Yes	int	1576746253	Order creation time (Unix timestamp)
symbol	Yes	string	ETH-USDT	Trading pair
price	Yes	string	1	Order price
lever_rate	Yes	int	10	Leverage multiplier
amount	Yes	string	10	Order quantity
type	Yes	string	buy-limit	Order type
trigger_sign	Yes	string	0	Trigger condition: 1 ≥ trigger price, 2 ≤ trigger price
trigger_price	Yes	string	10	Trigger price
stop_profit_price	Yes	string	15	Take-profit price
stop_loss_price	Yes	string	10	Stop-loss price
implement_status	Yes	int	3	Execution status (0=Pending, 1=Placing Order, 2=Partially Executed, 3=Fully Executed, 4=Execution Failed, 5=Canceled)
tactics_deal	Yes	string	10	Executed quantity

Response Example

JSON

{
    "errno": 0,
    "errmsg": "success",
    "result": [
        {
            "order_id": "BG5000181583375122413SZXEIX",
            "ctime": 1576746253,
            "symbol": "ETH-USDT",
            "price": "1",
            "lever_rate": 10,
            "amount": "10",
            "type": "buy-limit",
            "trigger_sign": "0",
            "trigger_price": "10",
            "stop_profit_price": "15",
            "stop_loss_price": "10",
            "implement_status": 3,
            "tactics_deal": "10"
        }
    ]
}