Authentication

Many API requests require an API key, typically passed via the x-api-key header.

Some read-only endpoints are available without authentication. When an endpoint is public, the API reference calls that out explicitly.

Getting an API Key

Get a free API key at app.venum.dev.

Plans start at $49/mo with 10K quotes/day and unlimited swap builds + submits.

Include the x-api-key header on authenticated requests:

bash

curl -X POST https://api.venum.dev/v1/quote \
  -H "Content-Type: application/json" \
  -H "x-api-key: vk_live_your_key_here" \
  -d '{ ... }'

typescript

const headers = {
  'Content-Type': 'application/json',
  'x-api-key': process.env.VENUM_API_KEY,
};

Missing or invalid key returns 401:

json

{
  "error": "Invalid or missing API key"
}

Always use HTTPS (https://api.venum.dev)
Optional plain HTTP is also available at http://api.venum.dev for server-to-server clients that explicitly want to avoid TLS overhead.
Do not use plain HTTP unless you understand and accept the lack of transport encryption.
Never expose your API key in client-side code or public repositories