> ## Documentation Index
> Fetch the complete documentation index at: https://docs.quantumapi.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Estimate token deployment

> Validate parameters and estimate gas before submitting a token deployment.

## `POST /v1/tokens/{tokenId}/deployment/estimate`

Run a dry-run validation of the deployment parameters and return a gas estimate, expected contract address (CREATE2 if applicable), and any warnings — without creating an approval request or broadcasting anything.

| Aspect               | Detail                                     |
| -------------------- | ------------------------------------------ |
| Method               | `POST`                                     |
| Path                 | `/v1/tokens/{tokenId}/deployment/estimate` |
| Authentication       | Bearer API key                             |
| Required permissions | `tokens:read`                              |
| Idempotent           | Yes — read-only                            |
| Approval policy      | Not applicable                             |
| Blockchain effect    | None — `eth_call` only                     |
| Webhook events       | None                                       |

### Request body

```json theme={null}
{
  "deployerWalletId": "wallet_xyz789",
  "constructorArgs": {
    "name": "Example Institutional Token",
    "symbol": "EIT",
    "decimals": 18,
    "initialSupply": "0"
  }
}
```

### Response (200)

```json theme={null}
{
  "tokenId": "token_abc123",
  "estimatedGas": "1230000",
  "estimatedFeeWei": "12300000000000",
  "predictedContractAddress": "0x9a8e5e21f0c27d2c5c14b6e9bd8e4a0f9c9b4d12",
  "warnings": [],
  "checks": {
    "templateBytecodeHashMatches": true,
    "deployerHasFunds": true,
    "deployerNonceAvailable": true
  }
}
```

### Errors

| Code | Type                      | Meaning                                                    |
| ---: | ------------------------- | ---------------------------------------------------------- |
| 1100 | `VALIDATION`              | Invalid constructor args or wallet reference.              |
| 1702 | `TOKEN_ALREADY_DEPLOYED`  | Token already has a confirmed `contractAddress`.           |
| 1707 | `TOKEN_DEPLOYMENT_FAILED` | Estimate failed because the simulated deploy would revert. |
| 1500 | `NODE_UNAVAILABLE`        | Upstream Quantum Chain node could not respond.             |

## Related

* [Deploy token](/api-reference/tokens/deploy-token)
* [Lifecycle](/qustody/token-management/token-operation-lifecycle)
* [QVM gas semantics](/quantum-chain/qvm-vs-evm)