> For the complete documentation index, see [llms.txt](https://docs.dexpal.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dexpal.io/for-partners/schemas/collateral-breakdown.md).

# Collateral Breakdown

Per-asset collateral entry for multi-asset margin accounts. Used in [`positions`](/for-partners/endpoints/user-positions.md) as a nested array in `collateralBreakdown`.

## Schema

| Field       | Type   | Required | Description                                                                                                                              |
| ----------- | ------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `asset`     | string | yes      | Asset symbol e.g. `"BTC"`, `"ETH"`, `"USDC"`.                                                                                            |
| `amount`    | number | yes      | Raw token amount of this asset posted as collateral.                                                                                     |
| `amountUsd` | number | yes      | USD value of `amount` at the time of the response.                                                                                       |
| `haircut`   | number | yes      | Collateral factor (0–1). Fraction of USD value credited toward margin. e.g. `0.85` = 85 cents of margin credit per dollar of this asset. |

## Example

```json
[
  {
    "asset": "BTC",
    "amount": 0.01,
    "amountUsd": 670.0,
    "haircut": 0.95
  },
  {
    "asset": "ETH",
    "amount": 0.5,
    "amountUsd": 1750.0,
    "haircut": 0.90
  }
]
```

## Notes

* `amountUsd` should be calculated at the current mark price of each asset at response time.
* The sum of `amount * haircut` across all entries determines the effective margin the position can use.
* Only present when the DEX supports multi-asset collateral (`collateralBreakdown` in `RawPosition`).