DexPaprika

DexPaprika MCP Server: Dữ liệu DEX và tiền mã hóa theo thời gian thực cho các tác nhân AI

Máy chủ Model Context Protocol (MCP) cung cấp quyền truy cập theo yêu cầu vào API dữ liệu tiền mã hóa và DEX của DexPaprika. Được xây dựng dành riêng cho các trợ lý AI như Claude để truy xuất dữ liệu token, pool và DEX hiện tại theo cách lập trình mà không cần cấu hình.

Tóm tắt

# Install globally
npm install -g dexpaprika-mcp

# Start the server
dexpaprika-mcp

# Or run directly without installation
npx dexpaprika-mcp@latest

DexPaprika MCP kết nối Claude với dữ liệu DEX trực tiếp trên nhiều blockchain. Gói miễn phí không cần khóa API để bắt đầu. Cài đặt | Cấu hình | Tài liệu tham khảo API

Muốn không cần thiết lập? Sử dụng máy chủ MCP được lưu trữ tại mcp.dexpaprika.com: không cần cài đặt, không cần khóa để bắt đầu, có cùng các công cụ dữ liệu cùng với submitFeedback. Xem Máy chủ được lưu trữ để biết các điểm cuối truyền tải.

Bản phát hành mới nhất

Xem CHANGELOG.md để biết ghi chú phát hành và hướng dẫn di chuyển.

Bạn có thể xây dựng gì?

• Công cụ phân tích token: Theo dõi biến động giá, thay đổi độ sâu thanh khoản và mô hình khối lượng
• So sánh DEX: Phân tích cấu trúc phí, khối lượng và các pool hiện có trên nhiều DEX khác nhau
• Phân tích pool thanh khoản: Theo dõi thay đổi TVL, tính toán tổn thất tạm thời và đánh giá tác động giá
• Phân tích thị trường: So sánh token xuyên chuỗi, xu hướng khối lượng và chỉ số hoạt động giao dịch
• Công cụ theo dõi danh mục đầu tư: Theo dõi giá trị hiện tại, phân tích hiệu suất lịch sử và cơ hội lợi suất
• Phân tích kỹ thuật: Thực hiện phân tích kỹ thuật nâng cao bằng dữ liệu OHLCV lịch sử, bao gồm xác định xu hướng, nhận diện mô hình và tính toán chỉ báo

Cài đặt

Cài đặt qua Smithery

Để tự động cài đặt DexPaprika cho Claude Desktop qua Smithery:

npx -y smithery mcp add coinpaprika/dexpaprika

Cài đặt thủ công

# Install globally (recommended for regular use)
npm install -g dexpaprika-mcp

# Start the server
dexpaprika-mcp

Đây là máy chủ stdio: máy chủ giao tiếp MCP qua stdin và stdout, đồng thời không mở cổng nào. Khi khởi động, máy chủ ghi DexPaprika MCP server v<version> (tool contract v<contract>) is running... vào stderr rồi chờ ứng dụng khách. Hãy chạy máy chủ từ một ứng dụng khách MCP (Claude Desktop, Cursor, Claude Code), thay vì mong đợi có URL để mở trong trình duyệt.

Video hướng dẫn

Xem hướng dẫn từng bước về cách thiết lập và sử dụng máy chủ DexPaprika MCP:

Tích hợp Claude Desktop

Thêm nội dung sau vào tệp cấu hình Claude Desktop:

macOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "dexpaprika": {
      "command": "npx",
      "args": ["dexpaprika-mcp@latest"]
    }
  }
}

Sau khi khởi động lại Claude Desktop, Claude sẽ tự động có thể sử dụng các công cụ DexPaprika.

Tùy chọn: sử dụng khóa API

Tính năng này hoạt động mà không cần khóa và sẽ luôn như vậy. Không cần đăng ký, không cần thẻ, không cần cấu hình. Cách chạy ở trên là cách được hỗ trợ.

Khóa miễn phí tăng hạn mức hàng tháng và mở quyền truy cập luồng dữ liệu trên mọi token, thay vì chỉ tập token giới thiệu công khai. Khóa này không tăng giới hạn yêu cầu mỗi phút; giới hạn này giống nhau ở cả hai gói. Lấy khóa tại console.dexpaprika.com; xem giới hạn hiện tại trên trang giới hạn tốc độ.

{
  "mcpServers": {
    "dexpaprika": {
      "command": "npx",
      "args": ["dexpaprika-mcp@latest"],
      "env": {
        "DEXPAPRIKA_API_KEY": "your_key_here"
      }
    }
  }
}

Khóa phải được nhập riêng, làm toàn bộ giá trị Authorization. Dán khóa đúng như được cấp, không thêm bất kỳ nội dung nào phía trước. Hầu hết API khác đều yêu cầu thêm nội dung phía trước khóa, vì vậy đây là lý do phổ biến nhất khiến một khóa hợp lệ có vẻ như không hoạt động.

Có hai điều cần biết:

• Nếu chúng tôi không đọc được khóa thì sẽ không có lỗi nào xuất hiện. Các điểm cuối dữ liệu bỏ qua khóa không đọc được và phục vụ bạn như người gọi ẩn danh, với 200 thông thường và dữ liệu thực, nên lỗi đánh máy trông giống hệt như thành công. Sau khi thiết lập khóa, hãy yêu cầu trợ lý chạy getKeyStatus: công cụ này báo gói mà API thực sự nhận diện và nêu nguyên nhân có khả năng xảy ra nếu khóa không được nhận.
• Khách hàng Dev và Pro cũng cần đặt DEXPAPRIKA_API_BASE_URL thành https://api-pro.dexpaprika.com, đây cũng là giá trị mà getTokenOHLCV cần. Máy chủ không tự động thay đổi, vì gửi khóa miễn phí đến máy chủ đó sẽ trả về 403.

Máy chủ được lưu trữ (không cần cài đặt)

Nếu muốn không cần thiết lập, hãy kết nối trực tiếp bất kỳ ứng dụng khách tương thích MCP nào với máy chủ được lưu trữ tại mcp.dexpaprika.com. Trang đích cung cấp hướng dẫn thiết lập và tài liệu. Có các điểm cuối truyền tải sau:

Truyền tải	Điểm cuối	Trường hợp sử dụng
HTTP có thể truyền luồng	https://mcp.dexpaprika.com/streamable-http	Được khuyến nghị cho hầu hết ứng dụng khách
SSE	https://mcp.dexpaprika.com/sse	Truyền tải SSE cũ
JSON-RPC	https://mcp.dexpaprika.com/json-rpc	JSON-RPC trực tiếp

Lưu ý: Đây là các điểm cuối giao thức MCP. Chúng sẽ không hiển thị nội dung gì trong trình duyệt. Truy cập mcp.dexpaprika.com để xem trang đích.

{
  "mcpServers": {
    "dexpaprika": {
      "type": "streamable-http",
      "url": "https://mcp.dexpaprika.com/streamable-http"
    }
  }
}

Các công cụ hiện có (20)

Bản dựng tự lưu trữ đăng ký 20 công cụ chỉ đọc: 19 công cụ dữ liệu thị trường cùng với getKeyStatus. Máy chủ được lưu trữ tại mcp.dexpaprika.com đăng ký bộ công cụ riêng, bao gồm submitFeedback. Hãy xác minh từng máy chủ bằng một tools/list trực tiếp.

Khám phá

Công cụ	Mô tả
getCapabilities	Khả năng của máy chủ, quy trình làm việc mẫu, tên gọi khác của mạng và các phương pháp hay nhất. Bắt đầu tại đây.
getNetworks	Liệt kê tất cả blockchain được hỗ trợ (36)
getStats	Thống kê tổng quan hệ sinh thái (tổng số mạng, DEX, pool, token)
search	Tìm token, pool và DEX trên TẤT CẢ mạng theo tên, ký hiệu hoặc địa chỉ
getKeyStatus	Cho biết khóa có được gửi hay không và API nhận diện gói nào. Không đọc dữ liệu thị trường.

Thao tác DEX

Công cụ	Mô tả	Tham số bắt buộc
getNetworkDexes	Liệt kê DEX trên một mạng cụ thể	network

Thao tác pool

Công cụ	Mô tả	Tham số bắt buộc
getNetworkPools	CHÍNH. Lấy các pool có thanh khoản cao nhất trên một mạng	network
getDexPools	Lấy pool từ một DEX cụ thể (các hàng trong results, phân trang bằng con trỏ; cần khóa để phân trang vượt quá trang đầu tiên)	network, dex
getNetworkPoolsFilter	Lọc pool theo khối lượng, giao dịch, thời điểm tạo	network
getPoolDetails	Thông tin chi tiết về pool (giá, khối lượng, TVL, token)	network, pool_address
getPoolOHLCV	Dữ liệu nến OHLCV lịch sử	network, pool_address, start
getPoolIndicator	RSI, EMA, MACD, Bollinger Bands hoặc VWAP cho một pool, được tính phía máy chủ từ dữ liệu nến của pool đó. Giới hạn gói đối với lịch sử và khoảng thời gian giống như getPoolOHLCV	network, pool_address, indicator
getPoolTransactions	Giao dịch gần đây của một pool	network, pool_address

Thao tác token

Công cụ	Mô tả	Tham số bắt buộc
getTokenDetails	Thông tin chi tiết về token	network, token_address
getTokenPools	Các pool thanh khoản chứa một token (bộ lọc theo mạng, results + phân trang bằng con trỏ; cần khóa để phân trang vượt quá trang đầu tiên)	network, token_address
getTokenOHLCV	Nến OHLCV USD lịch sử cho một token, tính theo trọng số khối lượng trên mọi pool mà token đó được giao dịch. Cần gói Dev hoặc Pro trên api-pro.dexpaprika.com; không có khóa và khóa miễn phí sẽ nhận 403	network, token_address, start
getTokenIndicator	Các chỉ báo tương tự trên nến USD của token, tính trên mọi pool mà token đó được giao dịch. Cần gói Dev hoặc Pro trên api-pro.dexpaprika.com; không có khóa và khóa miễn phí sẽ nhận 403	network, token_address, indicator
getTokenMultiPrices	Giá theo lô cho tối đa 10 token	network, tokens[]
getTopTokens	Các token hàng đầu trên một mạng, xếp hạng theo khối lượng, thanh khoản, FDV hoặc biến động giá 24 giờ	network
filterNetworkTokens	Lọc token theo khối lượng, thanh khoản, FDV, giao dịch và thời điểm tạo	network

Ví dụ sử dụng

// Start by getting capabilities for workflow guidance:
const caps = await getCapabilities();

// Get details about a specific token:
const solanaJupToken = await getTokenDetails({
  network: "solana",
  token_address: "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN"
});

// Find pools containing a token (returns `results` with cursor pagination;
// the token filter only works network-scoped). This first page works without
// a key; passing the response's next_cursor back as cursor to fetch a later
// page needs an API key (a free key pages without limit):
const jupiterPools = await getTokenPools({
  network: "solana",
  token_address: "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN",
  order_by: "volume_usd_24h",
  limit: 5
});

// Get top pools on Ethereum (first page, returns `results` with cursor pagination):
const ethereumPools = await getNetworkPools({
  network: "ethereum",
  order_by: "volume_usd_24h",
  limit: 10
});

// Filter pools by volume and creation time:
const filteredPools = await getNetworkPoolsFilter({
  network: "ethereum",
  volume_24h_min: 100000,
  created_after: "-7d", // also Unix seconds, RFC3339 or YYYY-MM-DD
  sort_by: "volume_usd_24h",
  limit: 20
});

// Get historical price data for a pool:
const ohlcvData = await getPoolOHLCV({
  network: "ethereum",
  pool_address: "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
  start: "-24h",     // last 24 hours; works without a key
  interval: "1h",
  limit: 24
});

// Get historical USD price data for a token, volume-weighted across every
// pool it trades in. Requires a Dev or Pro key in DEXPAPRIKA_API_KEY and
// DEXPAPRIKA_API_BASE_URL=https://api-pro.dexpaprika.com;
// on a keyless or free key this returns 403, so fall back to getPoolOHLCV
// on the token's main pool (found with getTokenPools) instead.
const tokenOhlcvData = await getTokenOHLCV({
  network: "ethereum",
  token_address: "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
  start: "-24h",
  interval: "1h",
  limit: 24
});

// RSI for a pool, computed server-side (no need to fetch candles first).
// Send only the parameters of the indicator you ask for: period for rsi, ema,
// bbands and vwap; fast_period, slow_period and signal_period for macd;
// std_dev for bbands. Any other parameter is refused with 400.
const rsi = await getPoolIndicator({
  network: "ethereum",
  pool_address: "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
  indicator: "rsi",
  interval: "1h",
  start: "-24h"
});

// Batch prices for multiple tokens (max 10):
const prices = await getTokenMultiPrices({
  network: "ethereum",
  tokens: [
    "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
    "0xdac17f958d2ee523a2206206994597c13d831ec7"
  ]
});

Gợi ý câu lệnh cho Claude

• "Phân tích token JUP trên Solana. Lấy giá, khối lượng và các pool thanh khoản hàng đầu."
• "So sánh khối lượng giao dịch giữa Uniswap V3 và SushiSwap trên Ethereum."
• "Lấy dữ liệu OHLCV theo giờ trong ngày vừa qua cho SOL/USDC trên Raydium và vẽ biểu đồ giá."
• "Tìm 5 pool có thanh khoản cao nhất trên mạng Fantom và phân tích cấu trúc phí của chúng."
• "Lấy các giao dịch gần đây của pool ETH/USDT trên Uniswap và phân tích áp lực mua so với bán."
• "Cho tôi xem 10 pool hàng đầu trên Ethereum theo khối lượng 24 giờ."
• "Tìm tất cả pool có token ARB và xếp hạng chúng theo khối lượng."
• "Lọc các pool Ethereum có khối lượng 24 giờ >$100K được tạo trong tuần qua."
• "Trước tiên, lấy tất cả mạng hiện có, sau đó cho tôi xem các pool hàng đầu trên từng mạng lớn."

Giới hạn tốc độ và hiệu suất

• Gói miễn phí: không cần khóa, không cần đăng ký, giới hạn 15 yêu cầu mỗi phút. Khóa API miễn phí tăng giới hạn lên 30 yêu cầu mỗi phút, tăng hạn mức hàng tháng và mở quyền truy cập luồng dữ liệu: đăng ký tại https://console.dexpaprika.com. Pro có giá $99/tháng với 500 yêu cầu mỗi phút, còn gói Dev giá $30 có 120 yêu cầu mỗi phút. Mỗi yêu cầu tốn một credit; các điểm cuối theo lô tính một credit cho mỗi mục. Tài liệu đầy đủ tại https://docs.dexpaprika.com. Hạn mức hàng tháng có thể thay đổi, vì vậy hãy xem tại đây thay vì dựa vào trang này: https://dexpaprika.com/api/pricing
• Cần khóa để phân trang kết quả tìm kiếm: trên getNetworkPools, getDexPools, getNetworkPoolsFilter, getTokenPools, filterNetworkTokens và getTopTokens, trang đầu tiên hoạt động mà không cần khóa, nhưng cần khóa API để truyền cursor nhằm lấy trang tiếp theo. Khóa miễn phí cho phép phân trang không giới hạn.
• Độ trễ dữ liệu: tối đa 60 giây ở gói miễn phí, theo thời gian thực ở các gói trả phí
• Pool và token mới trong kết quả tìm kiếm: nếu không có gói Dev trở lên, getNetworkPools, getDexPools, getTokenPools, getNetworkPoolsFilter, getTopTokens và filterNetworkTokens sẽ bỏ qua các pool và token được tạo trong giờ vừa qua. Vì vậy, truy vấn có cửa sổ created_after ngắn hơn một giờ hoặc các pool của token ra mắt trong giờ vừa qua sẽ trả về kết quả trống. getPoolDetails và getTokenDetails trả lời bất kể độ tuổi. Khóa Dev, Pro và Enterprise trên api-pro.dexpaprika.com sẽ thấy chúng ngay khi được lập chỉ mục. Chi tiết: https://docs.dexpaprika.com/knowledge-base/rate-limits#search-freshness
• Thời gian phản hồi: 100-500ms đối với hầu hết điểm cuối (tùy thuộc vào mạng)
• Xử lý lỗi: Lỗi có cấu trúc kèm mã, đề xuất và hướng dẫn thử lại
• Tính khả dụng của dữ liệu OHLCV: Dữ liệu lịch sử thường có từ ngày tạo token/pool

Khắc phục sự cố

Các vấn đề thường gặp:

• Giới hạn tốc độ: Nếu nhận lỗi DP429_RATE_LIMIT, hãy triển khai cơ chế chờ lũy thừa
• Thiếu dữ liệu: Một số token/pool mới có thể chưa có đầy đủ dữ liệu lịch sử
• Lỗi hết thời gian chờ: Yêu cầu dữ liệu lớn có thể mất nhiều thời gian hơn; hãy cân nhắc phân trang
• Lỗi mạng: Kiểm tra kết nối mạng; dịch vụ cần truy cập internet
• Giới hạn OHLCV: Mỗi yêu cầu trả về tối đa 1000 nến (limit); để lấy khoảng thời gian dài hơn, hãy đẩy start về phía trước rồi yêu cầu lại. Không có khóa, OHLCV bao phủ 24 giờ gần nhất ở 1h và khoảng thời gian dài hơn (start: "-24h"); khóa miễn phí mở quyền truy cập 7 ngày ở 10m và khoảng thời gian dài hơn. Xem Giới hạn OHLCV theo gói
• OHLCV trống: Pool có thể còn quá mới. Thay vào đó, hãy dùng getPoolTransactions

Phát triển

# Clone the repository
git clone https://github.com/coinpaprika/dexpaprika-mcp.git
cd dexpaprika-mcp

# Install dependencies
npm install

# Run with auto-restart on code changes
npm run watch

# Build for production
npm run build

# Run tests
npm test

Nhật ký thay đổi

Xem CHANGELOG.md để biết ghi chú phát hành chi tiết và hướng dẫn di chuyển.

Giấy phép

Dự án này được cấp phép theo MIT License - xem tệp LICENSE để biết chi tiết.

Tài nguyên bổ sung

• Tài liệu API DexPaprika
• Máy chủ MCP được lưu trữ, tùy chọn không cần thiết lập
• Đặc tả Model Context Protocol
• DexPaprika - Dữ liệu thị trường phân tích onchain toàn diện
• CoinPaprika - Dữ liệu thị trường tiền mã hóa toàn diện