Skip to main content
Balance WebSocket
curl --request GET \
  --url https://synthesis.trade/api/v1/balance/ws \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "<string>",
  "wallets": [
    {
      "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
      "assets": [
        "USDC",
        "12345"
      ]
    },
    {
      "address": "7xKXtg2CWz9P8VxP1Wm2G7x5Q8Y9LwYH6a7b8c9d1e2F"
    }
  ]
}
'
{
  "success": true,
  "response": {
    "wallets": [
      {
        "chain_id": "POL",
        "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
        "balances": {
          "USDC": "1234.567",
          "21742633143463906290569050155826241533067272736897614950488156847949938836455": "150.000"
        }
      },
      {
        "chain_id": "SOL",
        "address": "7xKXtg2CWz9P8VxP1Wm2G7x5Q8Y9LwYH6a7b8c9d1e2F",
        "balances": {
          "USDC": "500.000"
        }
      }
    ]
  }
}

Body

application/json
​
type
string
required

WebSocket message type. Supported values: subscribe or unsubscribe.

​
wallets
object[]
required

Wallet subscription list. Maximum 500 wallet entries total, and no more than 500 total requested assets across all entries.

Example:
[
  {
    "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
    "assets": ["USDC", "12345"]
  },
  {
    "address": "7xKXtg2CWz9P8VxP1Wm2G7x5Q8Y9LwYH6a7b8c9d1e2F"
  }
]

Response

101 - application/json

WebSocket connection established