Developers

Arena API

REST and SSE for pool state and trades.

The Arena service runs the demo bot and serves pool state. Base URL: NEXT_PUBLIC_ARENA_API. POST routes need the x-admin-token header.

Method	Path	Returns
GET	`/health`	chain, block, bot status, version
GET	`/config`	hook, PoolManager, pools, fee config and params
GET	`/state`	block, oracle, mark, both pools with fee previews
GET	`/stats`	LP fee income and bot profit per pool, LPs kept more
GET	`/trades?limit=50&pool=aven\|control`	trades, newest first
GET	`/verify/:tx`	checks A and B for one swap
GET	`/stream`	SSE: state, trade, shock, bot
POST	`/shock`	push both pools off the market price
POST	`/bot/start · /bot/stop`	start or stop the arb bot

HyperEVM's RPC has no websockets and no mempool API (txpool_* isn't served), so the app polls blocks and shows your own transactions as pending until they land.

← Previous

Build a hook

Contracts

Aven · MIT · ETHGlobal MumbaiEdit on GitHub ↗