Skip to main content
POST
/
api
/
partner
/
sandbox
/
v1
/
quote
Get Quote
curl --request POST \
  --url https://quickei.io/api/partner/sandbox/v1/quote \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "lookup_token": "<string>",
  "amount": 123,
  "sender_currency": "<string>",
  "receiver_currency": "<string>"
}
'
{
  "quote_id": "<string>",
  "amount": 123,
  "sender_currency": "<string>",
  "receiver_currency": "<string>",
  "exchange_rate": 123,
  "fee": 123,
  "total_deducted": 123,
  "receiver_amount": 123,
  "expires_at": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://developer.quickei.io/llms.txt

Use this file to discover all available pages before exploring further.

Request a quote to preview the exchange rate, fees, and final amount before executing a payout.

Parameters

lookup_token
string
required
The token returned from the Lookup endpoint. Valid for 10 minutes.
amount
number
required
Amount to send from your merchant wallet. Must be greater than 0.
sender_currency
string
required
ISO 4217 currency code of your merchant wallet (e.g. EUR, USD, XAF). Max 10 characters.
receiver_currency
string
required
ISO 4217 currency code of the recipient’s target wallet (e.g. XAF, USD). Max 10 characters. Must match one of the currencies returned in the lookup response.

Example Request

curl -X POST https://quickei.io/api/partner/sandbox/v1/quote \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "lookup_token": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "amount": 100.00,
    "sender_currency": "EUR",
    "receiver_currency": "XAF"
  }'

Success Response 200

{
  "message": {
    "success": ["Quote generated."]
  },
  "data": {
    "quote_id": "f7e6d5c4-b3a2-1098-7654-321fedcba098",
    "amount": 100.00,
    "sender_currency": "EUR",
    "receiver_currency": "XAF",
    "exchange_rate": 655.957,
    "fee": 2.50,
    "total_deducted": 102.50,
    "receiver_amount": 65595.70,
    "expires_at": "2026-03-29T14:05:00+00:00"
  }
}
quote_id
string
UUID identifying this quote. Pass it to the Payout endpoint to lock in this rate. Valid for 5 minutes.
amount
number
The amount that will be sent (before fees).
sender_currency
string
The currency being sent from your merchant wallet.
receiver_currency
string
The currency the recipient will receive.
exchange_rate
number
The applied exchange rate from sender_currency to receiver_currency.
fee
number
The total fee charged (fixed + percentage). Debited from your merchant wallet in sender_currency.
total_deducted
number
Total amount debited from your merchant wallet (amount + fee).
receiver_amount
number
The amount the recipient will receive in their wallet.
expires_at
string
ISO 8601 timestamp when this quote expires.

Same-Currency Example

When sending and receiving currencies match, the exchange rate is 1.0:
curl -X POST https://quickei.io/api/partner/sandbox/v1/quote \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "lookup_token": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "amount": 50.00,
    "sender_currency": "EUR",
    "receiver_currency": "EUR"
  }'
{
  "message": {
    "success": ["Quote generated."]
  },
  "data": {
    "quote_id": "d4c3b2a1-0987-6543-2109-876543210fed",
    "amount": 50.00,
    "sender_currency": "EUR",
    "receiver_currency": "EUR",
    "exchange_rate": 1.0,
    "fee": 1.00,
    "total_deducted": 51.00,
    "receiver_amount": 50.00,
    "expires_at": "2026-03-29T14:05:00+00:00"
  }
}

Error Responses

StatusMessageCause
400Invalid or expired lookup token.The lookup_token has expired (older than 10 minutes) or does not belong to your account
400Merchant wallet not found for currency: EURYou do not have a wallet in the specified sender_currency
400Invalid receiver currency.The receiver_currency does not exist or is inactive
400Recipient has no wallet for currency: XAFThe recipient does not have a wallet for the receiver_currency
400Currency EUR is not authorized for payouts.The currency is not enabled for payouts on your merchant account
422Validation errorMissing or invalid required fields
401Invalid API credentials.Bad or missing Bearer token
Quotes expire after 5 minutes. If a quote expires, request a new one before executing the payout.