Four.meme

Four.meme is a token launchpad on BNB Chain that uses a two-step creation process. The first step authenticates with the Four.meme API to obtain a createArg and signature, which are then submitted on-chain via the createToken(bytes, bytes) contract function along with a 0.01 BNB creation fee.

Chain

BNB Chain (BSC Mainnet)

Key Details

Property	Value
API	Four.meme REST API + on-chain contract
Launch Flow	API auth → `createArg`/`signature` → `createToken(bytes, bytes)`
Token Standard	BEP-20
Creation Fee	0.01 BNB
Private Key Format	Hex with `0x` prefix

Setup

Initialize dex-skills for Four.meme

import { createSkills, getSkill } from "dex-skills";

const skills = createSkills({
  wallets: {
    bnb: {
      privateKey: "0x-prefixed-hex-private-key",
      rpcUrl: "https://bsc-dataseed1.binance.org",
    },
  },
});

const fourmeme = getSkill(skills, "fourmeme");

Launch a Token

The launch process is a two-step operation. First, dex-skills authenticates with the Four.meme API to obtain the createArg and signature bytes. Then it calls the on-chain createToken(bytes, bytes) function with these values, sending 0.01 BNB as the creation fee.

Launch Example

const result = await fourmeme.launch({
  name: "Four Token",
  symbol: "FOUR",
  description: "A token launched on Four.meme via dex-skills.",
  imageUrl: "https://example.com/token-logo.png",
  initialBuyAmount: "0.01",
  links: {
    twitter: "https://x.com/fourtoken",
    telegram: "https://t.me/fourtoken",
    website: "https://fourtoken.xyz",
  },
});

console.log("Token address:", result.tokenAddress);
console.log("Transaction:", result.txHash);

Launch Parameters

Parameter	Type	Description
name *	string	Display name of the token.
symbol *	string	Token ticker symbol.
description	string	Description of the token.
imageUrl	string	URL to the token image. Must be publicly accessible.
initialBuyAmount	string	Amount of BNB to spend on an initial buy immediately after launch.
links	object	Social links object with optional keys: twitter, telegram, website.

Query Token Info

Get Token Info

const token = await fourmeme.getTokenInfo("0xTokenContractAddress...");

console.log("Name:", token.name);
console.log("Symbol:", token.symbol);
console.log("Total Supply:", token.totalSupply);
console.log("Market Cap:", token.marketCap);

List Tokens

const tokens = await fourmeme.listTokens({
  limit: 20,
  sortBy: "createdAt",
  sortOrder: "desc",
});

for (const token of tokens) {
  console.log(token.symbol, token.tokenAddress);
}

Buy Tokens

Purchase tokens on Four.meme by specifying the token address, BNB amount, and optional slippage.

Buy Example

const result = await fourmeme.buy({
  tokenAddress: "0xTokenContractAddress...",
  amount: "0.01",
  slippage: 10,
});

console.log("Tx Hash:", result.txHash);
console.log("Tokens received:", result.tokenAmount);

Sell Tokens

Sell tokens on Four.meme by specifying the token address and amount of tokens to sell.

Sell Example

const result = await fourmeme.sell({
  tokenAddress: "0xTokenContractAddress...",
  amount: "1000000",
  slippage: 10,
});

console.log("Tx Hash:", result.txHash);
console.log("BNB received:", result.nativeAmount);

Estimate Price

Four.meme is the only platform that supports price estimation before executing a trade.

Price Estimate

const quote = await fourmeme.estimatePrice({
  tokenAddress: "0xTokenContractAddress...",
  action: "buy",
  amount: "0.1",
});

console.log("Estimated tokens:", quote.estimatedAmount);
console.log("Estimated cost:", quote.estimatedCost);
console.log("Fee:", quote.fee);
console.log("Price per token:", quote.pricePerToken);

Supported Methods

Method	Supported
launch()	Yes
getTokenInfo()	Yes
listTokens()	Yes
buy()	Yes
sell()	Yes
getTrending()	No
getTradeHistory()	No
getHolders()	No
estimatePrice()	Yes

Platform Notes

Two-Step Creation Process

Unlike platforms that handle everything in a single transaction, Four.meme requires an off-chain API call first. The API returns createArg (the encoded token parameters) and a signature (server-side authorization). Both are passed as bytes to the on-chain createToken function. dex-skills handles both steps automatically.

Creation Fee

Each token launch on Four.meme requires a creation fee of 0.01 BNB, sent as the transaction value. Ensure your wallet has sufficient BNB to cover both the creation fee and gas costs.

Private Key Format

Four.meme operates on BNB Chain, an EVM-compatible chain. Private keys must be in hex format with the 0x prefix.

Supported Social Links

Field	Description
twitter	Twitter/X profile URL
telegram	Telegram group or channel URL
website	Project website URL