Skip to main content

​
Welcome to Vulcx

Vulcx aggregates liquidity across the Fogo ecosystem to find the best swap execution for any token pair.

​
Why Vulcx?

  • Best-price routing. Multi-hop routing across Vortex, Fluxbeam, Fogo.fun, 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

EndpointMethodAuth requiredDescription
/api/v1/quoteGET✅Get the best route and estimated output for a token pair
/api/v1/swapPOST✅Build an unsigned swap transaction
/api/v1/instructionsPOST✅Get raw instructions for custom transaction composition
/api/v1/streamGET (WS)✅Live-updating quotes over a WebSocket
/api/v1/tokensGET—Curated list of well-known token mints
/healthGET—Service health check
Every endpoint requires an API key (Authorization: Bearer vulcx_...) except /health and /api/v1/tokens — 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" \
  -H "Authorization: Bearer $VULCX_KEY"

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

import os, requests

resp = requests.get(
    "https://api.vulcx.xyz/api/v1/quote",
    params={
        "inputMint": "So11111111111111111111111111111111111111112",
        "outputMint": "uSd2czE61Evaf76RNbq4KPpXnkiL3irdzgLFUMe3NoG",
        "amount": "1000000000",
        "swapMode": "ExactIn",
        "slippageBps": "50",
    },
    headers={"Authorization": f"Bearer {os.environ['VULCX_KEY']}"},
)
data = resp.json()["data"]
print(f"Output: {data['amountOut']}, Hops: {data['hopCount']}")
Every request above needs an API key — see Authentication for how to get one and use it. /health and /api/v1/tokens are the only endpoints that don’t require it.

​
Next steps

Supported Chains

Fogo capabilities and supported DEXs.

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.

Self-Hosted

Run the community binary on your own infra with your own FluxRPC key.
Last modified on July 5, 2026

Related topics

Swap routing — multi-hop best-price paths on FogoVulcx architecture — how swaps are routed on FogoComposing Swaps On-Chain (CPI)Changelogsdk.quote()