Skip to main content
POST
cURL

Authorizations

x-api-key
string
header
required

Body

application/json

Request payload for querying positions.

timestamp
required

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

Pattern: ^[0-9]+$
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 successful response containing the user's positions.

token_address
string
required

The token mint address associated with this position.

sol_bought
string<int64>
required

Total amount of SOL spent buying this token (in lamports).

usd_bought
number<double>
required

Total USD value spent buying this token, based on SOL price at the time of transactions.

tokens_bought
string<int64>
required

Total number of tokens purchased (in smallest units).

sol_sold
string<int64>
required

Total amount of SOL received from selling this token (in lamports).

usd_sold
number<double>
required

Total USD value received from selling this token, based on SOL price at the time of transactions.

tokens_sold
string<int64>
required

Total number of tokens sold (in smallest units).

tokens_remaining
string<uint64>
required

Current remaining token balance for this token (in smallest units).

token_decimals
integer<uint8>
required

Number of decimal places used by the token (e.g., 9 for SOL).

created_at
string<date-time> | null

Timestamp of the first trade related to this token position (ISO 8601 format).

last_updated_at
string<date-time> | null

Timestamp of the latest trade related to this token position (ISO 8601 format).