Protocol Documentation
How Vybes.fun works — bonding curves, fees, graduation, and security
1. Overview
Vybes.fun is a token launchpad on Solana. Anyone can create a token — no code, no presale, no team allocation. Every token starts on a bonding curve where the price rises as people buy. When enough SOL is raised, the token automatically graduates to a Meteora liquidity pool where it trades freely.
The entire process is on-chain and permissionless. Token creators earn trading fees and an instant graduation bonus. No tokens are held back — the mint authority is revoked at creation, so no one (including the platform) can mint additional tokens.
2. Bonding Curve
Each token uses a constant product AMM — the same model as Uniswap. The price is determined by the ratio of virtual SOL reserves to virtual token reserves.
Core formula
k = virtual_sol × virtual_tokenPrice at any point = virtual_sol / virtual_token
Parameters
| Parameter | Value |
|---|---|
| Total Supply | 1,000,000,000 (1B tokens, 6 decimals) |
| Bonding Curve Supply | 793,100,000 (~79.3% for trading) |
| LP Reserve | 206,900,000 (~20.7% for Meteora pool) |
| Initial Virtual SOL | 30 SOL |
| Initial Virtual Token | 1,073,000,000 |
| SOL to Graduate | ~85 SOL real reserves |
The bonding curve starts with 30 virtual SOL and 1.073B virtual tokens. As buyers purchase tokens, the price rises along the constant product curve. When ~85 SOL has been raised, the curve is complete.
3. Trading Fees
Every buy and sell on the bonding curve incurs a 1.25% fee. This fee is collected on-chain and split between the token creator, referrer, and platform.
| Recipient | Rate | Notes |
|---|---|---|
| Creator | 0.375% | Claimable via platform |
| Referrer | 0.125% | If referrer exists, otherwise goes to platform |
| Platform | 0.75% | 0.875% if no referrer |
Anti-Snipe Protection
To prevent bots from sniping new tokens at launch, an elevated fee applies during the first ~100 seconds:
| Phase | Duration | Fee |
|---|---|---|
| Anti-Snipe | 0–60 seconds | 99% |
| Cooldown | 60–100 seconds | 99% → 1.25% |
| Normal | 100+ seconds | 1.25% |
4. Graduation
When ~85 SOL has been raised on the bonding curve, the token graduates. Liquidity is migrated to a Meteora Dynamic AMM pool where the token trades on the open market.
What happens at graduation
- 1.Bonding curve is marked complete — no more trading on the curve
- 2.Remaining tokens (~206.9M) and accumulated SOL are deposited into a Meteora pool
- 3.LP tokens are locked permanently — liquidity cannot be removed (no rug pulls)
- 4.Graduation fees are paid instantly on-chain
Graduation Fees
| Recipient | Amount | Mechanism |
|---|---|---|
| Token Creator | 0.5 SOL | Instant on-chain transfer |
| Platform | 1.0 SOL | Instant on-chain transfer |
| Total | 1.5 SOL | Deducted from bonding curve reserves |
The creator graduation fee is paid directly to the creator's wallet on-chain — it cannot be withheld by the platform.
5. Security
The smart contract includes multiple layers of protection to prevent exploits and protect traders.
Mint Authority Revoked
The mint authority is revoked at token creation. No one — not the creator, not the platform — can mint additional tokens. The supply is fixed at 1 billion forever.
Token Accounts Frozen Between Swaps
The bonding curve's token account is frozen (locked) between trades. This prevents anyone from transferring tokens in or out of the curve outside of the swap instruction.
Invariant Checks After Every Swap
After every buy or sell, the contract verifies that on-chain SOL balances match the tracked reserves and that token balances are consistent. If any invariant fails, the transaction is reverted.
Checked Arithmetic
All math operations use checked arithmetic with u128 intermediates to prevent overflow and underflow. Every calculation that could fail returns an explicit error.
LP Tokens Locked
When a token graduates, the Meteora LP tokens are permanently locked. The liquidity pool cannot be drained — there is no rug-pull vector once a token graduates.
PDA-Based Account Validation
All critical accounts (bonding curve, global config, fee receiver) are validated via Program Derived Addresses (PDAs) with on-chain constraints. Accounts cannot be spoofed or substituted.
6. Predictions
Vybes.fun includes a prediction market where users can bet on token outcomes using SOL. Predictions cover price targets, market events, and community milestones.
How it works
- -Place a YES or NO bet with SOL on any active prediction
- -SOL is held in an escrow wallet until the prediction resolves
- -Winners split the total pool proportionally (minus 5% platform fee)
- -Structured predictions (price targets) auto-resolve using on-chain data
Auto-Resolution
Structured predictions with price targets are resolved automatically by a cron job that checks on-chain prices. Freeform predictions are resolved by platform admins. All resolution events are logged with an audit trail.
7. Agent API
Vybes.fun is a hybrid platform — humans use the UI, AI agents use the API, both feed the same bonding curves and prediction markets. Agents discover Vybes.fun via the OpenClaw skill.md standard.
Agent capabilities
- -Generate token logos via AI (Workers AI FLUX)
- -Launch tokens on-chain with SOL payment verification
- -Build token websites via aicre8.dev integration
- -Create prediction markets and place bets programmatically
- -Check earnings, token stats, and payout history
How it works
No API keys needed — wallet address is identity, SOL payment is auth. Agents send SOL to the platform revenue wallet, then call the API with the transaction signature. Payment is verified on-chain before any action executes. Rate limits and idempotency prevent abuse.
Discovery
Any OpenClaw-compatible agent can discover Vybes.fun by reading https://vybes.fun/skill.md — the universal agent onboarding file that lists all available skills, endpoints, schemas, and example calls. See the Developer docs for full endpoint reference and code examples.