Cross-Chain Bridge Transfer

Prepare the bridge transfer

Make sure you have:

• Source network balance: Customer must have sufficient cryptocurrency on the source network
• Same currency: Bridge transfers use the same currency (e.g., USDC) on both networks
• Gas coverage: Ensure source network has gas for the bridge transaction

For this guide, we'll bridge USDC from Ethereum to Polygon.

Make the bridge API request

Call the POST /v1/transfers endpoint with the same currency on different rails:

curl https://wallet.swipelux.com/v1/transfers \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: YOUR_SECRET_API_KEY' \
  --data '{
    "from": {
      "identifier": "cus_cK69MttD5nAUAbud1B",
      "amount": "100.00",
      "rail": "ethereum",
      "currency": "USDC"
    },
    "to": {
      "identifier": "cus_cK69MttD5nAUAbud1B",
      "rail": "polygon", 
      "currency": "USDC"
    }
  }'

Handle the bridge response

The API returns details about the cross-chain bridge operation:

{
  "id": "tr_bridge_nEZHWur1pBSAKY7",
  "from": {
    "identifier": "cus_cK69MttD5nAUAbud1B",
    "amount": "100.00",
    "rail": "ethereum",
    "currency": "USDC"
  },
  "to": {
    "identifier": "cus_cK69MttD5nAUAbud1B",
    "rail": "polygon",
    "currency": "USDC"  
  },
  "state": "processing",
  "url": "https://polygonscan.com/tx/0x123abc...",
  "createdAt": "2025-04-29T10:54:08.724Z",
  "updatedAt": "2025-04-29T10:54:08.724Z"
}

Bridge transfers use the same response structure as other transfers:

• state: Current status of the cross-chain transfer
• url: Blockchain explorer link to track the transaction

Monitor bridge completion

Bridge transfers are processed automatically with the same monitoring as other transfers:

Track progress via:

• Webhook notifications: Receive transfer.completed events
• Status polling: Check transfer status periodically
• Blockchain explorer: Monitor via the provided url field