fiat

Binance 法定通貨スキル

公開 API（認証不要）を使用して、Binance の法定通貨決済機能、利用可能な決済方法、価格、対応通貨／国を照会します。注文履歴と決済履歴については、認証済みエンドポイントを参照してください。

ベース URL

https://www.binance.com/bapi/fiat/v1/public/fiatpayment/agent

利用可能な API

1. get_capabilities

国で対応している法定通貨、暗号資産、業務タイプを照会します。

curl "https://www.binance.com/bapi/fiat/v1/public/fiatpayment/agent/get-capabilities?country={COUNTRY_CODE}"

任意：絞り込みには businessType（BUY、SELL、DEPOSIT、WITHDRAW）を指定します。

レスポンス： data.supportedBusinessTypes、data.fiatCurrencies[]（code、name、supportedBusinessTypes を含む）、data.cryptoCurrencies[]

2. get_buy_and_sell_payment_methods

curl "https://www.binance.com/bapi/fiat/v1/public/fiatpayment/agent/get-buy-and-sell-payment-methods?businessType={BUY|SELL}&fiatCurrency={FIAT}&cryptoCurrency={CRYPTO}&country={COUNTRY_CODE}"

4 つのパラメーターをすべて指定する必要があります。

レスポンス： data.paymentMethods[] と data.p2pPaymentMethods[]。各要素には code、paymentMethodName、fiatMinLimit、fiatMaxLimit、cryptoMinLimit、cryptoMaxLimit、quotation、suspended が含まれます。

3. get_deposit_and_withdraw_payment_methods

curl "https://www.binance.com/bapi/fiat/v1/public/fiatpayment/agent/get-deposit-and-withdraw-payment-methods?businessType={DEPOSIT|WITHDRAW}&fiatCurrency={FIAT}&country={COUNTRY_CODE}"

3 つのパラメーターをすべて指定する必要があります。cryptoCurrency、quotation、P2P 決済方法はありません。

レスポンス： data.paymentMethods[]。code、paymentMethodName、fiatMinLimit、fiatMaxLimit、suspended が含まれます。

4. get_price

curl "https://www.binance.com/bapi/fiat/v1/public/fiatpayment/agent/get-price?fiatCurrency={FIAT}&cryptoCurrency={CRYPTO}&country={COUNTRY_CODE}"

任意：businessType（BUY または SELL。デフォルトは BUY）。

レスポンス： data.bestPrice — 参考価格です。実際の約定価格とは異なる場合があります。

推奨ワークフロー

1. まず get_capabilities を呼び出し、ほかの API を呼び出す前に対応状況を確認します。
2. 決済方法 API — BUY／SELL の場合は get_buy_and_sell_payment_methods、DEPOSIT／WITHDRAW の場合は get_deposit_and_withdraw_payment_methods を使用します。
3. get_price — ユーザーが為替レート情報を希望する場合に追加します。

簡単な価格照会（例：「BTC は USD でいくらですか？」）では、手順 1 を省略します。

API の呼び出し

WebFetch または Bash（curl）を使用します。すべてのレスポンスは次の形式です。

{ "code": "000000", "message": null, "data": { ... }, "success": true }

code: "000000" は成功を示します。それ以外の場合は message を確認してください。

アクションリンク

API の結果を提示した後は、ユーザーが Binance ですぐに操作できるよう、必ず関連するアクションリンクを含めてください。会話の内容から法定通貨、暗号資産、業務タイプを判断し、それに応じて URL を組み立てます。

URL テンプレート

業務タイプ	URL テンプレート	例
BUY	https://www.binance.com/en/crypto/buy/{FIAT}/{CRYPTO}	USD で BTC を購入
SELL	https://www.binance.com/en/crypto/sell/{FIAT}/{CRYPTO}	BTC を USD に売却
DEPOSIT	https://www.binance.com/en/fiat/deposit/{FIAT}	USD を入金
WITHDRAW	https://www.binance.com/en/fiat/withdraw/{FIAT}	USD を出金

言語に応じた URL

/en/ のロケール部分を、ユーザーの言語に合わせて置き換えます。対応ロケール：

en, zh-CN, zh-TC, ru, es, es-LA, fr, vi, en-TR, it, pl, id, uk-UA, ar,
en-AU, pt-BR, en-IN, en-NG, ro, bg, cs, lv, sv, pt, es-MX, el, sk, sl,
es-AR, fr-AF, en-KZ, en-ZA, en-NZ, en-BH, ar-BH, ru-UA, de, kk-KZ,
ru-KZ, ja, da-DK, en-AE, en-JP, hu, lo-LA, si-LK, az-AZ, uz-UZ, pt-AO

一般的な対応例：

ユーザーの言語	ロケール	URL の例
英語	en	https://www.binance.com/en/crypto/buy/USD/BTC
簡体字中国語	zh-CN	https://www.binance.com/zh-CN/crypto/buy/CNY/BTC
ポルトガル語（ブラジル）	pt-BR	https://www.binance.com/pt-BR/crypto/buy/BRL/BTC
トルコ語	en-TR	https://www.binance.com/en-TR/crypto/buy/TRY/BTC

地域別の英語（en-AU、en-IN、en-NG、en-AE、en-NZ など）の場合は、単なる en ではなく、地域に対応したロケールを使用します。これにより、ユーザーに地域に適したコンテンツが表示されます。

ユーザーの言語が不明な場合は、en をデフォルトとして使用します。

会話に特定の法定通貨／暗号資産ペアまたは業務タイプが含まれる場合は、必ず 1 つ以上のアクションリンクを含めてください。一般的な質問の場合は、get_capabilities に関連するリンクをすべて含めてください。次のような行動を促す形式にします：「購入する準備はできましたか？Binance で USD を使って BTC を購入」

結果の提示

• 支払い方法はテーブル形式で提示します（名称、上限、価格）。利用停止中の方法には印を付けます
• 価格は参考価格であることを明記します
• ユーザーの言語で回答します
• 必ず関連するアクションリンクで締めくくります

価格の並べ替えと最良価格の判定ロジック

価格の優劣の方向は取引の種類によって異なります。必ず正しい比較方法を適用してください。

取引の種類	有利な価格の方向	理由
BUY	価格が低いほど有利	暗号資産1単位あたりに支払う法定通貨が少なく、同じ額の法定通貨でより多くの暗号資産を購入できます
SELL	価格が高いほど有利	売却する暗号資産1単位あたりに受け取る法定通貨が多くなります

要約する際は、BUY では quotation の最低値を、SELL では最高値を強調してください。例（BUY USD/BTC）：$70,236 は $74,291 より有利です。1ドルあたりに購入できる BTC が多くなります。

ウォレットによる支払い方法（BUY）

BUY のレスポンスに、code に WALLET を含む支払い方法（大文字と小文字は区別しません）がある場合、Binance の法定通貨ウォレット残高を使って暗号資産を購入することを意味します。

この場合は、次の内容を事前に案内してください。

「利用可能な支払い方法の1つは、Binance の法定通貨ウォレット残高です。ウォレットの残高が不足している場合は、まず法定通貨を入金する必要があります。利用可能な入金方法を調べましょうか？」

ユーザーが同意した場合は、同じ法定通貨と国を使用して businessType=DEPOSIT を指定し、get_deposit_and_withdraw_payment_methods を呼び出して、結果を入金アクションリンクとあわせて提示してください。

注文と支払いの履歴（認証が必要）

認証が必要なエンドポイント（注文／支払い履歴、入金／出金記録）については、references/sapi-endpoints.md を参照してください。Binance API キーとシークレットが必要です。

国コードの参照

ISO 3166-1 alpha-2 コードを使用してください（BR、GB、DE、FR、JP、KR、AU など）。国のパラメーターに US を使用してはいけません。Binance の法定通貨決済 API は米国ユーザーに対応していません。

国の推定ルール

次の優先順位に従って、country パラメーターを決定してください。

1. 明示されたコンテキスト — 会話からすでに国がわかっている場合（ユーザーが述べた場合、または以前のターンで推定した場合）は、再推定せずにその国を使用してください。

2. 法定通貨から国への対応付け — 通貨から直接対応付けます。例：

   • SGD → SG、BRL → BR、JPY → JP、KRW → KR、AUD → AU、GBP → GB、CAD → CA、INR → IN、TRY → TR、MXN → MX、NGN → NG
   • EUR → FR（ユーザーが国を指定していない場合、EUR のデフォルトとして FR を使用します）
   • USD → SG（ユーザーが国を指定していない場合、USD のデフォルトとして SG を使用します）

   必須：いかなる場合も、国のパラメーターに US を使用してはいけません。

3. 結果が空の場合 — API が支払い方法を返さない場合、またはサポートされていない組み合わせの場合は、次のように尋ねてください。「現在の設定では結果が見つかりませんでした。別の国を試しますか？試す場合は、国を教えてください。」 その後、ユーザーが指定した国を使用してください。