Skip to main content
Kusama is a blockchain network designed as a “canary network” for Polkadot, aimed at testing and experimenting with new features before deploying them on Polkadot. Kusama has its own community and governance, with a focus on innovation and risk-taking.

How to Connect to Kusama

Using Public Endpoint

You can connect to kusama using Blockops public API endpoints. These endpoints are only suitable for testing. Public RPC endpoints are not intended for dApp building. (Throughput rate limited to 50 rps).
We have different rate limits set for private API endpoints (e.g. ones with API keys attached) - Read more below
To avoid rate limiting and service interruption, sign up now to get your own API key.
The below example uses the public API endpoint to make a request using curl

Using Private Endpoint

Using API keys on an RPC node provides better tracking and monitoring of API usage. Secure your data, speed up your queries, and take control of your API usage with our RPC API endpoint and personalized API keys. Sign up now to get your own API key. To get your API key, create a project using a unique Identifier as the project name and select Kusama from the network options.

Create a Kusama project

Open the project to view your api key and rpc endpoints.

view Kusama project

Send requests

All requests are POST requests.
Connect via Command Line You can connect to the network using websocket or HTTP with your API key in two ways:
  • Adding the API key as a query string ?api_key=${APIKEY}
  • Or the request header -H 'authorization: APIKEY ${APIKEY}'
Curl For example, the following CURL command can be used to get header and body of a relay chain block.
Here is the response you will receive back.
Wscat If you want to send data requests with WebSockets, you can use several libraries or wscat. You can install and use wscat as follows: You can connect to the network with wscat using two options by adding the API key as a query string.
Or the request header.
After executing the command, the terminal will display a message indicating that the connection has been enabled successfully.
Then, you can send the following request:
For more information on the Kusama network, please see the official Kusama developer documentation.
Login or set up an account here to get started! Website Github