Skip to main content

​
Endpoint

POST /info

​
Request Body

ParameterTypeDescription
type*stringMust be "assets"
user*stringUser’s wallet address (case-insensitive), e.g., "0x1234567890abcdef..."

​
Response

[
  {
    "asset": "0x0000000000000000000000000000000000000000",
    "hold": "0",
    "segregated": "0",
    "total": "10000.00",
    "coin": "USDC",
    "ltv": "1.0"
  }
]

​
Response Fields

FieldTypeDescription
assetstringAsset ID as hex string
holdstringAmount held (reserved for orders)
segregatedstringSegregated balance
totalstringTotal balance
coinstringAsset symbol (USDC, USDT, etc.)
ltvstringLoan-to-value ratio (1 - haircut)

​
Example Request

curl -X POST https://api.notional.xyz/info \
  -H "Content-Type: application/json" \
  -d '{
    "type": "assets",
    "user": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"
  }'

​
Error Responses

{
  "error": "Missing 'user' parameter for assets"
}
HTTP Status: 400 Bad Request

​
Notes

  • USDC is the primary collateral asset
  • The hold field indicates funds reserved for open orders
  • Available balance = total - hold