FaTPay Docs
🇨🇳 中文(简体)
🇨🇳 中文(简体)
  • 介绍
  • 申请集成
    • 成为合作伙伴
    • 快速启动
  • 更多场景的最佳实践
    • 交易所
    • 项目方
    • 钱包工具
    • 流量合作
    • NFT
  • 参考文档
    • 集成 on-ramp 页面
      • 自定义控件
      • 自定义界面
      • 加签
    • 集成 NFT Checkout 页面
    • API 接口文档
      • API
        • 加密货币查询接口
        • 法定货币及支付方式查询接口
        • 报价查询接口
        • 订单列表查询接口
      • Webhooks
        • 订单回调通知
      • 接口加签 & 验签
  • 附录
    • 语言种类
    • 可支持法币
    • 可支持加密货币(on-ramp)
    • 可支持的加密货币(NFT Checkout)
    • API 接口错误码索引
    • RSA 密钥生成指南
    • Demo
      • 集成 FaTPay 页面加签
      • API 接口加签
      • Webhook 订单回调验签
  • 翻译说明
    • 中文翻译
Powered by GitBook
On this page
  • 法定货币查询接口
  • 返回的对象
  • CryptoCurrencyQuote
  1. 参考文档
  2. API 接口文档
  3. API

报价查询接口

基于输入的法定货币金额查询当前加密货币报价

该接口可获取当前 partnerId 基于输入的法定货币金额查询当前加密货币报价,接口正常将返回为报价明细和对应的支付方式详情

法定货币查询接口

GET https://api.ramp.fatpay.xyz/open/api/onramp/price

基于输入的法定货币金额查询当前加密货币报价

Query Parameters

Name
Type
Description

fiatCurrency*

String

currencyAmount*

Decimal

buyType=nft,提交加密货币数量

buyType=crypto,提交加密货币数量

buyType=fiat,提交法币数量

e.g. 199

cryptoCurrencyCode*

String

e.g. USDT_ERC20

payment

String

buyType

String

buyType=nft:nft报价查询

on-ramp不需要该参数

Headers

Name
Type
Description

Content-Type*

String

application/json

X-Fp-Version*

String

FaTPay API 接口版本

e.g. v1.0

X-Fp-Timestamp*

Integer

Unixtime 时间戳,秒

e.g. 1661346861

X-Fp-Nonce*

Integer

6位随机正整数

e.g. 868964

X-Fp-Partner-Id*

String

申请高级合作伙伴时,由 FaTPay 分配的 partner ID

e.g. 2yQrS9A0xmM8xpfa

X-Fp-Signature*

String

由 APIPrivateKey 生成的签名

e.g. zbBQ+1nv/5up9riH1wbTSSMmkb26LQj3g1cNWsutOordOrtpk8agcA5D5bdYaGeVlHK0qZ2MlUV+ZfOK9cXMuficeIm5fnEjMEm7s1IZtSivMt5te7EFqe52dtVFafE4hUgwqH6QBZB0yZ1FSqHs2dOCI0e8RKJQBDitxtHkibStl1Jt5wulzzq96qWbbVnwoBqGDT52OtwwEcDqMI4SIAzUAdBhAuLqUig1U4Ne9ufT8B1aAohEk5fvn/Sbom21bEjLdgbt5PwH2wmmuBx4tq31IgcP4V+qEBILY2eMAFzkvxNXaX3PsLbj9NpgyIc3HQl0FtRq3gdN7FsSvyvcWA==

{
    "code": 10000,
    "msg": "Success",
    "data": {
        "fiatCurrency": "USD",
        "currencyAmount": 199,
        "cryptoCurrency": "USDT",
        "network": "ethereum_rinkeby",
        "cryptoCurrencyCode": "USDT_ERC20" 
        "cryptoCurrencyAmount": 182.0,
        "gasFee": 1.32,
        "cryptoCurrencyUnitPrice": 1.03,
        "platformFee": 11.94,
        "totalFee": 13.26,
        "paymentOptions": {
            "name": "CREDIT_DEBIT_CARD",
            "processingTime": "3 - 7Min",
            "icon": "https://fatpay.xyz/img/1.png",
            "maxAmount": 4000,
            "minAmount": 1
        }
    }
}

返回的对象

CryptoCurrencyQuote

参数名称
类型
是否必须
参数说明

fiatCurrency

String

是

法币ISO代码,如 USD、THB

currencyAmount

Decimal

是

法币金额,最多 2 位小数,如 199

cryptoCurrency

String

是

加密货币名称,如 USDT

network

String

是

加密货币所在公链,如ethereum_mainnet

cryptoCurrencyCode

String

是

加密货币标识码,如 USDT_ERC20

cryptoCurrencyAmount

Decimal

是

加密货币数量,最多 2 位小数,如 182

cryptoCurrencyUnitPrice

Decimal

是

加密货币单价,最多 2 位小数,如 1.03

gasFee

Decimal

是

网络手续费,最多 2 位小数,如 1.32,按照购买的Token为计价单位,如TRX

platformFee

Decimal

是

平台支付手续费,最多 2 位小数,如 11.94,按照用户支付的法币为计价单位,如USD

totalFee

Decimal

是

totalFee=platformFee

paymentOptions

Object

是

Previous法定货币及支付方式查询接口Next订单列表查询接口

Last updated 2 years ago

法币ISO代码 e.g. USD

加密货币类型

付款方式,来自 e.g. BANK_CARD_TRANSFER

法币支持的付款方式,见

可支持法币
可支持加密货币(on-ramp)
paymentOption
paymentOption