DexPaprika

DexPaprika MCP Sunucusu: Yapay Zekâ Ajanları için Gerçek Zamanlı DEX ve Kripto Verileri

DexPaprika'nın kripto para ve DEX veri API'sine isteğe bağlı erişim sağlayan bir Model Context Protocol (MCP) sunucusu. Claude gibi yapay zekâ asistanlarının güncel token, havuz ve DEX verilerini sıfır yapılandırmayla programatik olarak alması için özel olarak geliştirilmiştir.

Kısaca

# Install globally
npm install -g dexpaprika-mcp

# Start the server
dexpaprika-mcp

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

DexPaprika MCP, Claude'u birden fazla blok zincirindeki canlı DEX verilerine bağlar. Ücretsiz katmanı kullanmaya başlamak için API anahtarı gerekmez. Kurulum | Yapılandırma | API Referansı

Sıfır kurulum mu tercih ediyorsunuz? Barındırılan MCP sunucusunu mcp.dexpaprika.com adresinde kullanın: kurulum gerekmez, başlamak için anahtar gerekmez; aynı veri araçlarına ek olarak submitFeedback sunulur. Aktarım uç noktaları için Barındırılan sunucu bölümüne bakın.

En son sürüm

Sürüm notları ve geçiş kılavuzları için CHANGELOG.md dosyasına bakın.

Neler Geliştirebilirsiniz?

• Token Analizi Araçları: Fiyat hareketlerini, likidite derinliğindeki değişimleri ve hacim örüntülerini izleyin
• DEX Karşılaştırmaları: Farklı DEX'lerdeki ücret yapılarını, hacmi ve kullanılabilir havuzları analiz edin
• Likidite Havuzu Analitiği: TVL değişimlerini, geçici kayıp hesaplamalarını ve fiyat etkisi değerlendirmelerini izleyin
• Piyasa Analizi: Zincirler arası token karşılaştırmaları, hacim eğilimleri ve alım satım etkinliği ölçümleri
• Portföy Takip Araçları: Güncel değer takibi, geçmiş performans analizi ve getiri fırsatları
• Teknik Analiz: Eğilim belirleme, örüntü tanıma ve gösterge hesaplamaları dahil olmak üzere geçmiş OHLCV verilerini kullanarak gelişmiş teknik analiz yapın

Kurulum

Smithery ile kurulum

DexPaprika'yı Smithery aracılığıyla Claude Desktop'a otomatik olarak kurmak için:

npx -y smithery mcp add coinpaprika/dexpaprika

Elle kurulum

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

# Start the server
dexpaprika-mcp

Bu bir stdio sunucusudur: MCP'yi stdin ve stdout üzerinden kullanır ve herhangi bir bağlantı noktası açmaz. Başlatıldığında DexPaprika MCP server v<version> (tool contract v<contract>) is running... ifadesini stderr'e yazar ve ardından bir istemci bekler. Tarayıcıda bir URL açılmasını beklemek yerine sunucuyu bir MCP istemcisinden (Claude Desktop, Cursor, Claude Code) çalıştırın.

Video Eğitimi

DexPaprika MCP sunucusunu kurma ve kullanma adımlarını gösteren eğitim videomuzu izleyin:

Claude Desktop Entegrasyonu

Claude Desktop yapılandırma dosyanıza aşağıdakileri ekleyin:

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

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

Claude Desktop'ı yeniden başlattıktan sonra DexPaprika araçları Claude tarafından otomatik olarak kullanılabilir.

İsteğe bağlı: API anahtarı kullanma

Bu, anahtar olmadan çalışır ve her zaman da çalışacaktır. Kayıt, kart veya yapılandırma gerekmez. Yukarıdaki yöntem, sunucuyu çalıştırmanın desteklenen yoludur.

Ücretsiz bir anahtar aylık kullanım hakkını artırır ve herkese açık örnek kümesi yerine herhangi bir token için akış özelliğini açar. Her iki katmanda da aynı olan dakika başına istek sınırını artırmaz. Anahtarı console.dexpaprika.com adresinden alın; güncel sınırlar hız sınırları sayfasında yer alır.

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

Anahtar, tek başına ve Authorization değerinin tamamı olarak girilir. Önüne hiçbir şey eklemeden, verildiği biçimiyle yapıştırın. Diğer API'lerin neredeyse tamamı anahtarın önüne bir şey eklenmesini istediğinden, çalışan bir anahtarın bozuk görünmesinin en yaygın nedeni budur.

Bilmeniz gereken iki nokta:

• Okuyamadığımız bir anahtar hata oluşturmaz. Veri uç noktaları okunamayan bir anahtarı yok sayar ve size anonim kullanıcıymışsınız gibi normal bir 200 ve gerçek veriler sunar; bu nedenle bir yazım hatası başarılı olmuş gibi görünür. Anahtarı ayarladıktan sonra asistandan getKeyStatus çalıştırmasını isteyin: API'nin gerçekte hangi planı gördüğünü bildirir ve anahtar API'ye ulaşmadığında olası nedeni belirtir.
• Dev ve Pro müşterileri ayrıca DEXPAPRIKA_API_BASE_URL değerini https://api-pro.dexpaprika.com olarak ayarlamalıdır; getTokenOHLCV için de aynı değer gerekir. Anahtarsız kullanımda bu sunucuya ücretsiz anahtar gönderildiğinde 403 döndüğünden, sunucu adresi otomatik olarak değiştirilmez.

Barındırılan sunucu (kurulum gerekmez)

Sıfır kurulum tercih ediyorsanız, MCP uyumlu herhangi bir istemciyi doğrudan mcp.dexpaprika.com adresindeki barındırılan sunucuya yönlendirin. Açılış sayfasında kurulum talimatları ve belgeler bulunur. Aşağıdaki aktarım uç noktaları kullanılabilir:

Aktarım	Uç nokta	Kullanım alanı
Streamable HTTP	https://mcp.dexpaprika.com/streamable-http	Çoğu istemci için önerilir
SSE	https://mcp.dexpaprika.com/sse	Eski SSE aktarımı
JSON-RPC	https://mcp.dexpaprika.com/json-rpc	Doğrudan JSON-RPC

Not: Bunlar MCP protokolü uç noktalarıdır. Tarayıcıda herhangi bir şey görüntülemezler. Açılış sayfası için mcp.dexpaprika.com adresini ziyaret edin.

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

Kullanılabilir Araçlar (20)

Bu kendi sunucunuzda barındırılan derleme, 19 piyasa verisi aracı ve getKeyStatus olmak üzere 20 salt okunur araç kaydeder. mcp.dexpaprika.com adresindeki barındırılan sunucu, submitFeedback dahil kendi araç kümesini kaydeder. Her iki sunucuyu da canlı bir tools/list ile doğrulayın.

Keşif

Araç	Açıklama
getCapabilities	Sunucu özellikleri, iş akışı örüntüleri, ağ eş anlamlıları ve en iyi uygulamalar. Buradan başlayın.
getNetworks	Desteklenen tüm blok zinciri ağlarını listeler (36)
getStats	Ekosisteme ilişkin üst düzey istatistikler (toplam ağ, DEX, havuz ve token sayısı)
search	Tüm ağlardaki tokenları, havuzları ve DEX'leri ada, sembole veya adrese göre arar
getKeyStatus	Bir anahtarın gönderilip gönderilmediğini ve API'nin hangi planı gördüğünü bildirir. Piyasa verisi okumaz.

DEX İşlemleri

Araç	Açıklama	Gerekli Parametreler
getNetworkDexes	Belirli bir ağdaki DEX'leri listeler	network

Havuz İşlemleri

Araç	Açıklama	Gerekli Parametreler
getNetworkPools	Bir ağdaki en yüksek likiditeli havuzları getirir. BİRİNCİL	network
getDexPools	Belirli bir DEX'teki havuzları getirir (results altındaki satırlar, imleçle sayfalama; ilk sayfadan sonrasına geçmek için anahtar gerekir)	network, dex
getNetworkPoolsFilter	Havuzları hacme, işlem sayısına ve oluşturulma zamanına göre filtreler	network
getPoolDetails	Ayrıntılı havuz bilgileri (fiyat, hacim, TVL, tokenlar)	network, pool_address
getPoolOHLCV	Geçmiş OHLCV mum verileri	network, pool_address, start
getPoolIndicator	Bir havuzun mum verilerinden sunucu tarafında hesaplanan RSI, EMA, MACD, Bollinger Bantları veya VWAP. Geçmiş veriler ve aralık için getPoolOHLCV ile aynı plan sınırları geçerlidir	network, pool_address, indicator
getPoolTransactions	Bir havuzun son işlemleri/alım satımları	network, pool_address

Token İşlemleri

Araç	Açıklama	Gerekli Parametreler
getTokenDetails	Ayrıntılı token bilgileri	network, token_address
getTokenPools	Bir tokenı içeren likidite havuzları (ağ kapsamlı filtre, results + imleçle sayfalama; ilk sayfadan sonrasına geçmek için anahtar gerekir)	network, token_address
getTokenOHLCV	Bir tokenın tüm işlem gördüğü havuzlardaki hacim ağırlıklı geçmiş USD OHLCV mumları. api-pro.dexpaprika.com üzerinde Dev veya Pro planı gerekir; anahtarsız ve ücretsiz anahtarlı istekler 403 alır	network, token_address, start
getTokenIndicator	Bir tokenın tüm işlem gördüğü havuzlardaki USD mumları için aynı göstergeler. api-pro.dexpaprika.com üzerinde Dev veya Pro planı gerekir; anahtarsız ve ücretsiz anahtarlı istekler 403 alır	network, token_address, indicator
getTokenMultiPrices	En fazla 10 token için toplu fiyatlar	network, tokens[]
getTopTokens	Bir ağdaki en iyi tokenları hacme, likiditeye, FDV'ye veya 24 saatlik fiyat değişimine göre sıralar	network
filterNetworkTokens	Tokenları hacme, likiditeye, FDV'ye, işlem sayısına ve oluşturulma zamanına göre filtreler	network

Kullanım Örneği

// 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"
  ]
});

Claude için Örnek İstemler

• "Solana'daki JUP tokenını analiz et. Fiyatı, hacmi ve en yüksek likiditeli havuzları getir."
• "Ethereum'da Uniswap V3 ile SushiSwap arasındaki işlem hacmini karşılaştır."
• "Raydium'daki SOL/USDC için son güne ait saatlik OHLCV verilerini al ve fiyat grafiği çiz."
• "Fantom ağında likiditeye göre en iyi 5 havuzu bul ve ücret yapılarını analiz et."
• "Uniswap'taki ETH/USDT havuzunun son işlemlerini getir ve alış-satış baskısını analiz et."
• "Ethereum'daki 24 saatlik hacme göre en iyi 10 havuzu göster."
• "ARB tokenını içeren tüm havuzları ara ve hacme göre sırala."
• "Son bir haftada oluşturulmuş ve 24 saatlik hacmi 100 bin dolardan fazla olan Ethereum havuzlarını filtrele."
• "Önce kullanılabilir tüm ağları getir, ardından her büyük ağdaki en iyi havuzları göster."

Hız Sınırları ve Performans

• Ücretsiz katman: Anahtarsız, kayıt gerekmez; dakikada 15 istek. Ücretsiz API anahtarı bu sınırı dakikada 30 isteğe çıkarır, aylık kotayı artırır ve akış özelliğini açar: https://console.dexpaprika.com. adresinden kaydolun. Pro planı ayda 99 ABD doları karşılığında dakikada 500 istek, Dev planı ise 30 ABD doları karşılığında dakikada 120 istek sunar. Her istek bir krediye mal olur; toplu uç noktalar her öğe için bir kredi kullanır. Belgelerin tamamı: https://docs.dexpaprika.com. Aylık kotalar değişebildiğinden, bu sayfadaki bilgiler yerine güncel kotaları buradan kontrol edin: https://dexpaprika.com/api/pricing
• Arama sonuçlarında sayfalama için anahtar gerekir: getNetworkPools, getDexPools, getNetworkPoolsFilter, getTokenPools, filterNetworkTokens ve getTopTokens için ilk sayfa anahtarsız çalışır; ancak sonraki sayfayı getirmek üzere cursor iletmek için API anahtarı gerekir. Ücretsiz anahtarla sınırsız sayfalama yapılabilir.
• Veri gecikmesi: Ücretsiz katmanda 60 saniyeye kadar, ücretli planlarda gerçek zamanlı
• Aramadaki yeni havuzlar ve tokenlar: Dev planı veya üzeri olmadan getNetworkPools, getDexPools, getTokenPools, getNetworkPoolsFilter, getTopTokens ve filterNetworkTokens, son bir saat içinde oluşturulan havuzları ve tokenları sonuçlara dahil etmez. Bu nedenle bir saatten kısa bir created_after aralığı veya son bir saat içinde piyasaya sürülen bir tokenın havuzları boş sonuç döndürür. getPoolDetails ve getTokenDetails her yaşta sonuç verir. api-pro.dexpaprika.com üzerindeki Dev, Pro ve Enterprise anahtarları, bu verileri dizine eklenir eklenmez görür. Ayrıntılar: https://docs.dexpaprika.com/knowledge-base/rate-limits#search-freshness
• Yanıt Süresi: Çoğu uç nokta için 100-500 ms (ağa bağlıdır)
• Hata İşleme: Kodlar, öneriler ve yeniden deneme yönergeleri içeren yapılandırılmış hatalar
• OHLCV Verilerinin Kullanılabilirliği: Geçmiş veriler genellikle tokenın/havuzun oluşturulma tarihinden itibaren kullanılabilir

Sorun Giderme

Yaygın Sorunlar:

• Hız sınırına takılma: DP429_RATE_LIMIT hataları alıyorsanız üstel geri çekilme uygulayın
• Eksik veriler: Daha yeni bazı tokenların/havuzların geçmiş verileri eksik olabilir
• Zaman aşımı hataları: Büyük veri istekleri daha uzun sürebilir; sayfalamayı değerlendirin
• Ağ hataları: Ağ bağlantısını kontrol edin; hizmet internet erişimi gerektirir
• OHLCV sınırlamaları: Tek bir istek en fazla 1000 mum döndürür (limit); daha uzun bir dönem için start değerini ileri alıp yeniden istekte bulunun. Anahtarsız kullanımda OHLCV, 1h aralığında son 24 saati; daha uzun aralıkta ise (start: "-24h") kapsar. Ücretsiz anahtar, 10m aralığında 7 günlük veriyi ve daha uzun aralıkları açar. Plana göre OHLCV sınırları bölümüne bakın.
• Boş OHLCV: Havuz çok yeni olabilir. Bunun yerine getPoolTransactions kullanın

Geliştirme

# 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

Değişiklik Günlüğü

Ayrıntılı sürüm notları ve geçiş kılavuzları için CHANGELOG.md dosyasına bakın.

Lisans

Bu proje MIT Lisansı kapsamında lisanslanmıştır. Ayrıntılar için LICENSE dosyasına bakın.

Ek Kaynaklar

• DexPaprika API Belgeleri
• Barındırılan MCP Sunucusu, sıfır kurulum seçeneği
• Model Context Protocol Spesifikasyonu
• DexPaprika - Kapsamlı zincir üstü analitik piyasa verileri
• CoinPaprika - Kapsamlı kripto para piyasa verileri