# Bluvo API Docs

## Docs

- [Api Keys](https://docs.bluvo.dev/api-keys.md): How to use your API keys for secure access to Bluvo
- [Deposit Address](https://docs.bluvo.dev/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://docs.bluvo.dev/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.
- [Get Supported Countries](https://docs.bluvo.dev/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 URL](https://docs.bluvo.dev/api-reference/oauth2/get-url.md): Get OAuth2 authorization URL for exchange connection.
- [List Exchanges](https://docs.bluvo.dev/api-reference/oauth2/list-exchanges.md): List supported exchanges for OAuth2 connections.
- [API key info](https://docs.bluvo.dev/api-reference/organizations/api-key-info.md): Get information about the current API key, including its permissions and rate limit configuration.
- [Delete](https://docs.bluvo.dev/api-reference/wallets/delete.md): Delete a connected exchange wallet.
- [Get](https://docs.bluvo.dev/api-reference/wallets/get.md): Get wallet information and balances.
- [Get KYC Identity](https://docs.bluvo.dev/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.
- [Get Transaction](https://docs.bluvo.dev/api-reference/wallets/get-transaction.md): Get a single transaction by its ID.
- [List Transactions](https://docs.bluvo.dev/api-reference/wallets/list-transactions.md): List transactions for a specific wallet or all wallets with filtering options.
- [List Wallets](https://docs.bluvo.dev/api-reference/wallets/list-wallets.md): List all connected exchange wallets.
- [Ping](https://docs.bluvo.dev/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.
- [Balance](https://docs.bluvo.dev/api-reference/withdrawals/balance.md): Get withdrawable balances and supported networks.
- [Quotation](https://docs.bluvo.dev/api-reference/withdrawals/quotation.md): Get withdrawal quote with fees and estimates.
- [Withdraw](https://docs.bluvo.dev/api-reference/withdrawals/withdraw.md): Execute a withdrawal using a quote ID.
- [Supported Exchanges](https://docs.bluvo.dev/exchanges.md): A comprehensive list of exchanges supported by Bluvo API
- [Introduction](https://docs.bluvo.dev/introduction.md): A quickstart guide to integrate with Bluvo API and streamline your crypto operations
- [iFrame vs. Whitelabel](https://docs.bluvo.dev/learn/iframe-vs-whitelabel.md): A technical comparison of headful iFrame widgets and headless whitelabel APIs for crypto exchange connectivity and withdrawal flows
- [OAuth2 Integration](https://docs.bluvo.dev/learn/oauth2-integration.md): Implement secure exchange authentication with Bluvo's OAuth2 popup flow, from exchange selection through wallet connection
- [Custom Domain](https://docs.bluvo.dev/learn/sdk/custom-domain.md): Route Bluvo API calls through your own domain using CNAME records and the customDomain SDK option
- [Error Handling](https://docs.bluvo.dev/learn/sdk/error-handling.md): Handle errors, exchange-specific 2FA behavior, and multi-step MFA verification in the Bluvo SDK state machine
- [OpenAPI SDK Generation](https://docs.bluvo.dev/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://docs.bluvo.dev/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
- [Encryption](https://docs.bluvo.dev/learn/security.md): How Bluvo secures exchange API keys and sensitive credentials
- [Agent Skills](https://docs.bluvo.dev/learn/skill.md): Make AI agents work with Bluvo by installing the skill.md capability file
- [Wallet Id](https://docs.bluvo.dev/learn/wallet-id.md): How to generate and manage walletIds, one per user per exchange
- [Quickstart](https://docs.bluvo.dev/quickstart.md): A quickstart guide to integrate with Bluvo API and streamline your crypto operations
- [error.fatal](https://docs.bluvo.dev/webhooks/events/error-fatal.md): Sent when an unrecoverable error occurs
- [quotation.created](https://docs.bluvo.dev/webhooks/events/quotation-created.md): Sent when a withdrawal quote is successfully generated
- [quotation.error](https://docs.bluvo.dev/webhooks/events/quotation-error.md): Sent when a withdrawal quote fails
- [transaction.broadcasted](https://docs.bluvo.dev/webhooks/events/transaction-broadcasted.md): Sent when a withdrawal is confirmed on-chain
- [transaction.created](https://docs.bluvo.dev/webhooks/events/transaction-created.md): Sent when a withdrawal is submitted to the exchange
- [transaction.error](https://docs.bluvo.dev/webhooks/events/transaction-error.md): Sent when a withdrawal fails
- [wallet.balance.updated](https://docs.bluvo.dev/webhooks/events/wallet-balance-updated.md): Sent when a wallet's balances are synced
- [wallet.created](https://docs.bluvo.dev/webhooks/events/wallet-created.md): Sent when a wallet is connected to your project via OAuth or API key
- [wallet.deleted](https://docs.bluvo.dev/webhooks/events/wallet-deleted.md): Sent when a wallet is disconnected from your project
- [Webhooks](https://docs.bluvo.dev/webhooks/introduction.md): Receive real-time notifications when events happen in your Bluvo project
- [Retries & Delivery Logs](https://docs.bluvo.dev/webhooks/retries-and-logs.md): How Bluvo retries failed deliveries and how to inspect delivery history
- [Verify Signatures](https://docs.bluvo.dev/webhooks/verify-signatures.md): Validate webhook authenticity using HMAC-SHA256 signatures

## OpenAPI Specs

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