Skip to main content

What is the DexPaprika CLI?

A fast, standalone command-line tool for querying on-chain DEX data. Written in Rust. Covers the entire DexPaprika API — token prices, pools, OHLCV, transactions, search, pool filtering, and real-time price streaming via SSE. No API key. No dependencies. One binary. Source: github.com/coinpaprika/dexpaprika-cli

Install

One-line install (macOS, Linux)

curl -sSL https://raw.githubusercontent.com/coinpaprika/dexpaprika-cli/main/install.sh | sh
Downloads the latest release binary for your platform and puts it in ~/.local/bin. You can override the install path:
DEXPAPRIKA_INSTALL_DIR=/usr/local/bin curl -sSL https://raw.githubusercontent.com/coinpaprika/dexpaprika-cli/main/install.sh | sh

Download from GitHub

Pre-built binaries for every platform are on the releases page:
PlatformBinary
macOS (Apple Silicon)dexpaprika-cli-{version}-darwin-aarch64.tar.gz
macOS (Intel)dexpaprika-cli-{version}-darwin-x86_64.tar.gz
Linux (x86_64)dexpaprika-cli-{version}-linux-x86_64.tar.gz
Linux (ARM64)dexpaprika-cli-{version}-linux-aarch64.tar.gz
Windows (x86_64)dexpaprika-cli-{version}-windows-x86_64.zip

Build from source

Requires Rust:
cargo install --git https://github.com/coinpaprika/dexpaprika-cli

Verify installation

dexpaprika-cli status
You should see a health check response confirming the API is reachable.

Commands

Every DexPaprika REST API endpoint has a matching CLI command:
CommandWhat it doesExample
statsEcosystem overview (total networks, pools, tokens)dexpaprika-cli stats
networksList all supported chainsdexpaprika-cli networks
dexesDEXes on a networkdexpaprika-cli dexes ethereum
poolsTop pools on a networkdexpaprika-cli pools ethereum --limit 5
poolSingle pool detailsdexpaprika-cli pool ethereum 0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640
dex-poolsPools on a specific DEXdexpaprika-cli dex-pools ethereum uniswap_v3
transactionsRecent swaps for a pooldexpaprika-cli transactions ethereum 0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640
pool-ohlcvHistorical OHLCV candlesdexpaprika-cli pool-ohlcv ethereum 0x88e6... --start 2025-01-01
tokenToken price and detailsdexpaprika-cli token ethereum 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2
token-poolsAll pools containing a tokendexpaprika-cli token-pools ethereum 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2
pricesBatch token prices (up to 10)dexpaprika-cli prices ethereum --tokens 0xc02a...,0xdac1...
searchSearch tokens, pools, DEXesdexpaprika-cli search uniswap
streamReal-time SSE price streamdexpaprika-cli stream ethereum 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2
statusAPI health checkdexpaprika-cli status
attributionLicense attribution snippetsdexpaprika-cli attribution
onboardQuick start walkthroughdexpaprika-cli onboard
shellInteractive REPL modedexpaprika-cli shell

Output formats

The CLI outputs tables by default. Switch to JSON for scripting and piping:
# Table output (default, human-readable)
dexpaprika-cli pools ethereum

# JSON with metadata wrapper
dexpaprika-cli --output json pools ethereum

# Raw JSON (no _meta wrapper, for piping to jq)
dexpaprika-cli --output json --raw pools ethereum
Pipe raw JSON into jq for filtering:
dexpaprika-cli --output json --raw token ethereum 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2 | jq '.summary.price_usd'

Examples

Get a token price

dexpaprika-cli token solana So11111111111111111111111111111111111111112

Search for a token you don’t know the address of

dexpaprika-cli search jupiter

List top pools by volume

dexpaprika-cli pools ethereum --limit 10

Get OHLCV history for a pool

dexpaprika-cli pool-ohlcv ethereum 0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640 --start 2025-01-01

Stream live prices

# Single token -- streams until you hit Ctrl+C
dexpaprika-cli stream ethereum 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2

# Stop after 50 price updates
dexpaprika-cli stream ethereum 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2 --limit 50

# Multiple tokens from a JSON watchlist file
dexpaprika-cli stream --tokens watchlist.json --limit 100

Interactive REPL

dexpaprika-cli shell
Opens an interactive session where you can run commands without typing dexpaprika-cli each time.

Batch prices for a portfolio

dexpaprika-cli prices ethereum --tokens 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2,0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48,0x6b175474e89094c44da98b954eedeac495271d0f

Use with AI agents

AI agents running in terminals (Claude Code, Aider, etc.) can install and use the CLI as a tool. The one-liner install works in any shell:
curl -sSL https://raw.githubusercontent.com/coinpaprika/dexpaprika-cli/main/install.sh | sh
Once installed, agents can call dexpaprika-cli directly with --output json --raw for machine-readable output. This is useful when:
  • The agent doesn’t have MCP support
  • You want the agent to script data pipelines
  • You need to pipe output into other tools (jq, csvkit, scripts)
  • You’re running headless or in CI/CD
Example agent workflow:
# Agent searches for a token
dexpaprika-cli --output json --raw search "pepe" | jq '.tokens[0]'

# Agent gets the price
dexpaprika-cli --output json --raw token ethereum 0x6982508145454ce325ddbe47a25d4ec3d2311933 | jq '.summary.price_usd'

# Agent finds the top pool
dexpaprika-cli --output json --raw token-pools ethereum 0x6982508145454ce325ddbe47a25d4ec3d2311933 | jq '.[0]'

Troubleshooting

The installer puts the binary in ~/.local/bin. If that’s not in your PATH, add it:
export PATH="$HOME/.local/bin:$PATH"
Add that line to your ~/.bashrc, ~/.zshrc, or ~/.profile to make it permanent.
The installer tries ~/.local/bin first (no sudo needed). If it falls back to /usr/local/bin, it will ask for sudo. You can also set a custom directory:
DEXPAPRIKA_INSTALL_DIR=~/bin curl -sSL https://raw.githubusercontent.com/coinpaprika/dexpaprika-cli/main/install.sh | sh
Check the network ID (must be lowercase: ethereum, not Ethereum) and verify the token address. Use dexpaprika-cli search <name> to find the correct network and address.
SSE streams can drop due to network issues. The stream command will show an error. Restart it — the CLI handles reconnection. For production use, wrap it in a script with retry logic.

Next steps

FAQs

No. The CLI uses the public DexPaprika API. No keys, no registration.
Same as the REST API: 10,000 requests per day. Each CLI command makes one API call (except stream, which is a single long-lived SSE connection).
The filter endpoint can be accessed via the REST API directly. Check the pool filtering tutorial for examples.
Yes. Download the Windows binary from the releases page. The install script works on macOS and Linux only.