Socket Docs

This page covers how to integrate the Socket Deposit flow using the V3 quote and status endpoints.

V3 Deposit Flow

Step 1: Get a deposit quote

Request a quote with userOps=deposit. refundAddress is required for all deposit routes.

GET /v3/swap/quote
  ?userOps=deposit
  &originChainId=8453
  &destinationChainId=42161
  &inputToken=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
  &outputToken=0xaf88d065e77c8cC2239327C5EDb3A432268e5831
  &inputAmount=2000000
  &receiverAddress=0xRECEIVER
  &refundAddress=0xUSER

The response includes one or more routes. Each route has a quoteId and an activationRequired field.

Step 2: Check `activationRequired`

Value	Meaning
`false`	Route is fully active — `txData` and `depositData` are already present. Skip to Step 4.
`true`	Route is a preview — no `txData` or `depositData` yet. Call `/activate` first.

Step 3: Activate the route (if `activationRequired: true`)

POST /v3/swap/quote/{quoteId}/activate

The response returns the activated route with the same shape as a direct quote: txData, depositData, and a stable quoteId. Routes with activationRequired: false skip this step — they’re already ready.

Step 4: Submit the origin transfer

Use txData to submit the origin transaction programmatically, or surface depositData to the user for a manual transfer (address, token, amount, and optional memo — useful for QR-code or copy-paste UIs). txData.type tells you how to submit:

`txData.type`	How to submit
`evm`	`wallet.sendTransaction({ to, data, value })`
`solana`	`connection.sendRawTransaction(signedTx)`
`tron`	`tronWeb.trx.triggerSmartContract(...)`
`stellar`	`server.submitTransaction(signedTx)`

Step 5: Poll status

After the origin transfer is sent, poll with the quoteId:

GET /v3/swap/status?quoteId={quoteId}

Poll every 5–10 seconds. Terminal states:

Status	Terminal
`PENDING`	No
`IN_PROGRESS`	No
`COMPLETED`	Yes ✓
`FAILED`	Yes
`EXPIRED`	Yes
`REFUNDED`	Yes

GETTING STARTED

INTEGRATION GUIDES

MIGRATION

RESOURCES

Deposit Addresses

V3 Deposit Flow

Step 1: Get a deposit quote

Step 2: Check `activationRequired`

Step 3: Activate the route (if `activationRequired: true`)

Step 4: Submit the origin transfer

Step 5: Poll status

​V3 Deposit Flow

​Step 1: Get a deposit quote

​Step 2: Check activationRequired

​Step 3: Activate the route (if activationRequired: true)

​Step 4: Submit the origin transfer

​Step 5: Poll status

V3 Deposit Flow

Step 1: Get a deposit quote

Step 2: Check `activationRequired`

Step 3: Activate the route (if `activationRequired: true`)

Step 4: Submit the origin transfer

Step 5: Poll status