v1

latestOpenAPI 3.1.02026-07-26165182724.7 KB

Corporate Swaps

Swap currencies in your corporate account

post/corporate/swap

Headers

api-keystring required

api-key is available on the dashboard

Authorizationstring required

Request body

applicationIdstring required

Your application ID

sourceAccountIdstring required

The Id of the account to debit

destinationAccountIdstring required

The Id of the account to credit

memostring

An optional memo

amountstring required

The amount denominated in the smallest divisible unit of the sending currency. For example: cents or satoshis

ipstring required

IP address collected as the IP address from which the End User is making the swap request. IMPORTANT - This will be a required parameter from the 15th of June 2023 and is optional until then.

Response

200

idstring

sourceAccountIdstring

destinationAccountIdstring

memostring

statusstring

datetimestring

sourceSyncedOwnerIdstring

destinationSyncedOwnerIdstring

Example response

{
  "id": "3ba9b4cc-4b9d-4c98-8d0b-b6ed2895f483",
  "sourceAccountId": "4706004117c1cb14a1d782eabd87b64e",
  "destinationAccountId": "83601bc786b1384fc9f360473c70d3fa",
  "memo": "disintermediate ubiquitous systems",
  "status": "COMMITTED",
  "order": {
    "id": "4c40ba49-12d4-4454-a400-d1eb6937d983",
    "price": "40687.33",
    "type": "buy",
    "ticker": "BTCEUR",
    "debit": {
      "currency": "EUR",
      "amountFloat": "11",
      "amount": "1100"
    },
    "credit": {
      "currency": "BTC",
      "amountFloat": "0.00027035",
      "amount": "27035"
    }
  },
  "datetime": "2023-12-08T11:42:56.447Z",
  "balanceBefore": {
    "balance": {
      "balance": "1189",
      "currency": "cents"
    },
    "amount": {
      "balance": "1189",
      "currency": "cents"
    },
    "currency": "cents"
  },
  "balanceAfter": {
    "balance": {
      "balance": "89",
      "currency": "cents"
    },
    "amount": {
      "balance": "89",
      "currency": "cents"
    },
    "currency": "cents"
  },
  "sourceSyncedOwnerId": "92bfd8fe-14f0-49e3-8e5f-86192f352e6b",
  "destinationSyncedOwnerId": "92bfd8fe-14f0-49e3-8e5f-86192f352e6b",
  "feeEstimate": {
    "totalFee": "0",
    "theirFee": "0",
    "ourFee": "0",
    "networkFee": "0"
  }
}