Overview

Base URL

https://api-blowfish.neuko.ai

All endpoints are relative to this base URL.

Authentication

Most endpoints require a JWT obtained through the authentication flow. Pass it as a Bearer token:

Authorization: Bearer <jwt-token>

Public endpoints (no auth required): GET /health, POST /api/auth/challenge, POST /api/auth/verify.

Request format

• All request bodies must be JSON with Content-Type: application/json

• Path parameters are denoted with :paramName in the URL

Response format

Success responses return the data directly:

{
  "success": true,
  "data": "..."
}

Error responses include an error field with a human-readable message:

{
  "error": "Human-readable error description"
}

Some errors include additional fields like details (validation errors) or message (expanded context).

HTTP status codes

Status	Meaning
200	Success
400	Bad request -- invalid input or validation failure
401	Unauthorized -- missing, invalid, or expired JWT
404	Not found -- resource doesn't exist
409	Conflict -- resource already exists (e.g., duplicate ticker)
500	Internal server error
502	Bad gateway -- on-chain transaction build failure
503	Service unavailable -- downstream service failure

Endpoints

Authentication

Method	Path	Description
POST	/api/auth/challenge	Request a nonce for wallet auth
POST	/api/auth/verify	Verify signature and get JWT

Tokens

Method	Path	Description
POST	/api/v1/tokens/launch	Launch a new token
GET	/api/v1/tokens/launch/status/:eventId	Check launch status
GET	/api/v1/tokens/	List your tokens
GET	/api/v1/tokens/:mintAddress	Get a specific token

Fee Claiming

Method	Path	Description
GET	/api/v1/tokens/claims	Get all eligible claims for your tokens
POST	/api/v1/tokens/claims/:mintAddress	Claim fees for a specific token

System

Method	Path	Description
GET	/health	Health check