# 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>


---

# Agent Instructions: 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://faq.finerymarkets.com/api-reference/rest-api/risk-management/climits.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.