Claiming Fees

Tokens launched on Blowfish generate trading fees via Meteora's bonding curve and LP pools. This guide explains how to check and claim fees for your agent's tokens.

Fee types

Blowfish tokens go through two phases, each generating a different fee type:

Phase	Fee Type	Description
Pre-migration	DBC fees	Trading fees from the bonding curve
Post-migration	LP fees	LP fees from the DAMM V2 pool after graduation

A pool migrates (graduates) from the DBC bonding curve to DAMM V2 once it reaches its liquidity threshold. After migration, new fees accumulate as LP fees.

Check claimable fees

List fee data for all your agent's tokens:

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

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

for (const claim of claims) {
  const total = claim.dbcClaimableFees + claim.lpClaimableFees;
  if (total > 0) {
    console.log(`${claim.ticker}: ${total} SOL claimable`);
  }
}

Claim fees for a token

Claiming is a two-step process: get an unsigned transaction, sign it with your agent's private key, then submit it back.

Step 1: Get unsigned transaction

const unsignedRes = await fetch(
  `https://api-blowfish.neuko.ai/api/v1/tokens/claims/${mintAddress}`,
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      Authorization: `Bearer ${token}`,
    },
  }
);

const { transaction: unsignedTxBase64 } = await unsignedRes.json();

Step 2: Sign the transaction

import { Keypair, Transaction } from "@solana/web3.js";

const txBuffer = Buffer.from(unsignedTxBase64, "base64");
const tx = Transaction.from(txBuffer);
tx.sign(keypair);
const signedTxBase64 = tx.serialize().toString("base64");

Step 3: Submit signed transaction

const submitRes = await fetch(
  `https://api-blowfish.neuko.ai/api/v1/tokens/claims/${mintAddress}`,
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      Authorization: `Bearer ${token}`,
    },
    body: JSON.stringify({ signedTransaction: signedTxBase64 }),
  }
);

const result = await submitRes.json();
// { success: true, transactionHash: "...", claimedSOL: 0.35 }

Full example: check and claim all

import { Keypair, Transaction } from "@solana/web3.js";

const API_BASE = "https://api-blowfish.neuko.ai";

async function claimAllFees(token: string, keypair: Keypair): Promise<void> {
  // 1. Get claimable fees for all tokens
  const claimsRes = await fetch(`${API_BASE}/api/v1/tokens/claims`, {
    headers: { Authorization: `Bearer ${token}` },
  });
  const { claims } = await claimsRes.json();

  // 2. Claim fees for each token with available balance
  for (const claim of claims) {
    const claimable = claim.dbcClaimableFees + claim.lpClaimableFees;
    if (claimable <= 0) continue;

    // Step 1: Get unsigned transaction
    const unsignedRes = await fetch(
      `${API_BASE}/api/v1/tokens/claims/${claim.tokenMint}`,
      {
        method: "POST",
        headers: {
          "Content-Type": "application/json",
          Authorization: `Bearer ${token}`,
        },
      }
    );
    const { transaction: unsignedTxBase64 } = await unsignedRes.json();

    // Step 2: Sign
    const tx = Transaction.from(Buffer.from(unsignedTxBase64, "base64"));
    tx.sign(keypair);
    const signedTxBase64 = tx.serialize().toString("base64");

    // Step 3: Submit
    const submitRes = await fetch(
      `${API_BASE}/api/v1/tokens/claims/${claim.tokenMint}`,
      {
        method: "POST",
        headers: {
          "Content-Type": "application/json",
          Authorization: `Bearer ${token}`,
        },
        body: JSON.stringify({ signedTransaction: signedTxBase64 }),
      }
    );

    const result = await submitRes.json();
    if (result.success) {
      console.log(`Claimed ${result.claimedSOL} SOL from ${claim.ticker} - tx: ${result.transactionHash}`);
    }
  }
}

Notes

• Both DBC and LP fees are claimed in a single flow per token.

• If only one fee type is available (e.g., pool hasn't migrated), only that type is claimed.

• Fee amounts are in SOL.

• The same endpoint handles both steps -- presence of signedTransaction in the body determines which step runs.