Quickstart

Welcome to Addresses – the fastest way to generate custom vanity addresses via API.

Designed for bundlers, token creation platforms, and any service that needs to assign or deploy to a custom address — especially in the Solana ecosystem.

🪙 Step 1: Fund Your Account

⚠️ You need tokens in your account to use the API

Each custom address generation consumes points.
Check your balance or top up via the Dashboard (opens in a new tab).

Add Tokens Screenshot

💰 Address Pricing

2 points for addresses ending in pump
1.75 points for other suffixes like bonk, ray, moon, boop, etc.

💡 Need better rates or bulk support?
Join our Addresses Partner Program for lower pricing and early access to new features.
👉 Talk to us on Telegram (opens in a new tab)

🛠️ Step 2: Generate a Custom Address

Use the API to get a Solana-compatible address that ends with a specific suffix.
This is useful when deploying a new token or setting up a custom address for your bundlers.

curl -X POST "https://v1-api.addresses.fun/api/get-new-address" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "type": "pump"
  }'

✅ Example Response

{
  "address": "AVyjco9j8vv7ZPkhCpEoPJ3bLEuw7G1wrrNt8DrApump",
  "privateKey": "a110c84259c11c7d19892c83f85e68f1:5f4984a6c97...",
  "type": "pump"
}

🔒 Note:
The private key is encrypted for your safety. You can decrypt it using your unique key from the Dashboard (opens in a new tab).

🔓 Step 3: Decrypt the Private Key

Node.js

const crypto = require("crypto");
 
const ENCRYPTION_KEY = process.env.ENCRYPTION_KEY; // 64 hex chars
const IV_LENGTH = 16;
 
function decrypt(encryptedText) {
  const [ivHex, encrypted] = encryptedText.split(":");
  const iv = Buffer.from(ivHex, "hex");
  const decipher = crypto.createDecipheriv("aes-256-cbc", Buffer.from(ENCRYPTION_KEY, "hex"), iv);
  let decrypted = decipher.update(encrypted, "hex", "utf8");
  decrypted += decipher.final("utf8");
  return decrypted;
}

⚙️ Step 4: Use the Address

Once decrypted, this address can be:

Used for deploying a token to a memorable address
Assigned in your bundler for custom address

🛡️ Best Practices

Keep private keys and decryption keys secure
Avoid exposing sensitive keys in client-side apps
Monitor usage and rotate API keys as needed

Introduction Try API