User Trade List - Vessel Finance API

Request

Query Params

symbol

string

optional

The trading pair symbol for which trade history is requested.

Example:

WBTCUSDT

startTime

string

optional

The start time of the time range for filtering history (Unix timestamp in milliseconds).

Example:

1700779414660

endTime

string

optional

The end time of the time range for filtering history (Unix timestamp in milliseconds).

Example:

1700779414669

limit

string

optional

Specifies the maximum number of user trade history entries to retrieve (Default is 500. Maximum is 1000).

fromId

string

optional

The ID from which to start fetching records. In this API, since the order is descending (backwards), if fromId is set to 100, the system will return records starting from the ID just before 100 and continue moving backwards. The retrieval will proceed until the limit is reached.

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

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request GET 'https://testnet.trade.vessel.finance/api/v1/gateway/user/myTrades?symbol=WBTCUSDT&startTime=1700779414660&endTime=1700779414669&fromId' \
--header 'VESSEL-API-KEY;' \
--header 'VESSEL-PASSPHRASE;' \
--header 'VESSEL-SIGNATURE;' \
--header 'VESSEL-TIMESTAMP;'

Responses

🟢200OK

application/json

Body

trades

array [object {11}]

required

An array containing details for each trade.

id

string

required

Unique identifier for the trade.

symbol

string

required

Trading pair symbol for the trade.

price

string

required

Price at which the trade was executed.

side

string

required

Side of the trade, indicating whether it was a "BUY" or "SELL" order.

qty

string

required

Quantity of base token in this trade.

quoteQty

string

required

Quantity of quote token in this trade.

isBuyerMaker

boolean

required

Indicates whether the buyer is the maker of the trade.

isMaker

boolean

required

Indicates whether the trader is the maker of the trade.

feeCurrency

string

required

Currency in which the trading fee is applied.

fee

string

required

Amount of trading fee applied for the trade.

time

string

required

Timestamp when the trade occurred (Unix timestamps in milliseconds & UTC).

Example

{
  "trades": [
    {
      "id": "1728640580315091",
      "symbol": "WBTCUSDT",
      "price": "61140",
      "side": "SELL",
      "qty": "0.0003",
      "quoteQty": "18.342",
      "isBuyerMaker": true,
      "isMaker": false,
      "feeCurrency": "USDT",
      "fee": "0.036684",
      "time": "1728708856283"
    },
    {
      "id": "1728640580315089",
      "symbol": "WBTCUSDT",
      "price": "61150",
      "side": "SELL",
      "qty": "0.0006",
      "quoteQty": "36.69",
      "isBuyerMaker": true,
      "isMaker": false,
      "feeCurrency": "USDT",
      "fee": "0.07338",
      "time": "1728708856282"
    }
  ]
}