Skip to main content

​
General

Fogo. See Supported Chains for capabilities and supported DEXs.
Any SPL token with liquidity on a supported DEX on Fogo: Vortex, Fluxbeam, Fogo.fun, or Moonit. If a direct pool doesn’t exist, the routing engine tries multi-hop paths through intermediate tokens like FOGO or USDC.If GET /api/v1/quote returns no route found, the token either has no listed pools or insufficient liquidity for the requested amount.

​
Quotes and pricing

Quotes reflect real-time pool state at the moment of the request. Prices can change between getting a quote and submitting the transaction. The otherAmountThreshold field enforces a minimum output (ExactIn) or maximum input (ExactOut) on-chain.Quotes don’t have an explicit TTL, but the transaction built from POST /api/v1/swap expires at lastValidBlockHeight (roughly 60 seconds).
  • ExactIn: You specify the exact input amount. The API estimates the output. Use when selling a specific amount (“sell exactly 1 FOGO”).
  • ExactOut: You specify the exact output amount. The API estimates the input needed. Use when buying a specific amount (“buy exactly 100 USDC”).
Both modes enforce slippage protection on-chain.
Two types of fees:
  1. Pool fees set by the DEX operators. Shown in feeBps in the quote response.
  2. Aggregator fee on certain routes. Shown in feeAmount in the swap/instructions response.
The amountIn and amountOut values already account for all fees. No hidden charges.

​
Technical

Not currently. The API operates on Fogo mainnet only. Devnet support may be added in the future.
Transactions have a 1232-byte limit. For multi-hop routes with many accounts, the API uses Address Lookup Tables (ALTs) to compress the transaction. If you use POST /api/v1/instructions, include the addressLookupTableAddresses when building a v0 transaction.
Default: 60 requests/minute, 10 requests/second burst. If you hit a 429 response, use exponential backoff (1s, 2s, 4s). Contact the team for higher limits for production integrations.
  • Use POST /api/v1/swap for the simplest integration. You get a ready-to-sign transaction.
  • Use POST /api/v1/instructions when you need to compose the swap with other instructions in a single transaction (e.g., creating token accounts, adding memos, closing accounts).
Both use the same routing engine and produce the same on-chain result.
Nothing. All swap instructions execute atomically on-chain. If any hop fails (insufficient liquidity, slippage exceeded, etc.), the entire transaction reverts. No partial fills, no stuck funds.
Call GET https://api.vulcx.xyz/health. It returns {"status": "ok"} when the service is running. For production integrations, poll this endpoint periodically and alert if it returns a non-200 status.
Last modified on July 5, 2026

Related topics

Supported chains — FogoSelf-hosting VulcxSwap fees — pool & aggregator fees explainedVulcx architecture — how swaps are routed on FogoComposing Swaps On-Chain (CPI)