Skip to main content

CLI tool for querying Dolomite protocol data across all chains

Project description

dolomite CLI

Query Dolomite protocol data across all chains. Returns structured JSON. No API keys required.

Install

pipx install dolomite-cli

Or with pip:

pip install dolomite-cli

Requires Python 3.10+. Zero dependencies (stdlib only).

From source

git clone https://github.com/openclaw/dolomite-cli
cd dolomite-cli
pip install -e .

Commands

Command Description
dolomite rates All markets with supply/borrow rates
dolomite positions Top borrowing positions by size
dolomite flows Recent large deposits/withdrawals
dolomite liquidations Recent liquidation events
dolomite tvl Protocol TVL summary per chain
dolomite markets --token USDC Detailed info for a specific token
dolomite account <address> Full position detail for an address
dolomite risks High-risk positions and utilization alerts
dolomite schema Show all commands, chains, entities, examples

Examples

# Stablecoin rates across all chains
dolomite rates --stables-only

# Top 20 positions on Ethereum
dolomite positions --chain ethereum --top 20

# Whale flows in the last 48 hours
dolomite flows --hours 48 --min-usd 100000

# Deposits only
dolomite flows --type deposit --hours 72

# Look up a specific whale
dolomite account 0x8be46b25d59616e594f0a9e20147fb14c1b989d9

# High-risk positions (>80% LTV, >$100K)
dolomite risks --min-ltv 80 --min-usd 100000

# Berachain rates only
dolomite rates --chain berachain

# USDC across all chains
dolomite markets --token USDC

Output

All commands output JSON to stdout. Errors go to stderr. Pipe to jq for filtering:

# Top 5 stablecoin rates
dolomite rates --stables-only | jq '.markets[:5][] | {chain, symbol, supply_rate_pct}'

# Total protocol TVL
dolomite tvl | jq '.total_supply_usd'

# Addresses with >85% LTV
dolomite risks --min-ltv 85 | jq '.high_ltv_positions[] | {address, ltv_pct, supply_usd}'

Chains

Chain Chain ID Status
Ethereum 1 Active (~$370M TVL)
Arbitrum 42161 Active (~$52M TVL)
Berachain 80094 Active (~$50M TVL)
Mantle 5000 Minimal
Base 8453 Minimal
X Layer 196 Minimal

Default: queries Ethereum, Arbitrum, Berachain. Use --chain all for everything.

Data Sources

  • Subgraph API: subgraph.api.dolomite.io — on-chain positions, flows, liquidations
  • REST API: api.dolomite.io — token prices, interest rates, market data

No authentication required. All data is public.

For AI Agents

Run dolomite schema to get a complete description of all commands, available entities, and example queries. The output is JSON — parseable by any model.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dolomite_cli-1.0.0.tar.gz (11.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

dolomite_cli-1.0.0-py3-none-any.whl (11.9 kB view details)

Uploaded Python 3

File details

Details for the file dolomite_cli-1.0.0.tar.gz.

File metadata

  • Download URL: dolomite_cli-1.0.0.tar.gz
  • Upload date:
  • Size: 11.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for dolomite_cli-1.0.0.tar.gz
Algorithm Hash digest
SHA256 bf2999586a87818312c1d47b4af717f99da04ce619db2ce5f3604df9d5777df4
MD5 2cee57b5234ec12c76c9d470246b22c4
BLAKE2b-256 b728ebc3c97a9882aaf88a423ca6af3a961f1b4dcc3b6650f589cc3fadbc98f8

See more details on using hashes here.

File details

Details for the file dolomite_cli-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: dolomite_cli-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 11.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for dolomite_cli-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f56d4a605b22eabd0308ef8a3449ff9eb0c3c123e170742b5b9253ac5a62323d
MD5 4d4b89b841b219b7a5a3a79ef2936aa9
BLAKE2b-256 447212fc3ea44d47f63845277ee0bb494c73c28b60529cc20b33c2785c5f9eec

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page