# Retrieve quoted price

Retrieves cryptocurrency quotes based on fiat currency amount and present exchange rate. And returns a map with a `data` property that contains a `CryptoCurrencyQuote` object.

## Retrieve quoted price

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

Query cryptocurrency quotes based on fiat currency amount and present exchange rateObject definition

#### Query Parameters

| Name                                                 | Type    | Description                                                                                                                                                                |
| ---------------------------------------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| fiatCurrency<mark style="color:red;">\*</mark>       | String  | <p>ISO code of fiat currency from \[<a data-mention href="/pages/f5zI9xYaAZ8aEEjCEGkp">/pages/f5zI9xYaAZ8aEEjCEGkp</a>]<br>e.g. USD</p>                                    |
| currencyAmount<mark style="color:red;">\*</mark>     | Decimal | <p>Fiat currency amount, up to two decimal places<br>e.g 199</p>                                                                                                           |
| cryptoCurrencyCode<mark style="color:red;">\*</mark> | String  | <p>Cryptocurrency code from \[<a data-mention href="/pages/1lZG3OIg0b9HsyneU2vK">/pages/1lZG3OIg0b9HsyneU2vK</a>]<br>e.g. USDT\_ERC20</p>                                  |
| payment                                              | String  | <p>Payment method from  \[<a data-mention href="/pages/evavhaPG8aGp3cfrqGcp#paymentoption">/pages/evavhaPG8aGp3cfrqGcp#paymentoption</a>]<br>e.g. BANK\_CARD\_TRANSFER</p> |
| buyType                                              | String  | <p>buyType=nft：nft quoted price</p><p>buyType=fiat：on-ramp quoted price</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 version <br>e.g. v1.0</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| X-Fp-Timestamp<mark style="color:red;">\*</mark>  | Integer | <p>Unix timestamp in second <br>e.g. 1661346861</p>                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| X-Fp-Nonce<mark style="color:red;">\*</mark>      | Integer | <p>Random integer <br>e.g. 868964</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| X-Fp-Partner-Id<mark style="color:red;">\*</mark> | String  | <p>Partner ID assigned by FaTPay as Premium Partner <br>e.g. 2yQrS9A0xmM8xpfa</p>                                                                                                                                                                                                                                                                                                                                                                                                             |
| X-Fp-Signature<mark style="color:red;">\*</mark>  | String  | <p><a href="/pages/rkLKL3eVbRwxBcXNKOIy#signature-for-api-request">Signature</a> generated by <code>APIPrivateKey</code><br>e.g. zbBQ+1nv/5up9riH1wbTSSMmkb26LQj3g1cNWsutOordOrtpk8agcA5D5bdYaGeVlHK0qZ2MlUV+ZfOK9cXMuficeIm5fnEjMEm7s1IZtSivMt5te7EFqe52dtVFafE4hUgwqH6QBZB0yZ1FSqHs2dOCI0e8RKJQBDitxtHkibStl1Jt5wulzzq96qWbbVnwoBqGDT52OtwwEcDqMI4SIAzUAdBhAuLqUig1U4Ne9ufT8B1aAohEk5fvn/Sbom21bEjLdgbt5PwH2wmmuBx4tq31IgcP4V+qEBILY2eMAFzkvxNXaX3PsLbj9NpgyIc3HQl0FtRq3gdN7FsSvyvcWA==</p> |

{% tabs %}
{% tab title="200: OK Successful response" %}

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

{% endtab %}
{% endtabs %}

## Object definition

### `CryptoCurrencyQuote`

<table><thead><tr><th>Key</th><th width="127">Format</th><th width="114">Required</th><th>Description</th></tr></thead><tbody><tr><td>fiatCurrency</td><td>String</td><td>Y</td><td>ISO code of fiat currency, e.g. USD, THB, etc.</td></tr><tr><td>currencyAmount</td><td>Decimal</td><td>Y</td><td>Fiat currency amount, up to two decimal places.<br>e.g. 199</td></tr><tr><td>cryptoCurrency</td><td>String</td><td>Y</td><td>Cryptocurrency name, e.g. USDT</td></tr><tr><td>network</td><td>String</td><td>Y</td><td>Cryptocurrency blockchain, e.g. ethereum_mainnet</td></tr><tr><td>cryptoCurrencyCode</td><td>String</td><td>Y</td><td>Cryptocurrency code, e.g. USDT_ERC20</td></tr><tr><td>cryptoCurrencyAmount</td><td>Decimal</td><td>Y</td><td>The amount of cryptocurrency, up to two decimal places.<br>e.g. 182</td></tr><tr><td>cryptoCurrencyUnitPrice</td><td>Decimal</td><td>Y</td><td>Unit price of cryptocurrency, up to two decimal places.<br>e.g. 1.03</td></tr><tr><td>gasFee</td><td>Decimal</td><td>Y</td><td>Gas fee, up to two decimal places.<br>e.g. 1.32</td></tr><tr><td>platformFee</td><td>Decimal</td><td>Y</td><td>Processing fee charged by FaTPay, up to two decimal places.<br>e.g. 11.94</td></tr><tr><td>totalFee</td><td>Decimal</td><td>Y</td><td>Total fee = Gas fee + Processing fee,  up to two decimal places.<br>e.g. 13.26</td></tr><tr><td>paymentOptions</td><td>Object</td><td>Y</td><td>Array of <a href="/pages/evavhaPG8aGp3cfrqGcp#paymentoption"><code>PaymentOption</code></a></td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://dev.fatpay.org/reference/api-reference/apis/retrieve-quoted-price.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.