Create Crypto Withdrawal

Testing Env

https://partner-api-stage.p100.io

POST

/v1/crypto-withdrawal

Initiates a cryptocurrency withdrawal from a user's account to an external blockchain address. This endpoint is used for sending funds to personal wallets, exchanges, or business partners. The request must include the user's ID, currency, amount, destination wallet address, and required compliance information. If the request is valid, the withdrawal is queued for processing and a withdrawal ID is returned immediately. Actual transfer and all compliance checks (e.g., AML/KYC, travel rule) are performed asynchronously. The network fee is deducted from the user's balance in addition to the withdrawal amount. You can track the status and outcome using the Get Crypto Withdrawal Details endpoint.

Business logic errors (such as insufficient funds) are not checked at this stage. Processing occurs asynchronously. Use the Get Transfer Details endpoint to verify the final status and any errors.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Body Params application/json

Examples

Responses

🟢201Created

application/json

Body

🟠401Access Denied

🟠400P403: Validation error

🟠400P412: User not exist

🟠400P500: Unknown exception

🟠400P501: Service temporarily unavailable

🟠400P459: User not verified

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://partner-api-stage.p100.io/v1/crypto-withdrawal' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "sourceExternalUserId": "75a1d530-3c12-44e8-a23a-0241b9e73c87",
    "currency": "usdc",
    "amount": 1000.2313,
    "walletAddress": "0x5Fa1f7C5205EE01030b73601Bdec63f3E7E677fe",
    "network": "polygon",
    "name": "John Doe",
    "walletType": "CUSTODIAL",
    "receiverType": "NATURAL"
}'

Response Example

201 - Success

{
    "withdrawalId": "a739eb03-7454-4b2b-adc1-0fcbf245500a"
}

Get Network Fee

Get Crypto Withdrawal Details