MENU navbar-image

Introduction

Polkachu offers API access to various blockchain node operation services

This documentation aims to provide all the information you need to work with our API.

Base URL

https://polkachu.com

Authenticating requests

This API is not authenticated.

Endpoints

Chains

List all Tendermint-based chains we support and the availability of various services (RPC, API, state-sync, snapshot and live peers).

Example request:
curl --request GET \
    --get "https://polkachu.com/api/v1/chains" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://polkachu.com/api/v1/chains"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):

Show headers
cache-control: no-cache, private
content-type: application/json
x-ratelimit-limit: 60
x-ratelimit-remaining: 58
access-control-allow-origin: *
 

[
    {
        "network": "agoric",
        "name": "Agoric",
        "twitter": "agoric",
        "symbol": "BLD",
        "github": "https://github.com/Agoric/agoric-sdk",
        "binary": "agoric",
        "folder": ".agoric",
        "denom": "ubld",
        "chain_id": "agoric-3",
        "logo": "http://polkachu.wip/images/chains/agoric.png",
        "rpc": {
            "active": true,
            "url": "https://agoric-rpc.polkachu.com:443"
        },
        "api": {
            "active": true,
            "url": "https://agoric-api.polkachu.com"
        },
        "seed_node": {
            "active": true,
            "url": "[email protected]:44656"
        },
        "addrbook": {
            "active": true,
            "url": "https://snapshots1.polkachu.com/addrbook/agoric/addrbook.json",
            "instruction": "http://polkachu.com/addrbooks/agoric"
        },
        "state_sync": {
            "active": true,
            "url": "https://agoric-rpc.polkachu.com:443",
            "instruction": "http://polkachu.com/state_sync/agoric"
        },
        "snapshot": {
            "active": true,
            "endpoint": "http://polkachu.com/api/v1/chains/agoric/snapshot",
            "instruction": "http://polkachu.com/tendermint_snapshots/agoric"
        },
        "live_peers": {
            "active": true,
            "endpoint": "http://polkachu.com/api/v1/chains/agoric/live_peers",
            "instruction": "http://polkachu.com/live_peers/agoric"
        }
    },
    {
        "network": "akash",
        "name": "Akash",
        "twitter": "akashnet_",
        "symbol": "AKT",
        "github": "https://github.com/ovrclk/akash",
        "binary": "akash",
        "folder": ".akash",
        "denom": "uakt",
        "chain_id": "akashnet-2",
        "logo": "http://polkachu.wip/images/chains/akash.png",
        "rpc": {
            "active": true,
            "url": "https://akash-rpc.polkachu.com:443"
        },
        "api": {
            "active": true,
            "url": "https://akash-api.polkachu.com"
        },
        "seed_node": {
            "active": true,
            "url": "[email protected]:28656"
        },
        "addrbook": {
            "active": true,
            "url": "https://snapshots1.polkachu.com/addrbook/akash/addrbook.json",
            "instruction": "http://polkachu.com/addrbooks/akash"
        },
        "state_sync": {
            "active": true,
            "url": "https://akash-rpc.polkachu.com:443",
            "instruction": "http://polkachu.com/state_sync/akash"
        },
        "snapshot": {
            "active": true,
            "endpoint": "http://polkachu.com/api/v1/chains/akash/snapshot",
            "instruction": "http://polkachu.com/tendermint_snapshots/akash"
        },
        "live_peers": {
            "active": true,
            "endpoint": "http://polkachu.com/api/v1/chains/akash/live_peers",
            "instruction": "http://polkachu.com/live_peers/akash"
        }
    },
    {
        "network": "assetmantle",
        "name": "Asset Mantle",
        "twitter": "AssetMantle",
        "symbol": "MNTL",
        "github": "https://github.com/AssetMantle/node",
        "binary": "mantleNode",
        "folder": ".mantleNode",
        "denom": "umntl",
        "chain_id": "mantle-1",
        "logo": "http://polkachu.wip/images/chains/assetmantle.png",
        "rpc": {
            "active": true,
            "url": "https://assetmantle-rpc.polkachu.com:443"
        },
        "api": {
            "active": true,
            "url": "https://assetmantle-api.polkachu.com"
        },
        "seed_node": {
            "active": true,
            "url": "[email protected]:46656"
        },
        "addrbook": {
            "active": true,
            "url": "https://snapshots1.polkachu.com/addrbook/assetmantle/addrbook.json",
            "instruction": "http://polkachu.com/addrbooks/assetmantle"
        },
        "state_sync": {
            "active": true,
            "url": "https://assetmantle-rpc.polkachu.com:443",
            "instruction": "http://polkachu.com/state_sync/assetmantle"
        },
        "snapshot": {
            "active": true,
            "endpoint": "http://polkachu.com/api/v1/chains/assetmantle/snapshot",
            "instruction": "http://polkachu.com/tendermint_snapshots/assetmantle"
        },
        "live_peers": {
            "active": true,
            "endpoint": "http://polkachu.com/api/v1/chains/assetmantle/live_peers",
            "instruction": "http://polkachu.com/live_peers/assetmantle"
        }
    }
]
 

Request      

GET api/v1/chains

Chain Snapshot

List the information of the latest node snapshot for a network

Example request:
curl --request GET \
    --get "https://polkachu.com/api/v1/chains/osmosis/snapshot" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://polkachu.com/api/v1/chains/osmosis/snapshot"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):

Show headers
cache-control: no-cache, private
content-type: application/json
x-ratelimit-limit: 60
x-ratelimit-remaining: 57
access-control-allow-origin: *
 

{
    "network": "osmosis",
    "snapshot": {
        "file": "osmosis/osmosis_5817823.tar.lz4",
        "name": "osmosis_5817823.tar.lz4",
        "size": "9 GB",
        "time": "15 hours ago",
        "url": "https://snapshots1.polkachu.com/snapshots/osmosis/osmosis_5817823.tar.lz4",
        "block_height": "5817823"
    }
}
 

Request      

GET api/v1/chains/{network}/snapshot

URL Parameters

network  string  

Network: Use /chains endpoint to get the full list of networks.

Chain Live Peers

List the information of live peers for a network

Example request:
curl --request GET \
    --get "https://polkachu.com/api/v1/chains/osmosis/live_peers" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://polkachu.com/api/v1/chains/osmosis/live_peers"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):

Show headers
cache-control: no-cache, private
content-type: application/json
x-ratelimit-limit: 60
x-ratelimit-remaining: 56
access-control-allow-origin: *
 

{
    "network": "osmosis",
    "live_peers": [
        "[email protected]:26656",
        "[email protected]:26656",
        "[email protected]:26656",
        "[email protected]:26656",
        "[email protected]:25656",
        "[email protected]:36656",
        "[email protected]:26656",
        "[email protected]:26656",
        "[email protected]:26656",
        "[email protected]:26656",
        "[email protected]:26656",
        "[email protected]:26656",
        "[email protected]:26656",
        "[email protected]:26656",
        "[email protected]:26656",
        "[email protected]:26656",
        "[email protected]:26656",
        "[email protected]:26656",
        "[email protected]:26656",
        "[email protected]:36656",
        "[email protected]:26656",
        "[email protected]:26656",
        "[email protected]:26656",
        "6288433202ffc488[email protected]:26656",
        "[email protected]:26656",
        "[email protected]:26656",
        "[email protected]:26656",
        "[email protected]:26656",
        "[email protected]:26656",
        "bd2d0afca3215d7f1672397fc5[email protected]:25656",
        "[email protected]:26656",
        "[email protected]:26656",
        "[email protected]:26656",
        "[email protected]:26656",
        "[email protected]:26624",
        "[email protected]:26656",
        "[email protected]:10256",
        "[email protected]:26656",
        "[email protected]:26656",
        "[email protected]:26656",
        "[email protected]:26656",
        "[email protected]:26656",
        "[email protected]:26666",
        "[email protected]:26656",
        "[email protected]:26656",
        "[email protected]:26656",
        "[email protected]:26656",
        "[email protected]:26656",
        "[email protected]:31656",
        "[email protected]:26656",
        "a22b249c21ad[email protected]:26656"
    ]
}
 

Request      

GET api/v1/chains/{network}/live_peers

URL Parameters

network  string  

Network: Use /chains endpoint to get the full list of networks.

Chain Upgrades

List all upcoming Tendermint-based chain upgrades that we support

Example request:
curl --request GET \
    --get "https://polkachu.com/api/v1/chain_upgrades" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://polkachu.com/api/v1/chain_upgrades"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):

Show headers
cache-control: no-cache, private
content-type: application/json
x-ratelimit-limit: 60
x-ratelimit-remaining: 55
access-control-allow-origin: *
 

[
    {
        "network": "stargaze",
        "chain_name": "Stargaze",
        "repo": "https://github.com/public-awesome/stargaze",
        "node_version": "v7.0.0",
        "block": 4448796,
        "block_link": "https://www.mintscan.io/stargaze/blocks/4448796",
        "estimated_upgrade_time": "2022-08-30T17:37:19.000000Z",
        "guide": "https://github.com/polkachu/validator-guide/blob/main/upgrade_guides/stargaze/upgrade_v7.md",
        "rpc": "https://stargaze-rpc.polkachu.com",
        "api": "https://stargaze-api.polkachu.com"
    },
    {
        "network": "injective",
        "chain_name": "Injective",
        "repo": "https://github.com/InjectiveLabs/injective-chain-releases",
        "node_version": "568ce23",
        "block": 14731000,
        "block_link": "https://www.mintscan.io/injective/blocks/14731000",
        "estimated_upgrade_time": "2022-09-01T14:09:30.000000Z",
        "guide": "https://github.com/polkachu/validator-guide/blob/main/upgrade_guides/injective/10007_upgrade.md",
        "rpc": "https://injective-rpc.polkachu.com",
        "api": "https://injective-api.polkachu.com"
    }
]
 

Request      

GET api/v1/chain_upgrades