Skip to main content

Getting Started

Leverage SideShift's trading infrastructure to add fast, direct-to-wallet shifts to your project. Our API lets you request quotes, create shifts, and support 200+ assets across multiple networks. Track your earnings and configure automatic withdrawals via your dashboard.

1. Create an Account​

  1. A SideShift.ai account is automatically created in two ways:

    • When creating a shift on the site
    • When visiting the account page

  2. Copy your Private Key – used as x-sideshift-secret.

    warning

    Never share your Private Key with anyone. It grants full access to your account and should be kept secret.

  3. Copy your Account ID – passed as affiliateId.

    info

    Your account represents your integration, not your individual users. Use the same credentials for all shift requests. End users are identified by their shiftId — you do not need to create a separate account for each user.

.env
SIDESHIFT_SECRET=2d880aab08340f43c3803515f19a0ebf #REPLACE WITH YOUR SIDESHIFT ACCOUNT SECRET
AFFILIATE_ID=YQMi62XMb #REPLACE WITH YOUR SIDESHIFT ACCOUNT ID

2. Request a Quote​

curl -L 'https://sideshift.ai/api/v2/quotes' \
-H 'Content-Type: application/json' \
-H 'x-sideshift-secret: $SIDESHIFT_SECRET' \
-d '{
  "depositCoin": "eth",
  "depositNetwork": "arbitrum",
  "settleCoin": "eth",
  "settleNetwork": "mainnet",
  "depositAmount": "0.14364577",
  "settleAmount": null,
  "affiliateId": "$AFFILIATE_ID"
}'

Save the returned id as QUOTE_ID.

3. Create a Fixed Shift​

curl -L 'https://sideshift.ai/api/v2/shifts/fixed' \
-H 'Content-Type: application/json' \
-H 'x-sideshift-secret: $SIDESHIFT_SECRET' \
-d '{
  "settleAddress": "0xde2642b2120fd3011fe9659688f76e9E4676F472",
  "affiliateId": "$AFFILIATE_ID",
  "quoteId": "QUOTE_ID"
}'

Display the depositAddress to your user and poll /v2/shifts/{shiftId} to monitor the shift's status.

Relevant Resources​