> ## Documentation Index
> Fetch the complete documentation index at: https://developers.oceanxz-au.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Official SDK

### Example of Signature

```java theme={null}
/**
 * Generate sign
 **/
private String toSign(String timestamp, String method, String requestPath,
                             String queryString, String body, String secretKey) throws Exception {
    // 签名串
    String preHash = preHash(timestamp, method, requestPath, queryString, body);
    byte[] secretKeyBytes = secretKey.getBytes("UTF-8");
    SecretKeySpec secretKeySpec = new SecretKeySpec(secretKeyBytes, "HmacSHA256");
    Mac mac = (Mac) MAC.clone();
    mac.init(secretKeySpec);
    return Hex.encodeHexString(mac.doFinal(preHash.getBytes("UTF-8")));
}

/**
 * signature string
 **/
private String preHash(String timestamp, String method, String requestPath, String queryString, String body) {

    StringBuilder preHash = new StringBuilder();
    preHash.append(timestamp);
    preHash.append(method.toUpperCase());
    preHash.append(requestPath);
    if (org.apache.commons.lang3.StringUtils.isNotEmpty(queryString)) {
        preHash.append("?").append(queryString);
    }
    if (org.apache.commons.lang3.StringUtils.isNotEmpty(body)) {
        preHash.append(body);
    }
    return preHash.toString();
}

/**
 * queryString
 **/
private String queryString(ServerHttpRequest request) {
    String url = request.getURI().toString();
    String queryString = "";
    if (url.contains("?")) {
        queryString = url.substring(url.lastIndexOf("?") + 1);
    }
    return queryString;
}
```

***

### Example of how to create order

* Java

```java theme={null}
OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"symbol\":\"BTCUSDT\",\"volume\":1,\"side\":\"BUY\",\"type\":\"LIMIT\",\"price\":10000,\"newClientOrderId\":\"\",\"recvWindow\":5000}");
Request request = new Request.Builder()
  .url("https://openapi.oceanxz-au.com")
  .method("POST", body)
  .addHeader("X-CH-APIKEY", "<your-api-key>")
  .addHeader("X-CH-TS", "<your-timestamp>")
  .addHeader("Content-Type", "application/json")
  .addHeader("X-CH-SIGN", "<your-signature>")
  .build();
Response response = client.newCall(request).execute();
```

***

* Go

```go theme={null}
package main

import (
  "fmt"
  "strings"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://openapi.oceanxz-au.com"
  method := "POST"

  payload := strings.NewReader("{\"symbol\":\"BTCUSDT\",\"volume\":1,\"side\":\"BUY\",\"type\":\"LIMIT\",\"price\":10000,\"newClientOrderId\":\"\",\"recvWindow\":5000}")

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
  }
  req.Header.Add("X-CH-APIKEY", "<your-api-key>")
  req.Header.Add("X-CH-TS", "<your-timestamp>")
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("X-CH-SIGN", "<your-signature>")

  res, err := client.Do(req)
  defer res.Body.Close()
  body, err := ioutil.ReadAll(res.Body)

  fmt.Println(string(body))
}
```

***

* Python

```python theme={null}
import requests

url = "https://openapi.oceanxz-au.com"

payload = "{\"symbol\":\"BTCUSDT\",\"volume\":1,\"side\":\"BUY\",\"type\":\"LIMIT\",\"price\":10000,\"newClientOrderId\":\"\",\"recvWindow\":5000}"
headers = {
  'X-CH-APIKEY': '<your-api-key>',
  'X-CH-TS': '<your-timestamp>',
  'Content-Type': 'application/json',
  'X-CH-SIGN': '<your-signature>'
}

response = requests.request("POST", url, headers=headers, data = payload)

print(response.text.encode('utf8'))
```

***

* PHP

```php theme={null}
<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('https://openapi.oceanxz-au.com');
$request->setMethod(HTTP_Request2::METHOD_POST);
$request->setConfig(array(
  'follow_redirects' => TRUE
));
$request->setHeader(array(
  'X-CH-APIKEY' => '<your-api-key>',
  'X-CH-TS' => '<your-timestamp>',
  'Content-Type' => 'application/json',
  'X-CH-SIGN' => '<your-signature>'
));
$request->setBody('{"symbol":"BTCUSDT","volume":1,"side":"BUY","type":"LIMIT","price":10000,"newClientOrderId":"","recvWindow":5000}');
try {
  $response = $request->send();
  if ($response->getStatus() == 200) {
    echo $response->getBody();
  }
  else {
    echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
    $response->getReasonPhrase();
  }
}
catch(HTTP_Request2_Exception $e) {
  echo 'Error: ' . $e->getMessage();
}
```

***

* NodeJs

```javascript theme={null}
var request = require("request");
var options = {
  method: "POST",
  url: "https://openapi.oceanxz-au.com",
  headers: {
    "X-CH-APIKEY": "<your-api-key>",
    "X-CH-TS": "<your-timestamp>",
    "Content-Type": "application/json",
    "X-CH-SIGN": "<your-signature>",
  },
  body: JSON.stringify({
    symbol: "BTCUSDT",
    volume: 1,
    side: "BUY",
    type: "LIMIT",
    price: 10000,
    newClientOrderId: "",
    recvWindow: 5000,
  }),
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});
```