$SELF API Introduction

SELF is a decentralized project enabling users to build a Web3 identity stored in a NFT.

No need for complicated address strings any longer as SELF connects dApps across the Web3. This document describes how to integrate SELF naming resolution into your project and gain access to the ever increasing SELF user base.

Once your application with SELF naming resolution is ready to go live, please also publish it in our integrations directory

Getting started

To get started, create a new application in your preferred environment. You can then learn about 2 alternatives of the $SELF naming resolution or in other words, the process of associating names and wallet addresses.

The 1st option is to have your application create a direct connection to Web3 SELF Smart Contracts. Have a look in our codebase to show some examples.
The 2nd option is to make use of our fast and secure API-Server that will relay the $SELF record metadata or .json response based on the $SELF-name which is actually an encoded and hashed $SELF-name.
Its a simple as :

example call

call { "chain": "evm", "name": "superman"}
respond { "address": "0x1234ABCD67EFGHIJKKLMN901PQRASDF4321BA"}

You can also make use of our widget directory with a number of examples to get you started.
Also, feel free to reach out to any member of the SELF team!



Learn how to authenticate your API requests.

Read more


Understand how to work with endpoints for connecting web3 .

Read more


Read about the different types of errors returned by the API.

Read more


Learn how to programmatically configure webhooks for your app.

Read more



All about how to use SELF in your application


Learn about the web3 - web2 integrations.


Learn about an example game integration.


Learn how to register and consume widgets to integrate your dApp with Self