> This page is for API Reference. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://okx-demo.ferndocs.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://okx-demo.ferndocs.com/_mcp/server. # Withdrawal POST https://www.okx.com/api/v5/asset/withdrawal Content-Type: application/json Withdraw funds from the funding account to an on-chain address or via internal transfer. Only supported for on-chain and internal withdrawal. Reference: https://okx-demo.ferndocs.com/api/api-reference/funding/withdrawal ## Authentication - `OK-ACCESS-KEY` header (required) — Your API key. - `OK-ACCESS-SIGN` header (required) — Base64-encoded HMAC-SHA256 signature of the prehash string. - `OK-ACCESS-TIMESTAMP` header (required) — ISO 8601 UTC timestamp, e.g. 2020-12-08T09:08:57.715Z. - `OK-ACCESS-PASSPHRASE` header (required) — The passphrase you set when creating the API key. ## Request ### Body (application/json) This endpoint expects an object. - `ccy` (string, required) — Currency, e.g. USDT. - `amt` (string, required) — Withdrawal amount. The withdrawal fee is not included in this amount. - `dest` (enum, required) — Withdrawal method: 3=internal transfer, 4=on-chain withdrawal. - Allowed values: `3`, `4` - `toAddr` (string, required) — For on-chain: the recipient address (may append tag/memo with :). For internal transfer: recipient's email, phone, or login account name. - `toAddrType` (enum, optional) — Address type: 1=wallet address/email/phone/login account name, 2=UID (only for whitelisted users; applicable only when dest=3). - Allowed values: `1`, `2` - `chain` (string, optional) — Chain name, e.g. USDT-ERC20, USDT-TRC20. If not set, the default chain of the currency is used. - `areaCode` (string, optional) — Area code for the phone number, required when toAddr is a phone number. - `clientId` (string, optional) — Client-supplied ID. A combination of case-sensitive alphanumerics, up to 32 characters. - `rcvrInfo` (ApiV5AssetWithdrawalPostRequestBodyContentApplicationJsonSchemaRcvrInfo, optional) — Recipient information, required for some entity users doing on-chain/lightning withdrawals. ## Response ### 200 Successful response - `code` (string, optional) — Result code. `0` means success; any other value is an error code. - `msg` (string, optional) — Error message. Empty on success. - `data` (list of ApiV5AssetWithdrawalPostResponsesContentApplicationJsonSchemaDataItems, optional) ## Types ### ApiV5AssetWithdrawalPostRequestBodyContentApplicationJsonSchemaRcvrInfo Recipient information, required for some entity users doing on-chain/lightning withdrawals. - `walletType` (enum, optional) — Wallet type: exchange=exchange wallet, private=private wallet. - Allowed values: `exchange`, `private` - `exchId` (string, optional) — Exchange ID (required if walletType=exchange). Use 0 if the exchange is not in the list. - `rcvrFirstName` (string, optional) — Receiver's first name (required if walletType=exchange). - `rcvrLastName` (string, optional) — Receiver's last name (required if walletType=exchange). - `rcvrCountry` (string, optional) — Recipient's country - English name or ISO 3166-1 two-letter code. - `rcvrCountrySubDivision` (string, optional) — State/Province of the recipient. - `rcvrTownName` (string, optional) — Town/city where the recipient is located. - `rcvrStreetName` (string, optional) — Recipient's street address. ### ApiV5AssetWithdrawalPostResponsesContentApplicationJsonSchemaDataItems - `ccy` (string, optional) — Currency. - `chain` (string, optional) — Chain name, e.g. USDT-ERC20. - `amt` (string, optional) — Withdrawal amount. - `wdId` (string, optional) — Withdrawal ID. - `clientId` (string, optional) — Client-supplied ID. ## Examples **Request** ```json { "ccy": "USDT", "amt": "10", "dest": "4", "toAddr": "TEY8dvR7ejK64gCWmM6y6BqdX2SBM7fzZb" } ``` **Response** ```json { "code": "0", "msg": "", "data": [ { "ccy": "BTC", "chain": "BTC-Bitcoin", "amt": "0.1", "wdId": "67485", "clientId": "" } ] } ``` **SDK Code** ```python funding_withdrawal_example import requests url = "https://www.okx.com/api/v5/asset/withdrawal" payload = { "ccy": "USDT", "amt": "10", "dest": "4", "toAddr": "TEY8dvR7ejK64gCWmM6y6BqdX2SBM7fzZb" } headers = { "OK-ACCESS-KEY": "", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript funding_withdrawal_example const url = 'https://www.okx.com/api/v5/asset/withdrawal'; const options = { method: 'POST', headers: {'OK-ACCESS-KEY': '', 'Content-Type': 'application/json'}, body: '{"ccy":"USDT","amt":"10","dest":"4","toAddr":"TEY8dvR7ejK64gCWmM6y6BqdX2SBM7fzZb"}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go funding_withdrawal_example package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://www.okx.com/api/v5/asset/withdrawal" payload := strings.NewReader("{\n \"ccy\": \"USDT\",\n \"amt\": \"10\",\n \"dest\": \"4\",\n \"toAddr\": \"TEY8dvR7ejK64gCWmM6y6BqdX2SBM7fzZb\"\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("OK-ACCESS-KEY", "") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby funding_withdrawal_example require 'uri' require 'net/http' url = URI("https://www.okx.com/api/v5/asset/withdrawal") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["OK-ACCESS-KEY"] = '' request["Content-Type"] = 'application/json' request.body = "{\n \"ccy\": \"USDT\",\n \"amt\": \"10\",\n \"dest\": \"4\",\n \"toAddr\": \"TEY8dvR7ejK64gCWmM6y6BqdX2SBM7fzZb\"\n}" response = http.request(request) puts response.read_body ``` ```java funding_withdrawal_example import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://www.okx.com/api/v5/asset/withdrawal") .header("OK-ACCESS-KEY", "") .header("Content-Type", "application/json") .body("{\n \"ccy\": \"USDT\",\n \"amt\": \"10\",\n \"dest\": \"4\",\n \"toAddr\": \"TEY8dvR7ejK64gCWmM6y6BqdX2SBM7fzZb\"\n}") .asString(); ``` ```php funding_withdrawal_example request('POST', 'https://www.okx.com/api/v5/asset/withdrawal', [ 'body' => '{ "ccy": "USDT", "amt": "10", "dest": "4", "toAddr": "TEY8dvR7ejK64gCWmM6y6BqdX2SBM7fzZb" }', 'headers' => [ 'Content-Type' => 'application/json', 'OK-ACCESS-KEY' => '', ], ]); echo $response->getBody(); ``` ```csharp funding_withdrawal_example using RestSharp; var client = new RestClient("https://www.okx.com/api/v5/asset/withdrawal"); var request = new RestRequest(Method.POST); request.AddHeader("OK-ACCESS-KEY", ""); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"ccy\": \"USDT\",\n \"amt\": \"10\",\n \"dest\": \"4\",\n \"toAddr\": \"TEY8dvR7ejK64gCWmM6y6BqdX2SBM7fzZb\"\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift funding_withdrawal_example import Foundation let headers = [ "OK-ACCESS-KEY": "", "Content-Type": "application/json" ] let parameters = [ "ccy": "USDT", "amt": "10", "dest": "4", "toAddr": "TEY8dvR7ejK64gCWmM6y6BqdX2SBM7fzZb" ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://www.okx.com/api/v5/asset/withdrawal")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```