Skip to main content

POST /target-volume/initialize

Create a Target Volume order awaiting payment.

The order is priced from the chain at this moment; nothing about the pool is taken from the client. Send one target as nTargetUsd, or up to 10 targets as aTargetsUsd to buy several packages at once: each becomes its own order, and they share one sGroupId and one payment.

Body​

FieldTypeRequiredDescription
sTokenAddressstringyesToken mint.
sPoolIdstringyesPool from pools.
nTargetUsdintegerone of the two20000, 50000, 100000, 200000, 500000 or 1000000.
aTargetsUsdinteger[]one of the two1–10 targets from the same set; repeats allowed. Not together with nTargetUsd.
eSpeedenumyesFAST, 1H, 3H, 6H, 12H, 24H, 3D, 7D. Every target in the request must be able to run at it — check quote.

Response 201​

{
"order": {
"_id": "6730…",
"nBotCount": 12,
"sGroupId": "…",
"eStatus": "1",
"sStatus": "WAITING_PAYMENT",
"sTokenAddress": "…",
"sTokenName": "MyToken",
"sTokenSymbol": "MTK",
"sPoolId": "…",
"ePoolChosen": "PUMPSWAP",
"eSpeed": "24H",
"nDurationHours": 24,
"nMakers": 0,
"nSOL": 4.2,
"nVolumeSol": 0,
"nTargetUsd": 100000,
"nTargetSol": 520.8,
"paymentAddress": "…",
"dExpiresAt": "2026-11-12T10:30:00.000Z",
"nSolLeft": 4.2,
"dCreatedAt": "2026-11-12T10:00:00.000Z",
"dUpdatedAt": "2026-11-12T10:00:00.000Z"
},
"orders": [ { "_id": "6730…", "…": "…" } ],
"nTotalSol": 4.2
}
FieldDescription
orderThe first order of the group. Fields are described on GET /target-volume/bot/:id.
order.nSolLeftSOL still to send for the whole group. Already accounts for SOL the payment address holds. Left out when the balance could not be read — do not treat a missing value as 0.
ordersEvery order created, one per target.
nTotalSolSummed price of all orders.

Pay by sending nSolLeft to paymentAddress before dExpiresAt, or with POST /target-volume/pay.

Errors​

StatusMeaning
400Invalid inputs: bad public key, a target not on offer, more than 10 targets, both nTargetUsd and aTargetsUsd, unknown eSpeed.
403Target Volume is not available for this account.
404sPoolId is not a pool of this token.
409The user already has an open order: { "message": "Pay or cancel the open order first", "order": { … } }. Also returned when two requests race.
422The pool cannot take this order — too little liquidity, unsupported pool type, or eSpeed not possible for one of the targets. message says why.
503The chain or the SOL price could not be read in time; retry.

Example​

curl -X POST "$BASE_URL/target-volume/initialize" \
-H "Authorization: Bearer $ACCESS" \
-H "x-user-id: $USER_ID" \
-H "Content-Type: application/json" \
-d '{
"sTokenAddress": "…",
"sPoolId": "…",
"aTargetsUsd": [100000, 100000],
"eSpeed": "24H"
}'