get_currency_pairs

Retrieve supported currency pair details on Zaif exchange, including minimum order quantities, price steps, and precision, to validate trading parameters, calculate valid orders, and understand pair-specific rules.

Instructions

    対応している通貨ペア情報を取得します。

    取引可能な通貨ペアの詳細な制約情報を提供し、以下の用途で使用します：
    - 注文前に最小数量・価格制約を確認したい場合
    - 有効な注文パラメータを計算したい場合
    - 通貨ペアの取引ルールを理解したい場合

    使用例:
    - ビットコインの最小注文数量を確認したい場合
    - 価格の刻み幅に合わせて注文価格を調整したい場合
    - 通貨ペアごとの制約の違いを比較したい場合

    Returns:
        list[CurrencyPair]: 通貨ペア情報のリスト
            - currency_pair: 通貨ペア識別子（例: 'btc_jpy'）
            - min_quantity: 最小注文数量
            - quantity_step: 注文数量の刻み幅
            - min_price: 最小注文価格
            - price_step: 注文価格の刻み幅
            - price_precision: 価格表示の小数点桁数
            - display_name: 表示用名称（例: 'ビットコイン/円'）

    Raises:
        ValueError: APIエラーが発生した場合

Input Schema

TableJSON Schema

Name	Required	Description	Default
No arguments

Implementation Reference

zaifer_mcp/tools/market.py:82-115 (handler)

MCP tool handler for get_currency_pairs: fetches all currency pairs from Zaif API and filters to supported pairs (btc_jpy, eth_jpy, xym_jpy).

@mcp.tool()
def get_currency_pairs() -> list[CurrencyPair]:
    """
    対応している通貨ペア情報を取得します。

    取引可能な通貨ペアの詳細な制約情報を提供し、以下の用途で使用します：
    - 注文前に最小数量・価格制約を確認したい場合
    - 有効な注文パラメータを計算したい場合
    - 通貨ペアの取引ルールを理解したい場合

    使用例:
    - ビットコインの最小注文数量を確認したい場合
    - 価格の刻み幅に合わせて注文価格を調整したい場合
    - 通貨ペアごとの制約の違いを比較したい場合

    Returns:
        list[CurrencyPair]: 通貨ペア情報のリスト
            - currency_pair: 通貨ペア識別子（例: 'btc_jpy'）
            - min_quantity: 最小注文数量
            - quantity_step: 注文数量の刻み幅
            - min_price: 最小注文価格
            - price_step: 注文価格の刻み幅
            - price_precision: 価格表示の小数点桁数
            - display_name: 表示用名称（例: 'ビットコイン/円'）

    Raises:
        ValueError: APIエラーが発生した場合
    """
    all_pairs = api.market.get_currency_pairs("all")
    # 対応している通貨ペアのみをフィルタリング
    supported_pairs = [
        p for p in all_pairs if p.currency_pair in ["btc_jpy", "eth_jpy", "xym_jpy"]
    ]
    return supported_pairs

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

Registration of market tools including get_currency_pairs via register_market_tools call in the main server setup.

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)

zaifer_mcp/api/client.py:273-289 (helper)

Underlying MarketApi method that retrieves currency pair constraints from the Zaif API, called by the tool handler.

def get_currency_pairs(self, currency_pair: str = "all") -> List[CurrencyPair]:
    """
    通貨ペア情報を取得

    Args:
        currency_pair: 通貨ペア、または'all'

    Returns:
        通貨ペア情報のリスト
    """
    if currency_pair == "all":
        url = f"{self.base_url}/1/currency_pairs/all"
    else:
        url = f"{self.base_url}/1/currency_pairs/{currency_pair}"
    data = self.http.get(url)

    return [CurrencyPair.from_dict(item) for item in data]

Zaifer-MCP