Withdrawal Transaction

Pre-requisites

You have an active Conduit account with API access
You have API credentials (API Key and Secret)
You have reviewed our Customers Core Concepts

In this guide, you’ll create your first “withdrawal” transaction — sending cryptocurrency from a Conduit account to an external wallet.

Create a withdrawal transaction

To create a withdrawal transaction, use the /transactions endpoint.

Request Example

curl --request POST \
  --url https://api.conduit.financial/transactions \
  --header "X-API-Key: your_api_key" \
  --header "X-API-Secret: your_api_secret" \
  --header "Content-Type: application/json" \
  --header "Api-Version: 2024-12-01" \
  --data '{
    "type": "withdrawal",
    "destination": {
      "walletId": "wlt_2nqjHpNLK6wSNlFyMvZgX8SYeAO",
      "asset": "USDC",
      "network": "ethereum",
      "amount": "1400.00"
    },
    "purpose": "Other",
    "reference": "PAYOUT-2024-001"
  }'

Response Example

{
  "type": "withdrawal",
  "id": "trxn_2ji0un2T6BaGhHKsmJu93Zf5OQm",
  "source": {
    "id": "acct_2kezVryAA3Uw9LJYBiXUV7Pj6gu",
    "asset": "USDC",
    "network": "ethereum",
    "amount": "1400.00"
  },
  "destination": {
    "id": "wlt_2nqjHpNLK6wSNlFyMvZgX8SYeAO",
    "asset": "USDC",
    "network": "ethereum",
    "amount": "1400.00"
  },
  "status": "created",
  "createdAt": "2024-10-26T02:21:03.742Z"
}

The destination can be a saved walletId or a raw blockchain address. Using walletId is recommended for address reuse and safety.

Monitor status via webhooks

Subscribe to webhook events to track the withdrawal lifecycle:

Event	Description
`transaction.processing_withdrawal`	Conduit is submitting the on-chain transfer
`transaction.withdrawal_processed`	On-chain submission completed
`transaction.processing_settlement`	Awaiting confirmations/finalization
`transaction.settlement_processed`	Completed and settled

Validate addresses and networks

Always ensure the destination address supports the specified asset and network. Sending to the wrong network can permanently lose funds.

Summary

You have successfully created your first withdrawal transaction.

What’s next?

Set up webhooks to receive transaction status updates: Configuring Your First Webhook
Review Withdrawals Core Concept

API Reference

See the API Reference for full schema and request details.

Support

Reach out to our support team to get help and share your feedback.

Fiat Transfer Transaction Deposit Transaction

⌘I

Getting started

Guides

Developer Tools

Pre-requisites

Request Example

Response Example

Summary

What’s next?

API Reference

Support

​Pre-requisites

​Request Example

​Response Example

​Summary

​What’s next?

​API Reference

​Support

Pre-requisites

Request Example

Response Example

Summary

What’s next?

API Reference

Support