DexPaprika CLI: DEX data from your terminal

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 needed to start. 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:

Platform	Binary
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:

Command	What it does	Example
`stats`	Ecosystem overview (total networks, pools, tokens)	`dexpaprika-cli stats`
`networks`	List all supported chains	`dexpaprika-cli networks`
`dexes`	DEXes on a network	`dexpaprika-cli dexes ethereum`
`pools`	Top pools on a network	`dexpaprika-cli pools ethereum --limit 5`
`pool`	Single pool details	`dexpaprika-cli pool ethereum 0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640`
`dex-pools`	Pools on a specific DEX	`dexpaprika-cli dex-pools ethereum uniswap_v3`
`transactions`	Recent swaps for a pool	`dexpaprika-cli transactions ethereum 0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640`
`pool-ohlcv`	Historical OHLCV candles	`dexpaprika-cli pool-ohlcv ethereum 0x88e6... --start 2025-01-01`
`token`	Token price and details	`dexpaprika-cli token ethereum 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2`
`token-pools`	All pools containing a token	`dexpaprika-cli token-pools ethereum 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2`
`prices`	Batch token prices (up to 10)	`dexpaprika-cli prices ethereum --tokens 0xc02a...,0xdac1...`
`search`	Search tokens, pools, DEXes	`dexpaprika-cli search uniswap`
`stream`	Real-time SSE price stream	`dexpaprika-cli stream ethereum 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2`
`status`	API health check	`dexpaprika-cli status`
`attribution`	License attribution snippets	`dexpaprika-cli attribution`
`onboard`	Quick start walkthrough	`dexpaprika-cli onboard`
`shell`	Interactive REPL mode	`dexpaprika-cli shell`

dex-pools reads pool search with a dex_name filter. The REST path it used to call, GET /networks/{network}/dexes/{dex}/pools, was removed and returns 410 Gone, so an older build of the CLI fails on that command until you upgrade. The command name and arguments are unchanged; in --raw JSON the rows arrive under results with has_next_page and next_cursor, and the 24h volume field is volume_usd_24h.

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

Command not found after install

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.

Permission denied during install

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

No data returned for a token

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.

Streaming disconnects

SSE streams can drop due to network issues. The stream command will show an error. Restart it and the CLI handles reconnection. For production use, wrap it in a script with retry logic.

Next steps

REST API Reference

Full endpoint documentation with interactive playground

Streaming API

Real-time price streaming docs

Common Patterns

Standard API workflows

Vibe Coding with AI

Build projects with AI + DexPaprika

FAQs

Do I need an API key?

Not to start. The CLI calls the DexPaprika API keyless. Create a free key in the console and set it when you want the higher monthly allowance.

What are the rate limits?

Same as the REST API: 50,000 credits a month without a key, 300,000 with a free key, at 30 requests a minute. Each CLI command makes one API call. stream opens a single long-lived SSE connection, and each price update it delivers costs one credit, the same as a REST call. A stream left running all month can outgrow the free allowance, so see Pro pricing if you need 5,000,000 credits at 300 requests a minute.

Does the CLI support the filter endpoint?

The filter endpoint can be accessed via the REST API directly. Check the pool filtering tutorial for examples.

Can I use the CLI on Windows?

Yes. Download the Windows binary from the releases page. The install script works on macOS and Linux only.

Get Started

Knowledge Base

Tutorials

SDKs

Tools

Company

DexPaprika CLI: DEX data from your terminal

What is the DexPaprika CLI?

Install

One-line install (macOS, Linux)

Download from GitHub

Build from source

Verify installation

Commands

Output formats

Examples

Get a token price

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

List top pools by volume

Get OHLCV history for a pool

Stream live prices

Interactive REPL

Batch prices for a portfolio

Use with AI agents

Troubleshooting

Next steps

REST API Reference

Streaming API

Common Patterns

Vibe Coding with AI

FAQs

​What is the DexPaprika CLI?

​Install

​One-line install (macOS, Linux)

​Download from GitHub

​Build from source

​Verify installation

​Commands

​Output formats

​Examples

​Get a token price

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

​List top pools by volume

​Get OHLCV history for a pool

​Stream live prices

​Interactive REPL

​Batch prices for a portfolio

​Use with AI agents

​Troubleshooting

​Next steps

REST API Reference

Streaming API

Common Patterns

Vibe Coding with AI

​FAQs

What is the DexPaprika CLI?

Install

One-line install (macOS, Linux)

Download from GitHub

Build from source

Verify installation

Commands

Output formats

Examples

Get a token price

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

List top pools by volume

Get OHLCV history for a pool

Stream live prices

Interactive REPL

Batch prices for a portfolio

Use with AI agents

Troubleshooting

Next steps

FAQs