Authentication

This page details how to get an API Key as well as how to authenticate requests.

API Key

There are 2 ways to get an API key:

1. Visit the TOTO Dashboard, connect your Ethereum wallet, and purchase a credit package. Once confirmed, you're API key will show under the user dashboard section under the pricing cards.

2. Join the Public API Forum and request trial access.

You can view your current API key on the TOTO Dashboard page after connecting your Ethereum wallet.

Authenticating Requests

Toto API uses the 'x-api-key' custom header convention to authenticate requests. To authenticate a request, provide the API Key in the x-api-key header of the request as shown below:

Curl

curl -X POST \
  "<url>" \
  -H "accept: application/json" \
  -H "x-api-key: <api_key>" \
  -H "Content-Type: application/json" \
  -d <json_payload>'

Python

import requests

url="https://toto.oz.xyz/api/metadata/get_past_usernames"

headers={
    'accept': 'application/json',
    'x-api-key': api_key,
    'Content-Type': 'application/json',
}

example_payload={
    'user': username,
    'how': 'username',
    'page': 1,
}

response = requests.post(url=url, headers=headers, json=example_payload)

If you need a new API Key, you can Direct Message @babushka_slayer on Telegram. Automated revocation is coming soon.