The Instruments section is intended for working with exchange instruments on the DxSpot platform. An “instrument” means a specific combination of currency and network (e.g. USDT (TRC20) or BTC (BTC)) that can be used as part of a trading pair.
Using the methods of this section you can:
- get a complete list of all active instruments
(/public); - get detailed information about an individual instrument
(/public/one); - validate the wallet address for the selected instrument
(/public/validate-address) to avoid input errors.
These methods provide only public information and can be used when building the user interface (e.g., currency and network selection forms when creating an order).
Documentation
Returns a list of all active instruments available for exchange on the DxSpot platform.
An instrument represents a specific currency and the network it operates on (e.g., USDT (TRC20), BTC (BTC), EUR (SEPA)).
The data can be used to display a list of currencies in the exchange interface.
URL
https://dxspot.io/api/v1/instruments/public
Parameters
None
Request Example (cURL)
curl -X GET \
'https://dxspot.io/api/v1/instruments/public' \
-H 'Accept: application/json'Example Response (200)
[
{
"currencyTitle": "GHS",
"networkTitle": "GHS",
"slug": "ghsghs",
"currencyFriendlyTitle": "Ghanaian cedi",
"precisionDecimals": 2,
"currencyLogoLink": "https://s2.coinmarketcap.com/static/img/coins/64x64/3540.png",
"requiresMemo": false,
"instrumentType": "fiat",
"bestChangeName": ""
},
{
"currencyTitle": "HUF",
"networkTitle": "HUF",
"slug": "hufhuf",
"currencyFriendlyTitle": "Hungarian Forint",
"precisionDecimals": 2,
"currencyLogoLink": "https://s2.coinmarketcap.com/static/img/coins/64x64/2793.png",
"requiresMemo": false,
"instrumentType": "fiat",
"bestChangeName": ""
}
]Response Fields
currencyTitle— currency ticker (e.g., BTC, USDT, EUR).networkTitle— the network in which the instrument operates (e.g., TRC20, ERC20, SEPA).currencyFriendlyTitle— human-readable name of the currency.precisionDecimals— number of decimal places supported by the system.currencyLogoLink— link to the currency icon.requiresMemo— indicates whether a memo/tag is required for transfers.instrumentType— instrument type (cryptoorfiat).
Code Sample
curl -X 'GET' \
'https://dxspot.io/api/v1/instruments/public' \
-H 'accept: application/json'Try it out
Leave empty to use default
Headers
Documentation
Returns public information about a single active instrument on the DxSpot platform.
Used when it is necessary to clarify the parameters of a specific currency in the required network (e.g., USDT on the TRC20 network).
URL
https://dxspot.io/api/v1/instruments/public/one
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
currencyTitle |
string | yes | Currency code (e.g., USDT, BTC). |
networkTitle |
string | yes | Network name for this currency (e.g., TRC20, ERC20). |
Request Example (cURL)
curl -X GET \
'https://dxspot.io/api/v1/instruments/public/one?currencyTitle=USDT&networkTitle=TRC20' \
-H 'Accept: application/json'Example Response (200)
{
"currencyTitle": "USDT",
"networkTitle": "TRC20",
"okexCurrencyFriendlyTitle": "USDT",
"precisionDecimals": 2,
"requiresMemo": false,
"currencyLogoLink": "https://static.coinall.ltd/cdn/oksupport/asset/currency/icon/usdt20230419113051.png"
}Notes
- This method allows you to retrieve the properties of a single instrument without loading the full list.
precisionDecimalsindicates the number of decimal places available for calculations with this currency.requiresMemoshows whether a Memo/Tag must be specified for transfers (relevant for some networks, e.g., XRP or XLM).- Can be used for preliminary validation when building the currency and network selection UI.
Code Sample
curl -X 'GET' \
'https://dxspot.io/api/v1/instruments/public/one?currencyTitle={USDT}&networkTitle={TRC20}' \
-H 'accept: application/json'Response Example
{
"currencyTitle": "USDT",
"networkTitle": "TRC20",
"okexCurrencyFriendlyTitle": "USDT",
"precisionDecimals": 2,
"requiresMemo": false,
"currencyLogoLink": "https://static.coinall.ltd/cdn/oksupport/asset/currency/icon/usdt20230419113051.png"
}Try it out
Leave empty to use default
Query Parameters
Currency code (for example, USDT, BTC).
The name of the network for this currency (for example, TRC20, ERC20).
Headers
Documentation
/api/v1/instruments/public/validate-address
POST
Validates the correctness of a specified address for the selected instrument.
This method helps ensure that the address entered by the user matches the required network format (e.g., a TRC20 address for USDT).
It is used before sending a transaction or creating an order to minimize errors in address input.
URL
https://dxspot.io/api/v1/instruments/public/validate-address
Parameters
None (data is passed in the request body).
Request Body (JSON)
{
"currencyTitle": "USDT",
"networkTitle": "TRC20",
"address": "THUmkPhry61edcTf79yTioV6292ccsuCjV"
}Request Example (cURL)
curl -X POST \
'https://dxspot.io/api/v1/instruments/public/validate-address' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-d '{
"currencyTitle": "USDT",
"networkTitle": "TRC20",
"address": "THUmkPhry61edcTf79yTioV6292ccsuCjV"
}'Example Response (201)
trueNotes
- A response of
truemeans the address is valid and can be used in a transaction.- A response of
falsewill be returned if the address does not match the format of the selected network.- It is recommended to call this method during user input to prevent errors when creating orders.
Code Sample
curl -X 'POST' \
'https://dxspot.io/api/v1/instruments/public/validate-address' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-d '{
"currencyTitle": "USDT",
"networkTitle": "TRC20",
"address": "THUmkPhry61edcTf79yTioV6292ccsuCjV"
}'Response Example
trueTry it out
Leave empty to use default