🌊 WaveWarz

Statz Remixer

Your ultimate guide to building with the WaveWarz API ecosystem

💰 What is WaveWarz?

WaveWarz is the world's first real-time, live-traded music battle platform on Solana. Artists compete, fans trade ephemeral tokens, and everyone gets rewarded.

How It Works:

• 20-minute timed battles between artists
• Fans trade SOL for artist tokens during the battle
• Artist with the larger SOL pool wins
• Winners get 40% of loser's pool + settlement bonuses
• Artists earn 1% of every trade instantly + settlement payouts
• Even losing traders get 50% of the loser's pool back

📊 Live Platform Stats:

🎵 Any Artist, Any Genre, Anywhere

From hip-hop to EDM, country to experimental - WaveWarz is open to all musicians worldwide.

🛠️ Build with WaveWarz

API Playground - Get Real-Time Battle Data

API Base URL:https://analytics-wave-warz.vercel.app/api

GET/stats

Platform Statistics

Returns total battles, completed battles, artist payouts, unique traders, unique artists, and current SOL price

Use Cases:

• Dashboard widgets
• Real-time stats displays
• Platform health monitors
• Social media bots posting daily stats

GET/artists?limit=10

Artist Leaderboard

Top artists ranked by total SOL earnings, with Twitter handles, music links, Spotify equivalents, win rates, and battle history

Parameters:

limitnumber

Number of results (default: 10)

offsetnumber

Pagination offset (default: 0)

Use Cases:

• Artist discovery platforms
• Music directories with earnings
• Leaderboard widgets
• "Featured Artist" social posts
• Artist comparison tools

GET/traders?limit=10&sortBy=roi

Trader Leaderboard

Top traders ranked by profit, ROI, or payout with complete P&L stats

Parameters:

limitnumber

Number of results (default: 10)

offsetnumber

Pagination offset (default: 0)

sortBystring

net_pnl | roi | total_payout | win_rate (default: net_pnl)

Use Cases:

• Trader analytics dashboards
• ROI calculators
• Whale watchers
• Trading strategy analysis
• Leaderboard competitions

GET/battles?limit=10

Top Battles

Biggest battles by TVL with artist info, pools, winners, and margins

Parameters:

limitnumber

Number of results (default: 10)

Use Cases:

• Battle highlight reels
• Historical battle browsers
• TVL trackers
• Winner announcement bots
• Battle recap content

💰 Calculate Spotify Stream Equivalents

Want to show how WaveWarz earnings compare to Spotify? Here's how to calculate the stream equivalent:

📊 The Formula:

Spotify Stream Equivalent = (SOL Earnings × SOL Price in USD) ÷ $0.003

Spotify pays approximately $0.003 per stream (paid out over 30-90 days)

Example Calculation:

• Artist earned: 0.206 SOL
• Current SOL price: $136.97
• USD value: 0.206 × $136.97 = $28.22
• Stream equivalent: $28.22 ÷ $0.003 = 9,407 streams

💻 Implementation Example:

JavaScript Example

// Get artist data from API
const response = await fetch(
  'https://analytics-wave-warz.vercel.app/api/artists?limit=1'
);
const { data, meta } = await response.json();

const artist = data[0];
const solPrice = meta.solPrice;

// Calculate Spotify stream equivalent
const streamEquivalent = Math.round(
  (artist.totalEarningsSol * solPrice) / 0.003
);

console.log(`${artist.artistName} earnings = ${streamEquivalent.toLocaleString()} Spotify streams!`);
// Output: "STILO English earnings = 9,407 Spotify streams!"

💡 Pro Tip: The /artists endpoint already includes spotifyStreamEquivalents pre-calculated for you! Use it directly or calculate your own for real-time updates.

💡 What Can You Build?

Get inspired by these creative use cases

Social Media Bots 🤖

Post daily leaderboards to Twitter/X
Auto-generate memes about top traders
Announce battle results in real-time
Share artist milestones (earnings, wins)

Farcaster Frames 🖼️

Interactive artist profiles
Live battle status cards
Trader P&L calculators
"Which artist should I support?" quiz
Daily stats summaries

Meme Generators 🎨

"POV: You're #1 on the trader leaderboard"
"When you pick the winning artist 🚀"
"My earnings vs. Spotify streams" comparison
Artist vs Artist battle posters

Analytics Dashboards 📊

Real-time platform metrics
Artist earnings over time
Trader performance tracking
Battle volume trends
ROI calculators

Discovery Tools 🔍

Artist directory with music links
"Find artists by genre" filters
Twitter-integrated artist cards
Battle history browsers
Emerging artist spotlights

Gamification 🎮

Trading challenges & competitions
Achievement systems for traders
Prediction markets for battles
Fantasy trading leagues
Community tournaments

Content Creators 🎥

Automated battle recaps
Artist spotlight videos
"Top 10" weekly compilations
Educational explainer content
Platform growth stories

Notification Systems 🔔

Battle start/end alerts
New artist announcements
Leaderboard position changes
Earnings milestones
Discord/Telegram bots

🚀 Quick Start Guide

Build your first mini app in 5 minutes

Your First WaveWarz Bot

Here's a complete example that fetches platform stats, gets top artists, and generates a social media post. Copy, customize, and ship it! 🌊

Example: Social Media Bot

// Step 1: Fetch Platform Stats
const response = await fetch(
  'https://analytics-wave-warz.vercel.app/api/stats'
);
const { data } = await response.json();

console.log(`Total Battles: ${data.totalBattles}`);
console.log(`Total Artists: ${data.uniqueArtists}`);

// Step 2: Get Top 3 Artists
const artistsRes = await fetch(
  'https://analytics-wave-warz.vercel.app/api/artists?limit=3'
);
const { data: artists } = await artistsRes.json();

// Step 3: Generate a Social Post
const post = `
🔥 WaveWarz Top Artists:

1. ${artists[0].artistName} - ${artists[0].totalEarningsSol} SOL
   (${artists[0].spotifyStreamEquivalents.toLocaleString()} Spotify equivalent)
   
2. ${artists[1].artistName} - ${artists[1].totalEarningsSol} SOL

3. ${artists[2].artistName} - ${artists[2].totalEarningsSol} SOL

Trade now: wavewarz.com 🌊
`;

// Step 4: Post to social media (your implementation)
postToTwitter(post);

📝 Step 1

Fetch real-time stats from the API

🎯 Step 2

Get top artists with earnings data

🚀 Step 3

Generate and share your content

💡 Pro Tips:

• All endpoints are CORS-enabled - call from any origin
• No authentication required - start building immediately
• Data updates in real-time after each battle
• Rate limit: 100 requests/minute (generous for most use cases)
• Combine endpoints for richer insights

⚙️ Technical Details

Everything you need to know about our API

CORS & Access

✅CORS Enabled: All endpoints accessible from any origin
✅No Authentication: Public read-only access
✅Rate Limits: Generous (100 req/min recommended)
✅HTTPS Only: Secure connections required

Response Format

Success Response:

{
  "success": true,
  "data": { ... },
  "meta": {
    "lastUpdated": "ISO timestamp",
    "solPrice": 136.97,
    "total": 10
  }
}

Error Response:

{
  "success": false,
  "error": "Error message",
  "details": "Additional context"
}

Data Freshness

•Platform stats: Real-time from database
•Leaderboards: Updated after each battle scan
•Battle data: Live from Solana blockchain cache
•SOL price: Live from CoinGecko API

Technology Stack

•Platform: Vercel Serverless Functions
•Database: Supabase (PostgreSQL)
•Blockchain: Solana (Program: 9TUfEHvk...)
•Language: TypeScript
•Response Time: <500ms average

🌍 Join the WaveWarz Community

Connect, create, and compete with the community

🎵 Launch a Community Battle

Create your own WaveWarz battle! Pick any two artists, connect your livestream, share with your community, and watch the trading happen live.

🎤 Artists: Sign Up to Battle

Any artist, any genre, anywhere in the world. Earn 1% of every trade instantly, get settlement bonuses, and build your fanbase. No upfront costs.

📊 Main Analytics Dashboard

Explore the full WaveWarz Analytics app with battle history & replays, detailed leaderboards, live trading charts, artist profiles, and trader insights.

🎬 FLIX Community

Join the WaveWarz community on FLIX! Watch battle highlights, connect with artists and traders, and stay updated on the latest platform news.

🐦 Twitter/X

Follow for daily leaderboards, battle results, artist spotlights, and platform updates. Stay connected with the WaveWarz community.

📺 YouTube

Watch tutorials, battle highlights, artist interviews, and platform guides. Learn how to trade and discover new artists.

🎭 Farcaster

Engage on Farcaster with interactive frames, community discussions, and battle updates. Join the decentralized social revolution.

📝 Paragraph Blog

Read in-depth articles, platform updates, artist spotlights, and ecosystem insights. Stay informed with the official WaveWarz blog.

🎨 Brand Guidelines

Use these assets to build on-brand experiences

Color Palette

Deep Space Navy

#020202

rgb(2, 2, 2)

Usage: Background

Action Green

#95FE7C

rgb(149, 254, 124)

Usage: Highlights/CTAs

Wave Blue

#7EC1FB

rgb(126, 193, 251)

Usage: Accents

White Text

#DAECFD

rgb(218, 236, 253)

Usage: Text

Typography Guide

Rajdhani (Titles/Headers)

WaveWarz Battle Royale

Weights: Bold (700), Semi-Bold (600)
Usage: Battle titles, section headers, CTAs

Inter (Body Text)

The quick brown fox jumps over the lazy dog. This is Inter font for body text and descriptions.

Weights: Regular (400), Medium (500)
Usage: Descriptions, stats, labels

Design Principles

✨

Dark & Sleek

Use dark backgrounds for that cyberpunk aesthetic

🎵

Music-First

Keep artists and battles at the center

⚡

Neon Accents

Use Action Green and Wave Blue for energy

📱

Mobile-Responsive

Optimize for all screen sizes

🎮

Gamification

Add competitive elements and achievements

🌊

Wave Motifs

Incorporate wave and water elements

WaveWarz Logo Assets

Download official WaveWarz logos for your projects, social media, or promotional materials. All logos are free to use for WaveWarz community projects.