SaucerSwap API reference

SaucerSwap exposes two separate HTTP APIs. The REST API serves protocol data: tokens, prices, candlesticks, pools, positions, farms, and statistics. The Orderbook API serves the V3 order book: market data, quotes, order placement, cancellation, and WebSocket streams.

Two APIs at a glance

API	Best for	Authentication	Mainnet base URL
REST API	Prices, charts, pools, positions, farms, protocol stats	`x-api-key` header on every request	`https://api.saucerswap.finance`
Orderbook API	V3 order book market data, quotes, and trading	Public reads; wallet-JWT for account endpoints	`https://orderbook-api.saucerswap.finance`

Authentication comparison

The two APIs use different access models. Keys and tokens are not interchangeable between them.

Access model	Applies to	Credential	How you get it
API key	Every REST API endpoint	`x-api-key` header	Email [email protected]; see REST API authentication
Public read	Orderbook API market data: books, depth, trades, quotes, and the signature domain	None	No signup; see Orderbook market data
Wallet JWT	Orderbook API account endpoints: fees, onboarding, orders, cancels, and both WebSocket streams	`Authorization: Bearer <token>`	Sign a challenge with your account key; see Orderbook authentication

Base URLs

REST API:

Hedera network	Base URL
Mainnet	`https://api.saucerswap.finance`
Testnet	`https://test-api.saucerswap.finance`

Orderbook API:

Environment	Base URL
Mainnet	`https://orderbook-api.saucerswap.finance`
Testnet	`https://testnet-orderbook-api.saucerswap.finance`

Orderbook WebSocket streams use the same hosts with the wss:// scheme.

Endpoints by capability

I want to…	Start here
Get token prices and metadata	List all tokens
Build price charts (OHLCV candlesticks)	Token price history and latest candlesticks for all tokens
Read V1 pool reserves and history	List V1 pools
Read V2 pools, positions, and LARI rewards	List V2 pools and V2 positions by account
Read farm emissions and staked amounts	List active farms
Get protocol-wide TVL, volume, and staking stats	General statistics
Read the V3 order book, trade tape, and quotes	Orderbook market data
Place and cancel V3 orders programmatically	Orderbook orders
Stream live depth and order events	Orderbook WebSockets

Rate limits

The REST API enforces a monthly request quota per API key, agreed when your key is provisioned, and reports usage through x-ratelimit-* response headers. See REST API errors and rate limits. The Orderbook API applies rate and service-protection limits and returns 429 when they are exceeded, plus policy limits on order counts and deadlines. See Orderbook limits and errors. Teams planning sustained high-volume traffic should contact [email protected] to coordinate limits.

Next steps

REST API authentication

Request an API key and make your first authenticated call.

REST API conventions

Understand tinybar, smallest-unit amounts, timestamps, and intervals.

Orderbook API overview

Integrate with the V3 order book, from market data to order placement.

Developer quickstart

Make your first API call in under five minutes.

​Two APIs at a glance

​Authentication comparison

​Base URLs

​Endpoints by capability

​Rate limits

​Next steps