Quote
curl --request POST \
--url https://ca.raze.sh/perp/sol/order \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"wallet_addresses": [
"62ThHC1rs2GUfa8J4Qjcj5GD2MSL2d65pcJtenNieDnm"
],
"market_id": "jup:SOL-PERP",
"side": "long",
"collateral_usdc_e6": 100000000,
"leverage_bps": 50000,
"slippage_bps": 50,
"client_order_id": "ui-2026-05-06-a1b2c3"
}
'{
"success": true,
"data": [
{
"wallet": "<string>",
"tx_b64": "<string>",
"status": "<string>"
}
],
"error": "<string>"
}Open a perp position
Build unsigned versioned transaction(s) that open a perp position on the
chosen venue. One transaction per wallet in wallet_addresses.
Idempotency: identical client_order_id within 60s returns the
cached response (same tx) instead of rebuilding.
Oracle freshness: the build snapshots the Pyth oracle at request
time and fails fast (503) if the feed is missing or stale — the
server never signs a perp tx against a stale price band.
Funding mint: when funding_mint differs from the venue’s native
input mint, the server attaches a Pyth-derived SwapFunding spec so
the on-chain ix performs the keeper-side Jupiter swap on increase.
Supported funding mints: USDC, USD1, wSOL, BTC, ETH.
curl --request POST \
--url https://ca.raze.sh/perp/sol/order \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"wallet_addresses": [
"62ThHC1rs2GUfa8J4Qjcj5GD2MSL2d65pcJtenNieDnm"
],
"market_id": "jup:SOL-PERP",
"side": "long",
"collateral_usdc_e6": 100000000,
"leverage_bps": 50000,
"slippage_bps": 50,
"client_order_id": "ui-2026-05-06-a1b2c3"
}
'{
"success": true,
"data": [
{
"wallet": "<string>",
"tx_b64": "<string>",
"status": "<string>"
}
],
"error": "<string>"
}Documentation Index
Fetch the complete documentation index at: https://docs.raze.bot/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
Body
1"jup:SOL-PERP"
long, short Collateral in USDC micros. Server converts to the venue's input-mint native units (lamports for SOL longs, USDC e6 for shorts) using the live oracle price.
50000
50
Caller-supplied idempotency key. Identical IDs within the 60s window return the cached response (same tx) instead of rebuilding.
Optional funding mint. Omit (or set to the venue's native input mint)
for the native-funding path. Pass a different supported mint
(USDC, USD1, wSOL, BTC, ETH) to attach a Pyth-derived SwapFunding
spec — the on-chain ix performs the keeper-side Jupiter swap on
increase. Other mints return an error.