# Contract

## Public

{% hint style="info" %}
Security: None

Endpoints under **Public** section can be accessed freely without requiring any API-key or signatures
{% endhint %}

### 1) Test Connectivity

This endpoint checks connectivity to the host

URL: <https://futuresopenapi.koinbay.com/fapi/v1/ping>

Method: Get

Parameters: No

Success Response:&#x20;

```
{}
```

### 2) Check Server Time

URL: <https://futuresopenapi.koinbay.com/fapi/v1/time>

Method: Get

Parameters: No

Success Response:{

```
{
   "serverTime":1607702400000,
    "timezone":Chinese standard time
}
```

<table><thead><tr><th width="150">name</th><th>type</th><th>example</th><th>description</th></tr></thead><tbody><tr><td>serverTime</td><td>  long</td><td>1607702400000</td><td>server timestamp</td></tr><tr><td>timezone</td><td>string</td><td>China standard time</td><td> server time zone</td></tr></tbody></table>

### 3) Operation Summary

URL: <https://futuresopenapi.koinbay.com/fapi/v1/contracts>

Method: Get

Parameters: No

Success Response:

```
[
    {
        "symbol": "H-HT-USDT",
        "pricePrecision": 8,
        "side": 1,
        "maxMarketVolume": 100000,
        "multiplier": 6,
        "minOrderVolume": 1,
        "maxMarketMoney": 10000000,
        "type": "H",
        "maxLimitVolume": 1000000,
        "maxValidOrder": 20,
        "multiplierCoin": "HT",
        "minOrderMoney": 0.001,
        "maxLimitMoney": 1000000,
        "status": 1
    }
]
```

| Parametera      | Value Format | Sample response | Description                                                                       |
| --------------- | ------------ | --------------- | --------------------------------------------------------------------------------- |
| symbol          | number       | `E-BTC-USDT`    | Contract Name                                                                     |
| status          | string       | 1               | status（0：cannot trade，1：can trade                                                 |
| type            | number       | S               | contract type, E: perpetual contract, S: test contract, others are mixed contract |
| side            | number       | 1               | Contract direction(backwards：0，1：forward)                                         |
| multiplier      | string       | 0.5             | Contract face value                                                               |
| multiplierCoin  | number       | BTC             | Contract face value unit                                                          |
| pricePrecision  | number       | 4               | Precision of the price                                                            |
| minOrderMoney   | number       | 10              | Minimum order volume                                                              |
| minOrderVolume  | number       | 10              | Minimum order value                                                               |
| maxMarketVolume | number       | 100000          | Market price order maximum volume                                                 |
| maxMarketMoney  | number       | 100000          | Market price order maximum value                                                  |
| macLimitVolume  | number       | 100000          | Limit price order maximum volume                                                  |
| maxValidOrder   | number       | 100000          | Maximum valid order quantity                                                      |

## Market

{% hint style="info" %}
Security: None​

Market section can be accessed freely without requiring any API-key or signatures.
{% endhint %}

### 1) Depth

Market Depth Data

URL: <https://futuresopenapi.koinbay.com/fapi/v1/depth>

Parameters

Query

| Query         | Value Format | Value Format                  | Required/Optional |
| ------------- | ------------ | ----------------------------- | ----------------- |
| Limit         | Integer      | Default 100, Max 100          | Required          |
| Contract Name | String       | Contract Name E.g. E-BTC-USDT | Required          |

Success Response:

```json
{
  "bids": [
    [
      "3.90000000",   // price
      "431.00000000"  // quantity
    ],
    [
      "4.00000000",
      "431.00000000"
    ]
  ],
  "asks": [
    [
      "4.00000200",  // price
      "12.00000000"  // quantity
    ],
    [
      "5.10000000",
      "28.00000000"
    ]
  ]
}
```

<table><thead><tr><th>name</th><th width="150">type</th><th>example</th><th>description</th></tr></thead><tbody><tr><td>time</td><td>long</td><td>1595563624731</td><td>Current Timestamp  (ms)</td></tr><tr><td>bids</td><td>list</td><td>Look below</td><td>Order book purchase info</td></tr><tr><td>asks</td><td>list</td><td>Look below</td><td>Order book selling info</td></tr></tbody></table>

The fields bids and asks are lists of order book price level entries, sorted from best to worst.

| name | type  | example | description                               |
| ---- | ----- | ------- | ----------------------------------------- |
| ' '  | float | 131.1   | price level                               |
| ' '  | float | 2.3     | Total order quantity for this price level |

### 2) 24 hours ticker

24 hr price change statistics

URL: <https://futuresopenapi.koinbay.com/fapi/v1/ticker>

Method: Get

Parameters:

| Query         | Value Format | Value Format                   | Required/Optional |
| ------------- | ------------ | ------------------------------ | ----------------- |
| contract name | string       | Contract  name E.g. E-BTC-USDT | Optional          |

Success Response of obtaining ticker info:

<pre class="language-json"><code class="lang-json">{
<strong>    "high": "9279.0301",
</strong>    "vol": "1302",
    "last": "9200",
    "low": "9279.0301",
    "rose": "0",
    "time": 1595563624731
}
</code></pre>

| name | type   | example         | description     |
| ---- | ------ | --------------- | --------------- |
| time | long   | `1595563624731` | Open time       |
| high | float  | 9900            | Higher price    |
| low  | float  | 8800.34         | Lower price     |
| last | float  | 8900            | Newest price    |
| vol  | float  | 4999            | Trade volume    |
| rose | string | +0.5            | Price variation |

### 3) Get index/marked price

URL:  <https://futuresopenapi.koinbay.com/fapi/v1/index>

Method: Get

Parameters

| Query        | Value  format | Value format                  | Required/Optional |
| ------------ | ------------- | ----------------------------- | ----------------- |
| Contact Name | string        | Contract name E.g. E-BTC-USDT | Optional          |
| Limit        | string        | Default 100, Max 100          | Optional          |

Success Responses:

```json
{
    "markPrice": 581.5,
    "indexPrice": 646.3933333333333,
    "lastFundingRate": 0.001,
    "contractName": "E-ETH-USDT",
    "time": 1608273554063
}
```

##

## Trading

{% hint style="warning" %}
Publishing Soon
{% endhint %}

## Account&#x20;

{% hint style="warning" %}
Publishing Soon
{% endhint %}


---

# Agent Instructions: 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:

```
GET https://docs.koinbay.com/api/contract.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.