Skip to main content

Get RFQ convert assets

GET 
/config/convert

Returns the assets enabled for PRICE_GUARANTEE_CONVERT (the Convert product), their price rules, and the default order limits.

You can convert any returned asset to and from any other returned asset, so this endpoint returns a list of assets instead of a list of pairs. Derive the pairs you need from it.

Pairs and side

Convert requests are always side=BUY. A conversion from asset X to asset Y arrives as the pair Y-X, priced in X per 1 Y. For example, converting ADA to BTC arrives as BTC-ADA, priced in ADA per BTC.

A pair is enabled when both assets are in assets, unless Get RFQ markets returns a PRICE_GUARANTEE_CONVERT entry for that exact pair with enabled: false. Disabling a pair does not disable the reverse pair.

Price band

A Convert quote price outside the price band around the reference price is rejected with quoteTooWide. If Get RFQ markets returns a PRICE_GUARANTEE_CONVERT entry for the pair, its maxPriceDeviationBps sets the band for that pair. Pairs without an entry, or entries with maxPriceDeviationBps: null, use the default price band.

Price precision

The price precision of a pair comes from its quote asset X, the asset converted from:

  • At most priceDecimals digits after the decimal point.
  • At most pricePrecision significant digits, counted from the first non-zero digit.

If Get RFQ markets returns a PRICE_GUARANTEE_CONVERT entry for the pair, use its tickSize as the price increment for that pair instead.

Example

Assume BTC has priceDecimals: 16 and pricePrecision: 5, and SHIB has priceDecimals: 2 and pricePrecision: 5. Converting BTC to SHIB arrives as SHIB-BTC, priced in BTC, so quote 0.000000000061383 rather than 0.0000000000613835. Converting SHIB to BTC arrives as BTC-SHIB, priced in SHIB, so quote 16291000000 rather than 16291025269.

info

This is a private endpoint. To send requests, you need to authenticate. Your API key must have the View access permission.

Rate limit weight points: 1

Request​

Query Parameters

    rfqType string

    The type of RFQ. This endpoint only serves PRICE_GUARANTEE_CONVERT, which is also the default. Any other value returns an error.

    Example: PRICE_GUARANTEE_CONVERT

Responses​

The request was successful.

Schema
    rfqTypeRfqType (string)required

    The type of the RFQ. Possible values:

    • STABLECOIN_PARITY — EUR/EURC conversion at a 1:1 rate.
    • PRICE_GUARANTEE — the standard Price Guarantee RFQ for spot markets.
    • PRICE_GUARANTEE_UK — the Price Guarantee RFQ variant for United Kingdom customers. Markets are quoted in GBP.
    • PRICE_GUARANTEE_CONVERT — the Price Guarantee RFQ variant used for asset-to-asset conversions (the Convert product).

    Possible values: [STABLECOIN_PARITY, PRICE_GUARANTEE, PRICE_GUARANTEE_UK, PRICE_GUARANTEE_CONVERT]

    defaultMinOrderInEurstringnullable

    The minimum order value in EUR, applied to every convert pair.

    Example: 10
    defaultMaxOrderInEurstringnullable

    The maximum order value in EUR, applied to every convert pair.

    Example: 1000000
    assets object[]required

    The assets enabled for Convert. Every asset can be converted to and from every other asset in the list.

  • Array [
    • assetstringrequired

    The asset symbol.

    Example: BTC
    quantityDecimalsinteger<int32>required

    The maximum number of decimal places for an amount of this asset, whether it is the base or the quote asset of a pair.

    Example: 8
    priceDecimalsinteger<int32>required

    The maximum number of digits after the decimal point in the price, when this asset is the quote asset of a pair.

    Example: 16
    pricePrecisioninteger<int32>required

    The maximum number of significant digits in the price, counted from the first non-zero digit, when this asset is the quote asset of a pair.

    Example: 5
  • ]