Add

Add Subname

Add a new subname

post

/ens/v1/subname/add

Header parameters

x-api-keystringrequired

The Api Key.

x-signaturestringrequired

The signature.

x-messagestringrequired

The Message.

x-addressstringrequired

The Address.

Body

usernamestringrequired

The username

Example: dev

ensDomainstringrequired

The second-level domain

Example: jan.eth

chainIdnumberrequired

Chain id, we only support Ethereum Mainnet and Sepolia Testnet (1 for mainnet, 11155111 for sepolia)

Example: 11155111

contentHashstring

The content hash of the subname

Example: ipfs://QmRAQB6YaCyidP37UdDnjFY5vQuiBrcqdyoW1CuDgwxkD4

addressesobject[]required

Example: [{"address":"0xb965a5f3a0fC18D84E68883ccAd508445a7917A8","coinType":60},{"address":"1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa","coinType":0}]

textobject[]

Example: [{"key":"twitter.com","value":"justaname_id"},{"key":"youtube.com","value":"justaname"}]

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.justaname.id/ens/v1/subname/add' \
  --header 'x-api-key: text' \
  --header 'x-signature: text' \
  --header 'x-message: text' \
  --header 'x-address: text' \
  --header 'Content-Type: application/json' \
  --data '{
    "username": "dev",
    "ensDomain": "jan.eth",
    "chainId": 11155111,
    "contentHash": "ipfs://QmRAQB6YaCyidP37UdDnjFY5vQuiBrcqdyoW1CuDgwxkD4",
    "addresses": [
      {
        "address": "0xb965a5f3a0fC18D84E68883ccAd508445a7917A8",
        "coinType": 60
      },
      {
        "address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
        "coinType": 0
      }
    ],
    "text": [
      {
        "key": "twitter.com",
        "value": "justaname_id"
      },
      {
        "key": "youtube.com",
        "value": "justaname"
      }
    ]
  }'

default

default

{
  "statusCode": 200,
  "result": {
    "data": {
      "ens": "user.justan.id",
      "isClaimed": true,
      "claimedAt": "2024-05-22T11:55:29.000Z",
      "isJAN": true,
      "records": {
        "resolverAddress": "0x48De002d3c64e4cFD130A87A35ECD960c01954bc",
        "contentHash": {
          "protocolType": "ipfs",
          "decoded": "bafybeiafwq5iqeyk73or3dmzyjyqaauyzdwi3xtync7h6kp64umwvsiumi"
        },
        "texts": [
          {
            "key": "com.twitter",
            "value": "justaname_id"
          }
        ],
        "coins": [
          {
            "id": 60,
            "name": "eth",
            "value": "0x1FA89227d0F42960eb5f5693fAFCF58e255A4dfa"
          }
        ]
      }
    },
    "error": "text"
  }
}

The Subname was added successfully.