Saltar para o conteúdo principal
GET
Calcular preço de bandwidth

Calcular preço de bandwidth

Retorna o valor exato que será cobrado por um pedido de bandwidth com este volume e esta duração — aluguel e taxa fixa juntos, pela sua tarifa. A cotação é calculada pelo mesmo código que cobra o pedido; por isso, enquanto o preço não muda, a compra custa exatamente total_trx. Este endpoint é público — a autenticação é opcional. Envie sua chave de API para receber a sua tarifa e a sua taxa fixa; sem ela você obtém o preço público.
Mostre total_trx ao seu usuário e envie-o como max_price_trx em Comprar bandwidth. Se o preço mudar entre a cotação e a compra, a compra é recusada com 409 PRICE_CHANGED e nada é cobrado — cote novamente e repita.

Parâmetros de consulta

integer
obrigatório
Unidades de bandwidth a cotar. Entre 1 e 100.000.
string
padrão:"1h"
Período de aluguel: 1h, 1d ou um número inteiro de minutos de 5m a 59m — os mesmos valores de Comprar bandwidth.

Cabeçalhos

string
Opcional. Com uma chave válida a resposta reflete sua tarifa negociada e sua taxa fixa. Chave ausente, inválida ou revogada não é erro — você recebe o preço público com personal_price: false.

Resposta

number
Unidades de bandwidth para as quais a cotação foi calculada
string
Período de aluguel para o qual a cotação foi calculada
string
Tarifa em SUN por 1 unidade de bandwidth, arredondada a 0,01 para exibição. Os prazos em minutos têm desconto, por isso a tarifa deles é fracionária, e os valores abaixo são calculados a partir da tarifa exata — use total_trx em vez de multiplicar você mesmo este valor arredondado.
string
Custo de aluguel para este volume e esta duração, sem a taxa fixa
string
Taxa fixa, cobrada uma vez por pedido, independentemente do volume e da duração. Reflete a sua taxa caso haja taxa personalizada, desconto ou isenção na sua conta.
string
O que será cobrado: rental_trx + fixed_fee_trx. Envie-o como max_price_trx em Comprar bandwidth.
boolean
true quando sua tarifa negociada foi aplicada, false quando a cotação usa o preço público. Verifique este campo: um cabeçalho X-API-Key esquecido parece uma resposta normal, e você estaria cotando o preço público aos seus clientes enquanto é cobrado pelo seu.

Exemplo

Os valores abaixo são um exemplo, com price_sun_1h igual a 400 e short_max_discount_pct igual a 5. As tarifas e o desconto atuais estão em Consultar preços de bandwidth.
Response

O que a cotação não inclui

A cotação — e max_price_trx — cobre apenas o pedido de bandwidth. Se o endereço de destino ainda não estiver ativado on-chain, Comprar bandwidth o ativa e cobra a ativação à parte (activation_cost_trx na resposta). Essa cobrança não faz parte de total_trx e não entra na verificação de max_price_trx.

Agindo em nome de outra conta: GET /v1/bandwidth/quote/me

/bandwidth/quote calcula o preço para o dono da chave de API. Se a sua chave age em nome de outra conta com o cabeçalho X-Account-Id, a compra é cobrada pela tarifa e pela taxa dessa conta — a cotação pode diferir da cobrança, e um max_price_trx tirado dela pode ser recusado com 409 PRICE_CHANGED. Nesse caso, use GET /v1/bandwidth/quote/me. Ele aceita os mesmos parâmetros de consulta e retorna a mesma resposta, mas exige autenticação, e a conta é determinada exatamente como na compra, X-Account-Id incluído. Ele exige o escopo view, que toda chave sempre tem.
cURL

Erros

Em /bandwidth/quote uma X-API-Key inválida ou revogada não é erro: a cotação é retornada ao preço público com personal_price: false.