> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bluvo.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenAPI SDK Generation

> Generate a server-side SDK in any language from Bluvo's OpenAPI spec, and use the provided TypeScript/React libraries for client-side orchestration

## Overview

Bluvo exposes a full [OpenAPI 3.1](https://spec.openapis.org/oas/v3.1.0) 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](https://openapi-generator.tech/) or [Speakeasy](https://speakeasyapi.dev/).

***

## OpenAPI Spec URLs

| Environment    | URL                                         |
| -------------- | ------------------------------------------- |
| Production     | `https://api-bluvo.com/api/v0/openapi`      |
| Test / Sandbox | `https://test.api-bluvo.com/api/v0/openapi` |

<Tip>
  You can paste either URL directly into your generator CLI. For example:

  ```bash theme={null}
  openapi-generator-cli generate -i https://api-bluvo.com/api/v0/openapi -g python -o ./bluvo-sdk
  ```
</Tip>

***

## 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:

| Package                                    | Links                                                                                                                  |
| ------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------- |
| `@bluvo/sdk-ts` — TypeScript state machine | [npm](https://www.npmjs.com/package/@bluvo/sdk-ts) · [source](https://github.com/bluvoinc/sdk/tree/main/packages/ts)   |
| `@bluvo/react` — React hooks & components  | [npm](https://www.npmjs.com/package/@bluvo/react) · [source](https://github.com/bluvoinc/sdk/tree/main/packages/react) |

***

## Next Steps

<CardGroup cols={2}>
  <Card title="State Machine Reference" icon="diagram-project" href="/learn/sdk/state-machine">
    Full list of states, transitions, hook booleans, and context data
  </Card>

  <Card title="Error Handling & 2FA" icon="triangle-exclamation" href="/learn/sdk/error-handling">
    Error recovery patterns and exchange-specific 2FA behavior
  </Card>

  <Card title="Endpoints" icon="cloud" href="/api-reference">
    Browse the full API reference generated from the OpenAPI spec
  </Card>
</CardGroup>