curl --request POST \
  --url https://router.raze.bot/perp/sol/collateral \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "wallet_addresses": [
    "62ThHC1rs2GUfa8J4Qjcj5GD2MSL2d65pcJtenNieDnm"
  ],
  "market_id": "jup:SOL-PERP",
  "side": "long",
  "action": "add",
  "amount_usd_e6": 50000000,
  "slippage_bps": 50,
  "client_order_id": "ui-collat-20260728-a1"
}
'

{
  "success": true,
  "data": [
    {
      "wallet": "<string>",
      "tx_b64": "<string>",
      "status": "<string>",
      "position_request": "<string>",
      "counter": 123,
      "position": "<string>"
    }
  ],
  "error": "<string>"
}

{
  "success": false,
  "error": "<string>",
  "details": "<string>"
}

{
  "success": false,
  "error": "<string>",
  "details": "<string>"
}

{
  "success": false,
  "error": "<string>",
  "details": "<string>"
}

Perpetuals

Edit position collateral

Add or withdraw margin on an existing Jupiter Perps position without changing its size — the venue’s “Edit Collateral” operation.

action: "add" deposits in the side’s native collateral mint at the live oracle price; action: "withdraw" pays out in USDC like a close. The position PDA is derived server-side per wallet and is never client-supplied.

Idempotent on client_order_id for 60s, like every other /perp/sol/* write. When the fleet’s shared idempotency cache is configured, a request already served by another edge answers 409 instead of rebuilding.

POST

perp

sol

collateral

curl --request POST \
  --url https://router.raze.bot/perp/sol/collateral \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "wallet_addresses": [
    "62ThHC1rs2GUfa8J4Qjcj5GD2MSL2d65pcJtenNieDnm"
  ],
  "market_id": "jup:SOL-PERP",
  "side": "long",
  "action": "add",
  "amount_usd_e6": 50000000,
  "slippage_bps": 50,
  "client_order_id": "ui-collat-20260728-a1"
}
'

{
  "success": true,
  "data": [
    {
      "wallet": "<string>",
      "tx_b64": "<string>",
      "status": "<string>",
      "position_request": "<string>",
      "counter": 123,
      "position": "<string>"
    }
  ],
  "error": "<string>"
}

{
  "success": false,
  "error": "<string>",
  "details": "<string>"
}

{
  "success": false,
  "error": "<string>",
  "details": "<string>"
}

{
  "success": false,
  "error": "<string>",
  "details": "<string>"
}

Authorizations

X-API-Key

string

header

required

Body

application/json

wallet_addresses

string[]

required

Minimum array length: 1

market_id

string

required

Example:

"jup:SOL-PERP"

side

enum<string>

required

Side of the open position — picks the collateral custody account.

Available options:

long,

short

action

enum<string>

required

add deposits margin in the side's native collateral mint at the live oracle price; withdraw pays out in USDC like a close.

Available options:

add,

withdraw

amount_usd_e6

integer<int64>

required

USD value to move, in USDC micros. Must be > 0.

slippage_bps

integer

required

Must be < 10000.

client_order_id

string

required

Caller-supplied idempotency key (60s window), same contract as /perp/sol/order.

Response

Transactions built

success

boolean

data

object[]

Show child attributes

error

string

Cancel a pending perp trigger order

Read a live Phoenix position

Quote

Swap

Perpetuals

Edit position collateral

Authorizations

Body

Response