---
title: "Get quote"
method: GET
path: "/convert_withdraw/rfq"
tags: ["Convert and Withdraw"]
---

# Get quote

`GET /convert_withdraw/rfq`

## Request

- Base URL: `https://api.cert.zerohash.com`
- URL: `https://api.cert.zerohash.com/convert_withdraw/rfq`
- Auth: API key in header `X-SCX-API-KEY` and API key in header `X-SCX-PASSPHRASE`

Retrieves a quote for the purchase of an asset and the network fees associated with an imminent and automatic withdrawal of the asset. Exactly one of `quantity` or `total` must be supplied.

## Query parameters

- `side` 'buy' | 'sell', required
- `underlying` 'AAVE.ETH' | 'ADA' | 'ALGO' | 'AVAX' | 'BAT.ETH' | 'BCH' | 'BTC' | 'BUSD.ETH' | 'COMP.ETH' | 'DAI.ETH' | 'DOGE' | 'DOT' | 'EGLD' | 'EOS' | 'ETC' | 'ETH' | 'ETH.ARBITRUM' | 'GRT.ETH' | 'GYEN.ETH' | 'HBAR' | 'LINK.ETH' | 'LTC' | 'LUNA' | 'MATIC.ETH' | 'MATIC.POLYGON' | 'MKR.ETH' | 'MOB' | 'SAND.ETH' | 'SOL' | 'UNI.ETH' | 'USDC.ETH' | 'USDC.ALGO' | 'USDC.POLYGON' | 'USDC.SOL' | 'USDC.HBAR' | 'USDC.XLM' | 'USDC.AVAX' | 'USDT.ETH' | 'UST' | 'WBTC.ETH' | 'XEM' | 'XLM' | 'XRP' | 'XTZ' | 'ZUSD.ETH', required: the underlying asset
- `quoted_currency` 'CAD' | 'EUR' | 'GBP' | 'JPY' | 'MXN' | 'USD', required: the quoted asset
- `quantity` string
- `total` string
- `participant_code` string
- `account_label` string
- `withdrawal_address` string, required
- `fee_inclusive` boolean
- `spread` string
- `destination_tag` string
- `no_destination_tag` string
- `beneficiary_participant_code` string
- `beneficiary_first_name` string
- `beneficiary_last_name` string
- `beneficiary_business_name` string

## Headers

- `X-SCX-SIGNED` string, required
- `X-SCX-TIMESTAMP` string, required

## Response `200`

Successfully generated convert-and-withdraw quote. Returns the quote envelope (`{ message: {...} }`) with pricing, network fees, and an ephemeral `quote_id`.

- GetRequestForCWQuoteResponse
  - `message` CWQuoteEntity
    - `request_id` string: The identifier of the RFQ
    - `participant_code` string: The identifier of the participant making the quote request
    - `quoted_currency` 'CAD' | 'EUR' | 'GBP' | 'JPY' | 'MXN' | 'USD': the quoted asset
    - `side` 'buy' | 'sell': The participant side of the quote
    - `quantity` string: The amount of the underlying currency
    - `price` string: The cost per unit of underlying currency
    - `quote_id` string: The identifier for the quote Note: this is required to execute the quote
    - `expire_ts` number: Timestamp when the quote will expire
    - `account_group` string: The group that the account is a part of
    - `account_label` string: The account label associated with the account
    - `obo_participant` OBOParticipantEntity
      - `participant_code` string: The identifier of the participant making the request
      - `account_group` string: The identifier of the the account group
      - `account_label` string: The account label associated with the account
    - `network_fee_notional` string: fee notional in the currency quoted on the RFQ
    - `network_fee_quantity` string: fee quantity in the underlying asset
    - `withdrawal_fee_type` integer: Indicates the withdrawal fee schedule applied to this quote (0 = flat/default, non-zero values indicate a tiered schedule).
    - `withdrawal_fee_tiers_list` object[]: Withdrawal fee tier schedule applied to this quote. Empty when `withdrawal_fee_type` is 0 (no tiered schedule).
    - `total_notional` string: Total notional is the full cost inclusive of fees or the total proceeds after fees
    - `underlying` 'AAVE.ETH' | 'ADA' | 'ALGO' | 'AVAX' | 'BAT.ETH' | 'BCH' | 'BTC' | 'BUSD.ETH' | 'COMP.ETH' | 'DAI.ETH' | 'DOGE' | 'DOT' | 'EGLD' | 'EOS' | 'ETC' | 'ETH' | 'ETH.ARBITRUM' | 'GRT.ETH' | 'GYEN.ETH' | 'HBAR' | 'LINK.ETH' | 'LTC' | 'LUNA' | 'MATIC.ETH' | 'MATIC.POLYGON' | 'MKR.ETH' | 'MOB' | 'SAND.ETH' | 'SOL' | 'UNI.ETH' | 'USDC.ETH' | 'USDC.ALGO' | 'USDC.POLYGON' | 'USDC.SOL' | 'USDC.HBAR' | 'USDC.XLM' | 'USDC.AVAX' | 'USDT.ETH' | 'UST' | 'WBTC.ETH' | 'XEM' | 'XLM' | 'XRP' | 'XTZ' | 'ZUSD.ETH': the underlying asset
    - `asset_cost_notional` string: asset_cost_notional is a field that shows the notional cost of the asset
    - `withdrawal_address` string: The whitelisted withdrawal address to withdraw funds to
    - `payment_processor` object
      - `name` string: The name of the payment processor
      - `id` string: The unique identifier of the payment according to the PSP
    - `spread_notional` string: The notional spread applied to the quote
    - `spread_bps` string: The basis points spread to apply to the quote
    - `commission_notional` string: The notional commission applied to the quote
    - `commission_bps` string: The commission in basis points applied to the quote

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error
- `503`: Service Unavailable

## Changes

- **2026-11-03** `47cf70ae701c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zerohash/apis/zerohash-api/changes/convert_withdraw/rfq/get.md)

---

[API](https://skmtc.dev/zerohash/apis/zerohash-api.md) - [All operations](https://skmtc.dev/zerohash/apis/zerohash-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zerohash/apis/zerohash-api/revisions/47cf70ae701c?raw)