> 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/risk-management/climits.md).

# climits

**POST api/climits**

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

```
{}
```

{% endtab %}

{% tab title="200 OK" %}

```json
[
  {
    "counterpartyId": 5,
    "tradingPermissions": {
      "ownTradingEnabled": true,
      "mutualTradingEnabled": false
    },
    "ownLimit": {
      "grossLimit": 1000000000,
      "asset": "BTC",
      "limitUtilization": 5000000,
      "equity": 300000,
      "maintenanceMargin": 1000,
      "restrictedTrading": 2000,
      "initialMargin": 3000
    },
    "mutualLimit": {
      "grossLimit": 500000000000,
      "asset": "USD",
      "limitUtilization": 1000000000,
      "equity": -300000,
    }
  },
  {
    "counterpartyId": 10,
    "tradingPermissions": {
      "ownTradingEnabled": true,
      "mutualTradingEnabled": true,
      "ownIncomingFlowEnabled": true,
      "ownOutgoingFlowEnabled": false,
      "mutualIncomingFlowEnabled": true,
      "mutualOutgoingFlowEnabled": true
    },
    "ownLimit": {
      "grossLimit": 500000000000,
      "asset": "USD",
      "limitUtilization": 0,
      "equity": 0
    }
  }
]
```

{% endtab %}

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

```json
{
    "error": 2
}
```

{% endtab %}
{% endtabs %}

**Response description**

<table><thead><tr><th>Field name</th><th width="201">Type</th><th>Description</th></tr></thead><tbody><tr><td></td><td>Array of CLimits</td><td>Array of counterparty limits</td></tr><tr><td><strong>CLimit</strong></td><td>Dict</td><td></td></tr><tr><td>counterpartyId</td><td>Efx::ClientId</td><td>Counteraparty Id </td></tr><tr><td>tradingPermissions</td><td>TradingPermissions</td><td>Own and mitual trading permissions.</td></tr><tr><td>ownLimit</td><td>LimitData</td><td><em>Optional.</em> Own limit data, present only if the own gross limit exists.</td></tr><tr><td>mutualLimit</td><td>LimitData</td><td><em>Optional.</em> Mutual limit data, present only if the counterparty set the gross limit.</td></tr><tr><td><strong>LimitData</strong></td><td>Dict</td><td></td></tr><tr><td>grossLimit</td><td>Efx::Size</td><td>Gross limit value.</td></tr><tr><td>asset</td><td>string</td><td>Gross limit currency name.</td></tr><tr><td>limitUtilization</td><td>Efx::Size</td><td>Maintenance margin.<br>In % multiplied by 1e4.</td></tr><tr><td>equity</td><td>Efx::Size</td><td>Equity.</td></tr><tr><td>maintenanceMargin</td><td>int32</td><td><em>Optional.</em> Maintenance margin.<br>In % multiplied by 1e4.</td></tr><tr><td>restrictedTrading</td><td>int32</td><td><em>Optional.</em> Restricted trading level.<br>In % multiplied by 1e4.</td></tr><tr><td>initialMargin</td><td>int32</td><td><em>Optional.</em> Initial margin.<br>In % multiplied by 1e4.</td></tr><tr><td><strong>TradingPermissions</strong></td><td>Dict</td><td></td></tr><tr><td>ownTradingEnabled</td><td>bool</td><td>True if trading enabled by client.</td></tr><tr><td>mutualTradingEnabled</td><td>bool</td><td>True if trading enabled by counterparty.</td></tr><tr><td>ownIncomingFlowEnabled</td><td>bool</td><td><em>Optional</em>.  Field is present only for master-master connection. True if incoming flow from counterparty master is enabled by master client.</td></tr><tr><td>ownOutgoingFlowEnabled</td><td>bool</td><td><em>Optional</em>.  Field is present only for master-master connection. True if outgoing flow to counterparty master is enabled by master client.</td></tr><tr><td>mutualIncomingFlowEnabled</td><td>bool</td><td><em>Optional</em>.  Field is present only for master-master connection. True if counterparty master enabled incoming flow from the master client.</td></tr><tr><td>mutualOutgoingFlowEnabled</td><td>bool</td><td><em>Optional</em>.  Field is present only for master-master connection. True if counterparty master enabled outgoing flow to the master client.</td></tr></tbody></table>
