Skip to main content
POST
/
swaps
curl --request POST \
  --url https://api-staging.stablestack.xyz/api/swaps \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "customer_id": "85b148ab-3f6b-4d55-917f-3c8de668a48e",
  "from_currency": "USDT",
  "to_currency": "USDC",
  "amount": "1"
}
'
{
  "status": "success",
  "data": {
    "debitTransaction": {
      "id": "552e8bb6-e9bf-4956-ab3b-9e56cad65a04",
      "sender_wallet_id": "7c1c1825-75c2-4031-86ff-9c46ece29f6c",
      "receiver_wallet_id": "a0d8df69-5cb4-43e7-8746-5652576d7b8b",
      "transaction_id": "ICNZ1RG2VM",
      "asset_code": "usdt",
      "amount": "0.13000000",
      "reference_id": "e60637ec-e5d0-4c68-9bc8-a12658e5735e",
      "status": "PENDING",
      "created_at": "2025-05-21T13:25:08.478Z",
      "updated_at": "2025-05-21T13:25:08.478Z",
      "network": null,
      "crypto_transaction_id": null,
      "transaction_type": "INTERNAL TRANSFER",
      "transaction_mode": "DEBIT",
      "exchange_rate": "0.98",
      "fee": null,
      "withdrawal_recipient_name": null,
      "balance": "1.16240000",
      "reason": null,
      "customer_id": null
    },
    "creditTransaction": {
      "id": "0ea5afd1-3a83-4f54-8116-062fe4680666",
      "sender_wallet_id": "7c1c1825-75c2-4031-86ff-9c46ece29f6c",
      "receiver_wallet_id": "a0d8df69-5cb4-43e7-8746-5652576d7b8b",
      "transaction_id": "8OXM5O9NPM",
      "asset_code": "usdc",
      "amount": "0.12000000",
      "reference_id": "e60637ec-e5d0-4c68-9bc8-a12658e5735e",
      "status": "PENDING",
      "created_at": "2025-05-21T13:25:08.478Z",
      "updated_at": "2025-05-21T13:25:08.478Z",
      "network": null,
      "crypto_transaction_id": null,
      "transaction_type": "INTERNAL TRANSFER",
      "transaction_mode": "CREDIT",
      "exchange_rate": "0.98",
      "fee": null,
      "withdrawal_recipient_name": null,
      "balance": "1.10000000",
      "reason": null,
      "customer_id": null
    },
    "swapId": "e60637ec-e5d0-4c68-9bc8-a12658e5735e"
  },
  "message": "Swap transaction successful"
}
Executes a previously quoted currency swap transaction. This endpoint debits the from_currency amount and credits the to_currency amount.

​
Key Features:

  • Executes the actual currency conversion
  • Processes both debit and credit transactions automically
  • Supports both customer and merchant swaps
  • Returns detailed transaction records for both legs
  • Maintains transaction linkage through reference_id

​
Request Body:

Customer Swap: 
{
  "customer_id": "85b148ab-3f6b-4d55-917f-3c8de668a48e",
  "from_currency": "USDT",
  "to_currency": "USDC",
  "amount": "1"
}
Merchant Swap: 
{
  "from_currency": "USDT",
  "to_currency": "USDC",
  "amount": "1"
}

Headers

​
x-api-key
string
required

Body

application/json
​
from_currency
string
required
Example:

"USDT"

​
to_currency
string
required
Example:

"USDC"

​
amount
string
required
Example:

"20"

​
customer_id
string<uuid> | null

Required for customer, omit for merchant

Example:

"85b148ab-3f6b-4d55-917f-3c8de668a48e"

Response

Swap executed successfully

​
status
string
Example:

"success"

​
data
object
​
message
string
Example:

"Swap transaction successful"