OpenOcean CEX API

Instruction of OpenOcean CEX API for Centralized users

1. Preparation

Before you use API, you need to login the website to create API Key with proper permissions.

Please remember below information after creation:

  • AccessKey It is used in API request

  • SecretKey It is used to generate the signature (only visible once after creation)

2. Authentication instruction

The API request may be tampered during internet, therefore all private API must be signed by your API Key (Secrete Key).

Each API Key has permission property, please check the API permission, and make sure your API key has proper permission.

A valid request consists of below parts:

  • API Path: open-api.openocean.finance/exchange/spot/open/v1/createOrder

  • API Access Key: The 'AccessKey' in your API Key

  • Signature Method: The Hash method that is used to sign, it uses HmacSHA256

  • Signature Version: The version for the signature protocol, it uses 2

  • Timestamp: The UTC time when the request is sent, e.g. 2017-05-11T16:22:06. It is useful to prevent the request to be intercepted by third-party.

  • Parameters: Each API Method has a group of parameters, you can refer to detailed document for each of them.

    • For GET request, all the parameters must be signed.

    • For POST request, the parameters needn't be signed and they should be put in request body.

  • Signature: The value after signed, it is guarantee the signature is valid and the request is not be tempered.

example:

https://open-api.openocean.finance/exchange/spot/open/v1/createOrder?
AccessKeyId=e2xxxxxx-99xxxxxx-84xxxxxx-7xxxx
&SignatureMethod=HmacSHA256
&SignatureVersion=2
&Timestamp=2017-05-11T15%3A19%3A30
&order-id=1234567890
&Signature=calculated value

3. Signature method

The signature may be different if the request text is different, therefore the request should be normalized before signing.

Below signing steps take the order query as an example:

https://open-api.openocean.finance/exchange/spot/open/v1/createOrder?
AccessKeyId=e2xxxxxx-99xxxxxx-84xxxxxx-7xxxx
&SignatureMethod=HmacSHA256
&SignatureVersion=2
&Timestamp=2017-05-11T15:19:30
&order-id=1234567890

The request Method (GET or POST, WebSocket use GET), append line break "\n"

GET \n

The host with lower case, append line break "\n"

open-api.openocean.finance \n

The path, append line break "\n"

/exchange/spot/open/v1/createOrder \n

The parameters are URL encoded, and ordered based on ASCII

For example below is the original parameters:

  AccessKeyId=e2xxxxxx-99xxxxxx-84xxxxxx-7xxxx  
  order-id=1234567890  
  SignatureMethod=HmacSHA256  
  SignatureVersion=2  
  Timestamp=2017-05-11T15%3A19%3A30

Then above parameter should be ordered like below:

  AccessKeyId=e2xxxxxx-99xxxxxx-84xxxxxx-7xxxx  
  SignatureMethod=HmacSHA256  
  SignatureVersion=2  
  Timestamp=2017-05-11T15%3A19%3A30  
  order-id=1234567890

Use char "&" to concatenate all parameters

  AccessKeyId=e2xxxxxx-99xxxxxx-84xxxxxx-7xxxx
  &SignatureMethod=HmacSHA256
  &SignatureVersion=2
  &Timestamp=2017-05-11T15%3A19%3A30&order-id=1234567890

Assemble the pre-signed text

  GET\n  open-api.openocean.finance\n  
  /exchange/spot/open/v1/createOrder\n  
  AccessKeyId=e2xxxxxx-99xxxxxx-84xxxxxx-7xxxx
  &SignatureMethod=HmacSHA256&SignatureVersion=2
  &Timestamp=2017-05-11T15%3A19%3A30
  &order-id=1234567890

Use the pre-signed text and your Secret Key to generate a signature

Use the pre-signed text in step 6 and your API Secret Key to generate hash code by HmacSHA256 hash function.

  b0xxxxxx-c6xxxxxx-94xxxxxx-dxxxx

Encode the hash code with base-64 to generate the signature.

  4F65x5A2bLyMWVQj3Aqp+B4w+ivaA7n5Oi2SuYtCJ9o=

Put the signature into request URL

For Rest interface:

  • Put all the parameters in the URL

  • Encode signature by URL encoding and append in the URL with parameter name "Signature".

Finally, the request sent to API should be:

  https://open-api.openocean.finance/exchange/spot/open/v1/createOrder?
  AccessKeyId=e2xxxxxx-99xxxxxx-84xxxxxx-7xxxx
  &order-id=1234567890
  &SignatureMethod=HmacSHA256
  &SignatureVersion=2
  &Timestamp=2017-05-11T15%3A19%3A30
  &Signature=4F65x5A2bLyMWVQj3Aqp%2BB4w%2BivaA7n5Oi2SuYtCJ9o%3D

4. API docs

1. Create order

Request:

  • Method: POST

  • URL:/exchange/spot/open/v1/createOrder

  • Parameter:

{
    "exchangeCode": "binance", 
    "pairCode": "BNB/BUSD", 
    "direction": "0", 
    "orderType": "1", 
    "price": "10", 
    "volume": "10"
}
  • Response:

{
    "code": 0, 
    "msg": "Correct response", 
    "ts": 1608715168529, 
    "data": null, 
    "error": false
}

2. Cancel order

Request:

  • Method: POST

  • URL:/exchange/spot/open/v1/cancelOrder

  • Parameter:

{
    "localOrderId": "1"
}
  • Response:

{
    "code": 0, 
    "msg": "Correct response", 
    "ts": 1608715168529, 
    "data": null, 
    "error": false
}

3. List funds

Request:

  • Method: GET

  • URL:/exchange/spot/open/v1/listFunds

  • Parameter:

Response:

{
    "code": 0, 
    "msg": "Correct response", 
    "ts": 1608715168529, 
    "data": [
        {
            "coinType": "BNB", 
            "available": 390.7, 
            "forzen": 0
        }
    ], 
    "error": false
}

4. List current order

Request:

  • Method: GET

  • URL:/exchange/spot/open/v1/listCurrentOrder

  • Parameter:

Response:

{
    "code": 0, 
    "msg": "Correct response", 
    "ts": 1608715168529, 
    "data": {
        "pageInfo": {
            "total": 2, 
            "page": 1
        }, 
        "result": [
            {
                "localOrderId": "1774y3812418", 
                "exchangeSymbol": "Binance", 
                "pairCode": "BAKE/BNB", 
                "orderType": "Limit", 
                "direction": "Buy", 
                "orderStatus": "Canceled", 
                "orderPrice": "0.000357", 
                "orderVolume": "350.000000", 
                "tradePrice": "0.000000", 
                ja"tradeVolume": "0.000000", 
                "tradeAmount": "0.000000", 
                "fee": "0.000000", 
                "orderTime": 1611755902000
            }
        ]
    }, 
    "error": false
}

5. List history order

Request:

  • Method: GET

  • URL:/exchange/spot/open/v1/listHistoryOrder

  • Parameter:

  • Response

{
    "code": 0, 
    "msg": "Correct response", 
    "ts": 1608715168529, 
    "data": {
        "pageInfo": {
            "total": 2, 
            "page": 1
        }, 
        "result": [
            {
                "localOrderId": "1774y3812418", 
                "exchangeSymbol": "Binance", 
                "pairCode": "BAKE/BNB", 
                "orderType": "Limit", 
                "direction": "Buy", 
                "orderStatus": "Canceled", 
                "orderPrice": "0.000357", 
                "orderVolume": "350.000000", 
                "tradePrice": "0.000000", 
                "tradeVolume": "0.000000", 
                "tradeAmount": "0.000000", 
                "fee": "0.000000", 
                "orderTime": 1611755902000
            }
        ]
    }, 
    "error": false
}

Last updated