Skip to main content
For most use cases, use the Transfers endpoint. The bridging endpoint is available for advanced integrations where you need direct control over cross-chain routing.

​
Create Bridge Transaction

Initiate a cross-chain stablecoin transfer between blockchain networks. The bridging endpoint moves stablecoins from one chain to another, handling routing and settlement automatically.

​
Endpoint

POST /v1/bridge

​
Request Headers

HeaderRequiredDescription
X-API-KeyYesYour API key
Content-TypeYesapplication/json
Idempotency-KeyNoUnique identifier for idempotent retries

​
Request

curl -X POST https://api.thiqwave.com/v1/bridge \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: unique_request_id" \
  -d '{
    "quote_id": "quote_5555555555",
    "source_currency": "USDC",
    "source_network": "solana",
    "source_address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
    "destination_currency": "USDC",
    "destination_network": "ethereum",
    "destination_address": "0x742d35Cc6634C0532925a3b844Bc123e5fA42f9c",
    "amount": "1000.00",
    "metadata": {
      "user_id": "user_789"
    }
  }'

​
Request Body

FieldTypeRequiredDescription
quote_idstringYesQuote ID from a prior quote request. Locks in rates and fees.
source_currencystringYesSource stablecoin: USDT or USDC.
source_networkstringYesSource blockchain network: ethereum, avalanche, arbitrum, base, polygon, tron, stellar, solana, xrpl, algorand, sui.
source_addressstringYesWallet address to debit stablecoins from.
destination_currencystringYesDestination stablecoin: USDT or USDC.
destination_networkstringYesDestination blockchain network.
destination_addressstringYesWallet address to credit stablecoins to.
amountstringYesAmount in human-readable format (e.g., "1000.00").
metadataobjectNoKey-value pairs for your reference.

​
Response

{
  "bridge_id": "bridge_1234567890",
  "quote_id": "quote_5555555555",
  "status": "pending",
  "source_currency": "USDC",
  "source_network": "solana",
  "source_address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
  "source_amount": "1000.00",
  "destination_currency": "USDC",
  "destination_network": "ethereum",
  "destination_address": "0x742d35Cc6634C0532925a3b844Bc123e5fA42f9c",
  "destination_amount": "999.50",
  "created_at": "2026-04-09T14:30:00Z",
  "completed_at": null
}

​
Response Fields

FieldTypeDescription
bridge_idstringUnique bridge transaction identifier.
quote_idstringAssociated quote ID.
statusstringCurrent status: pending, processing, completed, failed.
source_currencystringSource stablecoin.
source_networkstringSource blockchain network.
source_addressstringSource wallet address.
source_amountstringAmount debited from source.
destination_currencystringDestination stablecoin.
destination_networkstringDestination blockchain network.
destination_addressstringDestination wallet address.
destination_amountstringAmount credited to destination.
created_atstringISO 8601 timestamp of creation.
completed_atstring or nullISO 8601 timestamp of completion.

​
Bridge States

StatusDescription
pendingBridge transaction initiated.
processingCross-chain transfer in progress.
completedStablecoins delivered to destination wallet.
failedBridge failed. Check details for reason.

​
Notes

  • Ensure the quote is not expired before creating a bridge transaction.
  • Both source and destination must be stablecoins on supported blockchain networks.
  • Monitor bridge status via the Get Bridge Transaction endpoint or webhooks.