# Margin Trade

### Trade

### Security Type: [TRADE](https://help.zke.com/api_en/broken-reference)

Endpoints under Trade require an API-key and a signature.​

##  New Order

<mark style="color:green;">`POST`</mark> `https://openapi.zke.com/sapi/v1/margin/order`

&#x20;**Rate Limit：100times/2s**

#### Headers

| Name        | Type   | Description  |
| ----------- | ------ | ------------ |
| X-CH-SIGN   | String | Sign         |
| X-CH-TS     | String | timestamp    |
| X-CH-APIKEY | String | Your API-key |

#### Request Body

| Name             | Type   | Description                                                                          |
| ---------------- | ------ | ------------------------------------------------------------------------------------ |
| type             | String | Type of the order, `LIMIT/MARKET`                                                    |
| recwwindow       | String | Time window                                                                          |
| price            | number | Order price, REQUIRED for LIMIT orders                                               |
| newClientOrderId | String | Unique order ID generated by users to mark their orders, Cannot exceed 32 characters |
| side             | String | Side of the order, `BUY/SELL`                                                        |
| volume           | number | Order vol. For MARKET BUY orders, vol=amount.                                        |
| symbol           | String | Symbol Name. E.g. `BTCUSDT`                                                          |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    'symbol': 'LXTUSDT', 
    'orderId': '494736827050147840', 
    'clientOrderId': '157371322565051',
    'transactTime': '1573713225668', 
    'price': '0.005452', 
    'origQty': '110', 
    'executedQty': '0', 
    'status': 'NEW',
    'type': 'LIMIT', 
    'side': 'SELL'
}
```

{% endtab %}
{% endtabs %}

**weight(IP/UID): 5**

## &#x20;Query Order

<mark style="color:blue;">`GET`</mark> `https://openapi.zke.com/sapi/v1/margin/order`

**Rate Limit: 20times/2s**

#### Query Parameters

| Name             | Type   | Description                                                                                      |
| ---------------- | ------ | ------------------------------------------------------------------------------------------------ |
| orderId          | String | Order ID                                                                                         |
| newClientOrderId | String | Client Order Id, Unique order ID generated by users to mark their orders. E.g. 354444heihieddada |
| symbol           | String | Symbol Name.E.g. `BTCUSDT`Header                                                                 |

#### Headers

| Name        | Type   | Description  |
| ----------- | ------ | ------------ |
| X-CH-SIGN   | String | Sign         |
| X-CH-TS     | String | timestamp    |
| X-CH-APIKEY | String | Your API-key |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    'orderId': '499890200602846976', 
    'clientOrderId': '157432755564968', 
    'symbol': 'BHTUSDT', 
    'price': '0.01', 
    'origQty': '50', 
    'executedQty': '0', 
    'avgPrice': '0', 
    'status': 'NEW', 
    'type': 'LIMIT', 
    'side': 'BUY', 
    'transactTime': '1574327555669'
}
```

{% endtab %}
{% endtabs %}

**weight(IP/UID): 5**

## &#x20;Cancel Order

<mark style="color:green;">`POST`</mark> `https://openapi.zke.com/sapi/v1/margin/cancel`

**Rate Limit: 100times/2s**

#### Headers

| Name        | Type   | Description  |
| ----------- | ------ | ------------ |
| X-CH-SIGN   | String | Sign         |
| X-CH-TS     | String | timestamp    |
| X-CH-APIKEY | String | Your API-key |

#### Request Body

| Name             | Type   | Description                                                                                      |
| ---------------- | ------ | ------------------------------------------------------------------------------------------------ |
| newClientOrderId | String | Symbol Name. E.g. `BTCUSDT`Responses200GET                                                       |
| symbol           | String | Client Order Id, Unique order ID generated by users to mark their orders. E.g. 354444heihieddada |
| orderId          | String | Order ID                                                                                         |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    'symbol': 'BHTUSDT', 
    'clientOrderId': '0', 
    'orderId': '499890200602846976', 
    'status': 'CANCELED'
}
```

{% endtab %}
{% endtabs %}

**weight(IP/UID): 5**

## &#x20;Current Open Orders

<mark style="color:blue;">`GET`</mark> `https://openapi.zke.com/sapi/v1/margin/openOrders`

**Rate Limit: 20times/2s**

#### Query Parameters

| Name   | Type   | Description                 |
| ------ | ------ | --------------------------- |
| symbol | String | Symbol Name. E.g. `BTCUSDT` |
| limit  | String | Default 100; Max 1000       |

#### Headers

| Name        | Type   | Description  |
| ----------- | ------ | ------------ |
| X-CH-SIGN   | String | Sign         |
| X-CH-TS     | String | timestamp    |
| X-CH-APIKEY | String | Your API-key |

{% tabs %}
{% tab title="200: OK " %}

```javascript
[
    {
        'orderId': '499902955766523648', 
        'symbol': 'BHTUSDT', 
        'price': '0.01', 
        'origQty': '50', 
        'executedQty': '0', 
        'avgPrice': '0', 
        'status': 'NEW', 
        'type': 'LIMIT', 
        'side': 'BUY', 
        'time': '1574329076202'
        },...
]
```

{% endtab %}
{% endtabs %}

**weight(IP/UID): 1**

## Trades

<mark style="color:blue;">`GET`</mark> `https://openapi.zke.com/sapi/v1/margin/myTrades`

#### Query Parameters

| Name   | Type   | Description                 |
| ------ | ------ | --------------------------- |
| symbol | String | Symbol Name. E.g. `BTCUSDT` |
| limit  | String | Default 100; Max 1000       |
| fromId | String | Trade Id to fetch from      |

#### Headers

| Name        | Type   | Description  |
| ----------- | ------ | ------------ |
| X-CH-SIGN   | String | Sign         |
| X-CH-TS     | String | timestamp    |
| X-CH-APIKEY | String | Your API-key |

{% tabs %}
{% tab title="200: OK " %}

```javascript
[
  {
    "symbol": "ETHBTC",
    "id": 100211,
    "bidId": 150695552109032492,
    "askId": 150695552109032493,
    "price": "4.00000100",
    "qty": "12.00000000",
    "time": 1499865549590,
    "isBuyer": true,
    "isMaker": false,
    "feeCoin": "ETH",
    "fee":"0.001"
  },...
]
```

{% endtab %}
{% endtabs %}

**weight(IP/UID): 1**