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

# Exchange

> Convert between crypto and fiat (or between cryptos) directly from your business wallet.

![Exchange — Vita Wallet Business API](https://mintcdn.com/vitawallet-c171bb38/4UkKy-vACfHm2ccw/api-reference/_assets/exchange-hero.svg?fit=max\&auto=format\&n=4UkKy-vACfHm2ccw\&q=85\&s=ff51b5e8c6c7c7d14f06effac47bcd3b)

When a client needs to convert cryptocurrency to fiat, fiat to cryptocurrency, or one cryptocurrency to another, **Vita Business** provides the **Crypto Exchange** service. The exchange runs against your wallet at current market rates — the source amount is deducted from the sending currency and the destination amount is credited to the matching currency balance.

> [!NOTE]
>
> **Account activation required.** Crypto exchange must be enabled for your business account. Contact support if you don't have it available yet.

> [!WARNING]
>
> **Fiat-to-fiat exchanges are not supported.** Exchanges are only allowed between crypto and fiat, or between different cryptocurrencies.

> [!NOTE]
>
> **Signature coverage.** All exchange parameters — including `transactions_type` — must be included in the signature validation.

## Exchange flow

An exchange is always a two-step operation: you must query a current price before executing the trade.

**1. Get current prices**

`GET /crypto_prices` — returns the valid rates and a `valid_until` timestamp.

**2. Execute the exchange**

`POST /create_exchange` — submits the trade using the quoted price before it expires.

```mermaid theme={null}
sequenceDiagram
  participant App as Your App
  participant Vita as Vita Business API
  App->>Vita: GET /crypto_prices
  Vita-->>App: prices + valid_until
  App->>App: Build exchange payload
  App->>Vita: POST /create_exchange (within valid_until)
  Vita-->>App: Exchange confirmed
```


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