π§°Utilities
1. Fetch a list of available namespaces for resolution
GET
/api/v1/resolver/namespaces
Returns a list of namespaces enabled for the tenant account. The shortname field value is the enumeration value for the resolver with namespace endpoint.
Response
200 OK
{
"timestamp": "2024-12-04T11:27:05.813793213",
"data": [
{
"name": "ENS Domains",
"shortname": "ENS",
"smartContractAddress": "0x57f1887a8bf19b14fc0df6fd9b2acc9af147ea85"
},
{
"name": "Freename Domains",
"shortname": "FNS",
"smartContractAddress": "0x465ea4967479a96d4490d575b5a6cc2b4a4bee65"
},
{
"name": "Unstoppable Domains",
"shortname": "UD",
"smartContractAddress": "0xa9a6a3626993d487d2dbda3173cf58ca1a9d9e9f"
}
]
}
2. Set blockchain address for resolution
POST
/api/v1/resolver/{asciiName}
This endpoint assigns a blockchain address to the item identified by the ASCII name provided in the path variable.
Example:
https://apis.freename.io/api/v1/resolver/monopattinohello.metaverse
Request Headers
Name
Description
Required
Authorization
Bearer token
true
Request Body
{
"address": "0xBc3c4559Ebcd85e4DB8EcbEb0038c880bFbD0d3E"
}
Request Body Parameters
Parameter
Type
Description
address
String
The blockchain address to be associated with the item
Response
200 OK
{
"timestamp": "2025-03-05T11:49:46.471884",
"message": "Blockchain address saved successfully.",
"data": {
"address": "0xBc3c4559Ebcd85e4DB8EcbEb0038c880bFbD0d3E"
}
}
Last updated