Skip to main content
GET
/
api
/
v1
/
mint
/
estimate
Estimate mint params
curl --request GET \
  --url https://mint-manager.namespace.ninja/api/v1/mint/estimate
{
  "canMint": true,
  "estimatedPriceEth": 0.01,
  "estimatedFeeEth": 0.002,
  "isStandardFee": true,
  "validationErrors": [
    "SUBNAME_TAKEN",
    "MINTER_NOT_WHITELISTED"
  ]
}

Query Parameters

​
parentName
string
required

The parent name (e.g., domain) under which the label will be minted.

Required string length: 3 - 100
Example:

"example.eth"

​
label
string
required

The label or subname to be minted under the parent name.

Required string length: 1 - 100
Example:

"subname"

​
minterAddress
string
required

Ethereum address of the minter.

Example:

"0x1234567890abcdef1234567890abcdef12345678"

​
isTestnet
boolean

Indicates whether the operation is on a sepolia testnet.

Example:

true

Response

Estimated price, fee, and validation status for requested subname.

​
canMint
boolean
required

Indicates if the subname can be minted.

Example:

true

​
estimatedPriceEth
number
required

Estimated price in ETH for the minting operation.

Example:

0.01

​
estimatedFeeEth
number
required

Estimated protocol/platform fee in ETH.

Example:

0.002

​
isStandardFee
boolean
required

Indicates whether the estimated fee is a standard fixed fee.

Example:

true

​
validationErrors
enum<string>[]
required

List of validation error types if minting is not allowed.

Available options:
SUBNAME_TAKEN,
MINTER_NOT_TOKEN_OWNER,
MINTER_NOT_WHITELISTED,
LISTING_EXPIRED,
SUBNAME_RESERVED,
VERIFIED_MINTER_ADDRESS_REQUIRED
Example:
["SUBNAME_TAKEN", "MINTER_NOT_WHITELISTED"]