BOT Chain publishes its own API reference on Apifox, linked from the DEX API reference page. We couldn’t load the Apifox pages on 2026-10-01, so this page covers only the endpoints we tested.
BDEX swaps use a routing API to find the best path between tokens. Its base URL is not public, so it is not covered here. To quote a swap on chain, call the QuoterV2 contract listed in Contract addresses.
List pairs
pairs.sh
string
default:"all"
all, v2 or v3.object[]
One entry per pool.
boolean
true if the request worked.List pools
Returns pools with volume, liquidity and fee statistics, sorted by total value locked (TVL), highest first.pools.sh
number
Page number, starting at 1.
number
Pools per page.
string
default:"all"
all, v2 or v3.object[]
One entry per pool.
object
Paging details:
count, page_num, page_size, pool_type, sort_by (tvl), sort_order (desc) and total.number
0 on success.boolean
true if the request worked.List tokens
Returns tokens known to BDEX, newest first.tokens.sh
object[]
One entry per token.
Fees
BDEX V2 pools charge 0.30% per swap. V3 pools use fee tiers of 0.05%, 0.30% or 1.00%. Source: BOT Chain’s DEX core concepts.Related pages
Contract addresses
BDEX routers, factories and quoter.
Explorer API
Token and transaction data from BOTScan.