DEVELOPER COMPASS
Docs for MEV Bots & Algorithmic Pirates
I. GraphQL Indexer API
All historical data, market listings, and trading volumes are indexed via our blazing-fast Ponder GraphQL endpoint. Do not spam RPC nodes—use the indexer for data aggregation.
// Endpoint: https://index.bigbounty.fun/graphql (Local: http://localhost:42069)
query GetTrendingMarkets {
markets(
orderBy: "volume24h",
orderDirection: "desc",
where: { state: "OPEN" }
) {
id
question
yesTickets
noTickets
currentYesPrice
currentNoPrice
}
}II. Smart Contract Integrations
All trading must be executed directly on-chain via the Base L2 network. Our contracts are designed for gas-efficient single-tx execution.
- Bonding Curve Quote: Call
quote(uint256 ethIn)on theBondingCurvecontract to get the exact amount of $BIGB you will receive. - Create Market: Call
createMarket(string question, string category, uint256 duration)on theMarketFactory. You MUST send at least theBASE_CREATION_FEEas msg.value (excess will be refunded if you have rank discounts). Bots can automate market generation to farm the Creator Airdrop Pool. - Market Tickets Quote: Call
quote(bool isYes, uint256 ethIn)on a specificMarketcontract. Returns the number of tickets out and the average price paid. - Execution: Send ETH directly to
betYes()orbetNo()on theMarketcontract. No approvals needed.
III. Arbitrage & MEV Strategies
Our polling markets do NOT use a traditional AMM pool (like Uniswap). Instead, every market uses a Dual Isolated Bonding Curve. YES and NO tickets have their own separate linear price paths. If 100 people buy YES and 0 people buy NO, YES tickets become extremely expensive while NO tickets remain at the base floor price (0.001 ETH)!
The Sniper Strategy
Because curves are isolated, early tickets are exponentially cheaper. Monitor the MarketCreated event and immediately buy tickets on highly polarized questions for maximum volume at minimum cost.
Polarity Arbitrage
If a market leans heavily to YES, the NO tickets are practically free. If there is a sudden news shift or reversal, buying the neglected side yields a 100x-1000x return upon resolution.
