Authentication

You'll need to authenticate your requests to access any of the endpoints in the Underdog API. In this guide, we'll look at how authentication works.

Underdog uses OAuth2 with a token to authenticate API requests.

OAuth2 with bearer token

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

Example request with bearer token

curl https://api.underdogprotocol.com/v1/collections \
  -H "Authorization: Bearer {token}"

Always keep your token safe and reset it if you suspect it has been compromised.

Network Access

API keys can be configured to give access to the Mainnet API, Devnet API, or both. This setting can be configured in the dashboard.