Internal Transfer History - Vessel Finance API

Request

Query Params

assetName

string

optional

Name of the asset to filter transfers, such as USDT.

startTime

string

optional

Start timestamp (in milliseconds) for the query range.

endTime

string

optional

End timestamp (in milliseconds) for the query range.

fromId

string

optional

The ID from which to start fetching records. In this API, since the transfer history 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.

type

string

optional

The type of transfer, either "SEND" or "RECEIVE", to filter specific transfer actions.

limit

string

optional

The maximum number of results to return (default 500, max 1000).

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/history/transfer?assetName&startTime&endTime&fromId&type&limit' \
--header 'VESSEL-API-KEY;' \
--header 'VESSEL-PASSPHRASE;' \
--header 'VESSEL-SIGNATURE;' \
--header 'VESSEL-TIMESTAMP;'

Responses

🟢200Success

application/json

Body

transfers

array [object {6}]

required

id

string

required

Unique identifier for the transfer transaction.

type

string

required

Indicates whether the transaction is a "SEND" or "RECEIVE".

address

string

required

The other address involved in the transaction.

amount

string

required

Amount of the asset transferred.

assetName

string

required

Name of the asset involved in the transfer.

timestamp

string

required

The timestamp of the transfer in milliseconds.

Example

{
  "transfers": [
    {
      "id": "1730705720975009",
      "type": "SEND",
      "address": "0xba2b367127d42f1cc397897b12346911925e5566",
      "amount": "100.12",
      "assetName": "USDT",
      "timestamp": "1730715805879"
    },
    {
      "id": "1730369424590003",
      "type": "RECEIVE",
      "address": "0xdb456c895f91c8a098b22eb0aae1ba7d85c5ae96",
      "amount": "1000",
      "assetName": "USDT",
      "timestamp": "1730432689726"
    }
  ]
}