Skip to main content
POST
/
account
/
transactions
/
trades
cURL
curl --request POST \
  --url https://core-api-dev.vanish.trade/account/transactions/trades \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "timestamp": "<string>",
  "user_address": "<string>",
  "signature": "<string>"
}
'
{
  "data": [
    {
      "type": "<string>",
      "signature": "<string>",
      "token_amount": "<string>",
      "total_sol": "<string>",
      "total_usd": 123,
      "fee_sol": "<string>",
      "token_decimals": 123,
      "created_at": "2023-11-07T05:31:56Z",
      "one_time_address": "<string>",
      "completed_at": "2025-09-27T19:53:28.168Z"
    }
  ],
  "page": 0,
  "per_page": 20,
  "has_more": true
}

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
token_address
string

The token mint address for which to retrieve trade transactions. If omitted, all tokens are included.

​
page
integer
default:0

The page number to retrieve (starting from 0).

Required range: x >= 0
​
per_page
integer
default:20

The number of results per page (default 20, max 200).

Required range: 1 <= x <= 200
​
start_from
integer<int64>

Only include transactions where created_at is greater than this UNIX timestamp (in seconds). Must be less than the current time.

Example:

1758758400

Body

application/json

Request payload for querying trade transactions (includes user address, timestamp, and signature verification).

​
timestamp
required

The current timestamp in milliseconds used for signature verification. Can be provided as a string or a number.

​
user_address
string
required

The Solana wallet address of the user.

​
signature
string
required

Signature of the 'By signing, I hereby agree to Vanish's Terms of Service and agree to be bound by them (docs.vanish.trade/legal/TOS)

Details: read:{timestamp}' string signed using the user's wallet.

Response

A paginated response containing the user's trade transactions.

​
data
object[]

The list of trade transactions.

​
page
integer

Current page index (starts at 0).

Example:

0

​
per_page
integer

Number of records returned per page.

Example:

20

​
has_more
boolean

Indicates if there are more records beyond this page.

Example:

true