---
title: "Create a new collateral package"
method: POST
path: "/collateral_management/packages"
tags: ["Collateral Management"]
---

# Create a new collateral package

`POST /collateral_management/packages`

Permissions required: **Manage Collateral Packages** and **Read vault activity**


Creates a new collateral package in the Collateral Management service.

## Headers

- `Api-Signature` string, required
- `Api-Timestamp` integer, required

## Request body

- CMCreatePackageRequest — The request payload for creating a new collateral package.
  - `acceleratedMarginCall` CMAcceleratedMarginCall — Accelerated Margin Call level config
    - `action` 'NONE' | 'PARTIAL' | 'FULL' | 'SWEEP', required — The action to be taken when the collateral package transitions into a Margin Call state
    - `curePeriod` string, required — The duration of the cure period for the accelerated margin call, specified in a format such as '1h' for 1 hour or '1m' for 1 minute
    - `ltv` string, required — The LTV threshold at which the Collateral Package will enter into an Accelerated Margin Call state, subject to cure period constraints
  - `clientReferenceId` string — A reference identifier provided by the client for this collateral package
  - `collateralAssetsConfig` CMAssetTrackingConfig[], required
    - `asset` CMAssetType, required — Asset symbol or ticker (e.g. BTC)
      - `assetType` string, required
      - `type` 'ANCHORAGECUSTODY' | 'EXTERNAL', required — The type of asset held in the Collateral Package. This can be either `ANCHORAGECUSTODY` for assets held in Anchorage custody, or `EXTERNAL` for assets held outside of Anchorage custody.
    - `liquidationPriority` integer, required — The priority order for liquidating this asset in the event of a default or margin call
    - `maxStalenessMinutes` integer — Optional maximum staleness in minutes assigned to the asset price in the collateral package configuration, expressed as an integer. If not specified, uses the system default configured (3 minutes)
    - `notes` string — Optional additional notes or comments about the asset tracking configuration
    - `priceSource` 'COINBASEPRO' | 'KRAKEN' | 'KAMINO' | 'BINANCE' — This field specifies the source from which the price information is derived
    - `weight` string, required — The configured weight assigned to the asset in the collateral package configuration, expressed as a decimal string
  - `critical` CMCritical — Critical level config
    - `action` 'NONE' | 'PARTIAL' | 'FULL' | 'SWEEP', required — The action to be taken when the collateral package transitions into a Critical state
    - `defaultNotice` boolean, required — A boolean parameter, if marked TRUE Anchorage will send a default notice to the Pledgor upon entering the critical state
    - `ltv` string, required — The LTV threshold at which the Collateral Package will enter into this state
    - `returnToLtv` string, required — The LTV that a collateral package must return to before transitioning back to a healthy state. This parameter is only configured if action within Critical Object is set to ‘Partial’
    - `warningLtv` string, required — The LTV at which a warning is sent notifying the parties that the collateral package is close to entering a particular state
  - `ltvRoundingPrecision` integer — Number of decimal places to round LTV values to
  - `marginCall` CMMarginCall — Margin Call level config
    - `action` 'NONE' | 'PARTIAL' | 'FULL' | 'SWEEP', required — The action to be taken when the collateral package transitions into a Margin Call state
    - `curePeriod` string, required — Time after the margin call that pledgor has to top up collateral and bring the LTV to the ‘returnToLtv’ (healthy state)”. The duration of the cure period, specified in a format such as '1h' for 1 hour or '1m' for 1 minute.
    - `curePeriodProtection` boolean, required — If activated, it prevents the transition of the collateral package to the critical stage while the cure period of a previous margin call lasts
    - `ltv` string, required — The LTV threshold at which the Collateral Package will enter into this state, subject to cure period constraints
    - `returnToLtv` string, required — The LTV that a collateral package must return to before a margin call is considered to be fulfilled and the collateral package is returned to a healthy state
    - `topUpType` 'LTV' | 'QUANTITY', required — Option on how to satisfy a Margin Call. If ‘LTV’ is selected, the requirement to cure the margin call is to bring the LTV below the ‘returnToLtv’ (healthy state). If ‘QUANTITY’ is selected, the requirement to cure the margin call is to provide the number of units of collateral asset calculated when the margin call was issued, regardless if LTV fluctuates during a potential cure period
    - `warningLtv` string, required — The LTV at which a warning is sent notifying the parties that the collateral package is close to entering a particular state
  - `marginReturn` CMMarginReturn — Margin Return level config
    - `action` 'NONE' | 'SWEEP', required — The action to be taken when the collateral package transitions into a Margin Return state
    - `ltv` string, required — The LTV threshold at which the Collateral Package will be eligible for a Margin Return
    - `returnToLtv` string, required — The LTV that a collateral package must return to before a margin return is considered to be fulfilled and the collateral package is returned to a healthy state
  - `pledgorId` string, required — Collateral management participant ID of the Pledgor (borrower) associated with this collateral package
  - `priceStrategy` 'DEFAULT' | 'BID' | 'ASK' | 'MID' | 'LAST', required — This field specifies the pricing strategy to be used for the collateral package. To be implemented in the future
  - `securedPartyId` string, required — Unique identifier of the secured party (lender) associated with this collateral package

## Response `201`

Successfully created collateral package

- CreateCMPackageResponse
  - `packageId` string, required

## Other responses

- `400` — Bad Request
- `401` — Unauthenticated
- `403` — Forbidden
- `422` — Unprocessable Entity
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/anchorage/apis/anchorage-digital-api-reference.md) · [All operations](https://skmtc.net/anchorage/apis/anchorage-digital-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/anchorage/anchorage-digital-api-reference/versions/166864b1ec6d/schema)