> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://okx-demo.ferndocs.com/api/api-reference/convert/estimate-quote/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://okx-demo.ferndocs.com/_mcp/server. # Estimate quote POST https://www.okx.com/api/v5/asset/convert/estimate-quote Content-Type: application/json Request a firm quote for a convert trade. The returned quoteId is valid for a short window and can be used to execute the trade. Reference: https://okx-demo.ferndocs.com/api/api-reference/convert/estimate-quote ## 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. - `baseCcy` (string, required) — Base currency, e.g. BTC in BTC-USDT. - `quoteCcy` (string, required) — Quote currency, e.g. USDT in BTC-USDT. - `side` (enum, required) — Trade side based on the base currency. buy: buy base currency; sell: sell base currency. - Allowed values: `buy`, `sell` - `rfqSz` (string, required) — RFQ amount. - `rfqSzCcy` (string, required) — RFQ currency, must be either the base or quote currency. - `clQReqId` (string, optional) — Client-supplied order ID for the quote request. A combination of case-sensitive alphanumerics, all numbers, or all letters of up to 32 characters. - `tag` (string, optional) — Order tag. A combination of case-sensitive alphanumerics, all numbers, or all letters of up to 16 characters. - `convertMode` (enum, optional) — Convert mode. 0: standard convert (default); 1: large order convert for VIP. - Allowed values: `0`, `1` ## 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 ApiV5AssetConvertEstimateQuotePostResponsesContentApplicationJsonSchemaDataItems, optional) ## Types ### ApiV5AssetConvertEstimateQuotePostResponsesContentApplicationJsonSchemaDataItems - `quoteTime` (string, optional) — Quote generation time, Unix timestamp in milliseconds. - `ttlMs` (string, optional) — Time to live of the quote, in milliseconds. The quote will be invalid after this duration. - `clQReqId` (string, optional) — Client-supplied order ID echoed from the request. - `quoteId` (string, optional) — Quote ID used to execute the convert trade. - `baseCcy` (string, optional) — Base currency, e.g. BTC in BTC-USDT. - `quoteCcy` (string, optional) — Quote currency, e.g. USDT in BTC-USDT. - `side` (string, optional) — Trade side based on the base currency. - `origRfqSz` (string, optional) — Original RFQ amount from the request. - `rfqSz` (string, optional) — Real RFQ amount. - `rfqSzCcy` (string, optional) — RFQ currency. - `cnvtPx` (string, optional) — Convert price based on the quote currency. - `baseSz` (string, optional) — Convert amount of the base currency. - `quoteSz` (string, optional) — Convert amount of the quote currency. ## Examples **Request** ```json { "baseCcy": "BTC", "quoteCcy": "USDT", "side": "buy", "rfqSz": "30", "rfqSzCcy": "USDT" } ``` **Response** ```json { "code": "0", "msg": "", "data": [ { "quoteTime": "1646188510461", "ttlMs": "10000", "clQReqId": "", "quoteId": "quoterETH-USDT16461885104612381", "baseCcy": "ETH", "quoteCcy": "USDT", "side": "buy", "origRfqSz": "30", "rfqSz": "30", "rfqSzCcy": "USDT", "cnvtPx": "2932.40104429", "baseSz": "0.01023052", "quoteSz": "30" } ] } ``` **SDK Code** ```python convert_estimateQuote_example import requests url = "https://www.okx.com/api/v5/asset/convert/estimate-quote" payload = { "baseCcy": "BTC", "quoteCcy": "USDT", "side": "buy", "rfqSz": "30", "rfqSzCcy": "USDT" } headers = { "OK-ACCESS-KEY": "", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript convert_estimateQuote_example const url = 'https://www.okx.com/api/v5/asset/convert/estimate-quote'; const options = { method: 'POST', headers: {'OK-ACCESS-KEY': '', 'Content-Type': 'application/json'}, body: '{"baseCcy":"BTC","quoteCcy":"USDT","side":"buy","rfqSz":"30","rfqSzCcy":"USDT"}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go convert_estimateQuote_example package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://www.okx.com/api/v5/asset/convert/estimate-quote" payload := strings.NewReader("{\n \"baseCcy\": \"BTC\",\n \"quoteCcy\": \"USDT\",\n \"side\": \"buy\",\n \"rfqSz\": \"30\",\n \"rfqSzCcy\": \"USDT\"\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 convert_estimateQuote_example require 'uri' require 'net/http' url = URI("https://www.okx.com/api/v5/asset/convert/estimate-quote") 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 \"baseCcy\": \"BTC\",\n \"quoteCcy\": \"USDT\",\n \"side\": \"buy\",\n \"rfqSz\": \"30\",\n \"rfqSzCcy\": \"USDT\"\n}" response = http.request(request) puts response.read_body ``` ```java convert_estimateQuote_example import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://www.okx.com/api/v5/asset/convert/estimate-quote") .header("OK-ACCESS-KEY", "") .header("Content-Type", "application/json") .body("{\n \"baseCcy\": \"BTC\",\n \"quoteCcy\": \"USDT\",\n \"side\": \"buy\",\n \"rfqSz\": \"30\",\n \"rfqSzCcy\": \"USDT\"\n}") .asString(); ``` ```php convert_estimateQuote_example request('POST', 'https://www.okx.com/api/v5/asset/convert/estimate-quote', [ 'body' => '{ "baseCcy": "BTC", "quoteCcy": "USDT", "side": "buy", "rfqSz": "30", "rfqSzCcy": "USDT" }', 'headers' => [ 'Content-Type' => 'application/json', 'OK-ACCESS-KEY' => '', ], ]); echo $response->getBody(); ``` ```csharp convert_estimateQuote_example using RestSharp; var client = new RestClient("https://www.okx.com/api/v5/asset/convert/estimate-quote"); var request = new RestRequest(Method.POST); request.AddHeader("OK-ACCESS-KEY", ""); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"baseCcy\": \"BTC\",\n \"quoteCcy\": \"USDT\",\n \"side\": \"buy\",\n \"rfqSz\": \"30\",\n \"rfqSzCcy\": \"USDT\"\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift convert_estimateQuote_example import Foundation let headers = [ "OK-ACCESS-KEY": "", "Content-Type": "application/json" ] let parameters = [ "baseCcy": "BTC", "quoteCcy": "USDT", "side": "buy", "rfqSz": "30", "rfqSzCcy": "USDT" ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://www.okx.com/api/v5/asset/convert/estimate-quote")! 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() ```