Documentation
chop is a DEX aggregator API for the TON blockchain. It quotes DeDust and StonFi in parallel, picks the best route, splits orders when it helps, and returns ready-to-sign transactions. This is a stateless HTTP API — no API keys, no user accounts.
Quickstart
Fetch your first quote in five lines of code.
POST /v1/quote
Get the best route across all DEXs for a swap.
POST /v1/tx
Build a signed transaction from a quote.
Routing & splitting
How chop decides between single-DEX and split routes.
Multi-hop
Atomic two-pool swaps when no direct pair exists.
TonConnect integration
Wire chop into a browser dapp with the official TonConnect kit.
Conventions
- Base URL:
https://chop.ag/api/v1 - Content type: all requests and responses are JSON. Send
Content-Type: application/json. - Amounts are always sent and returned as strings of smallest units (no fractional). For TON that means nanoton (10⁻⁹). For a jetton, that means its on-chain decimals.
- Assets are either the literal string
"TON"for native TON, or the bounceable jetton master address (theEQ…form). - Errors return non-2xx with
{ "error": "..." }. See Errors.