v1

latestOpenAPI 3.1.02026-07-26460218.4 KB

Check Eligibility

Pre-flight check for a currency conversion. Tells you whether an amount can auto-convert at the current rate tier or requires a manual RFQ quote, and returns the applicable transaction/daily limits, minimum, and fees. Does not execute a conversion.

post/conversions/eligibilty

Request body

sourceCurrencystring required

Currency to convert from, e.g. USDT, NGN. Length 1–10.

sourceCurrencyType'fiat' | 'crypto' required

Type of source currency. Allowed: crypto, fiat.

destinationCurrencystring required

Currency to convert to, e.g. KES, USDT. Length 1–10.

destinationCurrencyType'fiat' | 'crypto' required

Type of destination currency. Allowed: crypto, fiat.

amountstring required

Amount to check, in sourceCurrency. Must be greater than 0.

countryCodestring required

ISO 3166-1 alpha-2 country code, e.g. NG, KE. Length 2.

sourceWalletIdstring

Named source sub-wallet. Omit to use the partner default wallet. Length 1–64.

destinationWalletIdstring

Named destination sub-wallet. Omit to use the partner default wallet. Length 1–64.

Response

eligibleboolean

tierstring

requiresRfqboolean

{"stackTrail":"paths:/conversions/eligibilty:post:responses:200:content:application/json:schema:properties:reason","oasType":"schema","type":"unknown"}

transactionLimitinteger

dailyLimitinteger

dailyLimitRemaininginteger

mininteger

feesnumber

Example response

{
  "eligible": true,
  "tier": "default",
  "transactionLimit": 5000,
  "dailyLimit": 10000,
  "dailyLimitRemaining": 10000,
  "min": 1,
  "fees": 0.5
}