Skip to main content
POST
/
api
/
v1
/
mint
Generate mint params
curl --request POST \
  --url https://mint-manager.namespace.ninja/api/v1/mint \
  --header 'Content-Type: application/json' \
  --data '{
  "label": "satoshi",
  "parentName": "universe.eth",
  "expiryInYears": 1,
  "minterAddress": "0x1234567890abcdef1234567890abcdef12345678",
  "isTestnet": true,
  "owner": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd"
}'
{
  "content": {
    "label": "satoshi",
    "owner": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
    "fee": "0.002",
    "price": "0.01",
    "parentNode": "0xabc123abc123abc123abc123abc123abc123abc123abc123abc123abc123abc1",
    "paymentReceiver": "0x1234567890abcdef1234567890abcdef12345678",
    "verifiedMinter": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
    "signatureExpiry": 1726425612,
    "expiry": 4294967295,
    "fuses": 65536
  },
  "signature": "0xdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef1b"
}

Body

application/json

Mint request including label, parent name, minter address, etc.

​
label
string
required

Label or subname to mint (e.g., "satoshi"). Must be 1-255 characters.

Required string length: 1 - 255
Example:

"satoshi"

​
parentName
string
required

Parent ENS name under which the label is being minted (e.g., "universe.eth").

Required string length: 1 - 255
Example:

"universe.eth"

​
minterAddress
string
required

Ethereum address of the minter.

Example:

"0x1234567890abcdef1234567890abcdef12345678"

​
expiryInYears
number

Optional number of years the subname will be valid for. Used for expirable names. Defaults to 1 if not provided

Example:

1

​
isTestnet
boolean

Whether the operation is being performed on a testnet.

Example:

true

​
owner
object

Optional custom owner address of the subname (if different from minter).

Example:

"0xabcdefabcdefabcdefabcdefabcdefabcdefabcd"

Response

Signed mint parameters ready to be used on-chain.

​
content
object
required

The structured mint parameters used for generating the signature.

​
signature
string
required

Cryptographic signature of the mint parameters.

Example:

"0xdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef1b"

⌘I