#api-key #cli-tool #interact #unified #com-docs-api #covalent #covalenthq

app covctl

CLI tool to easily interact with the covalent API https://www.covalenthq.com/docs/api

3 releases

0.1.3 May 25, 2022
0.1.1 May 22, 2022
0.1.0 May 22, 2022

#30 in #unified

Download history 8/week @ 2024-02-26 5/week @ 2024-03-11 55/week @ 2024-04-01

60 downloads per month

Custom license



CLI tool to interact with the Covalent Unified API: https://www.covalenthq.com/docs/api

covctl will return JSON for each API call. It provides a convenient CLI interface to easily make Unified Covalent API calls without having to build the API URLs manually


Install with Cargo

cargo install covctl

Build from source

git clone https://github.com/mark-ruddy/covctl.git
cd covctl/covctl/
cargo build --release


First register and get an API key from: https://www.covalenthq.com/

Then you can pass this key into each call e.g. covctl --api-key=<YOUR_API_KEY>
Or you can omit the --api-key flag and set this environment variable: export COVALENT_API_KEY=<YOUR_API_KEY>

See available API endpoints to query(covctl covers all Class A Endpoints except for NFTs): covctl --help


  • covctl transaction --help - see the available flags for the transaction info API call, --help can be passed like this to any subcommand API call e.g. covctl changes-in-token-holders --help

  • covctl transaction --tx-hash 0x269fad968de5baf8d324b64d0a19df72ccfc762b33e1760729633f4946e0c863 - get back JSON on thistransaction

  • covctl token-balances --addr 0xf4024faad5fafd0755875e3161524c9c4e1a1111 | jq - get back JSON for token balances of this address and pipe it through jq

  • covctl log-events-by-topic-hashes --topic-hash 0x804c9b842b2748a22bb64b345453a3de7ca54a6ca45ce00d415894979e22897a --sender-addr 0x7d2768dE32b0b80b7a3454c06BdAc94A69DDc7A9 --starting-block 12500000 --ending-block 12500100 - in this example the returned items JSON array is empty because there is no information for the parameters given


~392K SLoC