Skip to content
CKB GraphQL Server
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


GraphQL server for CKB. For maximum performance, it works by reading from CKB's data directory directly.


The GraphQL server currently works with current CKB 0.25, notice since it reads directly into CKB's internal storage, compatibility issues might be encountered when CKB optimized its internal storage format. We will try our best to make sure we upgrade this project together with mainnet CKB versions.

First, a running CKB instance is needed. Since this project directly reads data from CKB's rocksdb instance, we need to keep track of the running directory of CKB. For example, if CKB is started via ckb run -C /foo/bar, the directory we will need here is /foo/bar. Please take a look at your CKB running configuration, and keep a note of the running directory in our environment.

Then we can start CKB's GraphQL server:

$ git clone
$ cd ckb-graphql-server
$ cargo build --release
$ target/release/ckb-graphql-server --db /foo/bar/data/db --listen

Again, if you are running CKB in a different directory than /foo/bar, you need to modify the command accordingly.

Now if you go to http://localhost:3000, you should have a GraphQL server to play with.

You can’t perform that action at this time.