Welcome to Vulcx

Vulcx is a swap aggregator for SVM chains — networks running the Solana Virtual Machine. It aggregates liquidity across every DEX on a chain to find the best execution for any token pair, behind one chain-independent API. Vulcx is live on Fogo today, routing across Valiant, Fluxbeam, and Moonit. Solana support is in progress — see Supported chains for current status.

Why Vulcx?

Best-price routing. Multi-hop routing across Valiant, Fluxbeam, and Moonit bonding curves to find optimal execution.
Fast execution. Get a quote and build a ready-to-sign transaction in a single API call.
Simple integration. Three endpoints cover the entire swap lifecycle: quote, build transaction, submit.

Endpoints

Endpoint	Method	Auth required	Description
`/api/v1/quote`	GET	Optional	Get the best route and estimated output for a token pair
`/api/v1/swap`	POST	Optional	Build an unsigned swap transaction
`/api/v1/instructions`	POST	Optional	Get raw instructions for custom transaction composition
`/api/v1/stream`	GET (WS)	✅	Live-updating quotes over a WebSocket
`/health`	GET	—	Service health check

An API key (Authorization: Bearer vulcx_...) is optional on REST endpoints — anonymous calls work but are capped at a small per-IP rate limit; a key raises that to the full published budget. The WebSocket stream always requires one. See Authentication.

Quick example

Get a quote for swapping 1 FOGO to USDC on Fogo:

curl "https://api.vulcx.xyz/api/v1/quote?inputMint=So11111111111111111111111111111111111111112&outputMint=uSd2czE61Evaf76RNbq4KPpXnkiL3irdzgLFUMe3NoG&amount=1000000000&swapMode=ExactIn&slippageBps=50"

const response = await fetch(
  "https://api.vulcx.xyz/api/v1/quote?" +
    new URLSearchParams({
      inputMint: "So11111111111111111111111111111111111111112",
      outputMint: "uSd2czE61Evaf76RNbq4KPpXnkiL3irdzgLFUMe3NoG",
      amount: "1000000000",
      swapMode: "ExactIn",
      slippageBps: "50",
    })
);
const { data } = await response.json();
console.log(`Output: ${data.amountOut}, Hops: ${data.hopCount}`);

import requests

resp = requests.get(
    "https://api.vulcx.xyz/api/v1/quote",
    params={
        "inputMint": "So11111111111111111111111111111111111111112",
        "outputMint": "uSd2czE61Evaf76RNbq4KPpXnkiL3irdzgLFUMe3NoG",
        "amount": "1000000000",
        "swapMode": "ExactIn",
        "slippageBps": "50",
    },
)
data = resp.json()["data"]
print(f"Output: {data['amountOut']}, Hops: {data['hopCount']}")

The example above works with no API key — anonymous requests are capped at a small per-IP rate limit. See Authentication for how to get a free key and the full published budget.

Next steps

Supported Chains

Which SVM chains are live — Fogo now, Solana in progress.

Architecture

High-level overview of how Vulcx routes and executes swaps.

API Reference

Full endpoint documentation with Try It.

Executing Swaps

End-to-end guide for your first swap.

Get Started

Introduction to Vulcx — best-price swaps on SVM chains

Welcome to Vulcx

Why Vulcx?

Endpoints

Quick example

Next steps

Supported Chains

Architecture

API Reference

Executing Swaps

​Welcome to Vulcx

​Why Vulcx?

​Endpoints

​Quick example

​Next steps

Supported Chains

Architecture

API Reference

Executing Swaps

Welcome to Vulcx

Why Vulcx?

Endpoints

Quick example

Next steps