Query Open Orders

Endpoint: /v1/futures/orders/open

Request Parameters

Required

Method: GET

Example

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"

Query Parameters

Parameter	Required	Type	Example	Description
symbol	No	string	ETH-USDT	Trading pair. Required when querying a specific symbol; omit to query all symbols
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 sequence: 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	object	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
price_avg	Yes	string	0	Average execution price
lever_rate	Yes	int	10	Leverage multiplier
amount	Yes	string	10	Order quantity
deal_amount	Yes	string	0	Executed quantity
type	Yes	string	buy-limit	Order type
status	Yes	int	1	Order status (1=Pending, 2=Partially Filled, 3=Filled, 4=Canceling, 5=Partially Canceled, 6=Canceled)
contract_type	Yes	string	open	Position action: open to open a position, close to close a position
trigger_price	Yes	string	1	Trigger price
stop_profit_price	Yes	string	15	Take-profit price
stop_loss_price	Yes	string	10	Stop-loss price

Response Example

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"
        }
    ]
}