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

# Getting started

Welcome to Silus API portal. Using our API you can:

* Create invoices & check their statuses;
* Make payouts;
* Check project balances.

## API Basics

All of the API requests should be made on `https://api.silus.io/v1/`.

### Idempotence of the API

Idempotence is the feature of the API to provide the same result upon a repeated request as it did on the initial request, without reprocessing.

This means you can send multiple requests to the system with the same identifier, and only one successful request will be processed, with all responses being identical. This implementation serves as protection against network errors that lead to the creation of duplicated records and actions.

### Requests Authentication

For most of our API endpoints we require authentication. For most of the methods it is done via  Bearer tokens ( `Authorization: Bearer ..` header). You can obtain yours from the back office

For additional security, we require `X-Project-ID` header to be sent with every request.

{% hint style="warning" %}
Take a note we're using different keys for Invoices and Payouts. You can obtain both from the backoffice. 
{% endhint %}

### Rate limits

To provide better service experience, we limit requests on per minute basis. Current system limitations:

* Invoice creating: **120 per minute\***
* Any other method: **60 per minute\***

\*These limits are negotiable. You can contact us and tell us your case, so we could extend them for your project.

In case of exceeding these limits, you will receive `429 Too Many Requests` status with `X-Retry-After` header which will indicate how much time (in seconds) you need to wait until next request.

## Let's build something!

{% content-ref url="/pages/v5NCLPcg4vySExGrRVNZ" %}
[Invoices](/methods/invoices.md)
{% endcontent-ref %}

{% content-ref url="/pages/YQN191S2DIWEsmPN0VpU" %}
[Withdrawals](/methods/withdrawals.md)
{% endcontent-ref %}

{% content-ref url="/pages/OITdk9xmpOyCVcmkquD2" %}
[Balances](/methods/services.md)
{% endcontent-ref %}

{% content-ref url="/pages/EcdHoJyX1TrrbEn06mdY" %}
[Exchange Rates](/methods/exchange-rates.md)
{% endcontent-ref %}

{% content-ref url="/pages/5qzKJ2F1N4s56Dh9BdSY" %}
[Currency-network reference](/methods/currencies.md)
{% endcontent-ref %}

{% content-ref url="/pages/ErrwfWWaBIeU2AZYMgnn" %}
[Supported Fiat currencies](/methods/fiat-currencies.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.silus.io/getting-started.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.