Docs
How Banger turns tweets into markets, and how to build on it.
What is Banger
Banger is a marketplace on Solana where any public tweet can become a tradable asset. Each listed tweet gets its own market: a token whose price rises as more people buy and falls as they sell. Traders back the ideas they think will matter, and the creator of the tweet earns a share of every purchase plus direct tips.
Nothing on the site is mocked. Tweet text, authors, avatars, likes and replies are pulled live from X. Prices, volume, holders, P&L and creator earnings come from real trades, and every trade moves real SOL on the devnet cluster.
How a tweet market works
Every market is a bonding curve priced in SOL. There is no order book and no counterparty: you always trade against the curve itself.
- base = 0.00005 SOL per token — where every new market starts.
- k = 200,000 tokens — how quickly the price steepens. At a supply of k the price is 4× base.
- supply = tokens currently held by everyone. Buying mints along the curve, selling burns back down it.
Buys and sells are integrated in small steps, so large orders pay slippage exactly as the curve dictates. The market cap shown on every card is price × supply, converted to dollars at the live SOL price.
Buying and selling
Trading mode on this deployment: on-chain settlement.
- Buy. Enter an amount of SOL and confirm. Your wallet sends that SOL to the Banger treasury. The API finds the transaction on-chain, checks that your wallet signed it, that the treasury received the amount, and that the signature has never been used, then credits your tokens at the curve price. 5% of every buy goes to the tweet's creator.
- Sell. Enter a token amount. Your position is debited and the treasury pays the SOL straight back to your wallet. The payout signature is stored on the trade and linked to the explorer.
- Track. Your holdings, average price, P&L, allocation and history live on the Portfolio page. Add markets to your watchlist from the ⋯ menu on any tweet.
The trade panel shows an estimate before you confirm. Actual fills follow the curve at the moment your deposit is verified.
Listing a tweet
Click List a tweet in the header, paste a public tweet URL such as https://x.com/user/status/123, pick a category, and review the live preview. Creating the market opens it at the base price with zero supply. Listing is free; the market only exists once, so if someone already listed that tweet you land on the existing page.
Deleted or protected tweets cannot be listed. Engagement counts refresh from X when the tweet is listed.
Creators, fees and tips
The author of a listed tweet is a creator on Banger automatically. Their profile shows every market they have, holders, 24h volume, earnings, supporters and followers. Earnings accrue from two sources: the 5% fee on every buy of their tweets, and direct tips from the Support panel.
Tips are real SOL transfers verified on-chain exactly like buys. Until a creator sets a payout wallet, their balance is held by the treasury. Following a creator is free and powers the Following filter on the marketplace.
Wallets and sign-in
Sign-in is powered by Privy. You can log in with email, Google, X or an existing Solana wallet such as Phantom or Solflare; email and social logins get an embedded Solana wallet created for them. Your wallet address is your identity on Banger: holdings, follows and watchlist are all keyed to it.
Wallet login is enabled on this deployment.
Network and treasury
- Cluster: Solana devnet. Devnet SOL has no value; get some from a faucet to try trading.
- Treasury: 6ESiUNozoapdoN7GHGKKUovbSXu7JCzvAeg1XxNi6A1i
- Every deposit and payout is a plain SOL transfer you can audit on the explorer. Signatures are shown on trades, tips and the activity feed.
Today the curve and token ledger run in Banger's backend while SOL settles on-chain. Moving the curve into an on-chain program is the next step on the roadmap.
API
Every endpoint returns { ok: true, data } or { ok: false, error } with a matching HTTP status. Endpoints marked auth need Authorization: Bearer <privy access token> and an x-wallet header naming one of that user's Solana wallets.
| Method | Route | What it does |
|---|---|---|
| GET | /api/tweets?sort=top|trending|new|volume|likes&category=&q=&handle=&limit= | List markets |
| POST | /api/tweets {url, category} | List a tweet as a market (auth) |
| GET | /api/tweets/:id | Market, top holders, related, latest trades |
| GET | /api/tweets/:id/prices?range=1H|1D|1W|1M|ALL | Price series |
| GET | /api/tweets/:id/trades?limit= | Recent trades |
| GET | /api/tweets/:id/holders?limit= | Holders |
| POST | /api/tweets/:id/trade {side:"buy", txSignature} | {side:"sell", quantity} | Execute a trade (auth) |
| POST/DELETE | /api/tweets/:id/watch | Watchlist (auth) |
| GET | /api/creators?sort=volume|trending|earnings|followers | Creator board |
| GET | /api/creators/:handle | Creator profile, markets, supporters |
| POST/DELETE | /api/creators/:handle/follow | Follow (auth) |
| POST | /api/creators/:handle/support {amountSol, txSignature} | Tip a creator (auth) |
| GET | /api/portfolio/:wallet?range= | Holdings, P&L, allocation, activity, value series |
| GET | /api/activity?wallet=&limit= | Trades, tips and listings feed |
| GET | /api/market/stats · /api/session · /api/sol · /api/me · /api/x/preview?url= | Stats, deployment config, SOL price, your profile, tweet preview |
FAQ
Is this real money?+
Trades settle in SOL on devnet. On devnet that SOL is free test currency; on mainnet it is real.
Why did I get fewer tokens than the estimate?+
The estimate uses the current price. Your fill walks up the curve as it executes, and the creator fee is taken first.
Can I lose money?+
Yes. If the supply falls after you buy, the curve price falls and your tokens are worth less SOL.
Where do creator earnings go?+
They accrue to the creator's balance and are paid to their payout wallet once one is set.
Who can list a tweet?+
Anyone signed in. Any public tweet works; each tweet can only be listed once.
Can I see my full history?+
Portfolio → History shows every trade with signatures. The Activity page shows everyone's.
Questions? Message us on X.