Overview

When developing DSH agents, retrieving external data usually requires manually handling API calls and authentication. This section introduces the xby-cryptocurrency-data-api-service plugin, which directly integrates with DexPaprika and provides AI assistants with real-time access to cryptocurrency and DEX data.

Plugin Positioning

This is an online-tool plugin maintained by xby-skill. It encapsulates the DexPaprika MCP Server into DSH, addressing the pain point that agents cannot directly query blockchain liquidity pools, token information, or DEX statistics.

Core Capabilities

This plugin provides the following data access capabilities:

  • API key management: Supports setting an API key in the chat via set_xby_apikey. The system automatically persists the setting, so it remains valid after a restart.
  • Network lookup: Retrieves the IDs of all supported blockchain networks.
  • DEX lookup: Retrieves a list of DEXes for a specific network, or retrieves the pools under a specific DEX.
  • Pool lookup: Retrieves the top liquidity pools for a specific network, or retrieves detailed information for a specific pool.
  • Token lookup: Retrieves detailed information for a specific token, or finds liquidity pools containing that token.
  • Historical and transaction data: Retrieves a pool’s historical price data (OHLCV) and recent transaction records.
  • Cross-network search: Supports searching tokens, pools, and DEXes across all networks.
  • Ecosystem statistics: Retrieves ecosystem statistics for DexPaprika.
  • Batch pricing: Retrieves batch price data for multiple tokens on a specific network.

Installation and Enablement

Add the plugin to DSH using the official installation command:

dsh plugin --profile web add github:xby_skill/xby-cryptocurrency-data-api-service

Typical Usage

Before using this plugin, configure the API key:

  1. Call set_xby_apikey in the chat and enter the key obtained from the official Xiaobenyang website.
  2. Call getNetworks to retrieve the list of supported blockchain networks (this is a prerequisite for using network-specific features).
  3. Use getNetworkPools to retrieve the top liquidity pools on a specific network.
  4. Use getPoolDetails to retrieve detailed parameters for a pool.
  5. Use getPoolOHLCV to retrieve a pool’s historical price data for analysis.

Notes

  • Key requirement: You must register on the official Xiaobenyang website and obtain an API key to use this plugin.
  • Call order: Some features (such as getPoolDetails) require calling getNetworks first to obtain a valid network ID.
  • Persistence: Once an API key is set, it is automatically saved locally and does not need to be entered again.