# Bluvo API Docs

## Docs

- [Introduction](https://bluvo.mintlify.app/introduction.md): A quickstart guide to integrate with Bluvo API and streamline your crypto operations
- [Quickstart](https://bluvo.mintlify.app/quickstart.md): A quickstart guide to integrate with Bluvo API and streamline your crypto operations
- [Api Keys](https://bluvo.mintlify.app/api-keys.md): How to use your API keys for secure access to Bluvo
- [Agent Skills](https://bluvo.mintlify.app/learn/skill.md): Make AI agents work with Bluvo by installing the skill.md capability file
- [OAuth2 Integration](https://bluvo.mintlify.app/learn/oauth2-integration.md): Implement secure exchange authentication with Bluvo's OAuth2 popup flow, from exchange selection through wallet connection
- [Wallet Id](https://bluvo.mintlify.app/learn/wallet-id.md): How to generate and manage walletIds, one per user per exchange
- [iFrame vs. Whitelabel](https://bluvo.mintlify.app/learn/iframe-vs-whitelabel.md): A technical comparison of headful iFrame widgets and headless whitelabel APIs for crypto exchange connectivity and withdrawal flows
- [OpenAPI SDK Generation](https://bluvo.mintlify.app/learn/sdk/openapi.md): Generate a server-side SDK in any language from Bluvo's OpenAPI spec, and use the provided TypeScript/React libraries for client-side orchestration
- [State Machine](https://bluvo.mintlify.app/learn/sdk/state-machine.md): Complete reference for the @bluvo/sdk-ts state machine, all 35 flow states, hook booleans, context data, and callable actions
- [Error Handling](https://bluvo.mintlify.app/learn/sdk/error-handling.md): Handle errors, exchange-specific 2FA behavior, and multi-step MFA verification in the Bluvo SDK state machine
- [Custom Domain](https://bluvo.mintlify.app/learn/sdk/custom-domain.md): Route Bluvo API calls through your own domain using CNAME records and the customDomain SDK option
- [Supported Exchanges](https://bluvo.mintlify.app/exchanges.md): A comprehensive list of exchanges supported by Bluvo API
- [Encryption](https://bluvo.mintlify.app/learn/security.md): How Bluvo secures exchange API keys and sensitive credentials
- [Webhooks](https://bluvo.mintlify.app/webhooks/introduction.md): Receive real-time notifications when events happen in your Bluvo project
- [Verify Signatures](https://bluvo.mintlify.app/webhooks/verify-signatures.md): Validate webhook authenticity using HMAC-SHA256 signatures
- [Retries & Delivery Logs](https://bluvo.mintlify.app/webhooks/retries-and-logs.md): How Bluvo retries failed deliveries and how to inspect delivery history
- [wallet.created](https://bluvo.mintlify.app/webhooks/events/wallet-created.md): Sent when a wallet is connected to your project via OAuth or API key
- [wallet.balance.updated](https://bluvo.mintlify.app/webhooks/events/wallet-balance-updated.md): Sent when a wallet's balances are synced
- [wallet.deleted](https://bluvo.mintlify.app/webhooks/events/wallet-deleted.md): Sent when a wallet is disconnected from your project
- [quotation.created](https://bluvo.mintlify.app/webhooks/events/quotation-created.md): Sent when a withdrawal quote is successfully generated
- [quotation.error](https://bluvo.mintlify.app/webhooks/events/quotation-error.md): Sent when a withdrawal quote fails
- [transaction.created](https://bluvo.mintlify.app/webhooks/events/transaction-created.md): Sent when a withdrawal is submitted to the exchange
- [transaction.error](https://bluvo.mintlify.app/webhooks/events/transaction-error.md): Sent when a withdrawal fails
- [transaction.broadcasted](https://bluvo.mintlify.app/webhooks/events/transaction-broadcasted.md): Sent when a withdrawal is confirmed on-chain
- [error.fatal](https://bluvo.mintlify.app/webhooks/events/error-fatal.md): Sent when an unrecoverable error occurs
- [Get URL](https://bluvo.mintlify.app/api-reference/oauth2/get-url.md): Get OAuth2 authorization URL for exchange connection.
- [List Exchanges](https://bluvo.mintlify.app/api-reference/oauth2/list-exchanges.md): List supported exchanges for OAuth2 connections.
- [Get Supported Countries](https://bluvo.mintlify.app/api-reference/oauth2/get-supported-countries.md): Returns the list of countries where the specified exchange is available for OAuth2 connectivity. For geo-restricted exchanges (e.g. `binance-web`, `bybit-web`), the response contains the explicit list of supported countries. For exchanges with no geo-restrictions, an empty array is returned — meanin…
- [Get Tickers](https://bluvo.mintlify.app/api-reference/market/get-tickers.md): Public endpoint (no API key required) returning the latest ticker prices in USD for the given exchange. Prices are refreshed from the exchange every ~30 seconds and served from Bluvo's cache. Asset symbols are normalized to Bluvo style (e.g. Kraken's `XDG` is returned as `DOGE`, `XBT` as `BTC`). Use…
- [Get](https://bluvo.mintlify.app/api-reference/wallets/get.md): Get wallet information and balances.
- [Delete](https://bluvo.mintlify.app/api-reference/wallets/delete.md): Delete a connected exchange wallet.
- [Ping](https://bluvo.mintlify.app/api-reference/wallets/ping.md): Test wallet connectivity and validate exchange API credentials. This endpoint verifies that the stored credentials are valid by making a test API call to the exchange.
- [Get KYC Identity](https://bluvo.mintlify.app/api-reference/wallets/get-kyc-identity.md): Retrieve KYC identity information associated with a wallet. Returns the user's full name, email, IBAN, and country as provided by the exchange during the OAuth flow. Returns 404 if the wallet has no linked identity.
- [List Wallets](https://bluvo.mintlify.app/api-reference/wallets/list-wallets.md): List all connected exchange wallets.
- [List Transactions](https://bluvo.mintlify.app/api-reference/wallets/list-transactions.md): List transactions for a specific wallet or all wallets with filtering options.
- [Get Transaction](https://bluvo.mintlify.app/api-reference/wallets/get-transaction.md): Get a single transaction by its ID.
- [Balance](https://bluvo.mintlify.app/api-reference/withdrawals/balance.md): Get withdrawable balances and supported networks.
- [Quotation](https://bluvo.mintlify.app/api-reference/withdrawals/quotation.md): Get withdrawal quote with fees and estimates.
- [Withdraw](https://bluvo.mintlify.app/api-reference/withdrawals/withdraw.md): Execute a withdrawal using a quote ID.
- [Tradable Assets](https://bluvo.mintlify.app/api-reference/trading/tradable-assets.md): List tradable assets and trading routes for an exchange. Provide either the x-bluvo-wallet-id header or the exchange query parameter. When both are provided, the wallet header wins and the wallet exchange is used. Optional source and destination filters limit the returned routes and prune the assets…
- [Place Order](https://bluvo.mintlify.app/api-reference/trading/place-order.md): Place a spot order on the connected exchange using a route from the tradable assets endpoint. Kraken is supported first; the API calls the wallet client's modular trading method so additional exchanges can implement the same contract later.
- [Get Order](https://bluvo.mintlify.app/api-reference/trading/get-order.md): Get the latest status for an exchange order. Clients can poll this endpoint until the normalized status is filled, canceled, or expired.
- [Deposit Address](https://bluvo.mintlify.app/api-reference/deposits/deposit-address.md): Get or create a deposit address for a specific asset and network (network and asset must follow the same shaped used in the quotation endpoint).
- [Withdrawal Fee](https://bluvo.mintlify.app/api-reference/info/withdrawal-fee.md): Get withdrawal fee and minimum amount information for a given asset without creating a quote. Returns fee details per network.
- [API key info](https://bluvo.mintlify.app/api-reference/organizations/api-key-info.md): Get information about the current API key, including its permissions and rate limit configuration.

## OpenAPI Specs

- [openapi](https://api-bluvo.com/api/v0/openapi)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.