> ## Documentation Index
> Fetch the complete documentation index at: https://402.cat/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Common Schemas

> Shared data structures across the API

## Response Wrapper

All responses follow this structure:

```typescript theme={null}
{
  success: boolean;
  operation: string;
  data?: any;
  error?: {
    code: string;
    message: string;
    details?: any;
  };
}
```

## Token Object

```typescript theme={null}
{
  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

```typescript theme={null}
{
  tokensOwned: string;
  usdcInvested: string;
  currentValue: string;
  pnl: string;
  roi: string;
  percentOfSupply: string;
}
```

## Bonding Curve State

```typescript theme={null}
{
  virtualUsdc: string;
  virtualTokens: string;
  realUsdc: string;
  realTokens: string;
  k: string;
}
```

## Transaction

```typescript theme={null}
{
  txId: string;
  type: "buy" | "sell" | "airdrop";
  amount: string;
  price: string;
  fee: string;
  timestamp: string;
  txHash?: string;
}
```