Quote

Get a quote for buying assets

Obtains a quote for buying assets. This endpoint is used to get the current exchange rate and other details for a specific asset pair.

If the asset pair is not supported, an error will be returned. Assets can go through multiple exchange layers (e.g., from TATUM to USDT, then to USDC), and the quote will reflect the final exchange rate after all conversions.

This endpoint is typically used in the process of exchanging assets, where a user wants to know the current exchange rate before proceeding with the transaction.

post/quote/buy

Request

  • Base URL: https://api.eldorado.io/api
  • URL: https://api.eldorado.io/api/quote/buy
  • Auth: none declared. Required headers: X-Client-ID, X-Referral-ID

Headers

X-Client-IDstring required
X-Referral-IDstring required
User-Agentstring
Authorizationstring

Bearer token. If not provided will be readonly

Request body

chainId'1' | '10' | '14' | '25' | '30' | '40' | '50' | '56' | '88' | '100' | '106' | '122' | '130' | '137' | '146' | '196' | '204' | '232' | '250' | '252' | '288' | '324' | '480' | '999' | '1088' | '1101' | '1135' | '1284' | '1285' | '1329' | '1480' | '1625' | '1868' | '1923' | '2020' | '2741' | '5000' | '8217' | '8453' | '9001' | '13371' | '32659' | '33139' | '34443' | '42161' | '42170' | '42220' | '42793' | '43114' | '55244' | '57073' | '59144' | '60808' | '80002' | '80094' | '81457' | '84532' | '98866' | '167000' | '421614' | '534352' | '747474' | '21000000' | '1313161554' | '1666600000' | '1151111081099710' | '1161011141099710' | '111971151099710' | '9270000000000000' | '20000000000001' | '20000000000002' | '20000000000003' | '20000000000004' required

The chain id of the token to be bought

fiatCurrencyId'USD' | 'COP' | 'ARS' | 'CLP' | 'PEN' | 'BRL' | 'PYG' | 'BOB' | 'VES' | 'MXN' | 'DOP' | 'ECU' required

The unique identifier for the fiat currency to be sent

paymentMethodIdstring required

The unique identifier for the payment method to be used. Get /payment-methods to obtain the list of supported payment methods.

addressTostring

The address to which the funds will be sent. If not provided, the quote will be readonly.

amountstring required

The token amount to be sold (IN) or the fiat amount to be received (OUT)

fixedAmountSide'IN' | 'OUT' required

Specifies whether the amount is fixed on the input (IN) or output (OUT) side

Example request

{
  "chainId": "42161",
  "fiatCurrencyId": "USD",
  "paymentMethodId": "app_zelle",
  "addressTo": "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9",
  "amount": "100.00",
  "fixedAmountSide": "IN"
}

Response

Successful response with quote details

OR

Example response

{
  "amountIn": "100.00",
  "amountOut": "100.00",
  "minAmountOut": "99.98",
  "fixedAmountSide": "IN",
  "chainId": "42161",
  "token": "USDT",
  "quoteId": "quote_123e4567-e89b-12d3-a456-426614174000",
  "createdAt": "2024-01-15T10:30:00.000Z",
  "expiresAt": "2024-01-15T10:35:00.000Z",
  "exchangeRate": "1409.23",
  "fee": {
    "amountInToken": "0.50",
    "amountInFiat": "704.61",
    "breakdown": {
      "platformFees": {
        "amountInToken": "0.50",
        "amountInFiat": "704.61",
        "rate": "0.50"
      },
      "integratorFees": {
        "amountInToken": "0.50",
        "amountInFiat": "704.61",
        "rate": "0.50"
      }
    }
  },
  "readonly": true
}

Changes

No recorded changes to this operation across all 1 revision of this API.