GET /holders/status/:holdersId

Poll order status. Response shape varies by state.

Idempotent. Poll while state is PENDING_PAYMENT or RUNNING.

Use case

Drive UI from payment detection → worker running → completion.

Path params

Param	Required	Description
holdersId	yes	From /holders/initialize.

Response 200

PENDING_PAYMENT:

{
  "holdersId": "…",
  "status": "PENDING_PAYMENT",
  "message": "Bot initialized, waiting for payment",
  "paymentAddress": "…",
  "nRequiredSol": 1.5,
  "nHoldersCount": 500,
  "sTokenAddress": "…",
  "sPoolId": "…",
  "ePoolChosen": "RAYDIUM"
}

RUNNING:

{
  "holdersId": "…",
  "status": "RUNNING",
  "message": "Bot running",
  "nHoldersCount": 500,
  "sTokenAddress": "…",
  "sPoolId": "…",
  "ePoolChosen": "RAYDIUM"
}

CANCELLED:

{ "holdersId": "…", "status": "CANCELLED", "message": "Order cancelled" }

COMPLETED:

{
  "holdersId": "…",
  "status": "COMPLETED",
  "message": "Bot completed",
  "nHoldersCount": 500,
  "sTokenAddress": "…",
  "sPoolId": "…",
  "ePoolChosen": "RAYDIUM"
}

Errors

Status	Meaning
404	Order not found or not owned.

Example

curl "$BASE_URL/holders/status/66b4…" \
  -H "Authorization: Bearer $ACCESS" \
  -H "x-user-id: $USER_ID"