Skip to main content

GET /target-volume/bot/:id

One Target Volume order. Poll it to follow payment, start and progress.

Path params​

ParamRequiredDescription
idyesOrder _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"
}
}
FieldDescription
nBotCountThe user's order number.
sGroupIdShared by orders created in one initialize call. They are paid and cancelled together.
eStatus1 waiting for payment or starting, 2 running, 3 ended, 4 cancelled or expired.
sStatusDetailed status — see Order status.
nSOLOrder price in SOL.
nVolumeSolVolume traded so far, in SOL.
nTargetUsd, nTargetSolThe target, in USD and in SOL at the price used for the quote. Left out once the order has ended.
nMakersUnique wallets that have traded so far.
dPaidAt, dStartTime, dEndTimeSet as the order is paid, starts and ends.
paymentAddress, dExpiresAtOnly while WAITING_PAYMENT.
nSolLeftOnly while WAITING_PAYMENT: SOL still to send for the whole group. Left out when the balance could not be read.

Errors​

StatusMeaning
400Invalid order id.
404Order not found or not owned.

Example​

curl "$BASE_URL/target-volume/bot/6730…" \
-H "Authorization: Bearer $ACCESS" \
-H "x-user-id: $USER_ID"