> For the complete documentation index, see [llms.txt](https://faq.finerymarkets.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://faq.finerymarkets.com/api-reference/rest-api/non-deliverable-trading/settings-getovernightrates.md).

# settings/getOvernightRates

Returns snapshot of overnight rates.

Overnight rates are set by makers and masters for trading assets. There are 2 types of overnight rates: positive and negative, each is set in percent per annum (%APR).

The system will decrease counterparty's/sub-account's negative positions every day by a calculated amount if a maker/master sets non-zero negative rates. If positive rates are set, positive positions will increase. A maker/master can set an individual rate for a counterparty/sub-account per asset.

Once rates are set, a system executes settlement orders to change positions at 00:00 UTC on a daily basis from the next day.

**POST api/settings/get\_overnight\_rates**

{% tabs %}
{% tab title="Payload" %}

```
{}
```

{% endtab %}

{% tab title="200 OK" %}
Response sample. Rates are in int32 format and rate=100 = 1 bps = 0.01%

<pre class="language-json"><code class="lang-json">[
  {
    "currency": "BTC", 
<strong>    "counterparty": 2, 
</strong>    "name": "FineryMarkets"
    "negativeRate": 100000, // negative rate value
    "positiveRate": 0 // positive rate value
  },
  ...
]
</code></pre>

{% endtab %}

{% tab title="400 Bad request" %}

```json
{
    "error": 9
}
```

{% endtab %}
{% endtabs %}

**Response description (for makers, takers)**

| Field name   | Type           | Description                                          |
| ------------ | -------------- | ---------------------------------------------------- |
|              | Array of rates | Array of overnight rates by asset and counterparty   |
| **Rate**     | JSON           |                                                      |
| currency     | string         | Currency name                                        |
| counterparty | ClientId       | Counterparty id                                      |
| name         | string         | Counterparty name                                    |
| negativeRate | unsigned int32 | <p>Negative rate,<br>min value=100=1 bps = 0.01%</p> |
| positiveRate | unsigned int32 | <p>Positive rate,<br>min value=100=1 bps = 0.01%</p> |

**Response description (for masters)**

| Field name  | Type                           | Description                                           |
| ----------- | ------------------------------ | ----------------------------------------------------- |
| **own**     | Array of OwnOvernightRates     |                                                       |
| rate        | Array of items                 | With the same structure as for makers, takers (above) |
| **against** | Array of AgainstOvernightRates |                                                       |
| rate        | Array of items                 | With the same structure as for makers, takers (above) |