> ## Documentation Index
> Fetch the complete documentation index at: https://docs.uzolabs.xyz/llms.txt
> Use this file to discover all available pages before exploring further.
# BDEX API
> Reference for the public BDEX data API, such as pool and pair listings.
Read BDEX pools, pairs and tokens over HTTP, without querying the chain. BDEX is BOT Chain's decentralized exchange, with V2 and V3 pools. This data API needs no key. Every endpoint below was tested on both networks on 2026-10-01.
| Network | Base URL |
| - | - |
| Mainnet | `https://dex-wallet.botchain.ai` |
| Testnet | `https://dex-wallet.bohr.life` |
BOT Chain publishes its own API reference on Apifox, linked from the [DEX API reference page](https://dev-docs.botchain.ai/docs/DEX/api-reference/). 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](/reference/contract-addresses).
## List pairs
```bash pairs.sh theme={"dark"}
curl -s "https://dex-wallet.bohr.life/api/v1/pairs?pool_type=v2"
```
`all`, `v2` or `v3`.
One entry per pool.
Chain ID, 677 or 968.
Pool contract address.
`v2` or `v3`.
Address of the first token.
Address of the second token.
`true` if the request worked.
## List pools
Returns pools with volume, liquidity and fee statistics, sorted by total value locked (TVL), highest first.
```bash pools.sh theme={"dark"}
curl -s "https://dex-wallet.bohr.life/api/v1/pools?page_num=1&page_size=10&pool_type=all"
```
Page number, starting at 1.
Pools per page.
`all`, `v2` or `v3`.
One entry per pool.
Pool contract address.
Pair name, such as `USDT/WBOT`.
DEX name.
`v2` or `v3`.
Fee in hundredths of a basis point. `3000` is 0.30%.
Base token address.
Quote token address.
Pool balance of token0, in whole tokens.
Pool balance of token1, in whole tokens.
24-hour volume in the base token.
24-hour volume in the quote token.
24-hour volume in USD.
Change in volume.
24-hour fees in USD.
Fee APR, as a fraction.
Fully diluted value in USD.
Change in TVL.
Transactions in the last 24 hours.
Whether the requesting user has liquidity. `false` when no user is given.
Paging details: `count`, `page_num`, `page_size`, `pool_type`, `sort_by` (`tvl`), `sort_order` (`desc`) and `total`.
`0` on success.
`true` if the request worked.
USD values on testnet are not real. Test tokens have no real-world value.
## List tokens
Returns tokens known to BDEX, newest first.
```bash tokens.sh theme={"dark"}
curl -s "https://dex-wallet.bohr.life/api/v1/tokens"
```
One entry per token.
Internal ID.
Token contract address.
Chain ID.
Token symbol.
Token name.
Token decimals.
When the entry was last updated.
Creation time. Returned as `0001-01-01T00:00:00Z` for every token we checked.
Anyone can create a token, so this list includes test tokens and copies of real ones. On testnet it includes a second token named "USDT" with 18 decimals. Match tokens by address, using [Contract addresses](/reference/contract-addresses), never by symbol.
## 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](https://dev-docs.botchain.ai/docs/DEX/core-concepts/).
## Related pages
BDEX routers, factories and quoter.
Token and transaction data from BOTScan.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.