Room ID: polymarket_accounts
Endpoint: wss://api.struct.to/ws
Rate: 0.005 credits per message
include_usdce, include_pusd, and include_matic to receive those balance types as well.
Subscribe
The wallets filter is required. Optionally enable USDCe, pUSD, and MATIC balance updates with the boolean flags.
Filters
| Filter | Type | Required | Description |
|---|
wallets | string[] | Yes | Wallet addresses to track (0x-prefixed) |
include_usdce | boolean | No | Include USDCe collateral balance updates, V1 (default: false) |
include_pusd | boolean | No | Include pUSD collateral balance updates, V2 CLOB (default: false) |
include_matic | boolean | No | Include MATIC gas balance updates (default: false) |
Example
{
"type": "join_room",
"payload": {
"room_id": "polymarket_accounts"
}
}
{
"type": "room_message",
"payload": {
"room_id": "polymarket_accounts",
"message": {
"action": "subscribe",
"wallets": ["0x1234567890abcdef1234567890abcdef12345678"],
"include_usdce": true,
"include_pusd": true,
"include_matic": true
}
}
}
Response
{
"type": "accounts_stream_subscribe_response",
"room_id": "polymarket_accounts",
"data": {
"wallets": ["0x1234567890abcdef1234567890abcdef12345678"],
"rejected": [],
"include_usdce": true,
"include_pusd": true,
"include_matic": true
}
}
Events
accounts_update
Share balance update for a tracked wallet.
{
"type": "accounts_update",
"room_id": "polymarket_accounts",
"data": {
"wallet": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
"position_id": "12345678901234567",
"balance": "500.000000",
"block_number": 65000000,
"updated_at": 1743500000,
"condition_id": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
"event_slug": "bitcoin-price-markets"
}
}
usdce_update
USDCe (V1) collateral balance update for a tracked wallet.
{
"type": "usdce_update",
"room_id": "polymarket_accounts",
"data": {
"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
"token_address": "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174",
"balance": "10250.500000",
"block_number": 65000000,
"updated_at": 1743500000
}
}
pusd_update
pUSD (V2 CLOB) collateral balance update for a tracked wallet.
{
"type": "pusd_update",
"room_id": "polymarket_accounts",
"data": {
"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
"token_address": "0xc011a7E12A19f7B1F670D46F03b03f3342e82DfB",
"balance": "10250.500000",
"block_number": 65000000,
"updated_at": 1743500000
}
}
matic_update
MATIC balance update for a tracked wallet.
{
"type": "matic_update",
"room_id": "polymarket_accounts",
"data": {
"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
"token_address": "0x0000000000000000000000000000000000001010",
"balance": "25.750000000000000000",
"block_number": 65000000,
"updated_at": 1743500000
}
}
