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"
}
}
]
Received response:
Request failed with error:
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"
}
}
Received response:
Request failed with error:
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"
]
}
Received response:
Request failed with error:
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"
}
]
Received response:
Request failed with error: