API and MCP

Pricing

How paying works

With x402, in USDC on Solana: no account, no key, no subscription. A request that needs paying gets 402 Payment Required with the price in a PAYMENT-REQUIRED header. Your client or agent signs a USDC transfer for that amount and sends the request again with it in PAYMENT-SIGNATURE. We check it, settle it on Solana, and answer, with the transaction in PAYMENT-RESPONSE. x402-aware clients and agent wallets do this automatically.

WeBall pays the network fee. You only ever sign a transfer of the stated amount to WeBall's address; nothing else can move from your wallet.

MCP for AI agents

The same data as the API, as tools an AI agent can call: a hosted, read-only Model Context Protocol server. No sign-in and no key.

Server URL

https://weball.fun/mcp

Claude Code

claude mcp add --transport http weball https://weball.fun/mcp

Claude (web and desktop)

Settings, then Connectors, then Add custom connector, and paste the server URL.

Other clients

Most accept a server entry like this in their MCP settings:

{
  "mcpServers": {
    "weball": {
      "url": "https://weball.fun/mcp"
    }
  }
}

Tools

• search_coins(q, sort, mode, graduated, limit)

  Find coins by mint, symbol or name, or list them by newest, volume or market cap.

• get_coin(mint)

  One coin in full: mode, fee, pair, basket, bonding progress, market cap and holders. Its health grade and signals: get_health_signal.

• get_coin_rewards(mint)

  Holder mode: the reward pot, what holders received per basket token (raw units, cost, and US cents at the time and at the latest price), and recent payout rounds, each with its snapshot slot and baseline slot (holders are counted at the smaller of their balance at the two). Creator mode: what the creator has earned, been sent, and is waiting on.

• get_flywheel()

  The platform’s funds: the flywheel (accruing; buys and burns not started yet), the $BALL burn fund and the platform share.

• get_platform_stats()

  Platform totals: coins launched and graduated, trades, volume, paid to holders and sent to creators (lamports, SOL value). `revenueDaily`: platform revenue per UTC day, the last 30, oldest first: WeBall’s fee share and swap referrals (lamports), API payments (micro-USD), that day’s SOL price (micro-USD) the day’s total in US cents (`usdCents`) and all revenue to the end of that day (`cumulativeUsdCents`).

• get_ball_burns(date)

  One UTC day of $BALL burns (today unless `date`, YYYY-MM-DD): burned that day, totals to the end of that day, percent of the original supply, the latest burn transaction and the burn fund now. Unlike the other tools, amounts are display strings: whole $BALL, SOL and US dollars.

• get_market_data(mint, interval)

  A coin’s recent price candles (the last 48 at the interval) and its latest 20 trades.

• get_top_holders(mint, limit)Basic

  A coin’s biggest holders and holder count (pools, locked liquidity and WeBall’s wallets left out), with what each would count for in the next round: the smaller of their balance now and at the round’s baseline (tokens bought since then count from the round after).

• get_wallet_rewards(wallet, coin)Basic

  What a wallet has been paid in holder rewards, and is owed (small shares carried to the next round).

• get_creator_earnings(wallet)Basic

  The coins a wallet launched here, and what each has earned it.

• get_health_signal(mint)Premium

  A coin’s health grade (A–F) and the signals behind it, each with its level (ok, caution, warning): top-10 concentration, the creator’s unlocked share, whether the creator sold their launch buy, snipers and bundled buys (what those wallets still hold), insiders (launch-block buyers, and tokens received by transfer), wash trading, and whether the mint and freeze authorities are still set; plus holders and the creator’s other launches. The grade is null when not scored yet or over an hour old. It flags warnings; it never means a coin is safe.

Coin names, symbols, descriptions and links are written by coin creators, so the server wraps each as {"untrusted_text": …} and tells the agent to treat them as data, never instructions.

Read API

Base URL

https://weball.fun/api/v1

Network

Solana mainnet: the network this site runs on

Limits

120 requests a minute (API), 60 (MCP), per visitor

Machine-readable

/api/v1/openapi.json

Try it

curl "https://weball.fun/api/v1/coins?sort=volume&limit=5"

Read-only: nothing here moves money or needs a wallet. Health grades signal warnings, not safety, and nothing on WeBall is financial advice (see the FAQ).