Learn/Developers

DeadBox Public REST API

DeadBox Public REST API reference

6 min readDevelopers

The DeadBox API provides public REST endpoints for accessing historical on-chain data, aggregated statistics, and real-time metrics. The API is free to use and requires no authentication.

Stats Endpoints

GET /api/stats returns current ecosystem statistics including total burned, circulating supply, lifetime dividends, holder count, and token prices. GET /api/stats/history?metric=supply&period=30d&token=DEAD returns historical data points for charting.

Burns Endpoints

GET /api/burns?period=30d&chain=base returns daily burn data for charts. GET /api/burns/total returns total burned across all chains with per-chain breakdown. GET /api/burns/recent?limit=20 returns the latest burn transactions.

Dividends Endpoints

GET /api/dividends/total returns lifetime dividend payouts across all reward tokens with USD values and 24h/7d/30d breakdowns. GET /api/dividends/{address} returns a user's claim history. GET /api/dividends/recent returns latest payout events.

Grave Digs Endpoints

GET /api/grave-digs?limit=20&chain=base returns recent grave dig events. GET /api/grave-digs/leaderboard?limit=10 returns the top grave diggers ranked by total tokens claimed.

Interactive Documentation

Full interactive API documentation with request/response examples is available at the /scalar/v1 endpoint on the API server. You can test all endpoints directly from your browser.