DxSpot Team

June 15, 2026

~1 min read

The Rates section provides methods for obtaining actual exchange rates on the DxSpot platform. A rate is understood as the ratio of one currency to another within a certain trading pair (for example, BTC → USDT).

This data allows you to build exchange calculators, display actual quotes to the user, and determine how much of the target currency you will receive when exchanging. In this section, a method is available for obtaining one specific rate in JSON format.

GET

rates/public/one

Endpoint URL

https://dxspot.io/api/v2/rates/public/one

Documentation

General Description

The request returns the calculation of a single exchange rate for a given pair of instruments and deposit amount.

HTTP Request

Method: GET
URL: https://dxspot.io/api/v2/rates/public/one

Request Example

curl -X GET \
 'https://dxspot.io/api/v2/rates/public/one
  ?instrumentFromCurrencyTitle=BTC
  &instrumentFromNetworkTitle=BTC
  &instrumentToCurrencyTitle=USDT
  &instrumentToNetworkTitle=TRC20
  &instrumentFromSlug=btc
  &instrumentToSlug=usdttrc20
  &claimedDepositAmountCurrency=BTC
  &rateMode=fixed
  &referrerId=123
  &claimedDepositAmount=0.082539
  &markup=0.0
  &exchangeType=crypto' \
-H 'accept: application/json'

Request Parameters

Query Parameters

Parameter	Type	Required	Description
instrumentFromCurrencyTitle	string	yes	The currency code the user gives (e.g., BTC).
instrumentFromNetworkTitle	string	yes	Network of the source instrument (BTC, ERC20, TRC20).
instrumentToCurrencyTitle	string	yes	The currency code the user receives (e.g., USDT).
instrumentToNetworkTitle	string	yes	Network of the target instrument (TRC20, ERC20).
instrumentFromSlug	string	no	Slug of the source instrument within Dxspot system (btc).
instrumentToSlug	string	no	Slug of the target instrument (usdttrc20).
claimedDepositAmountCurrency	string	yes	Currency code in which the deposit amount is specified.
claimedDepositAmount	number	no	Amount the user intends to send.
rateMode	string	no	Rate mode: fixed or float.
exchangeType	string	yes	Operation type: crypto / fiat / stablecoin.
referrerId	number	no	Partner ID.
markup	number	no	Partner’s markup on the rate (%).

Response Format

The method returns a JSON object with information about the selected pair, calculated amounts, rates, and limits.

Response Example

{
  "instrumentFrom": {
    "currencyTitle": "BTC",
    "networkTitle": "BTC",
    "slug": "btc",
    "precisionDecimals": 7
  },
  "instrumentTo": {
    "currencyTitle": "USDT",
    "networkTitle": "TRC20",
    "slug": "usdttrc20",
    "precisionDecimals": 2
  },
  "claimedDepositAmount": "0.082539",
  "depositRules": null,
  "platformFee_Absolute": "",
  "withdrawalRules": null,
  "minConfirmationsToWithdraw": 3,
  "minConfirmationsToTrade": 3,
  "updatedAt": 1764661006130,
  "liquidityProviderPublicCode": "hat",
  "amountToGet": "7031.14",
  "amountToGetUSDT": "7031.148333816",
  "amountToGive": "0.082539",
  "marketMinAmount": "",
  "enableFixedRate": true,
  "ckms": false,
  "ckm": "D",
  "amountToGiveCurrencyTitle": "BTC",
  "rateMode": "fixed",
  "finalNetworkFeeAmount": "1.5",
  "liquidityProviderQuotes": {
    "sellQuote": {
      "baseValue": "1",
      "quoteValue": "86942.8"
    },
    "buyQuote": {
      "baseValue": "86942.9",
      "quoteValue": "1"
    }
  },
  "price": "85185.7707727983133388",
  "leftPrice": "85185.7707727983133388",
  "rightPrice": "0.0000112693615569",
  "marketLeftPrice": "86942.8",
  "marketRightPrice": "0.0000115018017572",
  "marketAmountToGet": "7176.1717692",
  "marketAmountToGetUSDT": "7176.1717692",
  "quotesWithoutNetworkFee": {
    "sellQuote": {
      "baseValue": "1",
      "quoteValue": "85203.944"
    },
    "buyQuote": {
      "baseValue": "86942.9",
      "quoteValue": "0.98"
    }
  },
  "quotes": {
    "sellQuote": {
      "baseValue": "1",
      "quoteValue": "85185.77077279831333884"
    },
    "buyQuote": {
      "baseValue": "86942.9",
      "quoteValue": "0.9797909749030203"
    }
  },
  "generalMinAmount": "0.0011501",
  "generalMaxAmount": "0.09171",
  "debugInfo": null
}

Response Fields Breakdown

Instrument Information

"instrumentFrom": {
  "currencyTitle": "BTC",
  "networkTitle": "BTC",
  "slug": "btc",
  "precisionDecimals": 7
},
"instrumentTo": {
  "currencyTitle": "USDT",
  "networkTitle": "TRC20",
  "slug": "usdttrc20",
  "precisionDecimals": 2
}

Field	Type	Description
instrumentFrom	object	Source instrument.
instrumentTo	object	Target instrument.
currencyTitle	string	Currency code.
networkTitle	string	Network.
slug	string	Instrument slug.
precisionDecimals	number	Number of decimal places.

Amounts and Key Parameters

"claimedDepositAmount": "0.082539",
"amountToGive": "0.082539",
"amountToGiveCurrencyTitle": "BTC",
"amountToGet": "7031.14",
"amountToGetUSDT": "7031.148333816",
"rateMode": "fixed",
"enableFixedRate": true,
"finalNetworkFeeAmount": "1.5",
"generalMinAmount": "0.0011501",
"generalMaxAmount": "0.09171"

Field	Type	Description
claimedDepositAmount	string	Deposit amount requested by the user.
amountToGive	string	Final amount to send.
amountToGiveCurrencyTitle	string	Currency of the amount to send.
amountToGet	string	Amount the user will receive.
amountToGetUSDT	string	Equivalent amount in USDT.
rateMode	string	Rate mode: fixed or float.
enableFixedRate	boolean	Is fixed rate available.
finalNetworkFeeAmount	string	Final network fee.
generalMinAmount	string	Minimum possible deposit.
generalMaxAmount	string	Maximum possible deposit.

Code Sample

Response Example

Try it out

Share this article:

Rates API V2

Documentation

General Description

HTTP Request

Request Example

Request Parameters

Query Parameters

Response Format

Response Example

Response Fields Breakdown

Instrument Information

Amounts and Key Parameters

Code Sample

Response Example

Try it out

Query Parameters

Headers