Skip to main content

​
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.
1

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.
2

Monitor status via webhooks

Subscribe to webhook events to track the withdrawal lifecycle:
EventDescription
transaction.processing_withdrawalConduit is submitting the on-chain transfer
transaction.withdrawal_processedOn-chain submission completed
transaction.processing_settlementAwaiting confirmations/finalization
transaction.settlement_processedCompleted and settled
3

Validate addresses and networks

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

​
🎉 You’re done!

You have successfully created your first withdrawal transaction.

​
What’s next

​
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.
⌘I