> For the complete documentation index, see [llms.txt](https://docs.deltadefi.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.deltadefi.io/start-trading/developers/getting-started/withdraw-funds.md). # Withdraw funds {% stepper %} {% step %} ### Build withdrawal transaction Please note only free balances are able to withdraw from the current hydra cycle. [Deposit funds](/start-trading/developers/getting-started/deposit-funds.md#free-and-locked-balances) For in-depth API details [Build withdrawal transaction](/start-trading/developers/api-documentation/account/build-withdrawal-transaction.md) In the following example we're withdrawing 10 Ada, equivalent to 10\_000\_000 lovelace. {% tabs %} {% tab title="curl" %} ```sh curl --location 'https://api-staging.deltadefi.io/accounts/withdrawal/build' \ --header 'x-api-key: ' \ --header 'Content-Type: application/json' \ --data '{ "withdrawal_amount": [ { "unit": "lovelace", "quantity": "1000000" }, ] }' ``` {% endtab %} {% tab title="NodeJs (axios)" %} ```javascript const axios = require('axios'); let data = JSON.stringify({ "withdrawal_amount": [ { "unit": "lovelace", "quantity": "1000000" }, ] }); let config = { method: 'post', maxBodyLength: Infinity, url: 'https://api-staging.deltadefi.io/accounts/withdrawal/build', headers: { 'x-api-key': '', 'Content-Type': 'application/json' }, data : data }; axios.request(config) .then((response) => { console.log(JSON.stringify(response.data)); }) .catch((error) => { console.log(error); }); ``` {% endtab %} {% tab title="Go" %} ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api-staging.deltadefi.io/accounts/withdrawal/build" method := "POST" payload := strings.NewReader(`{ "withdrawal_amount": [ { "unit": "lovelace", "quantity": "10000000" }, ] }`) client := &http.Client { } req, err := http.NewRequest(method, url, payload) if err != nil { fmt.Println(err) return } req.Header.Add("x-api-key", "") req.Header.Add("Content-Type", "application/json") res, err := client.Do(req) if err != nil { fmt.Println(err) return } defer res.Body.Close() body, err := io.ReadAll(res.Body) if err != nil { fmt.Println(err) return } fmt.Println(string(body)) } ``` {% endtab %} {% endtabs %} {% endstep %} {% step %} ### Submit withdrawal transaction With the returned `tx_hex` from step 1, you will need to [sign it](/faq/cardano.md#how-can-i-sign-a-cardano-transaction) before submitting it. For in-depth API details [Submit withdrawal transaction](/start-trading/developers/api-documentation/account/submit-withdrawal-transaction.md) {% tabs %} {% tab title="curl" %} ```sh curl --location 'https://api-staging.deltadefi.io/accounts/withdrawal/submit' \ --header 'X-API-KEY: ' \ --header 'Content-Type: application/json' \ --data '{ "signed_tx": "" }' ``` {% endtab %} {% tab title="NodeJs (axios)" %} ```javascript const axios = require('axios'); let data = JSON.stringify({ "signed_tx": "" }); let config = { method: 'post', maxBodyLength: Infinity, url: 'https://api-staging.deltadefi.io/accounts/withdrawal/submit', headers: { 'X-API-KEY': '', 'Content-Type': 'application/json' }, data : data }; axios.request(config) .then((response) => { console.log(JSON.stringify(response.data)); }) .catch((error) => { console.log(error); }); ``` {% endtab %} {% tab title="Go" %} ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api-staging.deltadefi.io/accounts/withdrawal/submit" method := "POST" payload := strings.NewReader(`{ "signed_tx": "" }`) client := &http.Client { } req, err := http.NewRequest(method, url, payload) if err != nil { fmt.Println(err) return } req.Header.Add("X-API-KEY", "") req.Header.Add("Content-Type", "application/json") res, err := client.Do(req) if err != nil { fmt.Println(err) return } defer res.Body.Close() body, err := io.ReadAll(res.Body) if err != nil { fmt.Println(err) return } fmt.Println(string(body)) } ``` {% endtab %} {% endtabs %} *** ### :white\_check\_mark: Verifying withdrawal After you have made a successful withdrawal request, you can check your latest account balance via the [Account Balances](/start-trading/developers/api-documentation/account/balances.md) API. {% tabs %} {% tab title="curl" %} ```sh curl --location 'https://api-staging.deltadefi.io/accounts/balance' \ --header 'X-API-KEY: ' ``` {% endtab %} {% tab title="NodeJs" %} ```javascript const axios = require('axios'); let config = { method: 'get', maxBodyLength: Infinity, url: 'https://api-staging.deltadefi.io/accounts/balance', headers: { 'X-API-KEY': '' } }; axios.request(config) .then((response) => { console.log(JSON.stringify(response.data)); }) .catch((error) => { console.log(error); }); ``` {% endtab %} {% tab title="Go" %} ```go package main import ( "fmt" "net/http" "io" ) func main() { url := "https://api-staging.deltadefi.io/accounts/balance" method := "GET" client := &http.Client { } req, err := http.NewRequest(method, url, nil) if err != nil { fmt.Println(err) return } req.Header.Add("X-API-KEY", "") res, err := client.Do(req) if err != nil { fmt.Println(err) return } defer res.Body.Close() body, err := io.ReadAll(res.Body) if err != nil { fmt.Println(err) return } fmt.Println(string(body)) } ``` {% endtab %} {% endtabs %} {% hint style="info" %} Your requested withdrawal amount will be converted from `Free` will to `Locked` , and will be distributed during the next hydra closed. {% endhint %} Your Response should look something like below: ```json [ { "asset": "ada", "asset_unit": "", "free": 0, "locked": 100 } ] ``` {% endstep %} {% endstepper %} *** ### Related FAQ * [What is the minimum amount of deposit and withdrawal?](/faq/product.md#the-minimum-deposit-amount) * [How long does it take to deposit & withdraw?](/faq/product.md#how-long-does-it-take-to-deposit-and-withdrawal) * [What are locked and free balances?](/faq/product.md#what-are-locked-and-free-balances) * [How can I sign a Cardano transaction?](/faq/cardano.md#how-can-i-sign-a-cardano-transaction) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.deltadefi.io/start-trading/developers/getting-started/withdraw-funds.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.