SnowballSwap API Documentation

Interactive API documentation with live testing capabilities for the Voi Network SnowballSwap API

POST /quote

▼

Generate a swap quote and unsigned transaction group. Supports both single-pool and multi-pool routing modes.

Input token ID (underlying token, not wrapped)
Output token ID (underlying token, not wrapped)
Amount to swap (in base units)
User's Algorand address (required for transaction generation)
Slippage tolerance as decimal (e.g., 0.01 for 1%, default: 0.01)
Pool contract ID (optional, omit for multi-pool routing)
Filter pools by DEX names as JSON array (e.g., ["humbleswap", "nomadex"])
JavaScript (Fetch)
cURL

POST /unwrap

▼

Build an atomic group that unwraps multiple tokens in one go.

User's Algorand address
Array of items to unwrap, each with wrappedTokenId and amount
JavaScript (Fetch)
cURL

GET /pool/:poolId

▼

Get information about a specific swap pool. The response structure varies by DEX type.

Pool contract ID
JavaScript (Fetch)
cURL

GET /config/pools

▼

Return configured pools for discovery.

JavaScript (Fetch)
cURL

GET /config/tokens

▼

Return discovered tokens with metadata.

JavaScript (Fetch)
cURL

GET /health

▼

Health check endpoint.

JavaScript (Fetch)
cURL