---
title: "Get Estimated Currency Rate"
method: POST
path: "/api/v1/payment/currency-price"
tags: ["Payment"]
---

# Get Estimated Currency Rate

`POST /api/v1/payment/currency-price`

Estimate currency price as per the payment method, fiat currency, amount

## Request body

- GetCurrencyPriceDto
  - `cryptoAmount` number — Amount in crypto currency. Although 'fiatAmount' and 'cryptoAmount' is not both required, but need to pass one of them.
  - `fiatAmount` number — Amount in fiat currency. Although 'fiatAmount' and 'cryptoAmount' is not both required, but need to pass one of them.
  - `cryptoCurrency` string, required — Crypto currency symbol. You can get the symbol from GET /crypto-currencies. Example: 'ETH', 'BTC', 'DAI'
  - `fiatCurrency` string, required — Fiat currency symbol. You can get the symbol from GET /fiat-currencies. Example: 'INR', 'EUR', 'USD'
  - `isBuyOrSell` string, required — Is BUY or SELL order. Example: 'BUY', 'SELL'
  - `network` string, required — CryptoCurrency network. This field is required if we are supporting multiple networks of the cryptocurrency. You can get the network name from GET /crypto-currencies. Example: 'mainnet', 'ethereum', 'bep2', 'matic'
  - `paymentMethod` string, required — Payment method. You can get the payment method id from GET /fiat-currencies. Example: 'upi', 'credit_debit_card', 'gbp_bank_transfer'

## Response `201`

Price found

- GetCurrencyPriceResponseVo
  - `statusCode` number
  - `message` string
  - `data` object
    - `quoteId` string — Unique identifier of the quote for the estimated currency rate
    - `conversionPrice` number — Conversion rate
    - `marketConversionPrice` number — Market conversion rate
    - `slippage` number — Slippage
    - `fiatCurrency` string — Fiat currency symbol
    - `cryptoCurrency` string — Cryptocurrency symbol
    - `paymentMethod` string — Payment method used
    - `processingTime` string — Estimated processing time for the transaction
    - `processingTimeInSec` number — Estimated processing time in second for the transaction
    - `fiatAmount` number — Fiat amount used for convert to cryptocurrency
    - `cryptoAmount` number — Cryptocurrency amount expected to receive
    - `isBuyOrSell` string — Indicate the transaction either is `BUY` or `SELL`
    - `network` string — Blockchain network name
    - `feeDecimal` number — Fees in decimals
    - `totalFee` number — Total transaction fees
    - `feeBreakdown` object[] — Fees breakdown
      - `name` string
      - `value` number
      - `id` string
      - `ids` string[]
    - `nonce` number — Nonce number
    - `cryptoLiquidityProvider` string — Payment provider
    - `note` string — Additional note

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden Resources

---

[API](https://skmtc.dev/thirdfi/apis/thirdfi-api.md) · [All operations](https://skmtc.dev/thirdfi/apis/thirdfi-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/thirdfi/thirdfi-api/revisions/4d70807293f6/schema)