Onramp

Onramp transaction endpoints for converting fiat currency to stablecoins

Get onramp quote

post

Get a real-time quote for an onramp 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 onramp quote

application/json

400

Bad request - validation error or invalid parameters

application/json

post

/onramp/quote

HTTPcURLJavaScriptPython

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

{
  "amount": 150050,
  "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": 150050,
      "currency": "NGN"
    },
    "destination": {
      "amount": 100,
      "currency": "USDC"
    }
  }
}

Initiate onramp transaction

post

Initiate a fiat to stablecoin 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:

currencystring · enumOptional

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

Possible values:

assetstring · enumRequiredPossible values:

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 onramp transaction

application/json

400

Bad request - validation error or invalid parameters

application/json

post

/onramp/initiate

HTTPcURLJavaScriptPython

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

{
  "amount": 150050,
  "country": "NG",
  "currency": "NGN",
  "asset": "base:usdc",
  "beneficiary": {
    "holder_type": "INDIVIDUAL",
    "holder_name": "John Doe",
    "wallet_address": "0x1234567890123456789012345678901234567890"
  },
  "exact_output": false,
  "callback_url": "https://your-app.com/webhooks/onramp",
  "reference": "550e8400-e29b-41d4-a716-446655440000",
  "rail": "NIBSS"
}

{
  "success": true,
  "status": 200,
  "message": "Onramp initiated successfully",
  "timestamp": "2024-01-01T00:00:00.000Z",
  "data": {
    "status": "PENDING",
    "type": "ONRAMP",
    "reference": "550e8400-e29b-41d4-a716-446655440000",
    "payload": null,
    "source": {
      "amount": 150050,
      "currency": "NGN"
    },
    "destination": {
      "amount": 100,
      "currency": "USDC"
    },
    "deposit": {
      "bank_name": "Example Bank",
      "bank_code": "058",
      "account_name": "Your Company Name",
      "account_number": "0123456789",
      "note": [
        "Deposit exactly 150,050 NGN to the account above",
        "Include the reference in the payment narration"
      ]
    }
  }
}