# 报价查询接口

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

## 法定货币查询接口

<mark style="color:blue;">`GET`</mark> `https://api.ramp.fatpay.xyz/open/api/onramp/price`

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

#### Query Parameters

| Name                                                 | Type    | Description                                                                                                                                       |
| ---------------------------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| fiatCurrency<mark style="color:red;">\*</mark>       | String  | <p>法币ISO代码 <a data-mention href="../../../appendix/supported-fiat-list">supported-fiat-list</a><br>e.g. USD </p>                                  |
| currencyAmount<mark style="color:red;">\*</mark>     | Decimal | <p>buyType=nft，提交加密货币数量</p><p>buyType=crypto，提交加密货币数量</p><p>buyType=fiat，提交法币数量</p><p>e.g. 199</p>                                                |
| cryptoCurrencyCode<mark style="color:red;">\*</mark> | String  | <p>加密货币类型 <a data-mention href="../../../appendix/supported-cryptocurrencies-list">supported-cryptocurrencies-list</a></p><p>e.g. USDT\_ERC20</p> |
| payment                                              | String  | <p>付款方式，来自 <a data-mention href="../list-all-fiat-currencies#paymentoption">#paymentoption</a><br> e.g. BANK\_CARD\_TRANSFER</p>                  |
| buyType                                              | String  | <p>buyType=nft：nft报价查询</p><p>on-ramp不需要该参数</p>                                                                                                    |

#### Headers

| Name                                              | Type    | Description                                                                                                                                                                                                                                                                                                                                                                                                   |
| ------------------------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Content-Type<mark style="color:red;">\*</mark>    | String  | application/json                                                                                                                                                                                                                                                                                                                                                                                              |
| X-Fp-Version<mark style="color:red;">\*</mark>    | String  | <p>FaTPay API 接口版本</p><p>e.g. v1.0</p>                                                                                                                                                                                                                                                                                                                                                                        |
| X-Fp-Timestamp<mark style="color:red;">\*</mark>  | Integer | <p>Unixtime 时间戳，秒</p><p>e.g. 1661346861</p>                                                                                                                                                                                                                                                                                                                                                                   |
| X-Fp-Nonce<mark style="color:red;">\*</mark>      | Integer | <p>6位随机正整数</p><p>e.g. 868964</p>                                                                                                                                                                                                                                                                                                                                                                              |
| X-Fp-Partner-Id<mark style="color:red;">\*</mark> | String  | <p>申请高级合作伙伴时，由 FaTPay 分配的 partner ID</p><p>e.g. 2yQrS9A0xmM8xpfa</p>                                                                                                                                                                                                                                                                                                                                          |
| X-Fp-Signature<mark style="color:red;">\*</mark>  | String  | <p>由 <code>APIPrivateKey</code> 生成的签名</p><p>e.g. zbBQ+1nv/5up9riH1wbTSSMmkb26LQj3g1cNWsutOordOrtpk8agcA5D5bdYaGeVlHK0qZ2MlUV+ZfOK9cXMuficeIm5fnEjMEm7s1IZtSivMt5te7EFqe52dtVFafE4hUgwqH6QBZB0yZ1FSqHs2dOCI0e8RKJQBDitxtHkibStl1Jt5wulzzq96qWbbVnwoBqGDT52OtwwEcDqMI4SIAzUAdBhAuLqUig1U4Ne9ufT8B1aAohEk5fvn/Sbom21bEjLdgbt5PwH2wmmuBx4tq31IgcP4V+qEBILY2eMAFzkvxNXaX3PsLbj9NpgyIc3HQl0FtRq3gdN7FsSvyvcWA==</p> |

{% tabs %}
{% tab title="200: OK 正常返回" %}

```javascript
{
    "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
        }
    }
}
```

{% endtab %}
{% endtabs %}

## 返回的对象

### `CryptoCurrencyQuote`

<table><thead><tr><th>参数名称</th><th width="127">类型</th><th width="114">是否必须</th><th>参数说明</th></tr></thead><tbody><tr><td>fiatCurrency</td><td>String</td><td>是</td><td>法币ISO代码，如 USD、THB</td></tr><tr><td>currencyAmount</td><td>Decimal</td><td>是</td><td>法币金额，最多 2 位小数，如 199</td></tr><tr><td>cryptoCurrency</td><td>String</td><td>是</td><td>加密货币名称，如 USDT</td></tr><tr><td>network</td><td>String</td><td>是</td><td>加密货币所在公链，如ethereum_mainnet</td></tr><tr><td>cryptoCurrencyCode</td><td>String</td><td>是</td><td>加密货币标识码，如 USDT_ERC20</td></tr><tr><td>cryptoCurrencyAmount</td><td>Decimal</td><td>是</td><td>加密货币数量，最多 2 位小数，如 182</td></tr><tr><td>cryptoCurrencyUnitPrice</td><td>Decimal</td><td>是</td><td>加密货币单价，最多 2 位小数，如 1.03</td></tr><tr><td>gasFee</td><td>Decimal</td><td>是</td><td>网络手续费，最多 2 位小数，如 1.32，按照购买的Token为计价单位，如TRX</td></tr><tr><td>platformFee</td><td>Decimal</td><td>是</td><td>平台支付手续费，最多 2 位小数，如 11.94，按照用户支付的法币为计价单位，如USD</td></tr><tr><td>totalFee</td><td>Decimal</td><td>是</td><td>totalFee=platformFee</td></tr><tr><td>paymentOptions</td><td>Object</td><td>是</td><td>法币支持的付款方式，见 <a data-mention href="../list-all-fiat-currencies#paymentoption">#paymentoption</a></td></tr></tbody></table>