> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anchorage.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Asset-backed loans
> Offer your clients loans backed by their digital assets, monitored through Anchorage Digital's collateral management system.
Let your clients borrow against their digital assets without selling them, while Anchorage Digital prices the collateral and monitors loan-to-value in real time. You register the loan and respond to margin events; Anchorage Digital handles continuous risk monitoring so you don't have to build it yourself.
## How it works
When you approve a loan, create a collateral package specifying the pledgor (your end client), the pledged assets, and the loan-to-value thresholds that should trigger a warning, a margin call, or a critical alert.
Register the loan itself as an exposure against that collateral package, tagged with your own loan ID.
As the loan progresses, record activity: the initial pledge, any top-ups or margin returns, and the eventual payoff.
Anchorage Digital continuously prices the pledged assets and calculates loan-to-value in real time, alerting you as thresholds are approached or crossed.
When a threshold is breached, respond directly — for example, requesting a margin return — or, if pre-configured, let Anchorage Digital take an agreed action automatically as collateral manager.
Loan collateral can be held in the same subaccount as your client's tradable funds, so you don't need a separate account structure to offer asset-backed loans alongside custody and trading.
For the full collateral management concepts — terminology, package states, configured actions, pricing methodology, and liquidation mechanics — see [Atlas collateral management](/knowledge-base/platform/developers/atlas/atlas-collateral-management). This page covers the wealth-management-specific integration flow only.
Whether you or Anchorage Digital handles collateral unlock and liquidation depends on whether Anchorage Digital is configured as collateral manager for your program. Confirm this during setup.
***
## Integration steps
These calls require the **Manage Collateral Packages** and **Read vault activity** [API permissions](/knowledge-base/platform/developers/permission-groups). `POST` requests also require [request signing](/knowledge-base/platform/developers/request-signing).
### Step 1: Set up the collateral record
**`POST /v2/collateral_management/packages`**
Specify the pledgor, the pledged assets, and the loan-to-value thresholds that trigger a warning, margin call, or critical alert.
```bash Request theme={null}
curl --request POST \
--url https://api.anchorage-staging.com/v2/collateral_management/packages \
--header 'Api-Access-Key: [API Key]' \
--header 'Api-Signature: [Signature]' \
--header 'Api-Timestamp: [Timestamp]' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '{
"pledgorId": "end-client-042",
"securedPartyId": "your-lending-desk",
"collateralAssetsConfig": [
{
"asset": { "type": "ANCHORAGECUSTODY", "assetType": "BTC" },
"weight": "1",
"liquidationPriority": 1,
"priceSource": "COINBASEPRO"
}
],
"priceStrategy": "MID",
"marginCall": {
"ltv": "0.70",
"warningLtv": "0.65",
"returnToLtv": "0.60",
"curePeriod": "24h",
"curePeriodProtection": true,
"topUpType": "LTV",
"action": "NONE"
},
"critical": {
"ltv": "0.85",
"warningLtv": "0.80",
"returnToLtv": "0.70",
"defaultNotice": true,
"action": "FULL"
}
}'
```
```json Response theme={null}
{
"packageId": "9c3e5a1f-2b4d-4e6a-8f7c-1d5b9a2e4c6f"
}
```
### Step 2: Register the loan
**`POST /v2/collateral_management/exposures`**
```bash Request theme={null}
curl --request POST \
--url https://api.anchorage-staging.com/v2/collateral_management/exposures \
--header 'Api-Access-Key: [API Key]' \
--header 'Api-Signature: [Signature]' \
--header 'Api-Timestamp: [Timestamp]' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '{
"collateralPackageID": "9c3e5a1f-2b4d-4e6a-8f7c-1d5b9a2e4c6f",
"clientReferenceId": "your-loan-id-001",
"type": "LOAN",
"priceStrategy": "MID",
"assetTrackingConfig": {
"asset": { "type": "ANCHORAGECUSTODY", "assetType": "BTC" },
"liquidationPriority": 1
}
}'
```
```json Response theme={null}
{
"exposureId": "4f8b6d2a-9e1c-4a3f-b7d5-2c8e6a4f1b9d"
}
```
### Step 3: Record the initial pledge
Record the collateral deposit against the package, and the loan principal against the exposure.
```bash Request — collateral deposit theme={null}
curl --request POST \
--url https://api.anchorage-staging.com/v2/collateral_management/operations \
--header 'Api-Access-Key: [API Key]' \
--header 'Api-Signature: [Signature]' \
--header 'Api-Timestamp: [Timestamp]' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '{
"type": "COLLATERAL_PACKAGE",
"typeId": "9c3e5a1f-2b4d-4e6a-8f7c-1d5b9a2e4c6f",
"action": "INITIAL_DEPOSIT",
"asset": { "type": "ANCHORAGECUSTODY", "assetType": "BTC" },
"quantity": "1.5",
"idempotentId": "your-loan-id-001-deposit-1"
}'
```
```bash Request — loan funding theme={null}
curl --request POST \
--url https://api.anchorage-staging.com/v2/collateral_management/operations \
--header 'Api-Access-Key: [API Key]' \
--header 'Api-Signature: [Signature]' \
--header 'Api-Timestamp: [Timestamp]' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '{
"type": "EXPOSURE",
"typeId": "4f8b6d2a-9e1c-4a3f-b7d5-2c8e6a4f1b9d",
"action": "INITIAL_FUNDING",
"asset": { "type": "ANCHORAGECUSTODY", "assetType": "USD" },
"quantity": "50000",
"idempotentId": "your-loan-id-001-funding-1"
}'
```
### Step 4: Monitor loan-to-value
**`GET /v2/collateral_management/packages/{packageId}`**
Returns `currentLtv`, `state` (`HEALTHY`, `MARGIN_CALL`, `CRITICAL`, and other values), `packageValue`, and `exposureValue`. Alerts fire automatically by email and webhook as the thresholds set in Step 1 are crossed — see [Email and webhook notifications](/knowledge-base/platform/developers/atlas/atlas-collateral-management#email-and-webhook-notifications).
### Step 5: Respond to a threshold breach
Request a margin return once the package enters the `MARGIN_RETURN` state:
```bash Request theme={null}
curl --request POST \
--url https://api.anchorage-staging.com/v2/collateral_management/packages/9c3e5a1f-2b4d-4e6a-8f7c-1d5b9a2e4c6f/requests/margin-return \
--header 'Api-Access-Key: [API Key]' \
--header 'Api-Signature: [Signature]' \
--header 'Api-Timestamp: [Timestamp]' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '{
"assetAmounts": [
{ "assetTypeID": "BTC", "value": "0.2" }
],
"idempotencyKey": "your-loan-id-001-margin-return-1",
"useGasStation": false
}'
```
Or, once your client tops up collateral in response to a margin call:
```bash Request theme={null}
curl --request POST \
--url https://api.anchorage-staging.com/v2/collateral_management/operations \
--header 'Api-Access-Key: [API Key]' \
--header 'Api-Signature: [Signature]' \
--header 'Api-Timestamp: [Timestamp]' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '{
"type": "COLLATERAL_PACKAGE",
"typeId": "9c3e5a1f-2b4d-4e6a-8f7c-1d5b9a2e4c6f",
"action": "TOP_UP",
"asset": { "type": "ANCHORAGECUSTODY", "assetType": "BTC" },
"quantity": "0.3",
"idempotentId": "your-loan-id-001-topup-1"
}'
```