Skip to main content
POST
/
positions
/
increase-with-fee
cURL
curl --request POST \
  --url https://lite-api.jup.ag/perps/v1/positions/increase-with-fee \
  --header 'Content-Type: application/json' \
  --data '{
  "asset": "SOL",
  "feeToken": "USDC",
  "feeTokenAmount": "1000000",
  "feeReceiver": "<string>",
  "inputToken": "SOL",
  "inputTokenAmount": "1000000000",
  "leverage": "11.5",
  "maxSlippageBps": "100",
  "priorityFeeMicroLamports": "<string>",
  "side": "long",
  "sizeUsdDelta": "10000000",
  "tpsl": [
    {
      "receiveToken": "BTC",
      "triggerPrice": "20000000",
      "requestType": "tp"
    }
  ],
  "walletAddress": "<string>"
}'
{
  "positionPubkey": "<string>",
  "quote": {
    "collateralUsdDelta": "1124450000",
    "collateralUsdDeltaFormatted": "1124.45",
    "leverage": "2.99",
    "integratorFeeTokenMint": "<string>",
    "integratorFeeTokenAmount": "<string>",
    "integratorFeeUsd": "<string>",
    "integratorFeeUsdFormatted": "<string>",
    "liquidationPriceUsd": "13240000",
    "liquidationPriceUsdFormatted": "13.24",
    "openFeeUsd": "100000",
    "openFeeUsdFormatted": "0.1000",
    "outstandingBorrowFeeUsd": "100000",
    "outstandingBorrowFeeUsdFormatted": "0.1000",
    "positionCollateralUsd": "100000000",
    "positionCollateralUsdFormatted": "100.00",
    "positionPriceUsd": "2990000",
    "positionPriceUsdFormatted": "2.99",
    "positionSizeUsd": "10000000",
    "positionSizeUsdFormatted": "10.00",
    "priceImpactFeeBps": "1.3301",
    "priceImpactFeeUsd": "13301",
    "priceImpactFeeUsdFormatted": "0.0133",
    "side": "long",
    "sizeUsdDelta": "1124450000",
    "sizeUsdDeltaFormatted": "1124.45"
  },
  "serializedTxBase64": "<string>",
  "tpsl": [
    {
      "hasProfit": true,
      "pnlUsd": "<string>",
      "pnlUsdFormatted": "<string>",
      "pnlPercent": "<string>",
      "pubkey": "<string>",
      "requestType": "tp"
    }
  ],
  "txMetadata": {
    "blockhash": "<string>",
    "lastValidBlockHeight": "<string>",
    "transactionFeeLamports": "5000",
    "accountRentLamports": "2039280"
  }
}

Body

application/json
​
asset
enum<string>
required

The asset or market to trade against. Required when opening a new position. 'SOL' = 'So11111111111111111111111111111111111111112', 'ETH' = '7vfCXTUXx5WJV5JADk17DUJ4ksgau7utNKj4b963voxs', 'BTC' = '3NZ9JMVBmGAqocybic2c7LQCJScmgsAZ6vQqTDzcqmJh'

Available options:
BTC,
ETH,
SOL
Example:

"SOL"

​
feeToken
enum<string>
required

The token symbol for the fee token. Currently only USDC is supported. Must be the same as input token.

Available options:
USDC
​
feeTokenAmount
string
required

The amount of fee tokens to send to feeReceiver. The value must match the token mint decimals specified in feeToken (e.g., for USDC with 6 decimals, 1000000 = 1 USDC)

Example:

"1000000"

​
feeReceiver
string
required

The token address (ATA) to receive the fee specified in feeTokenAmount. The ATA must match the token mint specified in feeToken

​
inputToken
enum<string>
required

The token symbol for the input token used to fund the position. Must be the same as fee token.

Available options:
BTC,
ETH,
SOL,
USDC
Example:

"SOL"

​
inputTokenAmount
string
required

The amount of tokens for the input token to open the position or deposit collateral. NOTE: The token amount needs to be an integer and must conform to the token mint decimals specified onchain. For example, to deposit 1 SOL, the value would be '1000000000' (9 decimals)

Example:

"1000000000"

​
maxSlippageBps
string
required

The maximum slippage in (BPS) for the custody token price when executing the decrease position trade

Example:

"100"

​
side
enum<string>
required

Required when opening a new position

Available options:
long,
short
​
leverage
string

Leverage of the increase position, up to 1 decimal place. Either provide 'leverage' or 'sizeUsdDelta' to open a trade. Min leverage is '1.1'. Max leverage for SOL is 100.0. Max leverage for BTC / ETH is 150.0

Example:

"11.5"

​
priorityFeeMicroLamports
string

Custom priority fee in microlamports for the transaction (1,000,000 microlamports = 1 lamport). If not set, the API will automatically set the optimal priority fee

​
sizeUsdDelta
string

The amount in USD to increase the position size by. Must be an integer representing the USD amount multiplied by 10^6 (1 million) to align with the 6 decimal places used for USDC/USDT tokens on-chain. For example, to increase the position size by $10 USD, set 'sizeUsdDelta' to 10000000; for $0.50 USD, set 'sizeUsdDelta' to 500000. Either provide leverage or sizeUsdDelta.

Example:

"10000000"

​
tpsl
object[] | null

TPSL requests to set

​
walletAddress
string

The wallet address / public key for the trader, Required when opening a new position.

Response

200 OK

​
positionPubkey
string | null
required

The unique identifier (i.e. a program derived address) for the position account. Use this address to find the position account onchain.

​
quote
object
required
​
serializedTxBase64
string | null
required

The serialized transaction (base64 encoded) containing the instructions and given parameters for the increase position request. The transaction can be deserialized, signed by the owner of walletAddress and submitted onchain to execute the increase position request

​
tpsl
object[]
required

TPSL requests created with the increase position

​
txMetadata
object | null
required

Contains relevant metadata for the serialized transaction. Null if no wallet address passed in.