👨‍💻BNS API

Base Name Service provides a free REST API for developers to integrate .base names.

Resolve .base name to address

GET https://resolver-api.basename.app/v1/names/{name}

Example request

https://resolver-api.basename.app/v1/names/hello.base

Example response

{
  "statusCode": 200,
  "name": "hello.base",
  "address": "0x4fb3f133951bF1B2d52fF6CEab2c703fbB6E98cC"
}

Resolve address to .base name

GET https://resolver-api.basename.app/v1/addresses/{address}

Example request

https://resolver-api.basename.app/v1/addresses/0x4fb3f133951bF1B2d52fF6CEab2c703fbB6E98cC

Example response

{
  "statusCode": 200,
  "name": "hello.base",
  "address": "0x4fb3f133951bF1B2d52fF6CEab2c703fbB6E98cC"
}