Synfin
Start building Launch app
Menu
Product

Developers

Docs SDK Widget Integrators Security
Launch app Start building
Docs menu

Synfin developer docs

Synfin is the best-execution and liquidity-routing layer for the Canton Network. One integration gives you live quotes from every Canton venue, ranked by worst-case net receive after all fees, and an execution path your own wallet runs.

What you get

  • Best-execution quotes. GET /api/quote returns every venue's quote with its network fee shown in its real application direction, ranked by net receive. With an API key, your own fee and Synfin's service fee appear as disclosed lines (clientFees) on every quote.
  • Execution plans. POST /api/execute/plan turns a chosen quote into a typed plan your wallet executes: the deposit step with the price floor computed server-side, the fee legs, an expiry, and an idempotency key.
  • Client-side tracking. Your wallet observes its own ledger view and derives the execution state. Synfin never holds funds or keys.

The integration ladder

  • Minutes: curl. The quote endpoint is public. Start with the quickstart, no key needed.
  • An API key: your fee on every quote. Attach feeBps and feeRecipient and keep 100 percent of your fee. Keys also unlock execution planning and higher rate limits.
  • The SDK: the full journey. Quote, plan, execute from your wallet, track to a terminal state. See the execution client guide.

Availability, honestly

  • Quotes are live across the integrated Canton venues today. A venue that cannot quote is returned as unavailable with a reason, never silently dropped.
  • Execution v1 supports Tradecraft, the venue with a proven end to end flow. More venues follow as their execution capabilities are verified.
  • The execution SDK ships to design partners today; a public package is planned. The plan endpoint is live for keyed callers.
  • Execution tracking is client-side in v1. A server-side status endpoint is planned; the states it will report are the same lifecycle the SDK derives today.

Swapping as a user?

The Synfin Launch App is the end-user swap surface on top of the same routing core. Its single service fee is documented plainly on How fees work.

Neutrality

Venues never pay for placement or ranking. Quotes are ordered by worst-case net receive after all fees and by nothing else. Every fee on a quote is a disclosed line with its real application direction. See how Synfin ranks a quote.

Get a key

API keys are free with rate limits. Sign up at the partner portal and mint yours; design partners can also reach a human at info@cayvox.com.