Documentation

StableRoute docs

Everything you need to understand, operate and integrate the StableRoute liquidity router.

Overview

StableRoute is a liquidity router for stablecoin and fiat-backed token pairs on Stellar. Operators register routing pairs (for example USDC → EURC), configure fees and bounds, and expose a quoting API that wallets, payment apps and treasuries can call to find the best path for a transfer.

Quote

Instant price, fee and minimum-received for any registered pair.

Govern

Per-pair fees, min/max amounts, cooldowns and liquidity limits.

Protect

Emergency pause, timelocked admin handover and an audit log.

Architecture

StableRoute has three components, each in its own repository:

Frontend

Web console

Next.js app (this site) for quoting, pair management, stats and operator tools.

Backend

Routing API

Express + TypeScript service: pair registry, pricing engine, webhooks, API keys, metrics.

Contracts

Soroban router

Rust smart contract on Stellar that stores pairs, fees, bounds and pause state on-chain.

  Browser / wallet / app
          │  HTTPS (JSON)
          ▼
  ┌─────────────────────┐        ┌──────────────────────────┐
  │  StableRoute API    │  RPC   │  StableRouteRouter       │
  │  (Express, Vercel)  │ ─────▶ │  (Soroban, Stellar testnet)│
  │  quotes · pairs ·   │        │  pairs · fees · bounds · │
  │  webhooks · metrics │        │  pause · admin handover  │
  └─────────────────────┘        └──────────────────────────┘

How to use

1
Check the API is live
Open the Status page — it pings the routing API and reports latency.
2
Register a pair
Go to Pairs and add a source/destination asset pair such as USDC → EURC.
3
Get a quote
Open Quote, choose the pair and an amount, and review the route, fee and minimum received.
4
Monitor
Use Stats and Events to watch volume and audit activity.
5
Operate
Pause or resume routing from Admin; manage API keys and webhooks.

Routing API

Base URL: https://stableroute-backend.vercel.app. The full, interactive reference (Swagger UI) is at https://stableroute-backend.vercel.app/docs and the raw OpenAPI spec at /openapi.yaml.

GET /health: Liveness probe. Returns {"status":"ok"} when the API is up.; curl https://stableroute-backend.vercel.app/health
POST /api/v1/pairs: Register a (source, destination) routing pair. Idempotent.; curl -X POST https://stableroute-backend.vercel.app/api/v1/pairs \ -H "Content-Type: application/json" \ -d '{"source": "USDC", "destination": "EURC"}'
GET /api/v1/pairs: List every registered pair, with cursor pagination and ETag caching.; curl https://stableroute-backend.vercel.app/api/v1/pairs
GET /api/v1/quote: Quote a route for an amount: returns rate, fee, slippage and minimum received.; curl "https://stableroute-backend.vercel.app/api/v1/quote?source_asset=USDC&dest_asset=EURC&amount=100"
PATCH /api/v1/pairs/:src/:dest/fee_bps: Set the per-pair routing fee in basis points (0..1000).; curl -X PATCH https://stableroute-backend.vercel.app/api/v1/pairs/USDC/EURC/fee_bps \ -H "Content-Type: application/json" \ -d '{"fee_bps": 30}'

Smart contract

The StableRouteRouter Soroban contract is deployed on Stellar testnet.

Contract ID

CCKXEUALSDINT6FWCPZRK4BS5NJ5J5JBGM6GAKHSB6JAN7MOTWFI6IHD

View on stellar.expert ↗

Read-only calls you can try with the Stellar CLI:

stellar contract invoke --id CCKXEUALSDINT6FWCPZRK4BS5NJ5J5JBGM6GAKHSB6JAN7MOTWFI6IHD \
  --source <your-key> --network testnet -- version

stellar contract invoke --id CCKXEUALSDINT6FWCPZRK4BS5NJ5J5JBGM6GAKHSB6JAN7MOTWFI6IHD \
  --source <your-key> --network testnet -- \
  get_pair_info --source USDC --destination EURC

Resources

Overview

Quote

Instant price, fee and minimum-received for any registered pair.

Govern

Per-pair fees, min/max amounts, cooldowns and liquidity limits.

Protect

Emergency pause, timelocked admin handover and an audit log.

Architecture

StableRoute has three components, each in its own repository:

Frontend

Web console

Next.js app (this site) for quoting, pair management, stats and operator tools.

Backend

Routing API

Express + TypeScript service: pair registry, pricing engine, webhooks, API keys, metrics.

Contracts

Soroban router

Rust smart contract on Stellar that stores pairs, fees, bounds and pause state on-chain.

Browser / wallet / app │ HTTPS (JSON) ▼ ┌─────────────────────┐ ┌──────────────────────────┐ │ StableRoute API │ RPC │ StableRouteRouter │ │ (Express, Vercel) │ ─────▶ │ (Soroban, Stellar testnet)│ │ quotes · pairs · │ │ pairs · fees · bounds · │ │ webhooks · metrics │ │ pause · admin handover │ └─────────────────────┘ └──────────────────────────┘

How to use

Check the API is live

Open the Status page — it pings the routing API and reports latency.

Go to Pairs and add a source/destination asset pair such as USDC → EURC.

Get a quote

Open Quote, choose the pair and an amount, and review the route, fee and minimum received.

Monitor

Use Stats and Events to watch volume and audit activity.

Operate

Pause or resume routing from Admin; manage API keys and webhooks.

Routing API

Base URL: https://stableroute-backend.vercel.app. The full, interactive reference (Swagger UI) is at https://stableroute-backend.vercel.app/docs and the raw OpenAPI spec at /openapi.yaml.

GET /health

Liveness probe. Returns {"status":"ok"} when the API is up.

curl https://stableroute-backend.vercel.app/health

POST /api/v1/pairs

curl -X POST https://stableroute-backend.vercel.app/api/v1/pairs \
  -H "Content-Type: application/json" \
  -d '{"source": "USDC", "destination": "EURC"}'

GET /api/v1/pairs

List every registered pair, with cursor pagination and ETag caching.

curl https://stableroute-backend.vercel.app/api/v1/pairs

GET /api/v1/quote

Quote a route for an amount: returns rate, fee, slippage and minimum received.

curl "https://stableroute-backend.vercel.app/api/v1/quote?source_asset=USDC&dest_asset=EURC&amount=100"

PATCH /api/v1/pairs/:src/:dest/fee_bps

Set the per-pair routing fee in basis points (0..1000).

curl -X PATCH https://stableroute-backend.vercel.app/api/v1/pairs/USDC/EURC/fee_bps \
  -H "Content-Type: application/json" \
  -d '{"fee_bps": 30}'

Smart contract

The StableRouteRouter Soroban contract is deployed on Stellar testnet.

Contract ID

CCKXEUALSDINT6FWCPZRK4BS5NJ5J5JBGM6GAKHSB6JAN7MOTWFI6IHD

View on stellar.expert ↗

Read-only calls you can try with the Stellar CLI:

stellar contract invoke --id CCKXEUALSDINT6FWCPZRK4BS5NJ5J5JBGM6GAKHSB6JAN7MOTWFI6IHD \ --source <your-key> --network testnet -- version stellar contract invoke --id CCKXEUALSDINT6FWCPZRK4BS5NJ5J5JBGM6GAKHSB6JAN7MOTWFI6IHD \ --source <your-key> --network testnet -- \ get_pair_info --source USDC --destination EURC