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
| Field | Type | Required | Description |
|---|---|---|---|
aWallets | string[] | yes | 1–100 distinct public keys of your own wallets. |
nAmount | number | yes | Total 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"
}
| Field | Description |
|---|---|
quoteId | UUID to pass to reroll and create-order. |
nNetAmount | nAmount 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). |
bHasRates | false when the rate estimate was unavailable; the estimate fields are then null. |
nEstTotalReceiveSOL, nEstCostPct | Estimated total received and estimated cost. |
Errors
| Status | Meaning |
|---|---|
400 | Validation failed, or nAmount below the minimum (body adds nMinAmount). |
404 | Some aWallets not found or not yours. |
503 | Quote 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 }'