Offramp

Offramp transaction endpoints for converting stablecoins to fiat currency

Get offramp quote

post

Get a real-time quote for an offramp transaction including exchange rate, settlement time, and payment rail information.

Authorizations

ServiceKey

X-Service-KeystringRequired

Your Switch API service key. Contact us at [e-mail] to obtain your service key.

Body

application/json

amountnumberRequired

countrystring · enumRequiredPossible values:

assetstring · enumRequiredPossible values:

currencystring · enumOptional

Optional currency code. If not specified, defaults to the country's local currency.

Possible values:

railstring · enumOptional

Optional payment rail. If not specified, defaults to the country's default rail.

Possible values:

exact_outputbooleanOptionalDefault: false

Responses

200

Successfully retrieved offramp quote

application/json

400

Bad request - validation error or invalid parameters

application/json

post

/offramp/quote

HTTPcURLJavaScriptPython

POST /offramp/quote HTTP/1.1
Host: api.onswitch.xyz
X-Service-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 102

{
  "amount": 100,
  "country": "NG",
  "asset": "base:usdc",
  "currency": "NGN",
  "rail": "NIBSS",
  "exact_output": false
}

{
  "success": true,
  "status": 200,
  "message": "Quote fetched successfully",
  "timestamp": "2024-01-01T00:00:00.000Z",
  "data": {
    "rate": 1500.5,
    "expiry": "2024-01-01T00:05:00.000Z",
    "settlement": "Same day",
    "rail": "NIBSS",
    "source": {
      "amount": 100,
      "currency": "USDC"
    },
    "destination": {
      "amount": 150050,
      "currency": "NGN"
    }
  }
}

Initiate offramp transaction

post

Initiate a stablecoin to fiat transaction.

Authorizations

ServiceKey

X-Service-KeystringRequired

Your Switch API service key. Contact us at [e-mail] to obtain your service key.

Body

application/json

amountnumberRequired

countrystring · enumRequiredPossible values:

assetstring · enumRequiredPossible values:

currencystring · enumOptional

Optional currency code. If not specified, defaults to the country's local currency.

Possible values:

sender_namestringOptional

exact_outputbooleanOptionalDefault: false

callback_urlstring · uriOptional

referencestring · uuidOptional

railstring · enumOptional

Optional payment rail. If not specified, defaults to the country's default rail.

Possible values:

Responses

200

Successfully initiated offramp transaction

application/jsonexample

400

Bad request - validation error or invalid parameters

application/json

post

/offramp/initiate

HTTPcURLJavaScriptPython

POST /offramp/initiate HTTP/1.1
Host: api.onswitch.xyz
X-Service-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 324

{
  "amount": 100,
  "country": "NG",
  "currency": "NGN",
  "asset": "base:usdc",
  "beneficiary": {
    "holder_type": "INDIVIDUAL",
    "holder_name": "John Doe",
    "account_number": "0123456789",
    "bank_code": "058"
  },
  "exact_output": false,
  "callback_url": "https://your-app.com/webhooks/offramp",
  "reference": "550e8400-e29b-41d4-a716-446655440000",
  "rail": "NIBSS"
}

{
  "success": true,
  "status": 1,
  "message": "text",
  "timestamp": "2025-12-10T10:17:28.489Z",
  "data": null
}