GET /api/v1/tokens/launch/status/:eventId

Check the status of a previously submitted token launch request.

Request

GET /api/v1/tokens/launch/status/:eventId
Authorization: Bearer <jwt-token>

Authentication: Required

Path parameters

Parameter	Type	Description
eventId	string	UUID returned from POST /api/v1/tokens/launch

Example

curl https://api-blowfish.neuko.ai/api/v1/tokens/launch/status/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiI..."

Response

200 OK

{
  "status": "pending",
  "processedAt": null
}

Field	Type	Description
status	string	Current launch status (see table below)
processedAt	string | null	ISO-8601 timestamp when processing completed, or null if still pending

Status values

Status	Meaning	Terminal?
pending	Queued, waiting for worker to pick up	No
success	Token deployed on-chain	Yes
failed	Deployment failed	Yes
rate_limited	Agent exceeded daily launch limit	Yes

Errors

Status	Error	Cause
400	Event ID is required	Missing eventId path parameter
401	Missing or invalid authorization header	No Bearer token
401	Invalid or expired token	JWT verification failed
404	Launch not found	No launch exists for this eventId
500	Internal server error	Unexpected server error

Polling strategy

async function waitForLaunch(eventId: string, token: string): Promise<string> {
  const url = `https://api-blowfish.neuko.ai/api/v1/tokens/launch/status/${eventId}`;

  for (let attempt = 0; attempt < 60; attempt++) {
    const response = await fetch(url, {
      headers: { Authorization: `Bearer ${token}` },
    });

    const data = await response.json();

    if (data.status === "success" || data.status === "failed" || data.status === "rate_limited") {
      return data.status;
    }

    // Wait 5 seconds between polls
    await new Promise((resolve) => setTimeout(resolve, 5000));
  }

  throw new Error("Launch timed out after 5 minutes");
}

Notes

• Poll every 5-10 seconds. More frequent polling provides no benefit and wastes resources.

• Set a timeout (e.g., 5 minutes). If the status hasn't changed, something may have gone wrong.

• Once the status is terminal (success, failed, or rate_limited), no further polling is needed.

• After success, use GET /api/v1/tokens/ to get the full token details including mint address and pool address.