Custom Domain

Overview

By default, the Bluvo SDK sends requests to api-bluvo.com. The customDomain option lets you route traffic through your own domain instead (e.g., bluvo.my-company.com). Common reasons to do this:

Branding — keep all API traffic under your own domain
Compliance — satisfy internal policies that require first-party endpoints
Proxy control — route through your own infrastructure for logging or access control

DNS Setup

Create CNAME records pointing your subdomain to Bluvo’s servers.

Environment	Your Record	Points To
Production	`bluvo.my-company.com`	`api-bluvo.com`
Test / Sandbox	`test-bluvo.my-company.com`	`test.api-bluvo.com`

Verify CNAME propagation before testing. You can check with dig bluvo.my-company.com CNAME or any DNS lookup tool. Propagation typically takes a few minutes but can take up to 48 hours depending on your DNS provider.

CORS Configuration

No extra CORS setup is needed on your side. Bluvo’s API accepts requests from CNAME’d origins automatically.

SDK Configuration

The customDomain option in BluvoFlowClientOptions accepts three forms:

Form	Type	Behavior
Single string	`string`	Used for both API and WebSocket connections
Default literal	`"api-bluvo.com"`	No override — equivalent to omitting the option
Separate endpoints	`{ api: string, ws: string }`	Different domains for API calls and WebSocket connections

Usage Example

import { useBluvoFlow } from "@bluvo/react";

function WithdrawalFlow() {
  const flow = useBluvoFlow({
    orgId: "org_xxx",
    projectId: "proj_xxx",
    apiKey: "pk_xxx",
    customDomain: "bluvo.my-company.com",
  });

  // ... rest of your withdrawal UI
}

If you need separate domains for API and WebSocket traffic:

const flow = useBluvoFlow({
  orgId: "org_xxx",
  projectId: "proj_xxx",
  apiKey: "pk_xxx",
  customDomain: {
    api: "bluvo-api.my-company.com",
    ws: "bluvo-ws.my-company.com",
  },
});

Make sure your CNAME records are fully propagated before initializing the SDK with a custom domain. Requests will fail if the DNS records aren’t resolving yet.

Next Steps

State Machine Reference

Full list of states, transitions, hook booleans, and context data

Error Handling & 2FA

Error recovery patterns and exchange-specific 2FA behavior

Encryption & Security

How Bluvo encrypts and isolates exchange credentials

Code Samples

Full working examples for Next.js, React, and more

Get Started

Learn

SDK

More

Overview

DNS Setup

CORS Configuration

SDK Configuration

Usage Example

Next Steps

State Machine Reference

Error Handling & 2FA

Encryption & Security

Code Samples

​Overview

​DNS Setup

​CORS Configuration

​SDK Configuration

​Usage Example

​Next Steps

State Machine Reference

Error Handling & 2FA

Encryption & Security

Code Samples

Overview

DNS Setup

CORS Configuration

SDK Configuration

Usage Example

Next Steps