# Overview

Peach Aggregator is a BSC DEX aggregation service with a TypeScript SDK for route discovery, quote retrieval, transaction preparation, simulation, and swap execution.

### What It Does <a href="#what-it-does" id="what-it-does"></a>

Peach is built for integrators that need:

* **Route discovery** — find optimal swap paths across multiple DEX protocols
* **Quote retrieval** — get real-time price quotes with gas estimates and price impact
* **Transaction preparation** — build ready-to-sign approval and swap transactions

### Supported DEX Protocols <a href="#supported-dex-protocols" id="supported-dex-protocols"></a>

<table><thead><tr><th width="194.1015625">Provider</th><th width="218.83203125">Protocol</th><th>Description</th></tr></thead><tbody><tr><td><code>PANCAKEV2</code></td><td>PancakeSwap V2</td><td>AMM constant-product pools</td></tr><tr><td><code>PANCAKEV3</code></td><td>PancakeSwap V3</td><td>Concentrated liquidity pools</td></tr><tr><td><code>PANCAKE_INFINITY_CL</code></td><td>PancakeSwap Infinity CL</td><td>PancakeSwap Infinity concentrated liquidity</td></tr><tr><td><code>UNISWAPV3</code></td><td>Uniswap V3</td><td>Concentrated liquidity pools</td></tr><tr><td><code>UNISWAPV4</code></td><td>Uniswap V4</td><td>Singleton pool architecture</td></tr><tr><td><code>DODO</code></td><td>DODO</td><td>PMM (Proactive Market Maker) pools</td></tr><tr><td><code>THENA</code></td><td>Thena</td><td>ve(3,3) AMM pools</td></tr><tr><td><code>NOMISWAP_STABLE</code> </td><td>Nomiswap Stable</td><td>Stableswap-style pools</td></tr><tr><td><code>BISWAP</code> </td><td>BiSwap</td><td>AMM constant-product pools</td></tr><tr><td><code>APESWAP</code> </td><td>APESWAP</td><td>AMM constant-product pools</td></tr><tr><td><code>BABYDOGESWAP</code></td><td>BabyDogeSwap</td><td>AMM constant-product pools</td></tr><tr><td><code>BABYSWAP</code></td><td>BabySwap</td><td>AMM constant-product pools</td></tr></tbody></table>

All seven providers are enabled by default. You can restrict to specific providers via `options.providers` in `getQuote()`.

### Integration Entry Points <a href="#integration-entry-points" id="integration-entry-points"></a>

#### SDK <a href="#sdk" id="sdk"></a>

{% embed url="<https://www.npmjs.com/package/@peachprojects/aggregator-sdk>" %}

Use the SDK when you want the fastest integration path and a cleaner abstraction around quotes, approvals, and transaction building.

```ts
import { PeachClient, BSC_MAINNET_CONFIG } from "@peachprojects/aggregator-sdk";

const client = new PeachClient(config, provider?, options?);
```

Recommended flow:

1. `getQuote()` — retrieve a quote with routing details
2. `swap()` — build approval + swap transaction requests
3. Send transactions via your wallet/signer

#### API <a href="#api" id="api"></a>

Use the API directly when you want full control over the request layer and map Peach routing into your own internal models.

* `GET /router/find_routes` — returns route paths, amounts, gas estimate, and contract addresses
* `GET /router/status` — returns available providers and chainflow sync status


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.peach.ag/documentation/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.