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

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
tx_id
string
required

The signature/tx_id of the transaction

Body

application/json

Request payload for querying a trade transaction (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 transaction.

​
type
string
required

The type of trade transaction ('buy' or 'sell').

​
signature
string
required

The transaction signature on Solana blockchain.

​
token_amount
string<int64>
required

The amount of tokens traded (in smallest units).

​
total_sol
string<int64>
required

Total amount of SOL involved in the trade (in lamports).

​
total_usd
number
required

USD equivalent of the trade based on SOL price at the time of the transaction.

​
fee_sol
string<int64>
required

Total transaction fee paid in SOL (in lamports).

​
token_decimals
integer
required

Number of decimal places used by the traded token.

​
created_at
string<date-time>
required

Timestamp when the trade was completed (ISO 8601 format).

​
one_time_address
string | null

The one-time wallet address associated with the trade, if applicable.

​
completed_at
string<date-time> | null

The timestamp when the trade was completed (if available).

Example:

"2025-09-27T19:53:28.168Z"