Tokens

Endpoints for creating, managing, and retrieving meme tokens.

---

POST /tokens/generate-distribution-wallet

Generate a distribution wallet for collecting taxes. Called at the start of token creation.

Endpoint

POST https://api.vision.meme/tokens/generate-distribution-wallet

Authentication

Public - No authentication required

Request Body

No request body required.

Response (200 OK)

json

{
  "walletId": "550e8400-e29b-41d4-a716-446655440000",
  "address": "Dist1111111111111111111111111111111111111111"
}

Response Fields

Field	Type	Description
walletId	string	UUID for this distribution wallet
address	string	Solana address of distribution wallet

Important Notes

• The walletId must be included in the create-unsigned request

• Wallet address is derived deterministically on backend

• One wallet per token creation session

• Wallet is non-custodial and transparent

Code Example

javascript

const response = await fetch('https://api.vision.meme/tokens/generate-distribution-wallet', {
  method: 'POST'
});

const { walletId, address } = await response.json();
console.log('Distribution wallet:', address);
console.log('Wallet ID:', walletId);

// Save walletId for create-unsigned request
localStorage.setItem('distributionWalletId', walletId);

---

POST /tokens/upload-image

Upload token image to IPFS. Image is automatically optimized to 512x512 JPG.

Endpoint

POST https://api.vision.meme/tokens/upload-image

Authentication

Required - Include JWT token in Authorization header

Request

Content-Type: multipart/form-data

Field	Type	Required	Description
image	File	✅	PNG or JPG image, max 1MB

Image Requirements

• Formats: PNG, JPG, JPEG

• Max size: 1MB

• Recommended: Square (1:1 aspect ratio)

• Output: Optimized 512x512 JPG on IPFS

Response (200 OK)

json

{
  "success": true,
  "imageUri": "https://ipfs.io/ipfs/QmAbc123...",
  "imageCid": "QmAbc123..."
}

Response Fields

Field	Type	Description
success	boolean	Upload success status
imageUri	string	Full IPFS URI for the image
imageCid	string	IPFS Content ID (CID)

Code Example

javascript

// HTML
<input type="file" id="imageInput" accept="image/png,image/jpeg" />

// JavaScript
const imageInput = document.getElementById('imageInput');
const file = imageInput.files[0];

// Validate file
if (file.size > 1024 * 1024) {
  throw new Error('Image must be smaller than 1MB');
}

// Upload
const formData = new FormData();
formData.append('image', file);

const response = await fetch('https://api.vision.meme/tokens/upload-image', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${token}`
  },
  body: formData
});

const { imageUri, imageCid } = await response.json();
console.log('Image uploaded to:', imageUri);

Errors

400 Bad Request - File too large

json

{
  "error": "File too large",
  "message": "Image must be smaller than 1MB"
}

400 Bad Request - Invalid file type

json

{
  "error": "Invalid file type",
  "message": "Only PNG and JPG images are supported"
}

401 Unauthorized - Missing or invalid token

json

{
  "error": "Unauthorized",
  "message": "Invalid or expired token"
}

Rate Limits

• 20 requests per hour

---

POST /tokens/create-unsigned

Create an unsigned Solana Token-2022 transaction with on-chain metadata.

Endpoint

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

Authentication

Required - Include JWT token in Authorization header

Request Body

Field	Type	Required	Description
name	string	✅	Token name (1-32 chars)
symbol	string	✅	Token symbol (1-10 chars)
description	string	✅	Token description
imageUri	string	✅	IPFS image URI from upload endpoint
walletId	string	✅	Distribution wallet ID
twitter	string	❌	Twitter profile URL
telegram	string	❌	Telegram group URL
website	string	❌	Website URL
transferFeePercent	number	✅	Transfer tax % (0-100)
burnPercent	number	✅	Burn % of tax (0-100)
developerFeePercent	number	✅	Creator share % (0-100)
developerWallet	string	✅	Creator wallet address
distributionInterval	string	✅	Distribution frequency
percentageToSellPerDistribution	number	✅	% to sell per interval (1-100)
rewardToken	string	✅	"SOL" or token mint
minimumHoldingRequirement	string	❌	Minimum tokens to receive rewards
decimals	number	✅	Token decimals (6 or 9)
supply	string	✅	Total supply (in base units)
transferFeeAdjustable	boolean	✅	Can tax be changed later?
immutableMetadata	boolean	✅	Lock metadata permanently?

Distribution Intervals

Valid values: 5m, 10m, 15m, 30m, 1h, 6h, 12h, 24h

Request Example

json

{
  "name": "Vision Meme",
  "symbol": "VISION",
  "description": "The ultimate meme token on Solana",
  "imageUri": "https://ipfs.io/ipfs/QmAbc123...",
  "walletId": "550e8400-e29b-41d4-a716-446655440000",
  
  "twitter": "https://twitter.com/visionmeme",
  "telegram": "https://t.me/visionmeme",
  "website": "https://vision.meme",
  
  "transferFeePercent": 5,
  "burnPercent": 10,
  "developerFeePercent": 60,
  "developerWallet": "DevWallet1111111111111111111111111111111",
  
  "distributionInterval": "15m",
  "percentageToSellPerDistribution": 25,
  "rewardToken": "SOL",
  "minimumHoldingRequirement": "1000000",
  
  "decimals": 6,
  "supply": "1000000000000000",
  "transferFeeAdjustable": false,
  "immutableMetadata": true
}

Response (200 OK)

json

{
  "transaction": "AQAAAAAAAAAAAAAA...",
  "transactionId": "550e8400-e29b-41d4-a716-446655440000",
  "expiresAt": "2024-01-01T12:05:00Z",
  "mintKeypair": {
    "publicKey": "TokenMint1111111111111111111111111111111",
    "secretKey": []
  }
}

Response Fields

Field	Type	Description
transaction	string	Base64-encoded unsigned transaction
transactionId	string	UUID to use when submitting
expiresAt	string	Transaction expiration time
mintKeypair.publicKey	string	Token mint address

Important Notes

• Transaction expires in 5 minutes

• Must sign and submit within expiration time

• Supply is in smallest units (e.g., 1M tokens with 6 decimals = "1000000000000")

• transferFeeAdjustable: false recommended for trust

• immutableMetadata: true prevents future changes

Code Example

javascript

// Create unsigned transaction
const response = await fetch('https://api.vision.meme/tokens/create-unsigned', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: "Vision Meme",
    symbol: "VISION",
    description: "The ultimate meme token",
    imageUri: "https://ipfs.io/ipfs/QmAbc...",
    walletId: distributionWalletId,
    
    transferFeePercent: 5,
    burnPercent: 10,
    developerFeePercent: 60,
    developerWallet: wallet.publicKey.toString(),
    
    distributionInterval: "15m",
    percentageToSellPerDistribution: 25,
    rewardToken: "SOL",
    
    decimals: 6,
    supply: "1000000000000000", // 1B tokens
    transferFeeAdjustable: false,
    immutableMetadata: true
  })
});

const { transaction, transactionId, expiresAt, mintKeypair } = await response.json();

console.log('Transaction expires:', expiresAt);
console.log('Token mint:', mintKeypair.publicKey);

// Save for next step
localStorage.setItem('transactionId', transactionId);
localStorage.setItem('unsignedTransaction', transaction);

Errors

400 Bad Request - Validation errors

json

{
  "error": "Validation error",
  "details": [
    {
      "path": ["name"],
      "message": "String must contain at least 1 character(s)"
    }
  ]
}

Rate Limits

• 5 requests per hour

---

POST /tokens/submit

Submit a signed transaction to Solana and save token metadata.

Endpoint

POST https://api.vision.meme/tokens/submit

Authentication

Required - Include JWT token in Authorization header

Request Body

Field	Type	Required	Description
transactionId	string	✅	UUID from create-unsigned
signedTransaction	string	✅	Base64-encoded signed transaction

Request Example

json

{
  "transactionId": "550e8400-e29b-41d4-a716-446655440000",
  "signedTransaction": "AQAAAAAAAAAAAAAA..."
}

Response (200 OK)

json

{
  "success": true,
  "signature": "5VhQ7FqjkqQJ...",
  "mintAddress": "TokenMint1111111111111111111111111111111",
  "token": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "mintAddress": "TokenMint1111111111111111111111111111111",
    "name": "Vision Meme",
    "symbol": "VISION",
    "imageUri": "https://ipfs.io/ipfs/QmAbc...",
    "createdAt": "2024-01-01T12:00:00Z"
  }
}

Response Fields

Field	Type	Description
success	boolean	Submission success
signature	string	Solana transaction signature
mintAddress	string	Token mint address
token	object	Created token details

Code Example

javascript

// Get unsigned transaction from previous step
const unsignedTx = localStorage.getItem('unsignedTransaction');
const transactionId = localStorage.getItem('transactionId');

// Decode transaction
const txBuffer = Buffer.from(unsignedTx, 'base64');
const transaction = Transaction.from(txBuffer);

// Sign with wallet
const signedTx = await wallet.signTransaction(transaction);

// Encode signed transaction
const signedTxBase64 = signedTx.serialize().toString('base64');

// Submit
const response = await fetch('https://api.vision.meme/tokens/submit', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    transactionId,
    signedTransaction: signedTxBase64
  })
});

const { signature, mintAddress, token } = await response.json();

console.log('Token created!');
console.log('Mint address:', mintAddress);
console.log('Transaction:', signature);
console.log('View on Solana Explorer:', `https://solscan.io/tx/${signature}`);

Errors

400 Bad Request - Transaction expired

json

{
  "error": "Transaction expired",
  "message": "The unsigned transaction has expired. Please create a new one."
}

400 Bad Request - Invalid transaction

json

{
  "error": "Invalid transaction",
  "message": "The transaction signature is invalid or transaction is malformed"
}

Rate Limits

• 5 requests per hour

---

GET /tokens

Get paginated list of all visible meme tokens.

Endpoint

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

Authentication

Public - No authentication required

Query Parameters

Parameter	Type	Default	Description
page	number	1	Page number
limit	number	20	Items per page (max 100)

Request Example

bash

GET https://api.vision.meme/tokens?page=2&limit=50

Response (200 OK)

json

{
  "tokens": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "mintAddress": "TokenMint1111111111111111111111111111111",
      "name": "Vision Meme",
      "symbol": "VISION",
      "imageUri": "https://ipfs.io/ipfs/QmAbc...",
      "description": "The ultimate meme token",
      "transferFeePercent": 5,
      "poolAddress": "PoolAddress...",
      "createdAt": "2024-01-01T12:00:00Z"
    }
  ],
  "pagination": {
    "total": 150,
    "page": 2,
    "limit": 50,
    "totalPages": 3
  }
}

Code Example

javascript

async function getAllTokens(page = 1, limit = 20) {
  const response = await fetch(
    `https://api.vision.meme/tokens?page=${page}&limit=${limit}`
  );
  
  const { tokens, pagination } = await response.json();
  
  console.log(`Page ${pagination.page} of ${pagination.totalPages}`);
  console.log(`Total tokens: ${pagination.total}`);
  
  return tokens;
}

// Get first page
const tokens = await getAllTokens(1, 20);

// Get all tokens
async function fetchAllTokens() {
  const allTokens = [];
  let page = 1;
  let hasMore = true;
  
  while (hasMore) {
    const response = await fetch(
      `https://api.vision.meme/tokens?page=${page}&limit=100`
    );
    const { tokens, pagination } = await response.json();
    
    allTokens.push(...tokens);
    hasMore = page < pagination.totalPages;
    page++;
  }
  
  return allTokens;
}

Rate Limits

• 100 requests per 15 minutes

---

GET /tokens/me

Get list of tokens created by authenticated user.

Endpoint

GET https://api.vision.meme/tokens/me

Authentication

Required - Include JWT token in Authorization header

Response (200 OK)

json

{
  "tokens": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "mintAddress": "TokenMint1111111111111111111111111111111",
      "name": "Vision Meme",
      "symbol": "VISION",
      "imageUri": "https://ipfs.io/ipfs/QmAbc...",
      "distributionEnabled": true,
      "createdAt": "2024-01-01T12:00:00Z"
    }
  ]
}

Code Example

javascript

const response = await fetch('https://api.vision.meme/tokens/me', {
  headers: {
    'Authorization': `Bearer ${token}`
  }
});

const { tokens } = await response.json();

console.log(`You have created ${tokens.length} tokens`);
tokens.forEach(token => {
  console.log(`${token.name} (${token.symbol}): ${token.mintAddress}`);
});

Rate Limits

• 100 requests per 15 minutes

---

GET /tokens/:mintAddress

Get detailed information about a specific token.

Endpoint

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

Authentication

Public - No authentication required

Path Parameters

Parameter	Type	Description
mintAddress	string	Solana token mint address

Request Example

bash

GET https://api.vision.meme/tokens/TokenMint1111111111111111111111111111111

Response (200 OK)

json

{
  "token": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "mintAddress": "TokenMint1111111111111111111111111111111",
    "name": "Vision Meme",
    "symbol": "VISION",
    "decimals": 6,
    "supply": "1000000000000000",
    "imageUri": "https://ipfs.io/ipfs/QmAbc...",
    "description": "The ultimate meme token",
    "twitter": "https://twitter.com/visionmeme",
    "telegram": "https://t.me/visionmeme",
    "website": "https://vision.meme",
    "transferFeePercent": 5,
    "burnPercent": 10,
    "developerFeePercent": 60,
    "developerWallet": "DevWallet111...",
    "distributionWallet": "DistWallet111...",
    "distributionInterval": "15m",
    "distributionEnabled": true,
    "poolAddress": "PoolAddress...",
    "poolCreatedAt": "2024-01-01T12:30:00Z",
    "createdAt": "2024-01-01T12:00:00Z",
    "updatedAt": "2024-01-01T12:00:00Z"
  }
}

Code Example

javascript

async function getTokenDetails(mintAddress) {
  const response = await fetch(
    `https://api.vision.meme/tokens/${mintAddress}`
  );
  
  if (response.status === 404) {
    console.log('Token not found');
    return null;
  }
  
  const { token } = await response.json();
  
  console.log('Token:', token.name);
  console.log('Supply:', parseInt(token.supply) / Math.pow(10, token.decimals));
  console.log('Tax:', token.transferFeePercent + '%');
  console.log('Distribution:', token.distributionInterval);
  
  return token;
}

Errors

404 Not Found - Token doesn't exist

json

{
  "error": "Token not found"
}

Rate Limits

• 100 requests per 15 minutes

---

Complete Token Creation Flow

javascript

async function createToken(tokenData, wallet) {
  try {
    // Step 1: Authenticate
    const { token } = await authenticate(wallet);
    
    // Step 2: Generate distribution wallet
    const distRes = await fetch('https://api.vision.meme/tokens/generate-distribution-wallet', {
      method: 'POST'
    });
    const { walletId } = await distRes.json();
    
    // Step 3: Upload image
    const formData = new FormData();
    formData.append('image', tokenData.imageFile);
    
    const uploadRes = await fetch('https://api.vision.meme/tokens/upload-image', {
      method: 'POST',
      headers: { 'Authorization': `Bearer ${token}` },
      body: formData
    });
    const { imageUri } = await uploadRes.json();
    
    // Step 4: Create unsigned transaction
    const createRes = await fetch('https://api.vision.meme/tokens/create-unsigned', {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${token}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        ...tokenData,
        imageUri,
        walletId
      })
    });
    const { transaction, transactionId, mintKeypair } = await createRes.json();
    
    // Step 5: Sign transaction
    const txBuffer = Buffer.from(transaction, 'base64');
    const tx = Transaction.from(txBuffer);
    const signedTx = await wallet.signTransaction(tx);
    const signedTxBase64 = signedTx.serialize().toString('base64');
    
    // Step 6: Submit
    const submitRes = await fetch('https://api.vision.meme/tokens/submit', {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${token}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        transactionId,
        signedTransaction: signedTxBase64
      })
    });
    
    const { signature, mintAddress } = await submitRes.json();
    
    console.log('Token created successfully!');
    console.log('Mint:', mintAddress);
    console.log('Signature:', signature);
    
    return { mintAddress, signature };
    
  } catch (error) {
    console.error('Token creation failed:', error);
    throw error;
  }
}

---

Next Steps

• Distribution Settings - Manage tax distribution

• DEX Integration - Add liquidity

• Burns - Track token burns

---

© 2025 Vision.meme. All rights reserved.