Vulcx API reference — quote, swap & instructions

Base URL: https://api.vulcx.xyz All swap endpoints are under /api/v1. The API currently operates on Fogo.

An API key (Authorization: Bearer vulcx_...) is optional on REST endpoints — you can call /quote, /swap, /instructions, and /price with no key at all. Anonymous requests are capped at a small per-IP rate limit; add a free key for the full published budget. The WebSocket stream (GET /api/v1/stream) is the one exception — it always requires a key (?key=). See Authentication and Rate limits.

Response format

All responses use a consistent envelope: Success:

{
  "success": true,
  "data": { ... }
}

Error:

{
  "success": false,
  "error": "error message describing what went wrong"
}

HTTP status codes

Code	Meaning
`200`	Success
`400`	Bad request: invalid parameters, missing required fields
`401`	No API key was provided
`403`	The API key is invalid, disabled, or revoked
`404`	Not found: no route exists for the given token pair/amount
`429`	Rate limited: too many requests
`500`	Internal error: transaction build or simulation failed

Endpoints

Endpoint	Method	Auth required	Description
`GET https://api.vulcx.xyz/api/v1/quote`	GET	Optional	Get swap quote with routing details
`POST https://api.vulcx.xyz/api/v1/swap`	POST	Optional	Build unsigned swap transaction
`POST https://api.vulcx.xyz/api/v1/instructions`	POST	Optional	Get raw swap instructions
`WS wss://api.vulcx.xyz/api/v1/stream`	WS	✅	Stream live quotes over WebSocket
`GET https://api.vulcx.xyz/api/v1/price/:mint`	GET	Optional	Spot USD price for a token
`GET https://api.vulcx.xyz/health`	GET	—	Service health check

“Optional” means the endpoint works with no key, but is then subject to a small anonymous-tier rate limit rather than your plan’s rate limit. See Rate limits.

​Response format

​HTTP status codes

​Endpoints

Response format

HTTP status codes

Endpoints