Additional Endpoints

Endpoints for tracking burns, managing featured placement, and creating liquidity pools.

---

Burn Statistics

GET /burns/:mintAddress

Get burn statistics and history for a token.

Endpoint

GET https://api.vision.meme/burns/:mintAddress

Authentication

Public - No authentication required

Path Parameters

Parameter	Type	Description
mintAddress	string	Token mint address

Response (200 OK)

json

{
  "totalBurned": "50000000000",
  "burns": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "amount": "10000000000",
      "signature": "5VhQ7FqjkqQJ...",
      "timestamp": "2024-01-01T12:00:00Z"
    },
    {
      "id": "660e8400-e29b-41d4-a716-446655440001",
      "amount": "15000000000",
      "signature": "6WhR8GrkrqRK...",
      "timestamp": "2024-01-01T13:00:00Z"
    }
  ]
}

Response Fields

Field	Type	Description
totalBurned	string	Total tokens burned (base units)
burns	array	List of individual burn events
burns[].id	string	Burn event UUID
burns[].amount	string	Tokens burned in this event
burns[].signature	string	Solana transaction signature
burns[].timestamp	string	When burn occurred

Code Example

javascript

async function getBurnStats(mintAddress) {
  const response = await fetch(
    `https://api.vision.meme/burns/${mintAddress}`
  );
  
  const { totalBurned, burns } = await response.json();
  
  // Convert to human-readable (assuming 6 decimals)
  const totalBurnedHuman = parseInt(totalBurned) / Math.pow(10, 6);
  
  console.log(`Total Burned: ${totalBurnedHuman.toLocaleString()} tokens`);
  console.log(`Burn Events: ${burns.length}`);
  
  burns.forEach(burn => {
    const amount = parseInt(burn.amount) / Math.pow(10, 6);
    console.log(`- ${amount.toLocaleString()} tokens on ${burn.timestamp}`);
    console.log(`  Tx: https://solscan.io/tx/${burn.signature}`);
  });
  
  return { totalBurned, burns };
}

// Usage
await getBurnStats('TokenMint1111111111111111111111111111111');

Calculate Burn Percentage

javascript

async function getBurnPercentage(mintAddress, totalSupply, decimals = 6) {
  const { totalBurned } = await fetch(
    `https://api.vision.meme/burns/${mintAddress}`
  ).then(r => r.json());
  
  const burnedAmount = parseInt(totalBurned) / Math.pow(10, decimals);
  const supplyAmount = parseInt(totalSupply) / Math.pow(10, decimals);
  const burnPercentage = (burnedAmount / supplyAmount) * 100;
  
  console.log(`Supply: ${supplyAmount.toLocaleString()}`);
  console.log(`Burned: ${burnedAmount.toLocaleString()}`);
  console.log(`Burn Rate: ${burnPercentage.toFixed(2)}%`);
  
  return burnPercentage;
}

---

Featured Tokens

GET /featured

Get list of currently featured tokens.

Endpoint

GET https://api.vision.meme/featured

Authentication

Public - No authentication required

Response (200 OK)

json

{
  "featured": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "tokenMint": "TokenMint1111111111111111111111111111111",
      "token": {
        "name": "Featured Meme",
        "symbol": "FMEME",
        "imageUri": "https://ipfs.io/ipfs/QmAbc...",
        "description": "A featured meme token"
      },
      "startsAt": "2024-01-01T12:00:00Z",
      "endsAt": "2024-01-15T12:00:00Z",
      "daysRemaining": 5
    }
  ]
}

Code Example

javascript

async function getFeaturedTokens() {
  const response = await fetch('https://api.vision.meme/featured');
  const { featured } = await response.json();
  
  console.log(`${featured.length} Featured Tokens:`);
  
  featured.forEach(item => {
    console.log(`\n${item.token.name} (${item.token.symbol})`);
    console.log(`Days remaining: ${item.daysRemaining}`);
    console.log(`Ends: ${item.endsAt}`);
  });
  
  return featured;
}

---

POST /featured/create-unsigned

Create unsigned transaction to purchase featured placement.

Endpoint

POST https://api.vision.meme/featured/create-unsigned

Authentication

Required - Must be token creator

Request Body

Field	Type	Required	Description
tokenMint	string	✅	Token mint address
durationDays	number	✅	Duration in days (1-30)

Pricing

0.3 SOL per day

Request Example

json

{
  "tokenMint": "TokenMint1111111111111111111111111111111",
  "durationDays": 7
}

Response (200 OK)

json

{
  "transaction": "AQAAAAAAAAAAAAAA...",
  "promotionId": "550e8400-e29b-41d4-a716-446655440000",
  "amount": "2100000000",
  "durationDays": 7,
  "expiresAt": "2024-01-01T12:05:00Z"
}

Response Fields

Field	Type	Description
transaction	string	Base64-encoded unsigned transaction
promotionId	string	Promotion UUID
amount	string	Cost in lamports (SOL)
durationDays	number	Duration purchased
expiresAt	string	Transaction expiration

Code Example

javascript

async function purchaseFeatured(tokenMint, days, authToken, wallet) {
  // Create unsigned transaction
  const response = await fetch('https://api.vision.meme/featured/create-unsigned', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${authToken}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      tokenMint,
      durationDays: days
    })
  });
  
  const { transaction, promotionId, amount } = await response.json();
  
  // Calculate cost in SOL
  const costSOL = parseInt(amount) / 1e9;
  console.log(`Cost: ${costSOL} SOL for ${days} days`);
  
  // Sign and send transaction
  const txBuffer = Buffer.from(transaction, 'base64');
  const tx = Transaction.from(txBuffer);
  const signedTx = await wallet.signTransaction(tx);
  
  // Send to Solana
  const signature = await connection.sendRawTransaction(
    signedTx.serialize()
  );
  
  await connection.confirmTransaction(signature);
  
  console.log('Featured placement activated!');
  console.log('Promotion ID:', promotionId);
  console.log('Transaction:', signature);
  
  return { promotionId, signature };
}

// Usage: Feature token for 7 days
await purchaseFeatured(mintAddress, 7, token, wallet);

Price Calculator

javascript

function calculateFeaturedCost(days) {
  const pricePerDay = 0.3; // SOL
  const totalCost = pricePerDay * days;
  const totalLamports = totalCost * 1e9;
  
  console.log(`Featured Placement Cost:`);
  console.log(`${days} days × ${pricePerDay} SOL = ${totalCost} SOL`);
  
  return {
    days,
    costSOL: totalCost,
    costLamports: totalLamports.toString()
  };
}

// Examples
calculateFeaturedCost(1);  // 0.3 SOL
calculateFeaturedCost(7);  // 2.1 SOL
calculateFeaturedCost(14); // 4.2 SOL
calculateFeaturedCost(30); // 9.0 SOL

---

DEX Integration

POST /dex/raydium/cpmm/create-unsigned

Create unsigned transaction for Raydium CPMM pool.

Endpoint

POST https://api.vision.meme/dex/raydium/cpmm/create-unsigned

Authentication

Required - Include JWT token

Request Body

Field	Type	Required	Description
tokenMint	string	✅	Token mint address
tokenAmount	string	✅	Token amount in base units
solAmount	string	✅	SOL amount in lamports

Request Example

json

{
  "tokenMint": "TokenMint1111111111111111111111111111111",
  "tokenAmount": "700000000000",
  "solAmount": "20000000000"
}

Response (200 OK)

json

{
  "transaction": "AQAAAAAAAAAAAAAA...",
  "poolId": "pool_identifier",
  "poolKeys": {
    "id": "PoolAddress...",
    "baseMint": "TokenMint1111111111111111111111111111111",
    "quoteMint": "So11111111111111111111111111111111111111112",
    "lpMint": "LpMintAddress...",
    "baseVault": "BaseVaultAddress...",
    "quoteVault": "QuoteVaultAddress...",
    "baseDecimals": 6,
    "quoteDecimals": 9,
    "openTime": 0
  },
  "initialPrice": "0.0000000286",
  "estimatedMarketCap": "28600"
}

Code Example

javascript

async function createRaydiumPool(tokenMint, tokenAmount, solAmount, authToken, wallet) {
  // Create unsigned transaction
  const response = await fetch('https://api.vision.meme/dex/raydium/cpmm/create-unsigned', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${authToken}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      tokenMint,
      tokenAmount,
      solAmount
    })
  });
  
  const { transaction, poolKeys, initialPrice } = await response.json();
  
  console.log('Pool Details:');
  console.log('Pool Address:', poolKeys.id);
  console.log('Initial Price:', initialPrice, 'SOL per token');
  
  // Sign and send transaction
  const txBuffer = Buffer.from(transaction, 'base64');
  const tx = Transaction.from(txBuffer);
  const signedTx = await wallet.signTransaction(tx);
  
  const signature = await connection.sendRawTransaction(
    signedTx.serialize()
  );
  
  await connection.confirmTransaction(signature);
  
  console.log('Pool created!');
  console.log('Transaction:', signature);
  console.log('View on Raydium:', `https://raydium.io/swap/?inputMint=${tokenMint}`);
  
  return { poolId: poolKeys.id, signature };
}

// Usage: Create pool with 700M tokens and 20 SOL
await createRaydiumPool(
  mintAddress,
  '700000000000',  // 700M tokens (6 decimals)
  '20000000000',   // 20 SOL (9 decimals)
  token,
  wallet
);

Calculate Initial Price

javascript

function calculatePoolPrice(tokenAmount, solAmount, tokenDecimals = 6, solDecimals = 9) {
  const tokens = parseInt(tokenAmount) / Math.pow(10, tokenDecimals);
  const sol = parseInt(solAmount) / Math.pow(10, solDecimals);
  
  const pricePerToken = sol / tokens;
  const marketCap = pricePerToken * (tokens * 10); // Assuming 10x for full supply
  
  console.log('Pool Calculation:');
  console.log(`Tokens: ${tokens.toLocaleString()}`);
  console.log(`SOL: ${sol}`);
  console.log(`Initial Price: ${pricePerToken} SOL per token`);
  console.log(`Est. Market Cap: $${(marketCap * 100).toLocaleString()}`); // Assuming SOL = $100
  
  return {
    tokens,
    sol,
    pricePerToken,
    estimatedMarketCap: marketCap * 100
  };
}

// Example
calculatePoolPrice('700000000000', '20000000000');

---

Complete Liquidity Addition Flow

javascript

async function addLiquidityToToken(tokenMint, tokenAmount, solAmount, authToken, wallet) {
  try {
    console.log('Starting liquidity addition...');
    
    // Step 1: Create unsigned pool transaction
    const response = await fetch('https://api.vision.meme/dex/raydium/cpmm/create-unsigned', {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${authToken}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        tokenMint,
        tokenAmount,
        solAmount
      })
    });
    
    if (!response.ok) {
      const error = await response.json();
      throw new Error(error.error);
    }
    
    const { transaction, poolKeys, initialPrice, estimatedMarketCap } = await response.json();
    
    console.log('Pool Details:');
    console.log('- Pool Address:', poolKeys.id);
    console.log('- Initial Price:', initialPrice);
    console.log('- Est. Market Cap: $' + estimatedMarketCap);
    
    // Step 2: Sign transaction
    const txBuffer = Buffer.from(transaction, 'base64');
    const tx = Transaction.from(txBuffer);
    const signedTx = await wallet.signTransaction(tx);
    
    // Step 3: Send to Solana
    console.log('Sending transaction...');
    const signature = await connection.sendRawTransaction(
      signedTx.serialize(),
      { skipPreflight: false }
    );
    
    // Step 4: Wait for confirmation
    console.log('Waiting for confirmation...');
    await connection.confirmTransaction(signature, 'confirmed');
    
    console.log('✅ Liquidity pool created successfully!');
    console.log('Pool ID:', poolKeys.id);
    console.log('LP Mint:', poolKeys.lpMint);
    console.log('Transaction:', signature);
    console.log('View on Solscan:', `https://solscan.io/tx/${signature}`);
    console.log('Trade on Raydium:', `https://raydium.io/swap/?inputMint=${tokenMint}`);
    
    // Step 5: Recommend burning LP tokens
    console.log('\n⚠️ IMPORTANT: Burn your LP tokens to lock liquidity permanently!');
    console.log('LP Token Address:', poolKeys.lpMint);
    console.log('Send to burn address: 1nc1nerator11111111111111111111111111111111');
    
    return {
      poolId: poolKeys.id,
      lpMint: poolKeys.lpMint,
      signature
    };
    
  } catch (error) {
    console.error('Failed to add liquidity:', error);
    throw error;
  }
}

---

Rate Limits

Endpoint	Limit
GET /burns/:mintAddress	100 per 15 min
GET /featured	100 per 15 min
POST /featured/create-unsigned	5 per hour
POST /dex/raydium/cpmm/create-unsigned	10 per hour

---

Next Steps

• Token Endpoints - Create tokens

• Distribution Settings - Manage distributions

• LaunchLab - Bonding curves

---

© 2025 Vision.meme. All rights reserved.