Skip to main content

Overview

Bluvo exposes a full OpenAPI 3.1 specification for its REST API. You can use it to auto-generate a type-safe, server-side SDK in any language — Go, Python, Rust, .NET, Java, Ruby, and more — with tools like openapi-generator or Speakeasy.

OpenAPI Spec URLs

EnvironmentURL
Productionhttps://api-bluvo.com/api/v0/openapi
Test / Sandboxhttps://test.api-bluvo.com/api/v0/openapi
You can paste either URL directly into your generator CLI. For example:
openapi-generator-cli generate -i https://api-bluvo.com/api/v0/openapi -g python -o ./bluvo-sdk

Client-Side SDK

The OpenAPI spec covers the REST API, but Bluvo’s withdrawal flow is driven by a client-side state machine that coordinates multi-step interactions (2FA, SMS verification, KYC prompts, etc.). For this you should use the provided libraries instead of generating from the spec:
PackageLinks
@bluvo/sdk-ts — TypeScript state machinenpm · source
@bluvo/react — React hooks & componentsnpm · source

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

Endpoints

Browse the full API reference generated from the OpenAPI spec