POST /split/orders
Confirm a quote as an order. The split you saw in the quote is the split that gets executed. One order per quote.
Accepts an optional Idempotency-Key header.
Use case
Commit to a quoted split, paid either from one of your wallets
(INTERNAL) or by sending SOL to a deposit address (EXTERNAL).
Headers
| Header | Required | Description |
|---|---|---|
Idempotency-Key | no | 8–128 chars of A-Za-z0-9_-. A retry with the same key within 24 h returns the first response (with Idempotent-Replayed: true) instead of a second order. |
Body
| Field | Type | Required | Description |
|---|---|---|---|
quoteId | string | yes | Quote UUID from quote. |
eSource | string | yes | INTERNAL or EXTERNAL. |
sPayingWallet | string | when INTERNAL | Public key of your wallet that pays. It must hold at least nAmount SOL. |
Response 201
{
"orderId": "665f1c2e9b1d4a0012345678",
"eStatus": "PENDING_DEPOSIT",
"eSource": "EXTERNAL",
"nAmount": 2,
"sPayingWallet": null,
"sDepositAddress": "<deposit address>",
"aDistributions": [
{ "sWalletAddress": "<wallet 1>", "nPctBips": 4800, "nSOL": 0.9504 }
],
"sSplitnowOrderId": null,
"sSplitnowStatus": null,
"sForwardTxSignature": null,
"sError": null,
"dCreatedAt": "2026-10-30T12:00:00.000Z",
"dUpdatedAt": "2026-10-30T12:00:00.000Z",
"nRequiredSOL": 2
}
nRequiredSOL is present for EXTERNAL orders only: send that amount to
sDepositAddress, then call check-payment.
Errors
| Status | Meaning |
|---|---|
400 | Validation failed; or sPayingWallet holds less than nAmount (body adds nBalanceSOL); or malformed Idempotency-Key. |
403 | sPayingWallet is a Smart Sell–only wallet. |
404 | sPayingWallet not found / not yours. |
409 | The quote has already been used, or the Idempotency-Key request is still running. |
410 | Quote expired or unknown; request a new one. |
503 | Quote or idempotency storage unavailable, retry later. |
Example
curl -X POST "$BASE_URL/split/orders" \
-H "Authorization: Bearer $ACCESS" \
-H "x-user-id: $USER_ID" \
-H "Idempotency-Key: split-order-0001" \
-H "Content-Type: application/json" \
-d '{ "quoteId": "<quoteId>", "eSource": "INTERNAL", "sPayingWallet": "<wallet public key>" }'