Skip to main content

Response Wrapper

All responses follow this structure:
{
  success: boolean;
  operation: string;
  data?: any;
  error?: {
    code: string;
    message: string;
    details?: any;
  };
}

Token Object

{
  tokenId: string;
  tokenAddress: string;
  name: string;
  symbol: string;
  creator: string;
  createdAt: string;
  status: "active" | "graduating" | "graduated";
  price: string;
  mcap: string;
  totalSupply: string;
  graduationProgress: number;
}

User Position

{
  tokensOwned: string;
  usdcInvested: string;
  currentValue: string;
  pnl: string;
  roi: string;
  percentOfSupply: string;
}

Bonding Curve State

{
  virtualUsdc: string;
  virtualTokens: string;
  realUsdc: string;
  realTokens: string;
  k: string;
}

Transaction

{
  txId: string;
  type: "buy" | "sell" | "airdrop";
  amount: string;
  price: string;
  fee: string;
  timestamp: string;
  txHash?: string;
}