/coverage returns the supported local currencies you can use convert to or from stablecoin. Shows metadata such as country (ISO code), channels, the default channel, typical settlement times, transaction limits etc.
Example Request
curl -L \
--request GET \
--url 'https://api.onswitch.xyz/coverage?direction=OFFRAMP' \
--header 'x-service-key: '"$YOUR_SERVICE_KEY" \
--header 'Accept: */*'
const params = new URLSearchParams({ direction: 'OFFRAMP' });
const res = await fetch(`https://api.onswitch.xyz/coverage?${params}`, {
method: 'GET',
headers: {
'x-service-key': process.env.YOUR_SERVICE_KEY,
Accept: '*/*',
},
});
const json = await res.json();
console.log(json.data?.length, 'corridors');
import os, json, urllib.parse, urllib.request
q = urllib.parse.urlencode({"direction": "OFFRAMP"})
req = urllib.request.Request(
f"https://api.onswitch.xyz/coverage?{q}",
method="GET",
headers={
"x-service-key": os.environ["YOUR_SERVICE_KEY"],
"Accept": "*/*",
},
)
with urllib.request.urlopen(req, timeout=60) as r:
payload = json.load(r)
print(len(payload.get("data", [])), "corridors")
Direction can be
ONRAMP or OFFRAMP. ONRAMP returns currencies that can be converted to stablecoin. OFFRAMP returns currencies that stablecoin can be converted to.Example Response
{
"success": true,
"message": "Coverage fetched successfully",
"timestamp": "2026-08-04T10:44:30.935Z",
"data": [
{
"country": "NG",
"currency": ["NGN"],
"continent": "AFRICA",
"default_channel": "BANK",
"channel": ["BANK"],
"direction": ["ONRAMP", "OFFRAMP"],
"settlement_time": {
"BANK": "30-120 seconds",
"MOBILEMONEY": "5-10 minutes"
},
"payout_limit": {
"BANK": { "min": "$1", "max": "$100,000" },
"note": "This represents the maximum USD value allowed per transaction."
}
},
{
"country": "GH",
"currency": ["GHS"],
"continent": "AFRICA",
"default_channel": "MOBILEMONEY",
"channel": ["MOBILEMONEY"],
"direction": ["OFFRAMP", "ONRAMP"],
"settlement_time": {
"MOBILEMONEY": "5-10 minutes"
},
"payout_limit": {
"MOBILEMONEY": { "min": "$10", "max": "$100,000" },
"note": "This represents the maximum USD value allowed per transaction."
}
},
{
"country": "KE",
"currency": ["KES"],
"continent": "AFRICA",
"default_channel": "MOBILEMONEY",
"channel": ["MOBILEMONEY", "BANK"],
"direction": ["OFFRAMP", "ONRAMP"],
"settlement_time": {
"BANK": "5-10 minutes",
"MOBILEMONEY": "5-10 minutes"
},
"payout_limit": {
"MOBILEMONEY": { "min": "$10", "max": "$100,000" },
"BANK": { "min": "$10", "max": "$100,000" },
"note": "This represents the maximum USD value allowed per transaction."
}
},
{
"country": "ZA",
"currency": ["ZAR"],
"continent": "AFRICA",
"default_channel": "BANK",
"channel": ["BANK"],
"direction": ["OFFRAMP"],
"settlement_time": {
"BANK": "5-10 minutes"
},
"payout_limit": {
"BANK": { "min": "$100", "max": "$100,000" },
"note": "This represents the maximum USD value allowed per transaction."
}
},
{
"country": "CD",
"currency": ["CDF"],
"continent": "AFRICA",
"default_channel": "MOBILEMONEY",
"channel": ["MOBILEMONEY"],
"direction": ["OFFRAMP", "ONRAMP"],
"settlement_time": {
"MOBILEMONEY": "5-10 minutes"
},
"payout_limit": {
"MOBILEMONEY": { "min": "$10", "max": "$100,000" },
"note": "This represents the maximum USD value allowed per transaction."
}
},
{
"country": "GN",
"currency": ["GNF"],
"continent": "AFRICA",
"default_channel": "MOBILEMONEY",
"channel": ["MOBILEMONEY"],
"direction": ["OFFRAMP"],
"settlement_time": {
"MOBILEMONEY": "5-10 minutes"
},
"payout_limit": {
"MOBILEMONEY": { "min": "$10", "max": "$100,000" },
"note": "This represents the maximum USD value allowed per transaction."
}
},
{
"country": "UG",
"currency": ["UGX"],
"continent": "AFRICA",
"default_channel": "MOBILEMONEY",
"channel": ["MOBILEMONEY"],
"direction": ["OFFRAMP", "ONRAMP"],
"settlement_time": {
"MOBILEMONEY": "5-10 minutes"
},
"payout_limit": {
"MOBILEMONEY": { "min": "$10", "max": "$100,000" },
"note": "This represents the maximum USD value allowed per transaction."
}
},
{
"country": "ET",
"currency": ["ETB"],
"continent": "AFRICA",
"default_channel": "MOBILEMONEY",
"channel": ["MOBILEMONEY"],
"direction": ["OFFRAMP"],
"settlement_time": {
"MOBILEMONEY": "5-10 minutes"
},
"payout_limit": {
"MOBILEMONEY": { "min": "$10", "max": "$100,000" },
"note": "This represents the maximum USD value allowed per transaction."
}
},
{
"country": "CI",
"currency": ["XOF"],
"continent": "AFRICA",
"default_channel": "MOBILEMONEY",
"channel": ["MOBILEMONEY"],
"direction": ["OFFRAMP", "ONRAMP"],
"settlement_time": {
"MOBILEMONEY": "5-10 minutes"
},
"payout_limit": {
"MOBILEMONEY": { "min": "$1", "max": "$100,000" },
"note": "This represents the maximum USD value allowed per transaction."
}
},
{
"country": "CM",
"currency": ["XAF"],
"continent": "AFRICA",
"default_channel": "MOBILEMONEY",
"channel": ["MOBILEMONEY"],
"direction": ["OFFRAMP", "ONRAMP"],
"settlement_time": {
"MOBILEMONEY": "5-10 minutes"
},
"payout_limit": {
"MOBILEMONEY": { "min": "$10", "max": "$100,000" },
"note": "This represents the maximum USD value allowed per transaction."
}
},
{
"country": "SN",
"currency": ["XOF"],
"continent": "AFRICA",
"default_channel": "MOBILEMONEY",
"channel": ["MOBILEMONEY"],
"direction": ["OFFRAMP", "ONRAMP"],
"settlement_time": {
"MOBILEMONEY": "5-10 minutes"
},
"payout_limit": {
"MOBILEMONEY": { "min": "$10", "max": "$100,000" },
"note": "This represents the maximum USD value allowed per transaction."
}
},
{
"country": "RW",
"currency": ["RWF"],
"continent": "AFRICA",
"default_channel": "MOBILEMONEY",
"channel": ["MOBILEMONEY"],
"direction": ["OFFRAMP", "ONRAMP"],
"settlement_time": {
"MOBILEMONEY": "5-10 minutes"
},
"payout_limit": {
"MOBILEMONEY": { "min": "$10", "max": "$100,000" },
"note": "This represents the maximum USD value allowed per transaction."
}
},
{
"country": "BJ",
"currency": ["XOF"],
"continent": "AFRICA",
"default_channel": "MOBILEMONEY",
"channel": ["MOBILEMONEY"],
"direction": ["OFFRAMP", "ONRAMP"],
"settlement_time": {
"MOBILEMONEY": "5-10 minutes"
},
"payout_limit": {
"MOBILEMONEY": { "min": "$10", "max": "$100,000" },
"note": "This represents the maximum USD value allowed per transaction."
}
},
{
"country": "GA",
"currency": ["XAF"],
"continent": "AFRICA",
"default_channel": "MOBILEMONEY",
"channel": ["MOBILEMONEY"],
"direction": ["OFFRAMP"],
"settlement_time": {
"MOBILEMONEY": "5-10 minutes"
},
"payout_limit": {
"MOBILEMONEY": { "min": "$10", "max": "$100,000" },
"note": "This represents the maximum USD value allowed per transaction."
}
},
{
"country": "ML",
"currency": ["XOF"],
"continent": "AFRICA",
"default_channel": "MOBILEMONEY",
"channel": ["MOBILEMONEY"],
"direction": ["OFFRAMP", "ONRAMP"],
"settlement_time": {
"MOBILEMONEY": "5-10 minutes"
},
"payout_limit": {
"MOBILEMONEY": { "min": "$10", "max": "$100,000" },
"note": "This represents the maximum USD value allowed per transaction."
}
},
{
"country": "TZ",
"currency": ["TZS"],
"continent": "AFRICA",
"default_channel": "MOBILEMONEY",
"channel": ["MOBILEMONEY", "BANK"],
"direction": ["OFFRAMP", "ONRAMP"],
"settlement_time": {
"MOBILEMONEY": "5-10 minutes",
"BANK": "5-10 minutes"
},
"payout_limit": {
"MOBILEMONEY": { "min": "$10", "max": "$100,000" },
"BANK": { "min": "$10", "max": "$100,000" },
"note": "This represents the maximum USD value allowed per transaction."
}
},
{
"country": "ZM",
"currency": ["ZMW"],
"continent": "AFRICA",
"default_channel": "MOBILEMONEY",
"channel": ["MOBILEMONEY"],
"direction": ["OFFRAMP", "ONRAMP"],
"settlement_time": {
"MOBILEMONEY": "5-10 minutes"
},
"payout_limit": {
"MOBILEMONEY": { "min": "$10", "max": "$100,000" },
"note": "This represents the maximum USD value allowed per transaction."
}
},
{
"country": "SL",
"currency": ["SLE"],
"continent": "AFRICA",
"default_channel": "MOBILEMONEY",
"channel": ["MOBILEMONEY"],
"direction": ["OFFRAMP", "ONRAMP"],
"settlement_time": {
"MOBILEMONEY": "5-10 minutes"
},
"payout_limit": {
"MOBILEMONEY": { "min": "$10", "max": "$100,000" },
"note": "This represents the maximum USD value allowed per transaction."
}
},
{
"country": "MW",
"currency": ["MWK"],
"continent": "AFRICA",
"default_channel": "MOBILEMONEY",
"channel": ["MOBILEMONEY"],
"direction": ["OFFRAMP", "ONRAMP"],
"settlement_time": {
"MOBILEMONEY": "5-10 minutes"
},
"payout_limit": {
"MOBILEMONEY": { "min": "$10", "max": "$100,000" },
"note": "This represents the maximum USD value allowed per transaction."
}
},
{
"country": "LR",
"currency": ["LRD"],
"continent": "AFRICA",
"default_channel": "MOBILEMONEY",
"channel": ["MOBILEMONEY"],
"direction": ["OFFRAMP", "ONRAMP"],
"settlement_time": {
"MOBILEMONEY": "5-10 minutes"
},
"payout_limit": {
"MOBILEMONEY": { "min": "$10", "max": "$100,000" },
"note": "This represents the maximum USD value allowed per transaction."
}
},
{
"country": "GM",
"currency": ["GMD"],
"continent": "AFRICA",
"default_channel": "MOBILEMONEY",
"channel": ["MOBILEMONEY"],
"direction": ["OFFRAMP", "ONRAMP"],
"settlement_time": {
"MOBILEMONEY": "5-10 minutes"
},
"payout_limit": {
"MOBILEMONEY": { "min": "$10", "max": "$100,000" },
"note": "This represents the maximum USD value allowed per transaction."
}
}
]
}
payout_limit represents the maximum USD value that is allowed in a single transaction and varies by channel and currency.Need Help?
Email Support
Send us a message.
Book a call
Hop on a call with us.