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 and Fluxbeam. Solana support is in progress — see Supported chains for current status.

Why Vulcx?

Best-price routing. Multi-hop routing across Valiant and Fluxbeam 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=uSd2czE61Evaf76RNbq4KPpXnkiL3irdzgLFUMe3NoG&outputMint=So11111111111111111111111111111111111111112&amount=10000000&swapMode=ExactIn&slippageBps=50"

const response = await fetch(
  "https://api.vulcx.xyz/api/v1/quote?" +
    new URLSearchParams({
      inputMint: "uSd2czE61Evaf76RNbq4KPpXnkiL3irdzgLFUMe3NoG", // USDC.s, 6 decimals
      outputMint: "So11111111111111111111111111111111111111112", // FOGO, 9 decimals
      amount: "10000000", // 10 USDC.s
      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": "uSd2czE61Evaf76RNbq4KPpXnkiL3irdzgLFUMe3NoG",  # USDC.s, 6 decimals
        "outputMint": "So11111111111111111111111111111111111111112",  # FOGO, 9 decimals
        "amount": "10000000",  # 10 USDC.s
        "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.

Trying /swap before you have a funded Fogo wallet? Send "skipSimulation": true./swap simulates the transaction it built and refuses to return one whose simulation failed — which is what you want in production, and not what you want while evaluating. A wallet with no FOGO and no token accounts fails that simulation with SIM_FAILED / AccountNotFound, and you get a 422 instead of a transaction. With skipSimulation you get the base64 transaction straight away and can inspect it without holding anything.

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