Distribution

Endpoints for managing automatic tax distribution settings for your tokens.

---

GET /distribution/:tokenId/settings

Get distribution settings for a token.

Endpoint

GET https://api.vision.meme/distribution/:tokenId/settings

Authentication

Required - Must be token creator

Path Parameters

Parameter	Type	Description
tokenId	string	Token UUID or mint address

Request Example

bash

GET https://api.vision.meme/distribution/550e8400-e29b-41d4-a716-446655440000/settings

Response (200 OK)

json

{
  "rewardToken": "SOL",
  "distributionModel": "proportional",
  "minimumHoldingRequirement": "1000000",
  "percentageToSellPerDistribution": 25,
  "distributionEnabled": true,
  "distributionInterval": "15m",
  "burnPercent": 10,
  "developerFeePercent": 60,
  "developerWallet": "DevWallet1111111111111111111111111111111",
  "telegramGroupId": "-1001234567890"
}

Response Fields

Field	Type	Description
rewardToken	string	Token used for rewards ("SOL" or mint address)
distributionModel	string	Always "proportional"
minimumHoldingRequirement	string	Min tokens to receive rewards
percentageToSellPerDistribution	number	% of balance to sell per interval
distributionEnabled	boolean	Is distribution active?
distributionInterval	string	How often distributions occur
burnPercent	number	% of tax to burn (0-100)
developerFeePercent	number	Creator share % (0-100)
developerWallet	string	Creator wallet address
telegramGroupId	string	Telegram group for notifications

Code Example

javascript

async function getDistributionSettings(tokenId, authToken) {
  const response = await fetch(
    `https://api.vision.meme/distribution/${tokenId}/settings`,
    {
      headers: {
        'Authorization': `Bearer ${authToken}`
      }
    }
  );
  
  if (response.status === 403) {
    console.log('Not authorized - must be token creator');
    return null;
  }
  
  const settings = await response.json();
  
  console.log('Distribution Settings:');
  console.log('- Interval:', settings.distributionInterval);
  console.log('- Enabled:', settings.distributionEnabled);
  console.log('- Creator share:', settings.developerFeePercent + '%');
  console.log('- Burn rate:', settings.burnPercent + '%');
  
  return settings;
}

// Usage
const settings = await getDistributionSettings(tokenId, token);

Errors

403 Forbidden - Not token creator

json

{
  "error": "Forbidden",
  "message": "You are not authorized to access this resource"
}

404 Not Found - Token doesn't exist

json

{
  "error": "Token not found"
}

Rate Limits

• 100 requests per 15 minutes

---

PATCH /distribution/:tokenId/settings

Update distribution settings for a token.

Endpoint

PATCH https://api.vision.meme/distribution/:tokenId/settings

Authentication

Required - Must be token creator

Path Parameters

Parameter	Type	Description
tokenId	string	Token UUID or mint address

Request Body

All fields are optional - only include fields you want to update.

Field	Type	Validation	Description
rewardToken	string	"SOL" or mint address	Token for rewards
minimumHoldingRequirement	string	Positive number	Min tokens for rewards
percentageToSellPerDistribution	number	1-100	% to sell per interval
distributionEnabled	boolean	true/false	Enable/disable distribution
telegramGroupId	string	Valid Telegram ID	Telegram notifications
distributionInterval	string	See valid intervals	How often to distribute
burnPercent	number	0-100	% of tax to burn
developerFeePercent	number	0-100	Creator share %
developerWallet	string	Valid Solana address	Creator wallet

Valid Distribution Intervals

• 5m - Every 5 minutes

• 10m - Every 10 minutes

• 15m - Every 15 minutes

• 30m - Every 30 minutes

• 1h - Every hour

• 6h - Every 6 hours

• 12h - Every 12 hours

• 24h - Every 24 hours (daily)

Request Example

json

{
  "distributionInterval": "30m",
  "percentageToSellPerDistribution": 50,
  "burnPercent": 15,
  "developerFeePercent": 70
}

Response (200 OK)

json

{
  "success": true,
  "settings": {
    "rewardToken": "SOL",
    "distributionInterval": "30m",
    "percentageToSellPerDistribution": 50,
    "burnPercent": 15,
    "developerFeePercent": 70,
    "distributionEnabled": true
  }
}

Code Examples

Update distribution interval:

javascript

async function updateDistributionInterval(tokenId, interval, authToken) {
  const response = await fetch(
    `https://api.vision.meme/distribution/${tokenId}/settings`,
    {
      method: 'PATCH',
      headers: {
        'Authorization': `Bearer ${authToken}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        distributionInterval: interval
      })
    }
  );
  
  const { settings } = await response.json();
  console.log('Updated interval to:', settings.distributionInterval);
  
  return settings;
}

// Usage
await updateDistributionInterval(tokenId, '30m', token);

Pause/resume distributions:

javascript

async function pauseDistribution(tokenId, authToken) {
  const response = await fetch(
    `https://api.vision.meme/distribution/${tokenId}/settings`,
    {
      method: 'PATCH',
      headers: {
        'Authorization': `Bearer ${authToken}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        distributionEnabled: false
      })
    }
  );
  
  const { settings } = await response.json();
  console.log('Distribution paused');
  
  return settings;
}

async function resumeDistribution(tokenId, authToken) {
  const response = await fetch(
    `https://api.vision.meme/distribution/${tokenId}/settings`,
    {
      method: 'PATCH',
      headers: {
        'Authorization': `Bearer ${authToken}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        distributionEnabled: true
      })
    }
  );
  
  const { settings } = await response.json();
  console.log('Distribution resumed');
  
  return settings;
}

Update creator wallet:

javascript

async function updateDeveloperWallet(tokenId, newWallet, authToken) {
  const response = await fetch(
    `https://api.vision.meme/distribution/${tokenId}/settings`,
    {
      method: 'PATCH',
      headers: {
        'Authorization': `Bearer ${authToken}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        developerWallet: newWallet
      })
    }
  );
  
  if (!response.ok) {
    const error = await response.json();
    throw new Error(error.error);
  }
  
  const { settings } = await response.json();
  console.log('Developer wallet updated to:', settings.developerWallet);
  
  return settings;
}

Adjust burn and creator percentages:

javascript

async function updateFeeDistribution(tokenId, burnPercent, developerPercent, authToken) {
  // Validate percentages
  if (burnPercent < 0 || burnPercent > 100) {
    throw new Error('Burn percent must be between 0 and 100');
  }
  if (developerPercent < 0 || developerPercent > 100) {
    throw new Error('Developer percent must be between 0 and 100');
  }
  
  const response = await fetch(
    `https://api.vision.meme/distribution/${tokenId}/settings`,
    {
      method: 'PATCH',
      headers: {
        'Authorization': `Bearer ${authToken}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        burnPercent,
        developerFeePercent: developerPercent
      })
    }
  );
  
  const { settings } = await response.json();
  
  const holderPercent = 100 - developerPercent;
  
  console.log('Fee distribution updated:');
  console.log(`- Burn: ${settings.burnPercent}%`);
  console.log(`- Creator: ${settings.developerFeePercent}%`);
  console.log(`- Holders: ${holderPercent}%`);
  
  return settings;
}

// Usage: 15% burn, 70% to creator, 30% to holders
await updateFeeDistribution(tokenId, 15, 70, token);

Validation Errors

Invalid interval:

json

{
  "error": "Validation error",
  "details": [
    {
      "path": ["distributionInterval"],
      "message": "Invalid interval. Must be one of: 5m, 10m, 15m, 30m, 1h, 6h, 12h, 24h"
    }
  ]
}

Invalid percentage:

json

{
  "error": "Validation error",
  "details": [
    {
      "path": ["burnPercent"],
      "message": "Number must be between 0 and 100"
    }
  ]
}

Invalid wallet address:

json

{
  "error": "Validation error",
  "details": [
    {
      "path": ["developerWallet"],
      "message": "Invalid Solana wallet address"
    }
  ]
}

Important Notes

• Only token creator can update settings

• Changes take effect at next distribution interval

• Pausing distribution doesn't stop tax collection

• Accumulated taxes will distribute when re-enabled

• Cannot change transferFeePercent if set as non-adjustable

Rate Limits

• 10 requests per hour

---

Distribution Settings Dashboard

Example component for managing distribution:

javascript

class DistributionManager {
  constructor(tokenId, authToken) {
    this.tokenId = tokenId;
    this.authToken = authToken;
  }
  
  async getSettings() {
    const response = await fetch(
      `https://api.vision.meme/distribution/${this.tokenId}/settings`,
      {
        headers: { 'Authorization': `Bearer ${this.authToken}` }
      }
    );
    return await response.json();
  }
  
  async updateSettings(updates) {
    const response = await fetch(
      `https://api.vision.meme/distribution/${this.tokenId}/settings`,
      {
        method: 'PATCH',
        headers: {
          'Authorization': `Bearer ${this.authToken}`,
          'Content-Type': 'application/json'
        },
        body: JSON.stringify(updates)
      }
    );
    
    if (!response.ok) {
      const error = await response.json();
      throw new Error(error.error);
    }
    
    return await response.json();
  }
  
  async pause() {
    return this.updateSettings({ distributionEnabled: false });
  }
  
  async resume() {
    return this.updateSettings({ distributionEnabled: true });
  }
  
  async changeInterval(interval) {
    return this.updateSettings({ distributionInterval: interval });
  }
  
  async updateFees(burnPercent, developerPercent) {
    return this.updateSettings({
      burnPercent,
      developerFeePercent: developerPercent
    });
  }
  
  async changeDeveloperWallet(newWallet) {
    return this.updateSettings({ developerWallet: newWallet });
  }
}

// Usage
const manager = new DistributionManager(tokenId, authToken);

// Get current settings
const settings = await manager.getSettings();
console.log('Current settings:', settings);

// Pause distribution
await manager.pause();

// Change interval to 30 minutes
await manager.changeInterval('30m');

// Update fee distribution: 20% burn, 60% creator, 40% holders
await manager.updateFees(20, 60);

// Resume distribution
await manager.resume();

---

Common Use Cases

Optimizing for High Volume

When your token has high trading volume:

javascript

// Increase selling percentage to distribute faster
await updateSettings(tokenId, {
  percentageToSellPerDistribution: 75,
  distributionInterval: '15m'
}, token);

Optimizing for Low Volume

When your token has low trading volume:

javascript

// Decrease selling percentage to reduce price impact
await updateSettings(tokenId, {
  percentageToSellPerDistribution: 10,
  distributionInterval: '1h'
}, token);

Temporary Pause

Temporarily stop distributions (taxes still collect):

javascript

// Pause
await updateSettings(tokenId, {
  distributionEnabled: false
}, token);

// Do something...

// Resume later
await updateSettings(tokenId, {
  distributionEnabled: true
}, token);

Increase Holder Rewards

Shift more rewards to holders:

javascript

// 40% to creator, 60% to holders
await updateSettings(tokenId, {
  developerFeePercent: 40
}, token);

---

Next Steps

• Token Endpoints - Create and manage tokens

• Burns - Track token burns

• Code Examples - More examples

---

© 2025 Vision.meme. All rights reserved.