A seção Instruments é destinada ao trabalho com instrumentos de troca na plataforma Quickex.
Um “instrumento” significa uma combinação específica de moeda e rede (por exemplo,
USDT (TRC20) ou BTC (BTC)) que pode ser usada como parte de um par de negociação.
Usando os métodos desta seção, você pode:
- obter uma lista completa de todos os instrumentos ativos
(/public); - obter informações detalhadas sobre um instrumento individual
(/public/one); - validar o endereço da carteira para o instrumento selecionado
(/public/validate-address)para evitar erros de entrada.
Esses métodos fornecem apenas informações públicas e podem ser usados ao construir a interface do usuário
(por exemplo, formulários de seleção de moeda e rede ao criar uma ordem).
Documentation
Retorna uma lista de todos os instrumentos ativos disponíveis para troca na plataforma Quickex.
Um instrumento representa uma moeda específica e a rede na qual ela opera (por exemplo, USDT (TRC20), BTC (BTC), EUR (SEPA)).
Esses dados podem ser usados para exibir a lista de moedas na interface de troca.
URL
https://quickex.io/api/v1/instruments/public
Parâmetros
Nenhum
Exemplo de requisição (cURL)
curl -X GET \
'https://quickex.io/api/v1/instruments/public' \
-H 'Accept: application/json'
Exemplo de resposta (200)
[
{
"currencyTitle": "GHS",
"networkTitle": "GHS",
"slug": "ghsghs",
"currencyFriendlyTitle": "Cedi ganês",
"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": "Florim húngaro",
"precisionDecimals": 2,
"currencyLogoLink": "https://s2.coinmarketcap.com/static/img/coins/64x64/2793.png",
"requiresMemo": false,
"instrumentType": "fiat",
"bestChangeName": ""
}
]
Campos da resposta
currencyTitle— ticker da moeda (ex.: BTC, USDT, EUR).networkTitle— rede na qual o instrumento opera (ex.: TRC20, ERC20, SEPA).currencyFriendlyTitle— nome da moeda em formato legível.precisionDecimals— número de casas decimais suportadas pelo sistema.currencyLogoLink— link para o ícone da moeda.requiresMemo— indica se é necessário memo/tag para transferências.instrumentType— tipo de instrumento (cryptooufiat).
Code Sample
curl -X 'GET' \
'https://quickex.io/api/v1/instruments/public' \
-H 'accept: application/json'Try it out
Leave empty to use default
Headers
Documentation
Retorna informações públicas sobre um único instrumento ativo na plataforma Quickex.
É utilizado quando é necessário esclarecer os parâmetros de uma moeda específica na rede requerida
(por exemplo, USDT na rede TRC20).
URL
https://quickex.io/api/v1/instruments/public/one
Parâmetros de consulta (Query)
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
currencyTitle |
string | sim | Código da moeda (por exemplo, USDT, BTC). |
networkTitle |
string | sim | Nome da rede para essa moeda (por exemplo, TRC20, ERC20). |
Exemplo de requisição (cURL)
curl -X GET \
'https://quickex.io/api/v1/instruments/public/one?currencyTitle=USDT&networkTitle=TRC20' \
-H 'Accept: application/json'
Exemplo de resposta (200)
{
"currencyTitle": "USDT",
"networkTitle": "TRC20",
"okexCurrencyFriendlyTitle": "USDT",
"precisionDecimals": 2,
"requiresMemo": false,
"currencyLogoLink": "https://static.coinall.ltd/cdn/oksupport/asset/currency/icon/usdt20230419113051.png"
}
Notas
- Este método permite obter as propriedades de um único instrumento sem carregar a lista completa.
precisionDecimalsindica o número de casas decimais disponíveis para cálculos com essa moeda.requiresMemomostra se é necessário especificar um Memo/Tag para transferências (relevante para algumas redes, como XRP ou XLM).- Pode ser usado para validação preliminar ao construir a interface de seleção de moeda e rede.
Code Sample
curl -X 'GET' \
'https://quickex.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
Código da moeda (por exemplo, USDT, BTC).
Nome da rede para esta moeda (por exemplo, TRC20, ERC20).
Headers
Documentation
/api/v1/instruments/public/validate-address
POST
Valida a correção de um endereço especificado para o instrumento selecionado.
Este método ajuda a garantir que o endereço inserido pelo usuário corresponda ao formato exigido pela rede
(por exemplo, um endereço TRC20 para USDT).
É utilizado antes de enviar uma transação ou criar uma ordem para minimizar erros na inserção do endereço.
URL
https://quickex.io/api/v1/instruments/public/validate-address
Parâmetros
Nenhum (os dados são enviados no corpo da requisição).
Corpo da requisição (JSON)
{
"currencyTitle": "USDT",
"networkTitle": "TRC20",
"address": "THUmkPhry61edcTf79yTioV6292ccsuCjV"
}
Exemplo de requisição (cURL)
curl -X POST \
'https://quickex.io/api/v1/instruments/public/validate-address' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-d '{
"currencyTitle": "USDT",
"networkTitle": "TRC20",
"address": "THUmkPhry61edcTf79yTioV6292ccsuCjV"
}'
Exemplo de resposta (201)
true
Notas
- Uma resposta
truesignifica que o endereço é válido e pode ser usado em uma transação.- Uma resposta
falseserá retornada se o endereço não corresponder ao formato da rede selecionada.- Recomenda-se chamar este método durante a entrada de dados do usuário para evitar erros ao criar ordens.
Code Sample
curl -X 'POST' \
'https://quickex.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