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]