GET /token/creation-status/:botId

Poll a token creation job. Returns everything needed to follow progress and reconcile with on-chain state.

Idempotent. Poll at ~2s intervals while status is PENDING, POOL_CREATION, or IN_PROGRESS.

Use case

Drive UI progress after /token/create: show PENDING → POOL_CREATION → IN_PROGRESS → COMPLETED, surface sTokenAddress + sPoolId on completion, show sErrorMessage on FAILED.

Path params

Param	Required	Description
botId	yes	From the /token/create response.

Response 200

{
  "botId": "66a9ff…",
  "status": "IN_PROGRESS",
  "ePoolType": "CPMM",
  "sTokenAddress": "…",
  "sTokenName": "MyToken",
  "sTokenSymbol": "MTK",
  "sPoolId": null,
  "sPoolSignature": null,
  "nPoolTokenAmount": null,
  "nPoolSolAmount": null,
  "iTokenBot": null,
  "aSnipes": [
    {
      "sWalletAddress": "…",
      "sSignature": "3k…",
      "nSnipedTokenAmount": 123456789
    }
  ],
  "sErrorMessage": null,
  "dCreatedAt": "2026-04-20T10:00:00.000Z",
  "dUpdatedAt": "2026-04-20T10:00:20.000Z"
}

Status values

status	Meaning
PENDING	Record created, job not yet picked up.
POOL_CREATION	Pool transaction in progress.
IN_PROGRESS	Orchestration running (snipes, volume setup).
COMPLETED	sPoolId populated, snipes finalized.
FAILED	Check sErrorMessage.

Errors

Status	Meaning
404	Bot not found or not owned by the caller.

Example

curl "$BASE_URL/token/creation-status/66a9ff…" \
  -H "Authorization: Bearer $ACCESS" \
  -H "x-user-id: $USER_ID"