Create swap - Sarafa Docs

POST

/

v3

/

swap

Create swap

curl --request POST \
  --url https://serviceapi.sarafa.ss/v3/swap \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "_from": "USD",
  "_to": "SSP",
  "amount": 10,
  "callback_url": "https://merchant.example/webhooks"
}
'

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    _from: 'USD',
    _to: 'SSP',
    amount: 10,
    callback_url: 'https://merchant.example/webhooks'
  })
};

fetch('https://serviceapi.sarafa.ss/v3/swap', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://serviceapi.sarafa.ss/v3/swap"

payload = {
    "_from": "USD",
    "_to": "SSP",
    "amount": 10,
    "callback_url": "https://merchant.example/webhooks"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "status": "success",
  "data": {
    "quote": {
      "from_currency": "USD",
      "to_currency": "USD",
      "amount": 123,
      "rate": 123,
      "fee": 123,
      "platform_fee": 123,
      "receive_amount": 123,
      "quoted_at": "2023-11-07T05:31:56Z",
      "deposit_currency": "USD",
      "deposit_amount": 123
    }
  }
}

Authorizations

x-api-key

string

header

required

Merchant API secret.

Headers

environment

enum<string>

default:production

Target environment. Defaults to production when omitted and must match the API key environment.

Available options:

production,

sandbox

Body

application/json

_from

enum<string>

required

Available options:

USD,

SSP,

USDT,

USDC

_to

enum<string>

required

Available options:

USD,

SSP,

USDT,

USDC

amount

number

required

Required range: x <= 1000000000

callback_url

string<uri>

required

Maximum string length: 500

Pattern: ^https://

external_id

string

Required string length: 3 - 120

Pattern: ^[A-Za-z0-9._:-]+$

quote

boolean

default:true

Callbacks

POST

{$request.body#/callback_url}swapUpdated

Body

application/json

The callback-0-body is of type object.

Response

200

Callback accepted.

Response

Swap quote or executed swap legs.

Option 1
Option 2

status

enum<string>

required

Available options:

success

data

object

required

Show child attributes

Last modified on July 22, 2026

Create swap

curl --request POST \
  --url https://serviceapi.sarafa.ss/v3/swap \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "_from": "USD",
  "_to": "SSP",
  "amount": 10,
  "callback_url": "https://merchant.example/webhooks"
}
'

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    _from: 'USD',
    _to: 'SSP',
    amount: 10,
    callback_url: 'https://merchant.example/webhooks'
  })
};

fetch('https://serviceapi.sarafa.ss/v3/swap', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://serviceapi.sarafa.ss/v3/swap"

payload = {
    "_from": "USD",
    "_to": "SSP",
    "amount": 10,
    "callback_url": "https://merchant.example/webhooks"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "status": "success",
  "data": {
    "quote": {
      "from_currency": "USD",
      "to_currency": "USD",
      "amount": 123,
      "rate": 123,
      "fee": 123,
      "platform_fee": 123,
      "receive_amount": 123,
      "quoted_at": "2023-11-07T05:31:56Z",
      "deposit_currency": "USD",
      "deposit_amount": 123
    }
  }
}