DexPaprika

Server MCP DexPaprika

Server Model Context Protocol (MCP) yang menyediakan akses on-demand ke API data cryptocurrency dan DEX DexPaprika. Dibangun khusus untuk asisten AI seperti Claude untuk mengambil data token, pool, dan DEX secara terprogram tanpa konfigurasi apa pun.

Ringkasan

# Install globally
npm install -g dexpaprika-mcp

# Start the server
dexpaprika-mcp

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

DexPaprika MCP menghubungkan Claude ke data DEX langsung di berbagai blockchain. Tingkat gratis tidak memerlukan kunci API untuk memulai. Instalasi | Konfigurasi | Referensi API

Lebih suka tanpa pengaturan? Gunakan server MCP yang di-hosting di mcp.dexpaprika.com: tanpa instalasi, tanpa kunci untuk memulai, alat data yang sama plus submitFeedback. Lihat Server yang di-hosting untuk endpoint transport.

Rilis Terbaru

Lihat CHANGELOG.md untuk catatan rilis dan panduan migrasi.

Apa yang Dapat Anda Bangun?

• Alat Analisis Token: Lacak pergerakan harga, perubahan kedalaman likuiditas, dan pola volume
• Perbandingan DEX: Analisis struktur biaya, volume, dan pool yang tersedia di berbagai DEX
• Analitik Pool Likuiditas: Pantau perubahan TVL, perhitungan kerugian tidak permanen, dan penilaian dampak harga
• Analisis Pasar: Perbandingan token lintas rantai, tren volume, dan metrik aktivitas perdagangan
• Pelacak Portofolio: Pelacakan nilai saat ini, analisis kinerja historis, peluang hasil
• Analisis Teknis: Lakukan analisis teknis lanjutan menggunakan data OHLCV historis, termasuk identifikasi tren, pengenalan pola, dan perhitungan indikator

Instalasi

Instalasi melalui Smithery

Untuk menginstal DexPaprika untuk Claude Desktop secara otomatis melalui Smithery:

npx -y smithery mcp add coinpaprika/dexpaprika

Instalasi Manual

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

# Start the server
dexpaprika-mcp

Ini adalah server stdio: ia berbicara MCP melalui stdin dan stdout dan tidak mengikat port apa pun. Saat dimulai, ia menulis DexPaprika MCP server v<version> (tool contract v<contract>) is running... ke stderr dan kemudian menunggu klien. Jalankan dari klien MCP (Claude Desktop, Cursor, Claude Code) daripada mengharapkan URL di browser.

Tutorial Video

Tonton tutorial langkah demi langkah kami tentang menyiapkan dan menggunakan server MCP DexPaprika:

Integrasi Claude Desktop

Tambahkan berikut ini ke file konfigurasi Claude Desktop Anda:

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

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

Setelah memulai ulang Claude Desktop, alat DexPaprika akan tersedia untuk Claude secara otomatis.

Opsional: menggunakan kunci API

Ini berfungsi tanpa kunci dan akan selalu demikian. Tanpa pendaftaran, tanpa kartu, tanpa perlu mengonfigurasi apa pun. Semua hal di atas adalah cara yang didukung untuk menjalankannya.

Kunci gratis meningkatkan kuota bulanan dan membuka streaming pada token apa pun daripada set showcase publik. Ini tidak meningkatkan batas permintaan per menit, yang sama di kedua tingkat. Dapatkan satu di console.dexpaprika.com; batas saat ini ada di halaman batas tingkat.

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

Kunci masuk dengan sendirinya. Tidak ada awalan Bearer, dan tidak ada kata skema lainnya. Tempel kunci persis seperti yang diterbitkan. Hampir setiap API lain menginginkan kebalikannya, jadi ini adalah alasan paling umum mengapa kunci yang berfungsi terlihat rusak.

Dua hal yang perlu diketahui:

• Kunci yang tidak dapat kami baca tidak menghasilkan kesalahan. Endpoint data mengabaikan kunci yang tidak dapat dibaca dan melayani Anda sebagai pemanggil anonim, dengan 200 normal dan data nyata, jadi salah ketik terlihat persis seperti sukses. Minta asisten untuk menjalankan getKeyStatus setelah mengatur satu: ia melaporkan paket mana yang sebenarnya dilihat API dan menyebutkan kemungkinan penyebab ketika kunci tidak masuk.
• Pelanggan Pro juga mengatur DEXPAPRIKA_API_BASE_URL ke https://api-pro.dexpaprika.com. Host tidak berubah secara otomatis, karena mengirim kunci gratis ke host tersebut mengembalikan 403.

Server yang di-hosting (tanpa instalasi)

Jika Anda lebih suka tanpa pengaturan, arahkan klien yang kompatibel dengan MCP langsung ke server yang di-hosting di mcp.dexpaprika.com. Halaman arahan menyediakan instruksi pengaturan dan dokumentasi. Endpoint transport berikut tersedia:

Transport	Endpoint	Kasus Penggunaan
HTTP Streamable	https://mcp.dexpaprika.com/streamable-http	Direkomendasikan untuk sebagian besar klien
SSE	https://mcp.dexpaprika.com/sse	Transport SSE lama
JSON-RPC	https://mcp.dexpaprika.com/json-rpc	JSON-RPC langsung

Catatan: Ini adalah endpoint protokol MCP. Mereka tidak akan menampilkan apa pun di browser. Kunjungi mcp.dexpaprika.com untuk halaman arahan.

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

Alat yang Tersedia (17)

Build self-host ini mendaftarkan 17 alat baca: 16 alat data pasar plus getKeyStatus. Server yang di-hosting di mcp.dexpaprika.com mendaftarkan setnya sendiri termasuk submitFeedback. Verifikasi keduanya dengan tools/list langsung.

Penemuan

Alat	Deskripsi
getCapabilities	Kemampuan server, pola alur kerja, sinonim jaringan, dan praktik terbaik. Mulai di sini.
getNetworks	Daftar setiap jaringan blockchain yang didukung (36)
getStats	Statistik ekosistem tingkat tinggi (total jaringan, DEX, pool, token)
search	Cari token, pool, dan DEX di SEMUA jaringan berdasarkan nama, simbol, atau alamat
getKeyStatus	Apakah kunci sedang dikirim dan paket mana yang dilihat API. Tidak membaca data pasar.

Operasi DEX

Alat	Deskripsi	Parameter yang Diperlukan
getNetworkDexes	Daftar DEX di jaringan tertentu	network

Operasi Pool

Alat	Deskripsi	Parameter yang Diperlukan
getNetworkPools	UTAMA. Dapatkan pool likuiditas teratas di jaringan	network
getDexPools	Dapatkan pool dari DEX tertentu (baris di bawah results, paginasi kursor)	network, dex
getNetworkPoolsFilter	Filter pool berdasarkan volume, transaksi, waktu pembuatan	network
getPoolDetails	Info pool terperinci (harga, volume, TVL, token)	network, pool_address
getPoolOHLCV	Data candle OHLCV historis	network, pool_address, start
getPoolTransactions	Transaksi/perdagangan terbaru untuk pool	network, pool_address

Operasi Token

Alat	Deskripsi	Parameter yang Diperlukan
getTokenDetails	Informasi token terperinci	network, token_address
getTokenPools	Pool likuiditas yang berisi token (filter khusus jaringan, results + paginasi kursor)	network, token_address
getTokenMultiPrices	Harga batch untuk hingga 10 token	network, tokens[]
getTopTokens	Token teratas di jaringan diperingkat berdasarkan volume, likuiditas, FDV, atau perubahan harga 24 jam	network
filterNetworkTokens	Filter token berdasarkan volume, likuiditas, FDV, transaksi, dan waktu pembuatan	network

Contoh Penggunaan

// 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):
const jupiterPools = await getTokenPools({
  network: "solana",
  token_address: "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN",
  order_by: "volume_usd_24h",
  limit: 5
});

// Get top pools on Ethereum (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:
const ohlcvData = await getPoolOHLCV({
  network: "ethereum",
  pool_address: "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
  start: "-24h",     // last 24 hours; works without a key
  interval: "1h",
  limit: 24
});

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

Contoh Prompt untuk Claude

• "Analisis token JUP di Solana. Ambil harga, volume, dan pool likuiditas teratas."
• "Bandingkan volume perdagangan antara Uniswap V3 dan SushiSwap di Ethereum."
• "Dapatkan OHLCV per jam untuk hari terakhir untuk SOL/USDC di Raydium dan buat grafik harga."
• "Temukan 5 pool teratas berdasarkan likuiditas di jaringan Fantom dan analisis struktur biayanya."
• "Dapatkan transaksi terbaru untuk pool ETH/USDT di Uniswap dan analisis tekanan beli vs jual."
• "Tampilkan 10 pool teratas di Ethereum berdasarkan volume 24 jam."
• "Cari semua pool yang berisi token ARB dan peringkat berdasarkan volume."
• "Filter pool Ethereum dengan volume 24 jam >$100K yang dibuat minggu lalu."
• "Pertama dapatkan semua jaringan yang tersedia, lalu tampilkan pool teratas di setiap jaringan utama."

Batas Tingkat & Kinerja

• Tingkat gratis: tanpa kunci, tanpa pendaftaran, pada 15 permintaan per menit. Kunci API gratis menaikkannya menjadi 30 permintaan per menit, menaikkan kuota bulanan, dan membuka streaming: daftar di https://console.dexpaprika.com. Pro adalah $99/bulan pada 500 permintaan per menit, dan ada paket Dev $30 pada 120. Satu permintaan menghabiskan satu kredit; endpoint batch menghabiskan satu kredit per item. Dokumen lengkap di https://docs.dexpaprika.com. Kuota bulanan berubah, jadi baca di sini daripada dari halaman ini: https://dexpaprika.com/api/pricing
• Keterlambatan data: hingga 60 detik di tingkat gratis, real-time di paket berbayar
• Waktu Respons: 100-500ms untuk sebagian besar endpoint (tergantung jaringan)
• Penanganan Kesalahan: Kesalahan terstruktur dengan kode, saran, dan panduan coba ulang
• Ketersediaan Data OHLCV: Data historis biasanya tersedia sejak tanggal pembuatan token/pool

Pemecahan Masalah

Masalah Umum:

• Pembatasan tingkat: Jika menerima kesalahan DP429_RATE_LIMIT, terapkan backoff eksponensial
• Data hilang: Beberapa token/pool yang lebih baru mungkin memiliki data historis yang tidak lengkap
• Kesalahan waktu habis: Permintaan data besar mungkin memakan waktu lebih lama, pertimbangkan paginasi
• Kesalahan jaringan: Periksa konektivitas jaringan, layanan memerlukan akses internet
• Keterbatasan OHLCV: Satu permintaan mengembalikan hingga 1000 candle (limit); untuk rentang yang lebih panjang, pindahkan start ke depan dan tanyakan lagi. Tanpa kunci, OHLCV mencakup 24 jam terakhir di 1h dan lebih lama (start: "-24h"); kunci gratis membuka 7 hari di 10m dan lebih lama. Lihat Batas OHLCV berdasarkan paket
• OHLCV kosong: Pool mungkin terlalu baru. Gunakan getPoolTransactions sebagai gantinya

Pengembangan

# 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

Changelog

Lihat CHANGELOG.md untuk catatan rilis terperinci dan panduan migrasi.

Lisensi

Proyek ini dilisensikan di bawah Lisensi MIT - lihat file LICENSE untuk detailnya.

Sumber Daya Tambahan

• Dokumentasi API DexPaprika
• Server MCP yang Di-hosting, opsi tanpa pengaturan
• Spesifikasi Model Context Protocol
• DexPaprika - Data pasar analitik onchain yang komprehensif
• CoinPaprika - Data pasar cryptocurrency yang komprehensif