Skip to main content

​
OAuth2 Integration

​
Overview

Bluvo’s OAuth2 integration enables your users to securely connect their exchange accounts without exposing raw API keys. Instead of handling sensitive credentials, your application simply receives encrypted wallet IDs, which Bluvo resolves internally with enterprise-grade encryption. This integration can be implemented at different levels of complexity, depending on your team’s needs and the amount of development effort you want to invest.

​
Integration Levels

You can choose how “raw” or “abstracted” your integration should be:
  1. REST API (lowest-level, raw implementation) Directly integrate against the REST API. Gives you full control, but requires implementing the entire flow yourself. Effort: ~3–4 weeks
  2. Server SDK Wraps the REST API and authentication into your chosen language (TypeScript, Go, Dart, Rust). Developers still need to build out the whole flow, so it can have some friction. Effort: ~3 weeks
  3. Client State Machine SDK + Server SDK You only need to build your Widget UI. A provided State Machine orchestrates the flow and error handling for you. Effort: ~5 days
  4. React State Machine Library The State Machine approach, already wrapped for React: @bluvo/react. Other frameworks (Svelte, React Native, Flutter, Vue) coming soon. Effort: ~24 hours
  5. Vanilla JS Widget + Server SDK Provides an embeddable UI widget for the OAuth2 flow. Just plug it in, and pair it with the Server SDK for backend actions. Effort: ~24 hours
  6. Framework Widgets Prebuilt UI widgets for React, Svelte, Vue, Angular, React Native (Flutter coming soon). Effort: ~24 hours

​
Why This Matters

Regardless of which path you choose:
  • Users authenticate directly with their exchange, no raw API keys required.
  • Developers work at the level they’re comfortable with, from raw APIs to plug-and-play widgets.
  • Security stays consistent: wallet IDs replace sensitive tokens, with Bluvo managing encryption, refreshes, and compliance in the background.

​
Next Steps

Choose your integration level:

​
Whitelabel (use your own branding):

​
Widgets (prebuilt UI):

👉 This way, you can decide how much effort to invest in integration, from building everything yourself to going live in a day with prebuilt widgets.
⌘I