mcpField
F
fiat

fiat

github.com/binance其他1.1k4.9k 次安装2 天前更新
代码仓库

关于 fiat

通过无需身份验证的公开 API 查询 Binance 法币支付能力的技能。可按国家查询支持的币种、支付方式和参考价格，涵盖买入、卖出、充值与提现。

主要功能

  1. 01按国家查询支持的币种
  2. 02列出买卖支付方式
  3. 03列出充值和提现方式
  4. 04获取加密货币参考价格
  5. 05生成 Binance 操作链接

适用场景

  1. 01检查法币与加密货币组合是否受支持
  2. 02比较可用支付方式及限额
  3. 03查询买入或卖出的参考价格
  4. 04按国家查找充值或提现选项

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/binance/binance-skills-hub --skill fiat

安装后在 Claude Code 中输入/fiat确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

CHANGELOG.md
LICENSE.md
references/
authentication.md
sapi-endpoints.md

详细介绍

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——在进行其他调用前确认支持情况
  2. 支付方式 API——BUY/SELL 调用 get_buy_and_sell_payment_methods；DEPOSIT/WITHDRAW 调用 get_deposit_and_withdraw_payment_methods
  3. get_price——用户需要汇率信息时再调用

简单的价格查询（例如“BTC 的美元价格是多少？”）可以跳过步骤 1。

调用 API

使用 WebFetch 或 Bash（curl）。所有响应的格式如下：

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

code: "000000" = 成功；否则请检查 message。

操作链接

展示 API 结果后，始终附上相关操作链接，方便用户直接在 Binance 上继续操作。根据对话上下文中的法币、加密货币和业务类型动态构建 URL。

URL 模板
业务类型URL 模板示例
BUYhttps://www.binance.com/en/crypto/buy/{FIAT}/{CRYPTO}用 USD 购买 BTC
SELLhttps://www.binance.com/en/crypto/sell/{FIAT}/{CRYPTO}将 BTC 卖成 USD
DEPOSIThttps://www.binance.com/en/fiat/deposit/{FIAT}存入 USD
WITHDRAWhttps://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
英语enhttps://www.binance.com/en/crypto/buy/USD/BTC
简体中文zh-CNhttps://www.binance.com/zh-CN/crypto/buy/CNY/BTC
葡萄牙语（巴西）pt-BRhttps://www.binance.com/pt-BR/crypto/buy/BRL/BTC
土耳其语en-TRhttps://www.binance.com/en-TR/crypto/buy/TRY/BTC

对于英语地区变体（en-AU、en-IN、en-NG、en-AE、en-NZ 等），请使用对应的地区区域设置，而非普通的 en，以确保用户看到适合其所在地区的内容。

如果无法确定用户的语言，默认使用 en。

只要对话涉及具体的法币/加密货币交易对或业务类型，就至少附上一个操作链接。对于一般性问题，请附上 get_capabilities 返回的所有相关链接。请使用行动号召的格式，例如：“准备好购买了吗？在 Binance 上用 USD 购买 BTC”

呈现结果

  • 使用表格列出支付方式（名称、限额、价格）；标记已暂停的方式
  • 说明价格为指示性／参考价格
  • 使用用户的语言回复
  • 始终以相关操作链接结尾
价格排序与最佳价值逻辑

价格方向取决于业务类型——务必应用正确的比较方式：

业务类型较优的价格方向理由
BUY价格越低越好每单位加密货币支付的法币更少——相同金额的法币可买到更多加密货币
SELL价格越高越好每卖出单位加密货币可获得更多法币

总结时：对于 BUY，突出显示最低的 quotation；对于 SELL，突出显示最高的 quotation。例如（BUY USD/BTC）：$70,236 优于 $74,291——每美元可买到更多 BTC。

钱包支付方式（BUY）

如果 BUY 响应包含 code 中带有 WALLET（不区分大小写）的支付方式，则表示使用用户的 Binance 法币钱包余额购买加密货币。

出现这种情况时，主动说明：

“可用支付方式中有一种是您的 Binance 法币钱包余额。如果钱包余额不足，您需要先存入法币。需要我为您查询可用的入金方式吗？”

如果用户确认，请使用相同的法币和国家/地区，调用 get_deposit_and_withdraw_payment_methods，并将 businessType=DEPOSIT，然后连同入金操作链接一起呈现结果。

订单与支付历史（已认证）

有关已认证接口（订单／支付历史、存款／提现记录），请参阅 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 未返回任何支付方式或不支持该组合，请询问：“根据您当前的设置未找到结果。您想尝试其他国家／地区吗？如果想，请告诉我具体国家／地区。”然后使用用户提供的国家／地区。

评论

支持 Markdown