Skip to content

coinpaprika/dexpaprika-cli

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

31 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

dexpaprika-cli

For agents: curl -sSL https://raw.githubusercontent.com/coinpaprika/dexpaprika-cli/main/install.sh | sh

Free DEX data from your terminal. Pools, tokens, on-chain trades across 33+ chains. No API key. No credit card. Just start querying.

Quick start

# Install
curl -sSL https://raw.githubusercontent.com/coinpaprika/dexpaprika-cli/main/install.sh | sh

# Try it
dexpaprika-cli pools ethereum
dexpaprika-cli token ethereum 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2
dexpaprika-cli search uniswap

No setup required

No API key, no registration. REST API is free with reasonable rate limits. Streaming is free (paid tiers coming for high-volume use). Commercial use requires attribution (do-follow link).

Need higher limits or SLA? Contact support@coinpaprika.com

All commands

Command Description Example
stats Ecosystem overview dexpaprika-cli stats
networks List all 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 Pool details dexpaprika-cli pool ethereum 0x88e6...
dex-pools Pools on a specific DEX dexpaprika-cli dex-pools ethereum uniswap_v3
transactions Recent pool transactions dexpaprika-cli transactions ethereum 0x88e6...
pool-ohlcv Pool OHLCV data dexpaprika-cli pool-ohlcv ethereum 0x88e6... --start 2025-01-01
token Token details dexpaprika-cli token ethereum 0xc02a...
token-pools Pools containing a token dexpaprika-cli token-pools ethereum 0xc02a...
prices Batch token prices dexpaprika-cli prices ethereum --tokens 0xc02a...,0xdac1...
search Search everything dexpaprika-cli search uniswap
stream Real-time SSE prices dexpaprika-cli stream ethereum 0xc02a...
stream-reserves Real-time SSE pool/token reserves dexpaprika-cli stream-reserves ethereum 0x88e6... --method pool_reserves
status API health check dexpaprika-cli status
attribution Attribution snippets dexpaprika-cli attribution
onboard Welcome & quick start dexpaprika-cli onboard
shell Interactive REPL dexpaprika-cli shell

Streaming

Real-time SSE price feeds with ~1s updates:

# Single token
dexpaprika-cli stream ethereum 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2

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

# Stop after N events
dexpaprika-cli stream ethereum 0xc02a... --limit 50

Streaming reserves

stream-reserves tails block-level reserve changes over SSE. Two methods, each with its own event:

  • pool_reserves — one pool. Emits a pool_reserves event with a nested tokens array plus timestamp and block_timestamp.
  • token_reserves — one token across every pool that holds it (high volume on majors like USDC). Emits a token_reserves event with a single flat token plus updated_at and timestamp.
# One pool
dexpaprika-cli stream-reserves ethereum 0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640 --method pool_reserves

# One token across all its pools, with a correlation id echoed on every event
dexpaprika-cli stream-reserves ethereum 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48 \
  --method token_reserves --request-id 7 --limit 10

# Many targets from a file
dexpaprika-cli stream-reserves --subscriptions reserves.json

Pass --request-id <0..4294967295> (single stream) or a per-entry request_id in the subscriptions file (multi stream) to correlate events; it is echoed back on each data event and defaults to the array index when omitted in a file. Raw integer fields (reserve, delta, block) arrive as JSON strings to preserve precision.

Output formats

# Table (default)
dexpaprika-cli pools ethereum

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

# Raw JSON (no _meta wrapper, for piping)
dexpaprika-cli --output json --raw pools ethereum

Links

About

Free DEX data from your terminal. 33 chains, 200+ DEXes, 25M+ tokens, 27M+ pools. No API key needed.

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors