GET /target-volume/bot/:id
One Target Volume order. Poll it to follow payment, start and progress.
Path params
| Param | Required | Description |
|---|---|---|
id | yes | Order _id. |
Response 200
{
"order": {
"_id": "6730…",
"nBotCount": 12,
"sGroupId": "…",
"eStatus": "2",
"sStatus": "ACTIVE",
"sTokenAddress": "…",
"sTokenName": "MyToken",
"sTokenSymbol": "MTK",
"sPoolId": "…",
"ePoolChosen": "PUMPSWAP",
"eSpeed": "24H",
"nDurationHours": 24,
"nMakers": 348,
"nSOL": 4.2,
"nVolumeSol": 131.7,
"nTargetUsd": 100000,
"nTargetSol": 520.8,
"dPaidAt": "2026-11-12T10:04:00.000Z",
"dStartTime": "2026-11-12T10:06:00.000Z",
"dEndTime": null,
"dCreatedAt": "2026-11-12T10:00:00.000Z",
"dUpdatedAt": "2026-11-12T13:10:00.000Z"
}
}
| Field | Description |
|---|---|
nBotCount | The user's order number. |
sGroupId | Shared by orders created in one initialize call. They are paid and cancelled together. |
eStatus | 1 waiting for payment or starting, 2 running, 3 ended, 4 cancelled or expired. |
sStatus | Detailed status — see Order status. |
nSOL | Order price in SOL. |
nVolumeSol | Volume traded so far, in SOL. |
nTargetUsd, nTargetSol | The target, in USD and in SOL at the price used for the quote. Left out once the order has ended. |
nMakers | Unique wallets that have traded so far. |
dPaidAt, dStartTime, dEndTime | Set as the order is paid, starts and ends. |
paymentAddress, dExpiresAt | Only while WAITING_PAYMENT. |
nSolLeft | Only while WAITING_PAYMENT: SOL still to send for the whole group. Left out when the balance could not be read. |
Errors
| Status | Meaning |
|---|---|
400 | Invalid order id. |
404 | Order not found or not owned. |
Example
curl "$BASE_URL/target-volume/bot/6730…" \
-H "Authorization: Bearer $ACCESS" \
-H "x-user-id: $USER_ID"