Managing Tokens

After launching tokens, you can query them via the API to check their status, claim information, and deployment details.

List all your tokens

Retrieve every token launched by your agent:

const response = await fetch("https://api-blowfish.neuko.ai/api/v1/tokens/", {
  headers: { Authorization: `Bearer ${token}` },
});

const { tokens } = await response.json();

The response includes all tokens regardless of claim status. See Token Object for the full schema.

Example response

{
  "tokens": [
    {
      "poolAddress": "PoolAddr123...",
      "tokenMint": "MintAddr456...",
      "ticker": "MCT",
      "tokenName": "My Cool Token",
      "isClaimed": false,
      "claimedAt": null,
      "claimedToAddress": null,
      "deployedAt": "2024-01-15T12:00:00.000Z"
    },
    {
      "poolAddress": "PoolAddr789...",
      "tokenMint": "MintAddrABC...",
      "ticker": "AGT",
      "tokenName": "Agent Token",
      "isClaimed": true,
      "claimedAt": "2024-01-16T08:30:00.000Z",
      "claimedToAddress": "WalletAddr...",
      "deployedAt": "2024-01-14T09:00:00.000Z"
    }
  ]
}

Get a specific token

If you know the mint address, fetch a single token:

const mintAddress = "MintAddr456...";

const response = await fetch(`https://api-blowfish.neuko.ai/api/v1/tokens/${mintAddress}`, {
  headers: { Authorization: `Bearer ${token}` },
});

const tokenData = await response.json();

This returns the same shape as a single item from the list endpoint. Returns 404 if the token doesn't exist or doesn't belong to your agent.

Token fields

Field	Description
poolAddress	Meteora DBC pool address on Solana
tokenMint	SPL token mint address
ticker	Token ticker symbol
tokenName	Human-readable token name
isClaimed	Whether trading fees have been claimed
claimedAt	ISO-8601 timestamp of last claim, or null
claimedToAddress	Wallet address fees were claimed to, or null
deployedAt	ISO-8601 timestamp of deployment

Verifying on-chain

After deployment, you can verify your token on Solana block explorers:

• Solscan: https://solscan.io/token/<tokenMint>

• Solana Explorer: https://explorer.solana.com/address/<tokenMint>

For devnet tokens, append ?cluster=devnet to the explorer URL.

Scoping

All token queries are scoped to your agent. You can only see tokens that your agent launched -- not tokens from other agents or the web-based launcher.