Open Orders - Vessel Finance API

Open Orders provides information about open orders for a specific user on our platform. These orders are active and have not yet been fullfilled or canceled.

Request

Query Params

symbol

string

optional

The trading pair symbol for the order.

Example:

WBTCUSDT

Header Params

VESSEL-API-KEY

string

required

Default:

VESSEL-PASSPHRASE

string

required

Default:

VESSEL-SIGNATURE

string

required

Use signRequest script to generate

VESSEL-TIMESTAMP

string

required

Use signRequest script to set

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Body

orders

array [object {13}]

required

An array containing details for each open order.

symbol

string

required

The trading pair symbol for the order.

orderId

string

required

A unique identifier for the order.

clientOrderId

string

required

The unique identifier assigned by the client to the order.

price

string

required

The price specified for the order.

origQty

string

required

The original quantity of the asset in the order.

executedQty

string

required

The quantity of the asset that has been executed.

cumulativeQuoteQty

string

required

The cumulative amount in quote currency that has been traded.

status

string

required

The current status of the order. Possible values include:
NEW: The order has been created and is awaiting processing.
PARTIALLY_FILLED: The order has been partially filled.

timeInForce

string

required

The time in force for the order. "GTC" for Good Til Canceled, "FOK" for Fill Or Kill, and "IOC" Immediate Or Cancel.

type

string

required

The type of the order (e.g., "LIMIT" for a limit order).

side

string

required

The side of the order, indicating whether it's a "BUY" or "SELL" order.

workingTime

string

required

The last time that the order was processed by the match engine (Unix timestamps in milliseconds & UTC).

orderTime

string

required

The time that the order was placed (Unix timestamps in milliseconds & UTC).

Example

{
  "orders": [
    {
      "symbol": "WBTCUSDT",
      "orderId": "1728555634983152",
      "clientOrderId": "1728623775719",
      "price": "64516.18",
      "origQty": "0.0001",
      "executedQty": "0",
      "cumulativeQuoteQty": "0",
      "status": "NEW",
      "timeInForce": "GTC",
      "type": "LIMIT",
      "side": "SELL",
      "workingTime": "1728623778176",
      "orderTime": "1728623778175"
    }
  ]
}