Raze.bot Developers

curl --request POST \ --url https://router.raze.bot/perp/sol/close \ --header 'Content-Type: application/json' \ --header 'X-API-Key: <api-key>' \ --data ' { "wallet_addresses": [ "62ThHC1rs2GUfa8J4Qjcj5GD2MSL2d65pcJtenNieDnm" ], "market_id": "jup:SOL-PERP", "position_pubkey": "PoSLk3hQrTtUKn1ePNKczqJsZbftrxCzpEuhKdzS5sM", "side": "long", "entire_position": true, "slippage_bps": 50, "client_order_id": "ui-close-20260506-x1" } '

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

Authorizations

X-API-Key

string

header

required

Body

application/json

wallet_addresses

string[]

required

Minimum array length: 1

market_id

string

required

position_pubkey

string

required

Position PDA being closed.

side

enum<string>

required

Side of the open position. Required so the builder picks the correct collateral custody account; without it a short close is rejected on-chain.

Available options:

long,

short

slippage_bps

integer

required

client_order_id

string

required

entire_position

boolean

default:false

True = full close. When true, size_usd_delta_e6 is ignored.

size_usd_delta_e6

integer<int64>

USD notional to close in USDC micros. Required when entire_position=false on a Jupiter market.

close_pct_bps

integer | null

Phoenix only. Percent of the position to close, in basis points (10000 = full) — Phoenix closes are base-unit/percent oriented, not USD-notional like Jupiter. Omitted, entire_position maps to 10000; a PARTIAL Phoenix close without this field is rejected. Ignored on Jupiter markets, which use size_usd_delta_e6.

Response

Transactions built

success

boolean

data

object[]

Show child attributes

error

string

Quote

Swap

Perpetuals

Close (or partially close) a perp position

Authorizations

Body

Response