Safe tokens
Safe tokens são tokens conhecidos pelo sistema para enriquecer saldos, depósitos e transações com símbolo e casas decimais.
Criar um safe token
Endpoint: POST /safe-tokens
Serve para
Criar um safe token usando permissões de API user.
Autenticação
Exige bearer token com permissão safe-token:write.
Body
{
"network": "polygon",
"networkGroup": "evm",
"tokenAddress": "0x0000000000000000000000000000000000001010",
"symbol": "POL",
"name": "Polygon",
"decimals": 18
}
Retorno
{
"id": "uuid",
"network": "polygon",
"networkGroup": "evm",
"tokenAddress": "0x...",
"symbol": "POL",
"name": "Polygon",
"decimals": 18,
"status": "active",
"createdAt": "2026-03-26T12:00:00.000Z",
"updatedAt": "2026-03-26T12:00:00.000Z"
}
Atualizar um safe token
Endpoint: PATCH /safe-tokens/:id
Serve para
Atualizar um safe token.
Autenticação
Exige bearer token com permissão safe-token:write.
Body
Todos os campos são opcionais.
{
"symbol": "USDT",
"name": "Tether USD",
"decimals": 6,
"status": "active"
}
Listar safe tokens
Endpoint: GET /safe-tokens
Serve para
Listar safe tokens.
Autenticação
Exige bearer token com permissão safe-token:read.
Retorno
Array de safe tokens.
Criar um safe token como admin
Endpoint: POST /admin/safe-tokens
Serve para
Criar um safe token em contexto administrativo.
Autenticação
Exige token de admin.
Body
Mesmo formato de POST /safe-tokens.
Atualizar um safe token como admin
Endpoint: PATCH /admin/safe-tokens/:id
Serve para
Atualizar um safe token em contexto administrativo.
Autenticação
Exige token de admin.
Body
Mesmo formato de PATCH /safe-tokens/:id.
Listar safe tokens como admin
Endpoint: GET /admin/safe-tokens
Serve para
Listar todos os safe tokens em contexto administrativo.
Autenticação
Exige token de admin.
Retorno
Array de safe tokens.
Excluir um safe token
Endpoint: DELETE /admin/safe-tokens/:id
Serve para
Excluir um safe token.
Autenticação
Exige token de admin.
Parâmetros de rota
idUUID interno do safe token.
Networks
Criar ou atualizar uma rede
Endpoint: PUT /admin/networks
Serve para
Criar ou atualizar uma rede.
Autenticação
Exige token de admin.
Body
{
"network": "polygon",
"networkGroup": "evm",
"status": "active"
}
Listar networks
Endpoint: GET /admin/networks
Serve para
Listar networks cadastradas.
Autenticação
Exige token de admin.
Retorno
Array de networks.
Remover uma network
Endpoint: DELETE /admin/networks/:id
Serve para
Remover uma network pelo ID interno.
Autenticação
Exige token de admin.