Jupiter Developers

This page contains an overview of the used in the Jupiter Perpetuals Program, and specifically the account. The Position account is a struct which represents a set of parameters and states associated to trade position data for a given token.

Position account derivationThe Position account’s address is derived from the trader’s wallet address / public key, the custody account, the collateral custody account, and a few other constant seeds. This means traders will always have the same Position account address for their open positions.This also means that traders only have nine positions available at one time:

Long SOL
Long wETH
Long wBTC
Short SOL (USDC as collateral)
Short SOL (USDT as collateral)
Short wETH (USDC as collateral)
Short wETH (USDT as collateral)
Short wBTC (USDC as collateral)
Short wBTC (USDT as collateral)

This is an example Position account.

EXAMPLE TYPESCRIPT CODEThis repository contains Typescript code samples on interacting with the Jupiter Perpetuals program IDL with anchor and @solana/web3.jsYou can also find the Custody Account fields in the repository or on a blockchain explorer.

Account Details

Each Position account contains the following data:

Field	Description
`owner`	Type: `publicKey` The public key of the trader’s account.
`pool`	Type: `publicKey` The public key of the JLP pool account.
`custody`	Type: `publicKey` The public key of the position’s `custody` account.
`collateralCustody`	Type: `publicKey` The public key of the position’s collateral custody account. Like the `custody` account, a `collateralCustody` account contains information for the token that’s used as collateral for the position (SOL / wETH / wBTC for long positions, USDC / USDT for short positions). The borrow rates for the position will also be calculated based on the position’s `collateralCustody`.
`openTime`	Type: `i64` The open time of the position in UNIX timestamp format.
`updateTime`	Type: `i64` The last updated time of the position in UNIX timestamp format.
`side`	Type: `Side` The position’s side, either `long` or `short`.
`price`	Type: `u64` The entry price of the position when it was opened. The entry price is an integer in the atomic value (before decimals), a USDC (6 decimals) value of `158225872` is equivalent to $158.22.
`sizeUsd`	Type: `u64` The position size after leverage in USD in the atomic value (before decimals). A position with `sizeUsd = 0` is treated as a closed position.
`collateralUsd`	Type: `u64` The position’s collateral size after fees in USD in the atomic value (before decimals).
`realisedPnlUsd`	Type: `i64` The position’s realized PNL when closing the position partially. When a position is closed completely, the position’s `realisedPnlUsd` will be `0` as the position is considered closed (as described in `sizeUsd`).
`cumulativeInterestSnapshot`	Type: `u128` Stores the position’s interest rate snapshot when it was last updated. - The `collateralCustody` account for the respective collateral token stores a monotonically increasing counter in `collateralCustody .fundingRateState .cumulativeInterestRate`. - The difference between the `collateralCustody .fundingRateState .cumulativeInterestRate` and the position’s `cumulativeInterestSnapshot` is used to calculate the borrow fees for the position.
`lockedAmount`	Type: `u64` The amount of tokens (SOL / wETH / wBTC for long positions, USDC / USDT for short positions) locked to pay off the position’s max potential profit. It acts as a cap on the maximum potential profit of the position. This amount is locked in the collateral custody to ensure the platform has sufficient tokens to pay out profitable trades.
`bump`	Type: `u8` The bump seed used to derive the PDA for the `Position` account.

Portfolio

Send

Studio

Lock

Perps

API Reference

Position Account

Account Details

​Account Details

Account Details