Skip to main content
POST
Get Positions

Authorizations

x-api-key
string
header
required

Body

application/json

Request payload for querying lending positions.

user_address
string
required

The Solana wallet address of the user.

timestamp
required

The current timestamp in milliseconds used for signature verification. Read-scoped: accepted within 24 hours. Can be provided as a string or a number

Pattern: ^[0-9]+$
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 lending positions.

smart_wallet_id
integer
required

Identifier of the position's one-time wallet.

Example:

4821

address
string
required

The one-time wallet's Solana address.

protocol_label
string
required

The label set when the one-time wallet was created.

Example:

"kamino-lend-v2"

status
enum<string>
required

Current status of the position. It is closed once a settle with cleanup_leftover_sol has been committed.

Available options:
open,
closed
created_at
string
required

Timestamp (ISO 8601 format) indicating when the one-time wallet was created.

balances
object[]
required

Live token balances read from chain for this one-time wallet. An empty array means the balance lookup did not return - treat it as unknown rather than a confirmed zero.

has_active_balance
boolean
required

True only when balances holds a non-SOL token with a positive balance. Leftover SOL dust alone does not count - filter on this field instead of applying your own dust threshold.

closed_at
string | null

Timestamp (ISO 8601 format) indicating when the position was closed; null while it is open.