Quote

POST /api/quote

Returns a price + itemised fee breakdown for a pair, so you can show the user what they will get before they commit.

A quote is pricing, not a rate lock. No endpoint accepts a quoteToken today — /api/deposit/asset and /api/wallet/payout both price at execution time. Treat outputAmount as indicative, quote immediately before executing, and show the user the amount the operation response returns as the final one.

expiresAt is set 2 minutes after creation. It marks when the displayed price is stale enough that you should re-quote — it does not reserve anything.

Request

curl --request POST \
  --url https://api.hodle.com.br/api/quote \
  --header "Authorization: Bearer $API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "inputCurrency": "BRL",
    "inputPaymentMethod": "PIX",
    "outputCurrency": "USDC",
    "outputPaymentMethod": "BASE",
    "inputAmount": "100.00"
  }'

const res = await fetch('https://api.hodle.com.br/api/quote', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.HODLE_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    inputCurrency: 'BRL',
    inputPaymentMethod: 'PIX',
    outputCurrency: 'USDC',
    outputPaymentMethod: 'BASE',
    inputAmount: '100.00',
  }),
})
const data = await res.json()

import os, requests

res = requests.post(
    "https://api.hodle.com.br/api/quote",
    headers={
        "Authorization": f"Bearer {os.environ['HODLE_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "inputCurrency": "BRL",
        "inputPaymentMethod": "PIX",
        "outputCurrency": "USDC",
        "outputPaymentMethod": "BASE",
        "inputAmount": "100.00",
    },
)
data = res.json()

Parameters

Pass exactly one of inputAmount or outputAmount.

Response

{
  "success": true,
  "data": {
    "quoteToken": "qt_8f3a4b...",
    "pairName": "BRL-USDC",
    "basePrice": "0.18634",
    "inputCurrency": "BRL",
    "outputCurrency": "USDC",
    "inputAmount": "100.00",
    "outputAmount": "18.41",
    "appliedFees": [
      { "type": "MARKUP",        "amount": "0.20", "currency": "USDC" },
      { "type": "INPUT_FIXED",   "amount": "0.50", "currency": "BRL"  },
      { "type": "OUTPUT_FIXED",  "amount": "0.05", "currency": "USDC" }
    ],
    "expiresAt": "2026-05-09T22:02:00.000Z"
  }
}

Solana quotes

SOLANA is only routable with USDT or USDC; any other currency on that payment method answers 400 "No route ... at this time".

A Solana quote is priced on the Base leg, because that is where the money actually lands before it moves: a Pix on-ramp settles USDC on Base and Relay then bridges it to the destination Solana address. The response says so explicitly:

{
  "success": true,
  "data": {
    "outputAmount": "18.41",
    "settlement": {
      "quotedNetwork": "BASE",
      "deliveryNetwork": "SOLANA",
      "bridge": "relay",
      "bridgeFeeIncluded": false
    }
  }
}

bridgeFeeIncluded: false is the part to plan around — the Relay bridge cost is charged on delivery, so the amount that lands on Solana is marginally below outputAmount. Do not treat a Solana quote as an exact-out guarantee.

Errors

{ "success": false, "error": "No route for BRL-USDC at this time" }

{ "success": false, "error": "inputAmount must be at least 1.00 BRL" }

There is no "expired quote" error, because nothing consumes the quote. Once expiresAt has passed, call /api/quote again.

Common quote shapes