# Synfin

> Synfin is the best-execution and liquidity-routing layer for the Canton Network, built for wallets, apps, institutions, and agents. One integration returns live quotes from every Canton venue ranked by worst-case net receive after all fees, turns a chosen quote into an execution plan the user's own wallet runs, and tracks execution client-side. Neutral by design: venues compete on price alone.

Last updated: 2026-07-24. The quote API is public (no key). An API key (free, rate limited, self-serve at https://portal.synfin.xyz) adds disclosed integrator fee lines (partners set 0 to 10 bps and keep 100 percent) and the execution plan endpoint. Every example in the docs was run against production.

## Docs

- [Overview](https://synfin.xyz/docs): What Synfin gives a developer: best-execution quotes with disclosed fees, execution plans your wallet runs, client-side tracking, and the integration ladder.
- [Quickstart](https://synfin.xyz/docs/quickstart): First quote in one curl, then a keyed quote with your fee attached, with real captured responses.
- [GET /api/quote](https://synfin.xyz/docs/api/quote): Full reference: params, keyed vs keyless, the response shape (venues, clientFees, appliedSchema), caching, and every 400 case.
- [POST /api/execute/plan](https://synfin.xyz/docs/api/execute-plan): The plan endpoint: request, the plan shape (steps, server-computed memo floor, expiry, idempotencyKey), quote pinning, and the v1 boundary.
- [Errors](https://synfin.xyz/docs/api/errors): The full taxonomy (400, 401, 429 with Retry-After, 500, 503 identity-unverifiable) with captured bodies, plus the failure playbook.
- [Rate limits](https://synfin.xyz/docs/api/rate-limits): 60/min per IP keyless, 600/min per key default, X-RateLimit headers, block-not-bill, and the approximate-under-concurrency note.
- [Earn with your fee](https://synfin.xyz/docs/earn): Partners set 0 to 10 bps and keep 100 percent; the fee table and a worked example; the flat 10 bps service fee stated plainly.
- [Execution lifecycle](https://synfin.xyz/docs/lifecycle): The states (INITIATED, VENUE_ACCEPTED, COMPLETED, SLIPPAGE_FAILED, REFUNDED, ABORTED), refund semantics, and the per-venue floor guarantee.
- [SDK execution client](https://synfin.xyz/docs/sdk): quote to plan to executePlan with hooks to track, the wallet-adapter interface, and why tracking is client-side.
- [Changelog](https://synfin.xyz/docs/changelog): Shipped milestones, dated.

## Product

- [Partners](https://synfin.xyz/partners): Who Synfin is for, how integration works, what partners earn, and the honest current state of the program.
- [Security](https://synfin.xyz/security): The security posture: non-custodial by construction, server-side floors, the escrow-coupled fee design (devnet-proven, mainnet pending), and responsible disclosure.
- [Status](https://synfin.xyz/status): Live operational status of the quote API, execution planning, and the website, from real measured checks.
- [Swap](https://synfin.xyz/swap): The Synfin Launch App: swap Canton assets at the best available price, guaranteed minimum enforced on-ledger, one signature, non-custodial. (The former /demo address redirects here.)
- [How fees work](https://synfin.xyz/docs/fees): The Launch App's 20 bps service fee, stated plainly: embedded in the price, charged in Canton Coin, shown before you sign, never taken from your output.
- [Fee semantics](https://synfin.xyz/spec-notes): How quotes are ranked and how fee direction (on top vs deducted from give) changes what you receive.
- [Landing](https://synfin.xyz/): What Synfin is.

## Contact

- API keys and partnership: info@cayvox.com