Exchange API

Exchange API calculates fiat-to-crypto or crypto-to-fiat amounts with all fees included.

Fiat to Crypto Estimation

This method estimates the amount of cryptocurrency you'll receive for a specific fiat payment, based on current market rates and fully accounting for commissions and all associated fees. In other words, if you pay exactly X in fiat, you'll receive the precise crypto amount displayed, with all costs already factored in.

For instance, if you convert 1,000 EUR, the method could return an approximation of 0.3 ETH.

To call the API, it is essential to include the x-api-key header.

If the paymentMethod parameter is specified, the method returns the cryptoAmount that you will receive after applying all fees, including those specific to the selected payment method. Otherwise, it returns cryptoAmounts for all available payment methods, each reflecting the net amount of crypto you would receive after all applicable fees.

get

Authorizations

jwt

Query parameters

fiatAmountnumberRequired

currencyIsoCodestringRequired

cryptoSymbolstringRequired

paymentMethodstringOptional

Header parameters

x-api-keystringRequired

API key for authentication

Responses

200

Estimate crypto amount based on fiat amount

application/json

fiatAmountnumber · doubleRequired

Amount in fiat currency

currencyIsoCodestringRequired

Fiat currency ISO code (e.g., USD, EUR)

cryptoAmountnumber · doubleRequired

Estimated amount in cryptocurrency (if a payment method is specified)

cryptoAmountsarrayOptional

Estimated amounts in cryptocurrency for each payment method (if no payment method is specified)

cryptoSymbolstringRequired

Cryptocurrency symbol (e.g., USDT, BTC)

400

Bad request - Missing required fields or invalid values

401

Unauthorized - Missing or invalid API key

500

Internal Server Error

get

/payment/estimate-fiat-to-crypto-exchange

HTTPcURLJavaScriptPython

GET /payment/estimate-fiat-to-crypto-exchange?fiatAmount=1&currencyIsoCode=text&cryptoSymbol=text HTTP/1.1
Host: api.ahoracrypto.com
x-api-key: text
Accept: */*

{
  "fiatAmount": 1,
  "currencyIsoCode": "text",
  "cryptoAmount": 1,
  "cryptoAmounts": [],
  "cryptoSymbol": "text"
}

Example response when a payment method is specified:

{
    "cryptoSymbol": "BTC",
    "cryptoAmount": 0.00090935,
    "fiatAmount": 100,
    "currencyIsoCode": "EUR"
}

Example response when no payment method is specified:

{
    "cryptoSymbol": "BTC",
    "cryptoAmounts": {
        "bank-transfer": 0.00091621,
        "apple-pay": 0.0009066,
        "google-pay": 0.0009066,
        "card": 0.0009066
    },
    "fiatAmount": 100,
    "currencyIsoCode": "EUR"
}

Crypto to Fiat Estimation

This method calculates the precise fiat amount required to receive the exact specified amount of cryptocurrency, fully accounting for all fees and commissions. In other words, the fiat amount you see is the total payment needed to cover the exact crypto amount you want, with all costs already included.

For example, if you input a crypto amount such as 0.5 BTC, the method might return an estimate of around 25,000 USD.

It is important to note that the exchange rate already includes any fees that AhoraCrypto may apply, so it reflects the final rate the user will receive.

To call the API, it is essential to include the x-api-key header.

If the paymentMethod parameter is specified, the method returns the fiatAmount you need to pay, including all fees—also those specific to the selected payment method. Otherwise, it returns fiatAmounts for all available payment methods, each reflecting the total amount you'd need to pay with all applicable fees included.

get

Authorizations

jwt

Query parameters

cryptoAmountnumberRequired

cryptoSymbolstringRequired

currencyIsoCodestringRequired

paymentMethodstringOptional

Header parameters

x-api-keystringRequired

API key for authentication

Responses

200

Estimate fiat amount based on crypto amount

application/json

cryptoAmountnumber · doubleRequired

Amount in cryptocurrency

cryptoSymbolstringRequired

Cryptocurrency code (e.g., USDT, BTC)

fiatAmountnumber · doubleRequired

Estimated amount in fiat currency (if a payment method is specified)

fiatAmountsarrayOptional

Estimated amounts in fiat currency for each payment method (if no payment method is specified)

currencyIsoCodestringRequired

Fiat currency ISO code (e.g., USD, EUR)

400

Bad request - Missing required fields or invalid values

401

Unauthorized - Missing or invalid API key

500

Internal Server Error

get

/payment/estimate-crypto-to-fiat-exchange

HTTPcURLJavaScriptPython

GET /payment/estimate-crypto-to-fiat-exchange?cryptoAmount=1&cryptoSymbol=text&currencyIsoCode=text HTTP/1.1
Host: api.ahoracrypto.com
x-api-key: text
Accept: */*

{
  "cryptoAmount": 1,
  "cryptoSymbol": "text",
  "fiatAmount": 1,
  "fiatAmounts": [],
  "currencyIsoCode": "text"
}

Example response when a payment method is specified:

{
    "cryptoSymbol": "BTC",
    "cryptoAmount": 0.00091734,
    "fiatAmount": 100,
    "currencyIsoCode": "EUR"
}

Example response when no payment method is specified:

{
    "cryptoSymbol": "BTC",
    "cryptoAmount": 0.00091734,
    "fiatAmounts": {
        "bank-transfer": 100,
        "apple-pay": 100.95,
        "google-pay": 100.95,
        "card": 100.95
    },
    "currencyIsoCode": "EUR"
}