# 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.
- [Get Order](https://docs.bluvo.dev/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.
- [Place Order](https://docs.bluvo.dev/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.
- [Tradable Assets](https://docs.bluvo.dev/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…
- [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)