For the complete documentation index, see llms.txt. This page is also available as Markdown.

Collateral Breakdown

Per-asset collateral entry for multi-asset margin accounts. Used in positions 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

[
  {
    "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).

Last updated