Create fixed shift

POST 
/shifts/fixed

After requesting a quote, use the quoteId to create a fixed rate shift with the quote. The affiliateId must match the one used to request the quote.

Do not create a fixed shift when the deposit network is in depositVariableOnly or the settle network is in settleVariableOnly on /v2/coins. Use /v2/shifts/variable instead.

For fixed rate shifts, a deposit of exactly the amount of depositAmount must be made before the expiresAt timestamp, otherwise the deposit will be refunded.

For shifts that return a depositMemo, the deposit transaction must include this memo, otherwise the deposit might be lost.

For shifts settling in coins where the network is included in the networksWithMemo array in the /v2/coins endpoint, API users are allowed to specify a settleMemo field, for example "settleMemo": "123343245".

x-sideshift-secret header is required. It can be obtained from the account page under the account secret.

warning

x-sideshift-secret is your account's private key. Never share it with anyone as it grants full access to your account and should be kept confidential.

refundAddress and refundMemo are optional. If they aren't defined, the user is prompted to enter a refund address manually on the SideShift.ai order page if the shift needs to be refunded.

If the API requests are sent from the integration's own server, the x-user-ip header must be set to the end-user IP address; otherwise, the requests will be blocked. See Permissions.

averageShiftSeconds represents the average time in seconds it takes for SideShift to process a shift once the user's deposit is confirmed on the blockchain.

externalId is an optional field that can be used to pass an integration's own ID to the API.

Request

Header Parameters

x-sideshift-secret stringrequired
x-user-ip string

end-user IP address for integrations API requests

application/json

Body

settleAddressstringrequired
settleMemostring

for coins where network is included in networksWithMemo array

affiliateIdstringrequired

affiliateId used to request the quote

quoteIdstringrequired
refundAddressstring
refundMemostring
externalIdstring

integration's own ID

Responses

201

OK

application/json

Schema

Schema

idstringrequired
createdAtstringrequired
depositCoinstringrequired
settleCoinstringrequired
depositNetworkstringrequired
settleNetworkstringrequired
depositAddressstringrequired
depositMemostring
settleAddressstringrequired
settleMemostring
depositMinstringrequired
depositMaxstringrequired
refundAddressstring
refundMemostring
typestringrequired
quoteIdstringrequired
depositAmountstringrequired
settleAmountstringrequired
expiresAtstringrequired
statusstringrequired
averageShiftSecondsstring
externalIdstring
ratestringrequired

Example

{
  "id": "8c9ba87d02a801a2f254",
  "createdAt": "2023-10-17T04:32:00.855Z",
  "depositCoin": "ETH",
  "settleCoin": "ETH",
  "depositNetwork": "arbitrum",
  "settleNetwork": "ethereum",
  "depositAddress": "0xa20916158958168ff5668bF90C3753EcD333b0A2",
  "settleAddress": "0xde2642b2120fd3011fe9659688f76e9E4676F472",
  "depositMin": "1",
  "depositMax": "1",
  "refundAddress": "0xde2642b2120fd3011fe9659688f76e9E4676F472",
  "type": "fixed",
  "quoteId": "75cb6e56-a81b-45a9-8ab4-1f95bf92246g",
  "depositAmount": "1",
  "settleAmount": "0.98088036",
  "expiresAt": "2023-10-17T04:36:47.050Z",
  "status": "waiting",
  "averageShiftSeconds": "44.526343",
  "externalId": "integration-1234"
  "rate": "0.98088036"
}

400

Bad Request

application/json

Schema

Schema

error object
messagestringrequired
codestringrequired
orderIdstring
depositRangeMinstring
depositRangeMaxstring

Example

{
  "error": {
      "message": "Bad request: Invalid parameters: quoteId",
      "code": "BAD_USER_INPUT"
  }
}

{
  "error": {
      "message": "Quote has different affiliateId than input.",
      "code": "BAD_USER_INPUT"
  }
}

{
  "error": {
      "message": "Invalid receiving address",
      "code": "BAD_USER_INPUT"
  }
}

{
  "error": {
      "message": "Invalid refundDestination",
      "code": "BAD_USER_INPUT"
  }
}

{
  "error": {
      "message": "Invalid externalId",
      "code": "BAD_USER_INPUT"
  }
}

401

Unauthorized

application/json

Schema

Schema

error object
messagestringrequired
codestringrequired
orderIdstring
depositRangeMinstring
depositRangeMaxstring

Example

{
  "error": {
      "message": "Do not use the example affiliateId and x-sideshift-secret header from the documentation. Use your own from https://sideshift.ai/account",
      "code": "SESSION_REQUIRED"
  }
}

403

Forbidden

application/json

Schema

Schema

error object
messagestringrequired
codestringrequired
orderIdstring
depositRangeMinstring
depositRangeMaxstring

Example

{
  "error": {
      "message": "Access denied. See https://sideshift.ai/access-denied",
      "code": "ACCESS_DENIED"
  }
}

404

Not Found

application/json

Schema

Schema

error object
messagestringrequired
codestringrequired
orderIdstring
depositRangeMinstring
depositRangeMaxstring

Example

{
  "error": {
      "message": "Account not found",
      "code": "NOT_FOUND"
  }
}

500

Internal Server Error

application/json

Schema

Schema

error object
messagestringrequired
codestringrequired
orderIdstring
depositRangeMinstring
depositRangeMaxstring

Example

{
  "error": {
      "message": "Quote has already been accepted. Request a new quote.",
      "code": "QUOTE_ALREADY_ACCEPTED"
      "orderId": "8c9ba87d02a801a2f254"
  }
}

{
  "error": {
      "message": "Internal Server Error",
      "code": "UNKNOWN"
  }
}