Skip to main content

POST /split/quote

Preview a random split of nAmount SOL across your wallets, with estimated received amounts.

The quote is stored for 10 minutes and nothing is charged.

Use case​

Show the user the split before they commit to it.

Body​

FieldTypeRequiredDescription
aWalletsstring[]yes1–100 distinct public keys of your own wallets.
nAmountnumberyesTotal SOL to split, greater than 0. At least 0.05 × wallets + 0.01 SOL (e.g. 0.06 for one wallet).

Response 200​

{
"quoteId": "3f0c6d52-6f0e-4c1a-9a43-2f8f4f9c1a11",
"nAmount": 2,
"nNetAmount": 1.98,
"nPlatformFeePct": 1,
"aDistributions": [
{ "sWalletAddress": "<wallet 1>", "nPctBips": 4800, "nSOL": 0.9504, "nEstReceiveSOL": 0.94 },
{ "sWalletAddress": "<wallet 2>", "nPctBips": 5200, "nSOL": 1.0296, "nEstReceiveSOL": 1.02 }
],
"bHasRates": true,
"nEstTotalReceiveSOL": 1.96,
"nEstCostPct": 2.0,
"dExpiresAt": "2026-10-30T12:10:00.000Z"
}
FieldDescription
quoteIdUUID to pass to reroll and create-order.
nNetAmountnAmount minus the platform fee. This is what gets split.
aDistributions[]Per wallet: nPctBips (basis points, sums to 10000), nSOL and nEstReceiveSOL (null when no rate is available).
bHasRatesfalse when the rate estimate was unavailable; the estimate fields are then null.
nEstTotalReceiveSOL, nEstCostPctEstimated total received and estimated cost.

Errors​

StatusMeaning
400Validation failed, or nAmount below the minimum (body adds nMinAmount).
404Some aWallets not found or not yours.
503Quote storage unavailable, retry later.

Example​

curl -X POST "$BASE_URL/split/quote" \
-H "Authorization: Bearer $ACCESS" \
-H "x-user-id: $USER_ID" \
-H "Content-Type: application/json" \
-d '{ "aWallets": ["<wallet 1>", "<wallet 2>"], "nAmount": 2 }'