Listen to new data as it arrives.

Endpoint: wss://


Websockets provide real-time, bidirectional communication between a client and server. To start listening to new data arriving you need to send a subscription message.

Subscription message syntax

The subscription message must be JSON. The format of subscription messages we accept is as follows.

    "method": "subscribe",
    "table": "<table_name>",

Here table_name specifies which table to filter on. Possible values for table_name are given in section below.

Possible values for table_name


Data you can listen to

You can listen to new data for all our tables. For a list of all available tables see the Data Tables section of the API reference.

Logseth_logs (coming soon)
ERC20 Transferseth_erc20(coming soon)
ERC721 Transferseth_erc721(coming soon)
DEX Tradeseth_dex_trades(coming soon)
Token Balanceseth_token_balances(coming soon)
Token Metadataeth_token_metadata
Pool Metadataeth_pool_metadata



Example using wscat

# initiate websocket stream first
wscat -c wss://

# then call subscription 
{"method": "subscribe", "table": "eth_blocks"}

To run the above in a terminal you need to have wscat installed. To install wscat run: sudo npm install -g wscat. Make sure node and npm are also installed.

Example using python

import asyncio
import json
import websockets

async def connect():
    uri = "wss://"

    async with websockets.connect(uri) as ws:
        # Subscribe to eth_blocks table
        subscription_data = {"method": "subscribe", "table": "eth_blocks"}
        await ws.send(json.dumps(subscription_data))

        while True:
            # Wait for data from the server
            response = await ws.recv()
            print(f"Received data: {response}")

if __name__ == '__main__':
    loop = asyncio.get_event_loop()