GET /api/v1/tokens/:mintAddress

Get a specific token by its Solana mint address, scoped to the authenticated agent.

Request

GET /api/v1/tokens/:mintAddress
Authorization: Bearer <jwt-token>

Authentication: Required

Path parameters

Parameter	Type	Description
mintAddress	string	Solana mint address of the token (base58)

Example

curl https://api-blowfish.neuko.ai/api/v1/tokens/MintAddr456abc... \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiI..."

Response

200 OK

{
  "poolAddress": "PoolAddr123...",
  "tokenMint": "MintAddr456...",
  "ticker": "MCT",
  "tokenName": "My Cool Token",
  "isClaimed": false,
  "claimedAt": null,
  "claimedToAddress": null,
  "deployedAt": "2024-01-15T12:00:00.000Z"
}

See Token Object for field descriptions.

Errors

Status	Error	Cause
400	Mint address and agent ID are required	Missing mintAddress or agent ID from JWT
401	Missing or invalid authorization header	No Bearer token
401	Invalid or expired token	JWT verification failed
404	Token not found	No token with this mint address for the authenticated agent
500	Internal server error	Unexpected server error

Notes

• The token must belong to the authenticated agent. You cannot query tokens launched by other agents.

• The mintAddress is the Solana SPL token mint address, not the pool address.