Authentication

How to authenticate

To authenticate your request, you will need to provide an authentication token with the required permissions. You can request an authentication token through email.

After creating a token, you can authenticate your request by sending the token in the X-BANKLESS-TOKEN header of your request. For example, in the following request, replace YOUR-TOKEN with a reference to your token:

curl --request GET \
--url "https://api.bankless.com/endpoints \
--header "X-BANKLESS-TOKEN: YOUR-TOKEN"

Validate your authentication

You can validate your token performing by visiting the authentication endpoint.

Example Request

curl --request GET \
--url "https://api.bankless.com/authentication \
--header "X-BANKLESS-TOKEN: YOUR-TOKEN"

This will result in the id of your token, as well as your current permission. Available permissions:

• CLAIMABLES

• QUESTS

Example Response

{
    clientId: "bankless",
    id: "fbcc076f-3b9a-4be3-9e84-4a63dc779829",
    permissions: [
        "CLAIMABLES"
    ]
    config: {
      max_requests_per_minute: 300
    }
}

Rate Limits

A default rate limit of 300 calls per minute is enforced on a per key basis. On every authenticated request, the x-ratelimit-remaining header is returned. The header indicates how many requests you still have remaining for the minute.

x-ratelimit-remaining: 295