API V2 Instruments

Descrição geral
Retorna uma lista pública de todos os instrumentos ativos (moedas e redes) disponíveis para troca.

Parâmetros

Parâmetros de consulta (Query Parameters)

Headers

Exemplo de requisição

curl -X GET "https://quickex.io/api/v2/instruments/public?providers=" \
  -H "accept: application/json" \
  -H "X-Api-Public-Key: yourPublicKey" \
  -H "X-Api-Timestamp: 1691400000000" \
  -H "X-Api-Signature: yourHmacSignature"

Exemplo de resposta

[
  {
    "currencyTitle": "ADA",
    "networkTitle": "ADA",
    "currencyFriendlyTitle": "Cardano",
    "precisionDecimals": 11,
    "requiresMemo": false,
    "currencyLogoLink": "https://static.coinall.ltd/cdn/assets/imgs/221/5FFE6AFD21B40243.png",
    "instrumentType": "crypto"
  },
  {
    "currencyTitle": "USDT",
    "networkTitle": "TRC20",
    "currencyFriendlyTitle": "Tether USD",
    "precisionDecimals": 6,
    "requiresMemo": false,
    "currencyLogoLink": "https://static.coinall.ltd/cdn/assets/imgs/USDT.png",
    "instrumentType": "crypto"
  }
]

Caso de uso

Ao inicializar o formulário de troca em uma página web, você deve exibir todas as moedas e redes disponíveis dos provedores especificados. O frontend chama este método e constrói os menus suspensos de moedas e redes com base na lista retornada.

Descrição geral
Retorna informações sobre um único instrumento ativo (moeda + rede) da lista pública.

Parâmetros

Headers

Corpo da requisição (JSON)

Exemplo de requisição

curl -X POST 'https://quickex.io/api/v2/instruments/public/one' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Public-Key: yourPublicKey' \
  -H 'X-Api-Timestamp: 1691400000000' \
  -H 'X-Api-Signature: yourHmacSignature' \
  -d '{
    "currencyTitle": "USDT",
    "networkTitle": "TRC20"
  }'

Exemplos de resposta

200 OK — instrumento encontrado:

{
  "currencyTitle": "ADA",
  "networkTitle": "ADA",
  "currencyFriendlyTitle": "Cardano",
  "precisionDecimals": 11,
  "requiresMemo": false,
  "currencyLogoLink": "https://static.coinall.ltd/cdn/assets/imgs/221/5FFE6AFD21B40243.png",
  "instrumentType": "crypto",
  "bestChangeName": "USDTTRC20"
}

500 ERR_UNKNOWN — instrumento não encontrado ou erro interno:

{
  "status": "ERR_UNKNOWN",
  "message": "code=404, message=Not Found",
  "data": null
}

Caso de uso

Ao criar uma ordem, o frontend precisa exibir informações detalhadas sobre o instrumento selecionado: nome de exibição, precisão e necessidade de Memo/Tag. Após o usuário selecionar a moeda e a rede, este método é chamado e os dados retornados são usados para validar e renderizar os campos do formulário.

Descrição geral
Valida a correção de um endereço para a moeda e rede especificadas. Retorna true se o endereço estiver no formato correto e corresponder à rede; caso contrário, retorna false ou um erro.

Parâmetros

Headers

Corpo da requisição (JSON)

Exemplo de requisição

curl -X POST 'https://quickex.io/api/v2/instruments/public/validate-address' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Public-Key: yourPublicKey' \
  -H 'X-Api-Timestamp: 1691400050000' \
  -H 'X-Api-Signature: yourHmacSignature' \
  -d '{
    "currencyTitle": "USDT",
    "networkTitle": "TRC20",
    "address": "THUmkPhry61edcTf79yTioV6292ccsuCjV"
  }'

Exemplos de resposta

200 OK — endereço válido:

true

400 ERR_INVALID_ADDRESS — formato inválido para a rede especificada:

false

500 ERR_UNKNOWN — instrumento não encontrado ou erro interno:

{
  "status": "ERR_UNKNOWN",
  "message": "code=404, message=Not Found",
  "data": null
}

Caso de uso

Antes de criar uma ordem, o frontend valida o endereço inserido pelo usuário: chama este método e, caso true seja retornado, o formulário continua; caso contrário, exibe uma mensagem de erro e solicita ao usuário que verifique o endereço.