Skip to main content
POST
/
exchange
/
quote
Criar Cotação
curl --request POST \
  --url https://gateway.3xpay.co/exchange/quote \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --header 'api_secret: <api-key>' \
  --data '
{
  "network": "ethereum",
  "token": "USDT",
  "request_amount": 123,
  "address": "<string>",
  "currency_type": "sender"
}
'
{
  "success": true,
  "message": "<string>",
  "data": {
    "quote": {
      "quote_id": "<string>",
      "quotation": 123,
      "commercial_quotation": 123,
      "expires_at": 123,
      "flat_fee": 123,
      "receiver_amount": 123,
      "sender_amount": 123,
      "partner_fee_amount": 123,
      "payin_quote_id": "<string>"
    },
    "wallet": {
      "address": "<string>",
      "status": "<string>",
      "network": "<string>",
      "name": "<string>"
    },
    "token": "<string>"
  }
}

​
Visão Geral

Cria uma cotação para conversão de BRL para criptomoeda. A cotação inclui informações sobre a taxa de conversão, valores e informações da carteira de destino. O campo currency_type determina se o request_amount se refere ao valor enviado pelo pagador (sender) ou ao valor que o recebedor deve receber (receiver).
A cotação tem um tempo de expiração limitado. Após a expiração, uma nova cotação deve ser solicitada.
IMPORTANTE: A cotação tem validade de 5 minutos. O valor/quantidade que será transferido para sua conta/carteira será baseado na cotação no momento que a 3X Change recebeu o PIX, sendo assim podem haver variações para mais ou menos.

​
Parâmetros

​
body
object

​
Resposta

​
success
boolean
Indica se a operação foi bem-sucedida
​
message
string
Mensagem descritiva da operação
​
data
object
​
quote
object
​
quote_id
string
Identificador da cotação
​
quotation
number
Taxa de cotação
​
commercial_quotation
number
Taxa comercial aplicada
​
expires_at
number
Timestamp de expiração da cotação
​
flat_fee
number
Tarifa fixa aplicada
​
receiver_amount
number
Quantidade de criptomoeda que será recebida
​
sender_amount
number
Valor que o pagador envia
​
partner_fee_amount
number
Valor de taxa do parceiro, quando aplicável
​
payin_quote_id
string
Identificador de referência da cotação de entrada
​
wallet
object
​
address
string
Endereço da carteira cripto
​
status
string
Status da carteira
​
network
string
Rede da criptomoeda
​
name
string
Nome da carteira
​
token
string
Token da criptomoeda

​
Exemplo

Requisição 
{
  "network": "ethereum",
  "token": "USDT",
  "request_amount": 60,
  "address": "0x7e4bb73735f7cc10c07f7b2541d695b79bd831a0",
  "currency_type": "sender"
}
Resposta 
{
  "success": true,
  "message": "Quote created successfully",
  "data": {
    "quote": {
      "quote_id": "qu_4mqzgMfc8Jmg",
      "quotation": 5.4521,
      "commercial_quotation": 5.4169,
      "expires_at": 1765542661121,
      "flat_fee": 0.6,
      "receiver_amount": 11.08,
      "sender_amount": 63.64,
      "partner_fee_amount": 0.05,
      "payin_quote_id": "qu_4mqzgMfc8Jmg"
    },
    "wallet": {
      "address": "0x7e4bb73735f7cc10c07f7b2541d695b79bd831a0",
      "status": "ACTIVE",
      "network": "ethereum",
      "name": "teste blind"
    },
    "token": "USDT"
  }
}

Authorizations

​
api_key
string
header
required
​
api_secret
string
header
required

Body

application/json
​
network
enum<string>
required

Rede da criptomoeda

Available options:
ethereum,
tron,
polygon,
polygon_amoy
​
token
enum<string>
required

Token da criptomoeda

Available options:
USDT,
USDC
​
request_amount
number
required

Valor usado para calcular a cotação; interpretado conforme currency_type

​
address
string
required

Endereço da carteira cripto

​
currency_type
enum<string>
required

Define se request_amount representa o valor que o pagador envia (sender) ou o valor que o recebedor deve receber (receiver)

Available options:
sender,
receiver

Response

200 - application/json

Cotação criada com sucesso

​
success
boolean

Indica se a operação foi bem-sucedida

​
message
string

Mensagem descritiva da operação

​
data
object