Get Collaterals

Retrieve configuration for all supported collateral assets, including deposit caps, LTV thresholds, withdrawal fees, and tiered haircut structures.

Endpoint

POST https://papi.synthetix.io/v1/info

Request

Request Format

{
  "params": {
    "action": "getCollaterals"
  }
}

Request Parameters

Parameter	Type	Required	Description
`params.action`	string	Yes	Must be `"getCollaterals"`

Response

Success Response

{
  "status": "ok",
  "response": [
    {
      "collateral": "USDT",
      "market": "USDTUSD",
      "depositCap": "10000000.00000000",
      "ltv": "0.95",
      "lltv": "0.98",
      "withdrawFee": "5.00000000",
      "tiers": [
        {
          "id": 1,
          "name": "Tier1",
          "minAmount": "0.00000000",
          "maxAmount": "100000.00000000",
          "valueRatio": "1.00000000",
          "haircut": "0.00000000",
          "valueAddition": "0.00000000"
        },
        {
          "id": 2,
          "name": "Tier2",
          "minAmount": "100000.00000000",
          "maxAmount": "",
          "valueRatio": "0.99500000",
          "haircut": "0.00500000",
          "valueAddition": "0.00000000"
        }
      ]
    },
    {
      "collateral": "ETH",
      "market": "ETHUSD",
      "depositCap": "5000.00000000",
      "ltv": "0.90",
      "lltv": "0.95",
      "withdrawFee": "5.00000000",
      "tiers": [
        {
          "id": 3,
          "name": "Tier1",
          "minAmount": "0.00000000",
          "maxAmount": "50000.00000000",
          "valueRatio": "0.98000000",
          "haircut": "0.02000000",
          "valueAddition": "0.00000000"
        }
      ]
    }
  ],
  "requestId": "5ccf215d37e3ae6d"
}

Collateral Object Fields

Field	Type	Description
`collateral`	string	Collateral asset symbol (e.g., "USDT", "ETH", "WBTC")
`market`	string	Price feed market used to value this collateral (e.g., "USDTUSD", "ETHUSD")
`depositCap`	string	Platform-wide maximum deposit limit for this collateral type (decimal string)
`ltv`	string	Loan-to-Value ratio - target after auto-exchange (e.g., "0.95" for 95%)
`lltv`	string	Liquidation LTV - threshold that triggers auto-exchange to USDT (e.g., "0.98" for 98%)
`withdrawFee`	string	Flat fee in USD charged when withdrawing this collateral (decimal string)
`tiers`	array	Array of collateral tier configurations for tiered haircut structure

Tier Object Fields

Field	Type	Description
`id`	integer	Unique tier identifier
`name`	string	Tier name (e.g., "Tier1", "Tier2")
`minAmount`	string	Minimum amount in USDT for this tier (decimal string)
`maxAmount`	string	Maximum amount in USDT for this tier (decimal string, empty if unlimited)
`valueRatio`	string	Collateral value ratio (e.g., "0.995" for 99.5% value)
`haircut`	string	Collateral haircut percentage (e.g., "0.01" for 1% haircut)
`valueAddition`	string	Fixed value addition in USDT (decimal string)

Error Response

{
  "status": "error",
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "Could not retrieve collateral configuration",
    "details": {}
  },
  "requestId": "5ccf215d37e3ae6d"
}

Code Examples

Get All Collaterals

{
  "params": {
    "action": "getCollaterals"
  }
}

Collateral Information

No Authentication Required: Public endpoint accessible without signing
Supported Assets: Returns all collateral types supported by the platform
Tiered Haircuts: Larger collateral holdings may have larger haircuts applied
Auto-Exchange: Non-USDT collateral may be auto-exchanged when LLTV threshold is breached

Use Cases

Deposit Planning: Check deposit caps and supported assets before depositing
Withdrawal Validation: Verify withdrawal fees for each collateral type
Risk Assessment: Understand LTV/LLTV thresholds for non-USDT collateral
Collateral Valuation: Calculate effective collateral value using tier haircuts

Validation Rules

No authentication required
No rate limiting beyond standard API limits
Returns data for all configured collateral assets

Error Handling

Common error scenarios:

Error Code	Description	Retryable
`UNAUTHORIZED`	EIP-712 signature validation failed	No
`VALIDATION_ERROR`	Request validation failed	No
`MISSING_REQUIRED_FIELD`	Required field is missing	No
`INVALID_FORMAT`	Field format is invalid	No
`INVALID_VALUE`	Invalid parameter value	No
`RATE_LIMIT_EXCEEDED`	Too many requests in time window	Yes
`INSUFFICIENT_MARGIN`	Not enough margin for trade	No
`ORDER_NOT_FOUND`	Order does not exist	No
`OPERATION_TIMEOUT`	Operation timed out	Yes

Error	Description
Collateral configuration unavailable	Failed to retrieve collateral data from configuration service
Internal error	Service temporarily unavailable

Related Endpoints

Get Markets - Market configuration
Withdraw Collateral - Withdraw collateral from subaccount
Get Subaccount - View collateral balances