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
| Field | Type | Required | Description |
|---|---|---|---|
sTokenAddress | string | yes | Token mint. |
sPoolId | string | yes | Pool from pools. |
nTargetUsd | integer | one of the two | 20000, 50000, 100000, 200000, 500000 or 1000000. |
aTargetsUsd | integer[] | one of the two | 1–10 targets from the same set; repeats allowed. Not together with nTargetUsd. |
eSpeed | enum | yes | FAST, 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
}
| Field | Description |
|---|---|
order | The first order of the group. Fields are described on GET /target-volume/bot/:id. |
order.nSolLeft | SOL 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. |
orders | Every order created, one per target. |
nTotalSol | Summed price of all orders. |
Pay by sending nSolLeft to paymentAddress before dExpiresAt, or
with POST /target-volume/pay.
Errors
| Status | Meaning |
|---|---|
400 | Invalid inputs: bad public key, a target not on offer, more than 10 targets, both nTargetUsd and aTargetsUsd, unknown eSpeed. |
403 | Target Volume is not available for this account. |
404 | sPoolId is not a pool of this token. |
409 | The user already has an open order: { "message": "Pay or cancel the open order first", "order": { … } }. Also returned when two requests race. |
422 | The pool cannot take this order — too little liquidity, unsupported pool type, or eSpeed not possible for one of the targets. message says why. |
503 | The 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"
}'