Skip to main content

Prices

GET 
/prices

Allows you to retrieve real-time information about a conversion between two supported currencies, including the rate before and after the NOAH Fee is applied. During a NOAH Hosted Checkout session, real-time ‘/prices’ data is used to calculate the fees and thus the final amount a customer will pay. In case neither SourceAmount or DestinationAmount is defined the fee is not available.

Request​

Query Parameters

    SourceCurrency AssetIDrequired
    DestinationCurrency AssetIDrequired
    SourceAmount PositiveDecimal

    Possible values: non-empty and <= 38 characters, Value must match regular expression ^[+]?([.]\d+|\d+[.]?\d*)$

    Only one of SourceAmount or DestinationAmount can be defined. When this amount is specified, the response DestinationAmount field indicates how much you will get for this, after the deduction of any fees.

    DestinationAmount PositiveDecimal

    Possible values: non-empty and <= 38 characters, Value must match regular expression ^[+]?([.]\d+|\d+[.]?\d*)$

    Only one of SourceAmount or DestinationAmount can be defined. When this amount is specified, the response SourceAmount field indicates how much you will need to sell to get this and cover any fees.

    PaymentMethodCategory PaymentMethodCategory
    Country CountryCode

Responses​

Price estimate successful. Response includes the rate of currency exchange before and after fees are subtracted.

Schema
    Itemsobject[]required

  • Array [

    • PaymentMethodCategory PaymentMethodCategory (string)required

    Categorizes one or more PaymentMethodTypes into broader groups. Useful for listing channels, displaying payment methods:

    • Bank
    • Card
    • Identifier
    Example: Bank
    Rate PositiveDecimal (string)required

    Rate used to exchange currencies

    Possible values: non-empty and <= 38 characters, Value must match regular expression ^[+]?([.]\d+|\d+[.]?\d*)$

    Example: 10.1
    UpdatedAt date-timerequired
    Example: 2024-04-16T08:00:55Z
    TotalFee PositiveDecimal (string)

    The total fee that will be charged for using the specific channel, always specified in the same currency as the requested fiat segment of the transaction.

    Possible values: non-empty and <= 38 characters, Value must match regular expression ^[+]?([.]\d+|\d+[.]?\d*)$

    Example: 10.1
    BusinessFee PositiveDecimal (string)

    The fee applied on behalf of the business to customer transactions, always specified in the same currency as the requested fiat segment of the transaction.

    Possible values: non-empty and <= 38 characters, Value must match regular expression ^[+]?([.]\d+|\d+[.]?\d*)$

    Example: 10.1
    SourceAmount PositiveDecimal (string)

    Possible values: non-empty and <= 38 characters, Value must match regular expression ^[+]?([.]\d+|\d+[.]?\d*)$

    Example: 10.1
    DestinationAmount PositiveDecimal (string)

    Possible values: non-empty and <= 38 characters, Value must match regular expression ^[+]?([.]\d+|\d+[.]?\d*)$

    Example: 10.1

    CryptoFeeBreakdown

    object[]

    Total fee amount breakdown in cryptocurrency.

  • Array [

    • Type FeeBreakdownItemType (string)required

    What fee the items refers to:

    • ChannelFee
    • BusinessFee
    Amount PositiveDecimal (string)required

    Possible values: non-empty and <= 38 characters, Value must match regular expression ^[+]?([.]\d+|\d+[.]?\d*)$

    Example: 10.1

  • ]

  • ]

Loading...