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

# Trading Overview

> Partner guide to the ZBX Trading API for crypto conversion and crypto–fiat flows.

The ZBX Trading API converts value across crypto assets and chains, and between crypto and fiat, using your managed balance accounts. Fund an account, call Quick Trade, and poll until settlement completes.

## Base URL

```
https://mapi.zbx.boomfi.xyz/v1
```

Authenticate with `X-API-KEY`. See [Authentication](/api/authentication) for API keys and [Authentication](/authentication) for request signing when required.

Trade endpoints appear in the API reference under Instruments, Quotes, and Orders.

## Flow

```mermaid theme={null}
sequenceDiagram
  participant Partner
  participant API as Trading API

  Note over Partner,API: Fund: deposit to virtual account wallet (GET /accounts/virtual)

  Partner->>API: POST /trade/quicktrade (dry_run true)
  API-->>Partner: estimate (rate, fees, receive amount)

  Partner->>API: POST /trade/quicktrade
  API-->>Partner: order_id · status Open · settlement_status Processing

  loop poll until terminal
    Partner->>API: GET /trade/order
    API-->>Partner: status Closed · settlement_status Completed
  end

  Note over Partner,API: Proceeds delivered to your account or an external settlement address
```

1. **Fund**: deposit crypto to your virtual account wallet for the chain (`GET /accounts/virtual` lists addresses).
2. **Estimate**: `POST /trade/quicktrade` with `dry_run: true` to price without executing.
3. **Execute**: the same call without `dry_run` quotes and executes, returning an `order_id`.
4. **Track**: poll `GET /trade/order` until the order is `Closed` and `settlement_status` is `Completed`.

## Guides

| Guide                                                 | Contents                                                      |
| ----------------------------------------------------- | ------------------------------------------------------------- |
| [Core Concepts](/trading/core-concepts)               | Accounts, assets, quotes, order lifecycle                     |
| [Trading API Guide](/trading/api-guide)               | Accounts, Quick Trade, Sweep Trade, orders, discovery, errors |
| [Advanced RFQ](/trading/advanced-rfq)                 | Lower-level quote / accept (prefer Quick Trade when you can)  |
| [Integration Playbook](/trading/integration-playbook) | Off-ramp, custody delivery, retries, reconciliation, go-live  |