Skip to main content
GET /api/v1/account/loan

​
Query Parameters

FieldTypeNeedDescriptionExample
”account”stringrequiredAccount address42trU9A5…
/api/v1/account/loan?account=42trU9A5...

​
Response

  • Status 200: Successfully retrieved account loan info
{
  "success": true,
  "data": {
    "borrowed": "1250.500000",
    "pending_interest": "3.250000",
    "collateral_utilization": "0.45",
    "total_interest_earned": "120.750000",
    "total_interest_paid": "85.300000",
    "spot_balances": [
      {
        "symbol": "SOL",
        "amount": "10.00000000",
        "ltv_ratio": "0.90",
        "market_value": "1500.000000",
        "collateral_value": "1350.000000"
      }
    ],
    "updated_at": 1716200000000
  },
  "error": null,
  "code": null
}
FieldTypeDescription
'borrowed'decimal stringCurrent borrowed amount in USD
'pending_interest'decimal stringAccrued interest not yet repaid
'collateral_utilization'decimal stringRatio of borrowed amount to total spot collateral capacity
'total_interest_earned'decimal stringTotal interest earned as a lender (cumulative)
'total_interest_paid'decimal stringTotal interest paid as a borrower (cumulative, returned as positive)
'spot_balances'arraySpot balances with their effective LTV and collateral contribution (see below)
'updated_at'integerTimestamp in milliseconds of last data update
Spot Balance Fields
FieldTypeDescription
'symbol'stringSpot asset symbol
'amount'decimal stringSpot balance amount
'ltv_ratio'decimal stringEffective LTV ratio used for loan collateral
'market_value'decimal stringRaw marked-to-market USD value of this positive spot balance
'collateral_value'decimal stringEffective collateral contribution of this asset after LTV/cap logic
  • Status 404: Account loan cache not found
  • Status 500: Internal server error

​
Code Example (Python)

import requests

response = requests.get(
    "/api/v1/account/loan",
    params={"account": "42trU9A5..."},
    headers={"Accept": "*/*"},
)

data = response.json()