How To Access Polkadot via Substrate RPC API

Learn how to access Polkadot via Substrate RPC API.

Step 1: To access the available Substrate RPC methods, use the native access endpoint with /http-rpc at the end:

  • Network: Polkadot Mainnet
  • Request Type: POST
  • Network: Polkadot Westend
  • Request Type: POST

Step 2: You should authorize your request. Learn more: Authentication Guide

Step 3: Specify a Substrate RPC method in the request body:

    "jsonrpc": "2.0",
    "id": 1,
    "method": "YOUR_METHOD",
    "params": []

Example Request for Substrate RPC API

Here is a cURL example for using system_syncState to get the chainspec running the node, with a sync state, in Polkadot Mainnet:

curl -X POST \ \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"jsonrpc": "2.0", "id": 1, "method": "system_syncState", "params": []}'

The following is a typical response you will get:

    "jsonrpc": "2.0",
    "result": {
        "startingBlock": 11614877,
        "currentBlock": 11615160
    "id": 1

👋 Need Help?

Contact us through email or our support page for any issues, bugs, or assistance you may need.