> For the complete documentation index, see [llms.txt](https://3commas.gitbook.io/3commas-official-api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://3commas.gitbook.io/3commas-official-api-docs/market-data/currency-rates-and-limits-with-leverage-data.md).

# Currency rates and limits with leverage data

<br>

**Description:** Returns the current trading rules and ticket information with data about leverages on the futures exchange<br>

{% hint style="success" %}
This is an endpoint that does not need authentication
{% endhint %}

<br>

> <mark style="color:blue;">**`GET`**</mark>
>
> `/ver1/accounts/currency_rates_with_leverage_data`

<br>

## Query Parameters<br>

**market\_code**     `integer`     <mark style="color:orange;">required</mark>\
Unique exchange code in the 3Commas system

**pair**     `integer`     <mark style="color:orange;">required</mark>\
Trading pair in 3Commas format

<br>

{% hint style="info" %}
The market and trading pair codes are used in 3Commas format. Use endpoints [Supported Markets List](/3commas-official-api-docs/market-data/supported-markets-list.md) to get value for parameter `market_code` and [All Market Pairs](/3commas-official-api-docs/market-data/all-market-pairs.md) to get value for parameter `pair` in 3Commas format.
{% endhint %}

<br>

## Response Parameters<br>

**last**     `string`\
Last price

**bid**     `string`\
Bid price

**ask**     `string`\
Ask price

**orderbook\_ask**     `string`\
Ask price of ticker

**orderbook\_bid**     `string`\
Bid price of ticker

**orderbook\_last**     `string`\
Last price of ticker

**orderbook\_price\_currency**     `string`\
Currency price of ticker

**strategy\_name**     `string`\
\[Description needed]

**leverage\_data**     `array[object]`\
Represents a leverage data for this pair

&#x20;     **code**     `string`\
&#x20;     The type of leverage available

&#x20;     **name**     `string`\
&#x20;     Name of the leverage option available for this contract

&#x20;     **can\_set\_leverage\_value**     `boolean`\
&#x20;     Indicates whether a custom leverage value can be set

&#x20;     **available\_leverage\_values**     `array`\
&#x20;     Available leverage values for settings for this pair and exchange

&#x20;     **max\_leverage**     `string`\
&#x20;     The maximum leverage value allowed for this contract

&#x20;    **value**     `string`\
&#x20;    Contains minimum and maximum leverage value that can be applied for this pair

&#x20;           **min**     `string`\
&#x20;           The minimum leverage value that can be applied to this contract

&#x20;           **max**     `string`\
&#x20;           The maximum leverage value that can be applied to this contract

**contract\_strategy\_name**     `string`\
The strategy by which the contract price is calculated

**instrumentKind**     `string`\
The type of exchange instrument

**minPrice**     `string`\
Minimum price order

**maxPrice**     `string`\
Maximum price order

**priceStep**     `string`\
The minimum step for changing the price

**minLotSize**     `string`\
The minimum lot size for order in Base currency

**lotStep**     `string`\
Order of changing the size in Base currency

**maxMarketBuyAmount**     `string`\
Maximum order size in Base currency for buy

**maxMarketSellAmount**     `string`\
Maximum order size in Base currency for sell

**bidMultiplierDown**     `string`\
A multiplier applied to decrease the bid price

**bidMultiplierUp**     `string`\
A multiplier applied to increase the bid price

**askMultiplierUp**     `string`\
A multiplier applied to increase the ask price

**askMultiplierDown**     `string`\
A multiplier applied to decrease the ask price

**minTotal**     `string`\
Minimum order size in Quote

**minMarketTotal**     `string`\
Minimum order size in Quote for market order

**maxTotal**     `string`\
Maximum order size in Quote

**maxLotSize**     `string`\
Maximum order size in Base

\ <br>

## Example request<br>

```json
GET /ver1/accounts/currency_rates_with_leverage_data?market_code=binance_futures_eea&pair=BNFCR_1INCHUSDT
```

<br>

## Example response and errors<br>

<details>

<summary>Status: 200 OK</summary>

<br>

```json
{
  "last": "0.3039",
  "bid": "0.3039",
  "ask": "0.304",
  "orderbook_ask": "0.304",
  "orderbook_bid": "0.3039",
  "orderbook_last": "0.3039",
  "orderbook_price_currency": "BNFCR",
  "strategy_name": "orderbook_price",
  "contract_strategy_name": "orderbook_price",
  "leverage_data": [
    {
      "code": "cross",
      "name": "Cross",
      "can_set_leverage_value": true,
      "available_leverage_values": [
        
      ],
      "max_leverage": "25.0",
      "valid": {
        "min": 1,
        "max": "25.0"
      }
    }
  ],
  "instrumentKind": "linear_futures",
  "priceStep": "0.0001",
  "minLotSize": "1.0",
  "maxLotSize": "5000000.0",
  "lotStep": "1.0",
  "maxMarketBuyAmount": "500000.0",
  "maxMarketSellAmount": "500000.0",
  "minMarketBuyAmount": "1.0",
  "minMarketSellAmount": "1.0",
  "minTotal": "5.0",
  "bidMultiplierUp": "1.1",
  "askMultiplierDown": "0.9",
  "minPrice": "0.0613",
  "maxPrice": "100000.0"
}
```

</details>

<details>

<summary>Status: 400 Bad Request</summary>

\ <br>

```json
{
  "error": "Unknown pair"
}
```

</details>
