Request quote

POST 
/quotes

For fixed rate shifts, a quote should be requested first.

A quote can be requested for either a depositAmount or a settleAmount.

When defining non-native tokens like AXS and USDT for depositCoin and/or settleCoin, the depositNetwork and settleNetwork fields must also be specified. This also applies to native tokens like ETH that supports multiple networks. depositCoin can also be a token contract address for the selected depositNetwork when you need to target a specific token implementation.

info

When a quote is created with a contract address in depositCoin, the response will normalize depositCoin back to the canonical asset ticker, such as USDC.

commissionRate optional parameter can be used to adjust rates for your users. The default commission rate is 0.5%. Rates below the default offer better rates by reducing affiliate commission, while rates above the default are passed on to the user. The maximum commission rate is 2%.

info

Use the same commissionRate in the /v2/pair and /v2/pairs endpoints as when creating the shift/quotes to get an accurate rate information. See Monetization for detailed examples of how commission rates affect rates.

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.

After the quote request, a fixed rate shift should be created using the `id` returned by the /v2/quotes endpoint.

A quote expires after 15 minutes.

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.

Request

Header Parameters

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

end-user IP address for integrations API requests

application/json

Body

depositCoinstringrequired

ticker or token contract address for the selected depositNetwork

depositNetworkstring

required for non-native tokens (e.g. AXS, USDT) and multi-network native tokens (e.g. ETH).

settleCoinstringrequired
settleNetworkstring

required for non-native tokens (e.g. AXS, USDT) and multi-network native tokens (e.g. ETH).

depositAmountstringnullablerequired

if null, settleAmount is required

settleAmountstringnullablerequired

if null, depositAmount is required

affiliateIdstringrequired

Responses

201

OK

application/json

Schema

Schema

idstringrequired
createdAtstringrequired
depositCoinstringrequired
settleCoinstringrequired
depositNetworkstringrequired
settleNetworkstringrequired
expiresAtstringrequired
depositAmountstringrequired
settleAmountstringrequired
ratestringrequired
affiliateIdstring

Example

{
  "id": "c1d79240-0117-4867-afed-9cc4605c53aa",
  "createdAt": "2023-10-17T03:33:21.230Z",
  "depositCoin": "ETH",
  "settleCoin": "ETH",
  "depositNetwork": "arbitrum",
  "settleNetwork": "ethereum",
  "expiresAt": "2023-10-17T03:48:21.230Z",
  "depositAmount": "0.14364577",
  "settleAmount": "0.14078454",
  "rate": "0.980081348723",
  "affiliateId": "YQMi62XMb"
}

400

Bad Request

application/json

Schema

Schema

error object
messagestringrequired
codestringrequired
orderIdstring
depositRangeMinstring
depositRangeMaxstring

Example

{
  "error": {
      "message": "Bad request",
      "code": "BAD_USER_INPUT"
  }
}

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

{
  "error": {
      "message": "Method ETH/bitcoin not found",
      "code": "METHOD_NOT_FOUND"
  }
}

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

{
  "error": {
      "message": "Commission rate cannot be higher than 0.02",
      "code": "BAD_USER_INPUT"
  }
}

{
  "error": {
      "message": "Invalid parameters: commissionRate: Must be a positive number",
      "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": "Invalid coin",
      "code": "BAD_USER_INPUT"
  }
}

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

{
  "error": {
      "message": "Amount too low. Settle amount is less than or equals to 0",
      "code": "BAD_USER_INPUT"
  }
}

{
  "error": {
      "message": "Amount too low. Minimum deposit amount: 0.00010663.",
      "depositRangeMin": "0.00010663",
      "code": "QUOTE_UNAVAILABLE"
  }
}

{
  "error": {
      "message": "Amount too high. Maximum deposit amount: 0.5117083972",
      "depositRangeMax": "0.5117083972",
      "code": "QUOTE_UNAVAILABLE"
  }
}

{
  "error": {
      "message": "Cannot specify both depositAmount and settleAmount",
      "code": "BAD_USER_INPUT"
  }
}

{
  "error": {
      "message": "Deposit method quote unavailable",
      "code": "QUOTE_UNAVAILABLE"
  }
}

{
  "error": {
      "message": "Settle method quote unavailable",
      "code": "QUOTE_UNAVAILABLE"
  }
}

{
  "error": {
      "message": "Deposit method unavailable",
      "code": "SHIFT_UNAVAILABLE"
  }
}

{
  "error": {
      "message": "Settle method unavailable",
      "code": "SHIFT_UNAVAILABLE"
  }
}