Zaifer-MCP

Instructions

    指定した通貨ペアのティッカー情報を取得します。

    現在の市場価格統計を提供し、以下の用途で使用します：
    - 現在の市場価格と24時間の価格変動を確認したい場合
    - 売買注文の価格設定の参考にしたい場合
    - 市場の活発さ（取引量）を把握したい場合

    使用例:
    - ビットコインの現在価格を確認したい場合
    - 最適な注文価格を決定するため最良売買価格を確認したい場合
    - 24時間の価格レンジを分析したい場合

    Args:
        currency_pair: 通貨ペア（'btc_jpy': ビットコイン/円、'eth_jpy': イーサリアム/円、'xym_jpy': シンボル/円）

    Returns:
        Ticker: ティッカー情報
            - last_price: 最終取引価格
            - high_price: 24時間最高値
            - low_price: 24時間最安値
            - ask_price: 最良売り価格
            - bid_price: 最良買い価格
            - volume: 24時間取引量

    Raises:
        ValueError: 通貨ペアが無効な場合や、APIエラーが発生した場合
    

Implementation Reference

• zaifer_mcp/tools/market.py:21-51 (handler)

  The primary MCP tool handler for 'get_ticker'. Decorated with @mcp.tool() for registration, it delegates to the Zaif API's market.get_ticker method to retrieve real-time ticker data for the specified currency pair.

  @mcp.tool()
  def get_ticker(currency_pair: SupportedPair) -> Ticker:
      """
      指定した通貨ペアのティッカー情報を取得します。
  
      現在の市場価格統計を提供し、以下の用途で使用します：
      - 現在の市場価格と24時間の価格変動を確認したい場合
      - 売買注文の価格設定の参考にしたい場合
      - 市場の活発さ（取引量）を把握したい場合
  
      使用例:
      - ビットコインの現在価格を確認したい場合
      - 最適な注文価格を決定するため最良売買価格を確認したい場合
      - 24時間の価格レンジを分析したい場合
  
      Args:
          currency_pair: 通貨ペア（'btc_jpy': ビットコイン/円、'eth_jpy': イーサリアム/円、'xym_jpy': シンボル/円）
  
      Returns:
          Ticker: ティッカー情報
              - last_price: 最終取引価格
              - high_price: 24時間最高値
              - low_price: 24時間最安値
              - ask_price: 最良売り価格
              - bid_price: 最良買い価格
              - volume: 24時間取引量
  
      Raises:
          ValueError: 通貨ペアが無効な場合や、APIエラーが発生した場合
      """
      return api.market.get_ticker(currency_pair)

• zaifer_mcp/models/market.py:154-209 (schema)

  Data class defining the output structure of the get_ticker tool, including fields for last price, high/low, bid/ask, and volume, with from_dict factory for API response parsing.

  @dataclass
  class Ticker:
      """
      ティッカー情報を表すデータクラス。
      
      Attributes:
          last_price: 最終取引価格
          high_price: 最高値（24時間）
          low_price: 最安値（24時間）
          ask_price: 売り注文最安値
          bid_price: 買い注文最高値
          volume: 24時間取引量
      """
      last_price: Decimal
      high_price: Decimal
      low_price: Decimal
      ask_price: Decimal
      bid_price: Decimal
      volume: Decimal
      
      @classmethod
      def from_dict(cls, data: Dict[str, Any]) -> 'Ticker':
          """
          APIレスポンスからTickerインスタンスを作成します。
          
          Args:
              data: APIレスポンスの辞書
              
          Returns:
              Tickerインスタンス
          """
          return cls(
              last_price=Decimal(str(data['last'])),
              high_price=Decimal(str(data['high'])),
              low_price=Decimal(str(data['low'])),
              ask_price=Decimal(str(data['ask'])),
              bid_price=Decimal(str(data['bid'])),
              volume=Decimal(str(data['volume']))
          )
      
      def to_dict(self) -> Dict[str, Any]:
          """
          TickerインスタンスをAPIレスポンス形式の辞書に変換します。
          
          Returns:
              APIレスポンス形式の辞書
          """
          return {
              'last': str(self.last_price),
              'high': str(self.high_price),
              'low': str(self.low_price),
              'ask': str(self.ask_price),
              'bid': str(self.bid_price),
              'volume': str(self.volume)
          }

• zaifer_mcp/models/common.py:4-7 (schema)

  Literal type defining the valid input values for the currency_pair parameter: only 'btc_jpy', 'eth_jpy', 'xym_jpy' are supported.

  from typing import Literal
  
  # 対応する通貨ペアを明示的に制限
  SupportedPair = Literal["btc_jpy", "eth_jpy", "xym_jpy"]

• zaifer_mcp/api/client.py:228-241 (helper)

  Helper method in MarketApi class that performs the actual HTTP GET request to Zaif's ticker endpoint and parses the response into a Ticker object.

  def get_ticker(self, currency_pair: str) -> Ticker:
      """
      ティッカー情報を取得
  
      Args:
          currency_pair: 通貨ペア（例: 'btc_jpy'）
  
      Returns:
          Tickerオブジェクト
      """
      url = f"{self.base_url}/1/ticker/{currency_pair}"
      data = self.http.get(url)
      return Ticker.from_dict(data)

• zaifer_mcp/server.py:34-39 (registration)

  Import and invocation of register_market_tools during server initialization, which defines and registers the get_ticker tool (among others) to the FastMCP instance.

  from zaifer_mcp.tools.market import register_market_tools
  from zaifer_mcp.tools.account import register_account_tools
  from zaifer_mcp.tools.trade import register_trade_tools
  from zaifer_mcp.tools.chart import register_chart_tools
  
  register_market_tools(mcp, zaif_api)