Skip to main content

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​

HeaderRequiredDescription
Idempotency-Keyno8–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​

FieldTypeRequiredDescription
quoteIdstringyesQuote UUID from quote.
eSourcestringyesINTERNAL or EXTERNAL.
sPayingWalletstringwhen INTERNALPublic 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​

StatusMeaning
400Validation failed; or sPayingWallet holds less than nAmount (body adds nBalanceSOL); or malformed Idempotency-Key.
403sPayingWallet is a Smart Sell–only wallet.
404sPayingWallet not found / not yours.
409The quote has already been used, or the Idempotency-Key request is still running.
410Quote expired or unknown; request a new one.
503Quote 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>" }'