用途:查询币安法币支付能力,包括某国家支持的法币、加密货币与业务类型,买卖及充提的支付方式、限额与指示性价格,无需认证。
主要能力:get_capabilities 查询某国家支持的法币、加密货币与业务类型(可用 businessType=BUY/SELL/DEPOSIT/WITHDRAW 过滤);get_buy_and_sell_payment_methods 需 businessType、fiatCurrency、cryptoCurrency、country 四个参数,返回 paymentMethods 与 p2pPaymentMethods 及各自限额、报价、是否暂停;get_deposit_and_withdraw_payment_methods 需 businessType、fiatCurrency、country,无加密货币与报价;get_price 按法币、加密货币、国家查询 bestPrice,businessType 可选(默认 BUY)。
使用方式:基址为 https://www.binance.com/bapi/fiat/v1/public/fiatpayment/agent,可用 WebFetch 或 curl 调用,响应统一为 code、message、data、success,code 为 000000 表示成功。建议先调 get_capabilities 确认支持情况;简单价格查询可跳过。买卖用买卖接口,充提用充提接口。国家参数用 ISO 3166-1 alpha-2 代码,绝不能使用 US,美国用户不受支持。结果需标注价格为指示性参考价,可能与实际成交价不同;支付方式建议用表格呈现并标明暂停项;展示后应附对应币安操作链接(BUY、SELL、DEPOSIT、WITHDRAW 的 URL 模板按法币、加密货币和业务类型动态生成,可替换语言区域段)。
适用场景:查询某国支持哪些法币与支付方式、买卖或充提限额、法币对加密货币参考价,并引导用户前往币安操作。若结果中出现 code 含 WALLET 的支付方式,表示可用币安法币钱包余额购买,可提示余额不足时先充值并查询充值方式。
限制:订单与支付历史需使用认证端点(references/sapi-endpoints.md),需币安 API key 与 secret;US 不得作为国家参数;EUR 默认国家为 FR,USD 默认 SG;无结果时应询问用户是否更换国家。