> For the complete documentation index, see [llms.txt](https://oobla.gitbook.io/tyche/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://oobla.gitbook.io/tyche/get-started.md).

# Get Started

{% hint style="warning" %}
All API requests need to be authenticated. Authentication is done using the API user's secret key. Any request that doesn't include an authentication will return an error
{% endhint %}

## Get your API secret key

To get a secret key, you need to first create an API user. This is done via the Tyche portal as seen below. Navigate to Settings > API Users > Click "Add new API user" button.

<figure><img src="https://1487547199-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJXrgErx7zzKYTNBXSte2%2Fuploads%2Fq3PvLtY31K1db7FxuKJQ%2FScreenshot%202023-12-15%20at%2007.38.53.png?alt=media&amp;token=bc691c58-b1d7-4816-a426-08b6763044f7" alt=""><figcaption><p>Add API user interface</p></figcaption></figure>

After creating the user, you can copy the secret key as seen below.

<figure><img src="https://1487547199-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJXrgErx7zzKYTNBXSte2%2Fuploads%2FjLCYy9XZuCpbfzyKtDLB%2Fdownload.png?alt=media&amp;token=a7e20e7b-9921-4ef4-b2ee-a052d9730332" alt=""><figcaption><p>API user secret key interface</p></figcaption></figure>

## Make your first request

Now you proceed to make your API requests 😊