---
title: "Get Reg-T simulation"
method: GET
path: "/entities/{entity_id}/regt-margin-simulations/{simulation_id}"
tags: ["Margin Simulations"]
---

# Get Reg-T simulation

`GET /entities/{entity_id}/regt-margin-simulations/{simulation_id}`

Get a Reg-T margin simluation that was previously created. Note, simulations are automatically deleted after 48-hours.

## Path parameters

- `entity_id` string, required — Entity ID for the legal entity.
- `simulation_id` string, uuid, required — Unique ID for a simulation.

## Response `200`

Reg-T margin simulation

- RegTMarginSimulation
  - `created_at` integer, required — Milliseconds since epoch.
  - `name` string, required — Name of a simulation.
  - `simulation_id` string, uuid, required — Unique ID for a simulation.
  - `before` RegTMargin, required
    - `version` string, required — Unique identifier for this margin calculation.
    - `timestamp` integer, required — Milliseconds since epoch.
    - `net_market_value` number, double, required — Market value net of long and short market values.
    - `effective_requirement` number, double, required — The enforced margin requirement in effect.
    - `effective_excess` number, double — The maring amount by taking the difference between total equity and the effective requirement. A negative number reflects an effective margin deficit.
    - `house_requirement` number, double, required — Margin requirements based on Clear Street's house margin methodology.
    - `house_excess` number, double, required — The margin amount by taking the difference between total equity and the house requirement. A negative number reflects a house margin deficit.
    - `exchange_requirement` number, double, required — Margin requirements based on regulatory rules.
    - `exchange_excess` number, double — The margin amount by taking the difference between total equity and the exchange requirement. A negative number reflects an regulatory margin deficit.
    - `sma` number, double, required — Special Memorandum Account (SMA). The regulatory line of credit amount for margin trading based on market value, trading activity, and available cash.
    - `sod_buying_power` number, double, required — The limit, or "up-to" amount, of securities value that can be day-traded for a given trading day.
    - `overnight_buying_power` number, double, required — The limit, or "up-to" amount, of securities value that can be purchased and held overnight.
    - `day_trade_buying_power` number, double, required — The remaining amount of start_of_day_buying_power that captures any day-trading activity.
    - `groups` RegTGroup[], required — Reg-T margin groups
      - `name` string, required — Unique name of the group, typically the symbol of the underlier.
      - `market_value` number, double, required — The aggregated market value of all instruments for the symbol group.
      - `market_value_percent` number, double, required — The percentage market value of the symbol group in terms of the total net_market_value of all positions. Formula: `(market_value / net_market_value)`
      - `effective_requirement` number, double, required — The enforced margin requirement in effect for the symbol group.
      - `house_requirement` number, double, required — Margin requirements based on Clear Street's house margin methodology for the symbol group.
      - `exchange_requirement` number, double, required — Margin requirements based on regulatory rules for the symbol group.
      - `margin_percent` number, double, required — The percentage effective margin requirement in terms of the symbol group market value. Formula: `(effective_requirement / net_market_value)`
      - `margin_percent_contribution` number, double, required — The percentage effective margin requirement in terms of the total effective requirement. Formula: `(effective_requirement / sum(effective_requirement))`
      - `members` RegTGroupMember[], required — A list of securities that comprise this group.
        - `symbol` string, required
        - `asset_class` 'other' | 'currency' | 'equity' | 'option' | 'debt' | 'fund', required — The asset class of the symbol.
        - `quantity` string, required — String representation of quantity.
        - `market_value` number, double, required — Market value of the instrument.
        - `market_value_percent` number, double, required — The percentage market value of the instrument in terms of the total `net_market_value` of all positions held. Formula: `market_value / net_market_value`
  - `after` RegTMargin, required
    - `version` string, required — Unique identifier for this margin calculation.
    - `timestamp` integer, required — Milliseconds since epoch.
    - `net_market_value` number, double, required — Market value net of long and short market values.
    - `effective_requirement` number, double, required — The enforced margin requirement in effect.
    - `effective_excess` number, double — The maring amount by taking the difference between total equity and the effective requirement. A negative number reflects an effective margin deficit.
    - `house_requirement` number, double, required — Margin requirements based on Clear Street's house margin methodology.
    - `house_excess` number, double, required — The margin amount by taking the difference between total equity and the house requirement. A negative number reflects a house margin deficit.
    - `exchange_requirement` number, double, required — Margin requirements based on regulatory rules.
    - `exchange_excess` number, double — The margin amount by taking the difference between total equity and the exchange requirement. A negative number reflects an regulatory margin deficit.
    - `sma` number, double, required — Special Memorandum Account (SMA). The regulatory line of credit amount for margin trading based on market value, trading activity, and available cash.
    - `sod_buying_power` number, double, required — The limit, or "up-to" amount, of securities value that can be day-traded for a given trading day.
    - `overnight_buying_power` number, double, required — The limit, or "up-to" amount, of securities value that can be purchased and held overnight.
    - `day_trade_buying_power` number, double, required — The remaining amount of start_of_day_buying_power that captures any day-trading activity.
    - `groups` RegTGroup[], required — Reg-T margin groups
      - `name` string, required — Unique name of the group, typically the symbol of the underlier.
      - `market_value` number, double, required — The aggregated market value of all instruments for the symbol group.
      - `market_value_percent` number, double, required — The percentage market value of the symbol group in terms of the total net_market_value of all positions. Formula: `(market_value / net_market_value)`
      - `effective_requirement` number, double, required — The enforced margin requirement in effect for the symbol group.
      - `house_requirement` number, double, required — Margin requirements based on Clear Street's house margin methodology for the symbol group.
      - `exchange_requirement` number, double, required — Margin requirements based on regulatory rules for the symbol group.
      - `margin_percent` number, double, required — The percentage effective margin requirement in terms of the symbol group market value. Formula: `(effective_requirement / net_market_value)`
      - `margin_percent_contribution` number, double, required — The percentage effective margin requirement in terms of the total effective requirement. Formula: `(effective_requirement / sum(effective_requirement))`
      - `members` RegTGroupMember[], required — A list of securities that comprise this group.
        - `symbol` string, required
        - `asset_class` 'other' | 'currency' | 'equity' | 'option' | 'debt' | 'fund', required — The asset class of the symbol.
        - `quantity` string, required — String representation of quantity.
        - `market_value` number, double, required — Market value of the instrument.
        - `market_value_percent` number, double, required — The percentage market value of the instrument in terms of the total `net_market_value` of all positions held. Formula: `market_value / net_market_value`

## Other responses

- `default` — Error response

---

[API](https://skmtc.net/clear-street/apis/common-api-models.md) · [All operations](https://skmtc.net/clear-street/apis/common-api-models/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clear-street/common-api-models/versions/05b4df42c056/schema)