You'll need to authenticate your requests to access any of the endpoints in the SELF API. In this guide, we'll look at how authentication works. SELF offers two ways to authenticate your API requests: Basic authentication and OAuth2 with a token — OAuth2 is the recommended way.

No authentication

Basic authentication

With basic authentication, a username and password is required to authenticate HTTP requests. This option is strictly limited for the SELF development team and not used for 3rd party integrators.

Example request with basic auth

  -u username:password

Please don't comprimize your SELF API token!

OAuth2 with API token

The OAuth 2.0 authorization framework is a protocol that allows a user to grant a third-party web site or application access to the user's protected resources, without necessarily revealing their long-term credentials or even their identity.

The recommended way to authenticate with the SELF API is by using OAuth2. When establishing a connection using OAuth2, you will need your access token — you will find it in the SELF dashboard under API settings. Here's how to add the token to the request header using cURL:

Example request with SELF API token

name predator
// --> resolves walletAddress ... thats all!

Using an SDK

If you use one of our official widgets or use the boilerplate, you won't have to worry about any of the above — fetch your access token from the SELF dashboard under API settings, and our client library will take care of the rest.