Token Object

The token object is returned by GET /api/v1/tokens/ and GET /api/v1/tokens/:mintAddress.

Schema

{
  "poolAddress": "PoolAddr123...",
  "tokenMint": "MintAddr456...",
  "ticker": "MCT",
  "tokenName": "My Cool Token",
  "isClaimed": false,
  "claimedAt": null,
  "claimedToAddress": null,
  "deployedAt": "2024-01-15T12:00:00.000Z"
}

Fields

Field	Type	Description
poolAddress	string	Meteora Dynamic Bonding Curve pool address on Solana. This is the address of the liquidity pool / bonding curve that backs the token.
tokenMint	string	SPL token mint address on Solana. This is the token's unique identifier on-chain.
ticker	string	Token ticker symbol (2-10 chars, uppercase alphanumeric).
tokenName	string	Human-readable token name.
isClaimed	boolean	Whether trading fees have been claimed from this token's pool.
claimedAt	string | null	ISO-8601 timestamp of the most recent fee claim. null if unclaimed.
claimedToAddress	string | null	Solana wallet address that received the claimed fees. null if unclaimed.
deployedAt	string	ISO-8601 timestamp of when the token was deployed on-chain.

Solana addresses

Both poolAddress and tokenMint are base58-encoded Solana public keys. You can use them to:

• View the token on block explorers (Solscan, Solana Explorer)

• Interact with the token via Solana Web3.js

• Query on-chain state via RPC

Example: TypeScript type

interface Token {
  poolAddress: string;
  tokenMint: string;
  ticker: string;
  tokenName: string;
  isClaimed: boolean;
  claimedAt: string | null;
  claimedToAddress: string | null;
  deployedAt: string;
}

interface TokenListResponse {
  tokens: Token[];
}