Editar Cotação de Tokens

Pré-requisitos de acesso

• Permissão (módulo): updateExchangeRate (ou manageToken)
• Licença/Feature: MANAGE_TOKENS
• Contêiner do menu: TOKENIZAÇÃO → grupo Tokenização → Gerenciar Tokens → ícone Cotação na linha

O que é / quando usar

Define manualmente a cotação de um token. Útil para tokens com cotação fixa (sem provedor automático), correções pontuais ou ajustes administrativos. A cotação é registrada com data, então cada atualização vira um ponto no histórico de cotação do token.

Pré-condições

• Permissão: updateExchangeRate ou manageToken (dupla — enum CPM + módulo no DB).
• Licença/Feature: MANAGE_TOKENS.

Passo a passo

1. Em Gerenciar Tokens, clique no ícone de Cotação na linha do token.
2. Informe a moeda de referência e a nova taxa.
3. Confirme. A taxa é gravada via storeExchangeRateInformation.

Campos

Campo	O que é	Obrigatório?	Efeito no sistema/backend
Moeda de referência	Moeda em que a cotação está expressa	Sim	Enviada como referenceCurrency.
Nova cotação (taxa)	Valor da cotação	Sim	Enviada como rate (BigNumber). Deve ser >= 0.
Data	Momento da cotação	Automático	date = new Date() — registra o ponto no histórico.

Ações e modais

• Salvar: grava a cotação (storeExchangeRateInformation). Sucesso e erro são sinalizados por snackbar ("Cotação atualizada" / "Erro ao atualizar a cotação").

Regras de negócio / cuidados

Atenção

• A atualização manual sobrepõe a cotação corrente, mas se o token tiver provedor automático (cmc_name preenchido), o próximo ciclo de cotação pode sobrescrever o valor manual. Para fixar uma cotação, deixe o provedor vazio.
• O preço médio por usuário (calculado nas compras) continua sendo o usado nas operações daquele usuário — a cotação aqui afeta novas operações, não o preço médio já formado.

• Valores financeiros: a taxa é BigNumber — sem arredondamento.

Telas relacionadas

• Gerenciar Tokens
• Gerenciar Cotas