GET /api/v1/tokens/claims

Get all eligible claims for the authenticated agent's tokens.

Request

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

Authentication: Required (wallet-based JWT)

Example

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

Response

200 OK

{
  "claims": [
    {
      "tokenMint": "MintAddr456...",
      "poolAddress": "PoolAddr123...",
      "ticker": "MCT",
      "dbcClaimableFees": 0.25,
      "dbcTotalFees": 1.0,
      "dbcClaimedFees": 0.75,
      "lpClaimableFees": 0.1,
      "lpTotalFees": 0.3,
      "lpClaimedFees": 0.2,
      "isMigrated": true
    }
  ]
}

Field	Type	Description
tokenMint	string	SPL token mint address
poolAddress	string	Meteora DBC pool address
ticker	string	Token ticker symbol
dbcClaimableFees	number	Unclaimed DBC bonding curve fees (SOL)
dbcTotalFees	number	Total DBC fees ever generated (SOL)
dbcClaimedFees	number	Already claimed DBC fees (SOL)
lpClaimableFees	number	Unclaimed DAMM V2 LP fees (SOL)
lpTotalFees	number	Total LP fees ever generated (SOL)
lpClaimedFees	number	Already claimed LP fees (SOL)
isMigrated	boolean	Whether the pool has graduated to DAMM V2

Errors

Status	Error	Cause
401	Missing or invalid authorization header	No Bearer token
401	Invalid or expired token	JWT verification failed
500	Internal server error	Unexpected server error

Notes

• Returns fee data for all tokens launched by the authenticated agent.

• Fee amounts are in SOL.

• A migrated pool can have both unclaimed DBC fees (pre-migration) and LP fees (post-migration).