IC Query: Query Anything on the Internet Computer from the Command Line

Developers
1

We’ve released another open-source tool from Toko Studios.

IC Query gives developers a simple way to query Internet Computer canisters, SNS projects, NNS metadata, topology information, nodes, subnets, token standards, and more directly from the command line.

Like all of our tooling, it’s completely free and open source.

If there’s a feature you need, open an issue and we’ll add it.

:backhand_index_pointing_right: Learn more: https://toko.ltd/ic-query

:backhand_index_pointing_right: Source code: https://github.com/dragginzgame/ic-query

Why We Built It

When working with the Internet Computer, there is a lot of information scattered across dashboards, explorers, governance interfaces, and custom scripts.

We wanted a single tool that could answer questions like:

  • What SNS projects exist?
  • What token standards does a token support?
  • What metadata is exposed by a canister?
  • Which subnets exist?
  • Who are the node providers?
  • What data centers are participating?
  • What is the current registry version?
  • What topology changes have occurred?

Without having to write custom code every time.

IC Query turns these questions into simple CLI commands.

Example: Querying an SNS Token

icq sns token 1

This command queries the SNS and returns:

  • SNS identity
  • Root canister
  • Ledger canister
  • Index canister
  • Token name
  • Symbol
  • Decimals
  • Supply
  • Transfer fee
  • Supported ICRC standards
  • Ledger metadata
  • Additional token capabilities

Example output:

output
output789×892 175 KB

Why This Is Useful

Token Research

Want to understand an SNS token before integrating with it?

icq sns token 1

Instantly view:

  • Supported standards
  • Fee structure
  • Supply information
  • Ledger capabilities

SNS Discovery

See all deployed SNS projects.

icq sns list

Useful for:

  • Wallet developers
  • Analytics platforms
  • Market dashboards
  • Ecosystem research

Infrastructure Monitoring

Inspect the current state of the Internet Computer.

icq nns subnet list
icq nns node list
icq nns topology summary

Useful for:

  • Node providers
  • Infrastructure teams
  • Researchers
  • Deployment tooling

Automation & CI

Because IC Query is a CLI tool, it can easily be integrated into:

  • CI/CD pipelines
  • Monitoring systems
  • Deployment scripts
  • Canic workflows
  • Analytics jobs

Instead of manually looking things up, scripts can pull live data directly from the IC.

Built for Canic

IC Query was originally developed to support Canic, our canister deployment and management platform.

Canic needs access to registry information, topology data, SNS metadata, and network state.

Rather than embedding all of that logic directly into Canic, we created IC Query as a standalone tool that any developer can use.

Install

cargo install ic-query

or

git clone https://github.com/dragginzgame/ic-query
cd ic-query
make install

Current Capabilities

NNS

icq nns registry version
icq nns subnet list
icq nns node list
icq nns topology summary

SNS

icq sns list
icq sns info 1
icq sns token 1

JSON Output

icq sns token 1 --format json

Perfect for scripting and automation.

Feedback, bug reports, and feature requests are welcome.

If there’s information on the Internet Computer you’d like to query from the command line and IC Query doesn’t support it yet, let us know and we’ll add it.

Website: https://toko.ltd/ic-query

GitHub: https://github.com/dragginzgame/ic-query

Built by Toko Studios :rocket:

2

image
image765×464 15.8 KB

Next we’re going to have versioned, cached json files of all the neurons for a SNS so we can query them, sort them etc. We’re using the SNS for Toko even though the Foundation have moved on.

3

Looks really cool, much support

11

Amazing!! This will help alot of people :slight_smile: