Response Wrapper
All responses follow this structure:Copy
{
success: boolean;
operation: string;
data?: any;
error?: {
code: string;
message: string;
details?: any;
};
}
Token Object
Copy
{
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
Copy
{
tokensOwned: string;
usdcInvested: string;
currentValue: string;
pnl: string;
roi: string;
percentOfSupply: string;
}
Bonding Curve State
Copy
{
virtualUsdc: string;
virtualTokens: string;
realUsdc: string;
realTokens: string;
k: string;
}
Transaction
Copy
{
txId: string;
type: "buy" | "sell" | "airdrop";
amount: string;
price: string;
fee: string;
timestamp: string;
txHash?: string;
}