Skip to main content

​
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.
EnvironmentYour RecordPoints To
Productionbluvo.my-company.comapi-bluvo.com
Test / Sandboxtest-bluvo.my-company.comtest.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:
FormTypeBehavior
Single stringstringUsed 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