---
title: "Get Market Marker Protection (MMP) by Trading Account ID"
method: GET
path: "/v2/mmp-configuration"
tags: ["market-maker-protection"]
---

# Get Market Marker Protection (MMP) by Trading Account ID

`GET /v2/mmp-configuration`

## Request

- Base URL: `https://api.exchange.bullish.com/trading-api`
- URL: `https://api.exchange.bullish.com/trading-api/v2/mmp-configuration`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/bullish/apis/bullish-trading-api/docs/v2/mmp-configuration/get.ts> (a function with typed inputs; its response is checked against the schema)

Get market maker protection configurations under a trading account id

This endpoint requires [authentication](/rest/authentication#generate-a-jwt-token). To filter by `symbol`, additional parameters are required. For detailed instructions, see the [Filtering Support](/rest/general/filtering) section.

## Query parameters

- `symbol` string: the underlying asset symbol that is configured for MMP checks
- `tradingAccountId` string, required: unique trading account ID

## Response `200`

Status OK. This means a command was successfully acknowledged.

- GetMmpConfigurationResponse
  - `tradingAccountId` string, required: unique trading account ID
  - `message` string, required: If there are no market maker protection configurations setup for this trading account or for the provided optional symbol under the same trading account, this field will be returned as "No mmp config setup".
  - `mmpConfigurations` MmpConfiguration[], required: A list of market maker protection configurations that the user has setup for each underlying asset symbol under the trading account provided. Supports filtering of symbol.
    - `underlyingAssetSymbol` string, required: Underlying Asset Symbol
    - `windowTimeInSeconds` integer, required: Time window during which the MMP checks are conducted. It helps in determining how frequently the system evaluates the market maker's activity against predefined thresholds. Value needs to be `> 0`. Maximum value is 600 seconds (10 minutes).
    - `frozenTimeInSeconds` integer, required: The duration for which a market maker's trading activity is temporarily halted after a protective measure is triggered. Value needs to be `>= 0`. Maximum value is 3600 seconds (60 minutes).
    - `quantityLimit` string, required: Cap on the total number of contracts that a market maker can trade within `windowTimeInSeconds`. This is direction(side) agnostic. Needs to be `> 0` if set.
    - `deltaLimit` string, required: Net delta exposure that a market maker can accumulate within `windowTimeInSeconds`
    - `isActive` boolean, required: This boolean indicates if this configuration is in effect or not.

## Other responses

- `400`: Bad Request
- `401`: Not Authenticated
- `403`: Access Forbidden

---

[API](https://skmtc.dev/bullish/apis/bullish-trading-api.md) - [All operations](https://skmtc.dev/bullish/apis/bullish-trading-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bullish/apis/bullish-trading-api/revisions/df5d69ccedcf?raw)