> For the complete documentation index, see [llms.txt](https://openapi-docs.nagaexchange.co.id/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://openapi-docs.nagaexchange.co.id/rest-api-futures-trading/market-data.md).

# Market Data

**Public** and **Market** endpoints on this page can be accessed freely without requiring any API-key or signatures. See [Authentication](/authentication.md) for signing details.

***

## Test Connectivity

<mark style="color:blue;">`GET`</mark> `https://futuresopenapi.nagaexchange.co.id/fapi/v1/ping`

This endpoint checks connectivity to the host.

{% tabs %}
{% tab title="200  Successfully connected" %}

```
{}
```

{% endtab %}
{% endtabs %}

***

## Check Server Time

<mark style="color:blue;">`GET`</mark> `https://futuresopenapi.nagaexchange.co.id/fapi/v1/time`

{% tabs %}
{% tab title="200 Successfully obtained server time" %}

```json
{
    "timezone": "Western Indonesia Time",
    "serverTime": 1704962055664
}
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Response:" %}

<table><thead><tr><th width="153">Parameter</th><th width="121">Type</th><th width="193">Example</th><th>Describe</th></tr></thead><tbody><tr><td>timezone</td><td>string</td><td>Western Indonesia Time</td><td>Server time zone</td></tr><tr><td>serverTime</td><td>long</td><td>1607702400000</td><td>Server timestamp</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

***

## Contracts List

<mark style="color:blue;">`GET`</mark> `https://futuresopenapi.nagaexchange.co.id/fapi/v1/contracts`

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

```json
[
    {
        "symbol": "E-ETC-USDT",
        "pricePrecision": 3,
        "side": 1,
        "maxMarketVolume": 200000,
        "multiplier": 1.0000000000000000,
        "minOrderVolume": 1,
        "maxMarketMoney": 500000.0000000000000000,
        "type": "E",
        "maxLimitVolume": 300000,
        "maxValidOrder": 10,
        "multiplierCoin": "ETC",
        "minOrderMoney": 1.0000000000000000,
        "maxLimitMoney": 500000.0000000000000000,
        "status": 1
    },
    {
        "symbol": "E-ATOM-USDT",
        "pricePrecision": 3,
        "side": 1,
        "maxMarketVolume": 100000,
        "multiplier": 1.0000000000000000,
        "minOrderVolume": 1,
        "maxMarketMoney": 200000.0000000000000000,
        "type": "E",
        "maxLimitVolume": 200000,
        "maxValidOrder": 10,
        "multiplierCoin": "ATOM",
        "minOrderMoney": 20.0000000000000000,
        "maxLimitMoney": 2000000.0000000000000000,
        "status": 1
    }
]
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Response:" %}

<table><thead><tr><th>Parameter</th><th width="136">Type</th><th width="168">Example</th><th>Describe</th></tr></thead><tbody><tr><td>symbol</td><td>string</td><td><code>E-BTC-USDT</code></td><td>Uppercase contract name</td></tr><tr><td>pricePrecision</td><td>number</td><td>4</td><td>Price accuracy</td></tr><tr><td>status</td><td>number</td><td><code>1</code></td><td>Contract status (0: not tradable, 1: tradable)</td></tr><tr><td>type</td><td>string</td><td><code>S</code></td><td>Contract type (E: Perpetual contract, S: Simulated contract, others are mixed contracts)</td></tr><tr><td>side</td><td>number</td><td><code>1</code></td><td>Contract direction (0: reverse, 1: forward)</td></tr><tr><td>multiplier</td><td>number</td><td><code>0.50</code></td><td>Contract value</td></tr><tr><td>minOrderVolume</td><td>number</td><td><code>10</code></td><td>Minimum order quantity</td></tr><tr><td>minOrderMoney</td><td>number</td><td><code>10</code></td><td>Minimum order amount</td></tr><tr><td>maxMarketVolume</td><td>number</td><td><code>100000</code></td><td>Maximum order quantity for market orders</td></tr><tr><td>maxMarketMoney</td><td>number</td><td><code>100000.00</code></td><td>Maximum order amount at market price</td></tr><tr><td>maxLimitVolume</td><td>number</td><td><code>100000</code></td><td>Maximum order quantity for limit orders</td></tr><tr><td>maxLimitMoney</td><td>number</td><td><code>100000.00</code></td><td>Maximum order amount for limit orders</td></tr><tr><td>maxValidOrder</td><td>number</td><td><code>100000</code></td><td>The maximum number of valid orders</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

***

## Depth

<mark style="color:blue;">`GET`</mark> `https://futuresopenapi.nagaexchange.co.id/fapi/v1/depth`

Market depth data.

#### Query Parameters

| Name         | Type    | Description                              |
| ------------ | ------- | ---------------------------------------- |
| limit        | integer | Default 100; Maximum 100                 |
| contractName | string  | Uppercase contract name, e.g. E-BTC-USDT |

{% tabs %}
{% tab title="200  Successfully obtain depth data" %}

```java
{
  "asks": [
    [
      "4.00000200",  // Price
      "12.00000000"  // Volume
    ],
    [
      "5.10000000",
      "28.00000000"
    ]
  ],
  "bids": [
    [
      "3.90000000",   // Price
      "431.00000000"  // Volume
    ],
    [
      "4.00000000",
      "431.00000000"
    ]
  ],
  "time":1704962463000
}
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Response:" %}

<table><thead><tr><th width="136">Parameter</th><th width="71">Type</th><th width="183">Example</th><th>Describe</th></tr></thead><tbody><tr><td>time</td><td>long</td><td><code>1595563624731</code></td><td>Current timestamp (ms)</td></tr><tr><td>bids</td><td>list</td><td>[[2100,13],[1990,3]]</td><td>Order book bid (buy) information. Each entry is a two-element array: index 0 is the price (float), index 1 is the quantity at that price (float)</td></tr><tr><td>asks</td><td>list</td><td>[[2100,13],[1990,3]]</td><td>Order book ask (sell) information. Each entry is a two-element array: index 0 is the price (float), index 1 is the quantity at that price (float)</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

{% hint style="info" %}
Bids and asks represent all price levels in the order book, each paired with its quantity, ordered from the best price outward.
{% endhint %}

***

## 24hrs ticker

<mark style="color:blue;">`GET`</mark> `https://futuresopenapi.nagaexchange.co.id/fapi/v1/ticker`

24-hour price change data.

#### Query Parameters

| Name                                           | Type   | Description                              |
| ---------------------------------------------- | ------ | ---------------------------------------- |
| contractName<mark style="color:red;">\*</mark> | string | Uppercase contract name, e.g. E-BTC-USDT |

{% tabs %}
{% tab title="200  Successfully obtain ticker information" %}

```json
{
    "high": "2500",
    "vol": "0",
    "last": "2500",
    "low": "2500",
    "buy": 2100,
    "sell": 0,
    "rose": "0",
    "time": 1704966225000
}
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Response:" %}

<table><thead><tr><th width="137">Parameter</th><th width="112">Type</th><th width="207">Example</th><th>Describe</th></tr></thead><tbody><tr><td>time</td><td>long</td><td><code>1595563624731</code></td><td>Timestamp</td></tr><tr><td>high</td><td>float</td><td><code>9900</code></td><td>Highest price</td></tr><tr><td>low</td><td>float</td><td><code>8800.34</code></td><td>Lowest price</td></tr><tr><td>last</td><td>float</td><td><code>8900.23</code></td><td>The last price</td></tr><tr><td>vol</td><td>float</td><td><code>4999</code></td><td>Trade volume</td></tr><tr><td>rose</td><td>string</td><td>+0.05</td><td>Percentage change — a leading <code>+</code> means an increase and <code>-</code> means a decrease (e.g. <code>+0.05</code> means a 5% increase)</td></tr><tr><td>buy</td><td>float</td><td>2100.01</td><td>Best (highest) bid price</td></tr><tr><td>sell</td><td>float</td><td>2050.01</td><td>Best (lowest) ask price</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

***

## Obtain index/tag price

<mark style="color:blue;">`GET`</mark> `https://futuresopenapi.nagaexchange.co.id/fapi/v1/index`

#### Query Parameters

| Name                                           | Type   | Description                              |
| ---------------------------------------------- | ------ | ---------------------------------------- |
| contractName<mark style="color:red;">\*</mark> | string | Uppercase contract name, e.g. E-BTC-USDT |
| limit                                          | string | Default 100; Maximum 1000                |

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

```java
{
    "currentFundRate": -0.0037500000000000,
    "indexPrice": 27905.9800000000000000,
    "tagPrice": 27824.4422146875000000,
    "nextFundRate": -0.0037500000000000
}
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Response:" %}

<table><thead><tr><th width="191">Parameter</th><th width="108">Type</th><th width="114">Example</th><th>Describe</th></tr></thead><tbody><tr><td>indexPrice</td><td>float</td><td><code>0.055</code></td><td>Index price</td></tr><tr><td>tagPrice</td><td>float</td><td><code>0.0578</code></td><td>Tag price</td></tr><tr><td>nextFundRate</td><td>float</td><td><code>0.343</code></td><td>Next funding rate</td></tr><tr><td>currentFundRate</td><td>float</td><td><code>0.123</code></td><td>Funding rate for the previous period (used for settlement in this period)</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

***

## Kline/candlestick data

<mark style="color:blue;">`GET`</mark> `https://futuresopenapi.nagaexchange.co.id/fapi/v1/klines`

#### Query Parameters

| Name                                           | Type    | Description                                                                                                       |
| ---------------------------------------------- | ------- | ----------------------------------------------------------------------------------------------------------------- |
| contractName<mark style="color:red;">\*</mark> | string  | Uppercase contract name, e.g. E-BTC-USDT                                                                          |
| interval<mark style="color:red;">\*</mark>     | string  | Interval of the Kline. Possible values include: `1min`, `5min`, `15min`, `30min`, `1h`, `1day`, `1week`, `1month` |
| limit                                          | integer | Default 100; Maximum 300                                                                                          |

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

```java
[
    {
        "high": "6228.77",
        "vol": "111",
        "low": "6228.77",
        "idx": 1594640340,
        "close": "6228.77",
        "open": "6228.77"
    },
    {
        "high": "6228.77",
        "vol": "222",
        "low": "6228.77",
        "idx": 1587632160,
        "close": "6228.77",
        "open": "6228.77"
    },
    {
        "high": "6228.77",
        "vol": "333",
        "low": "6228.77",
        "idx": 1587632100,
        "close": "6228.77",
        "open": "6228.77"
    }
]
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Response:" %}

<table><thead><tr><th width="161">Parameter</th><th width="114">Type</th><th width="175">Example</th><th>Describe</th></tr></thead><tbody><tr><td><code>idx</code></td><td>long</td><td><code>1538728740000</code></td><td>Open time (timestamp,ms)</td></tr><tr><td><code>open</code></td><td>float</td><td><code>36.00000</code></td><td>Open price</td></tr><tr><td><code>close</code></td><td>float</td><td><code>33.00000</code></td><td>Close price</td></tr><tr><td><code>high</code></td><td>float</td><td><code>36.00000</code></td><td>Highest price</td></tr><tr><td><code>low</code></td><td>float</td><td><code>30.00000</code></td><td>Lowest price</td></tr><tr><td><code>vol</code></td><td>float</td><td><code>2456.00000</code></td><td>Trade volume</td></tr></tbody></table>
{% endtab %}
{% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://openapi-docs.nagaexchange.co.id/rest-api-futures-trading/market-data.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.