> 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/account.md).

# Account

**Account** endpoints on this page require a valid API key and signature. See [Authentication](/authentication.md) for signing details.

***

## Account Information

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

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

#### Headers

| Name        | Type    | Description  |
| ----------- | ------- | ------------ |
| X-CH-SIGN   | string  | Sign         |
| X-CH-APIKEY | string  | User API-KEY |
| X-CH-TS     | integer | Timestamp    |

{% tabs %}
{% tab title="200  Successfully obtained account information" %}

```json
{
    "account": [
        {
            "marginCoin": "USDT",
            "accountNormal": 999.5606,
            "accountLock": 23799.5017,
            "partPositionNormal": 9110.7294,
            "totalPositionNormal": 0,
            "achievedAmount": 4156.5072,
            "unrealizedAmount": 650.6385,
            "totalMarginRate": 0,
            "totalEquity": 99964804.560,
            "partEquity": 13917.8753,
            "totalCost": 0,
            "sumMarginRate": 873.4608,
            "positionVos": [
                {
                    "contractId": 1,
                    "contractName": "E-BTC-USDT",
                    "contractOtherName": "BTC-USDT",
                    "contractSymbol": "BTC-USDT",
                    "positions": [
                        {
                            "id": 13603,
                            "uid": 10023,
                            "contractId": 1,
                            "positionType": 2,
                            "side": "BUY",
                            "volume": 69642.0,
                            "openPrice": 11840.2394,
                            "avgPrice": 11840.3095,
                            "closePrice": 12155.3005,
                            "leverageLevel": 24,
                            "openAmount": 0.0600000000000000,
                            "holdAmount": 7014.2111,
                            "closeVolume": 40502.0,
                            "pendingCloseVolume": 0,
                            "realizedAmount": 8115.9125,
                            "historyRealizedAmount": 1865.3985,
                            "tradeFee": -432.0072,
                            "capitalFee": 2891.2281,
                            "closeProfit": 8117.6903,
                            "shareAmount": 0.1112,
                            "freezeLock": 0,
                            "status": 1,
                            "ctime": "2020-12-11T17:42:10",
                            "mtime": "2020-12-18T20:35:43",
                            "brokerId": 21,
                            "lockTime": "2023-12-05T13:53:04",
                            "marginRate": 0.2097,
                            "reducePrice": 9740.8083,
                            "returnRate": 0.3086,
                            "unRealizedAmount": 2164.5289,
                            "openRealizedAmount": 2165.0173,
                            "positionBalance": 82458.2839,
                            "settleProfit": 0.4883,
                            "totalMargin": 0.8351780179968750,
                            "indexPrice": 12151.1175,
                            "keepRate": 0.005,
                            "maxFeeRate": 0.0025
                        }
                    ]
                }
            ]
        }
    ]
}
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Account field" %}

<table><thead><tr><th>Parameter</th><th width="134">Type</th><th>Example</th><th>Describe</th></tr></thead><tbody><tr><td>marginCoin</td><td>string</td><td>USDT</td><td>Margin currency</td></tr><tr><td>accountNormal</td><td>float</td><td>10.05</td><td>Account balance</td></tr><tr><td>accountLock</td><td>float</td><td>10.07</td><td>Margin frozen account</td></tr><tr><td>partPositionNormal</td><td>float</td><td>10.07</td><td>Isolated margin balance</td></tr><tr><td>totalPositionNormal</td><td>float</td><td>10.07</td><td>Initial margin occupied by full position</td></tr><tr><td>achievedAmount</td><td>float</td><td>10.07</td><td>Realized profit and loss</td></tr><tr><td>unrealizedAmount</td><td>float</td><td>10.05</td><td>Unrealized profit or loss</td></tr><tr><td>totalMarginRate</td><td>float</td><td>10.05</td><td>Cross margin rate</td></tr><tr><td>totalEquity</td><td>float</td><td>10.07</td><td>Cross margin interest</td></tr><tr><td>partEquity</td><td>float</td><td>10.07</td><td>Isolated interest</td></tr><tr><td>totalCost</td><td>float</td><td>10.07</td><td>Cost of holding the full position</td></tr><tr><td>sumMarginRate</td><td>float</td><td>10.07</td><td>Margin rate for all accounts</td></tr><tr><td>positionVos</td><td>[ ]</td><td></td><td>Position contract records</td></tr></tbody></table>
{% endtab %}

{% tab title="PositionVos field" %}

<table><thead><tr><th>Parameter</th><th width="114">Type</th><th width="186">Example</th><th>Describe</th></tr></thead><tbody><tr><td>contractId</td><td>integer</td><td>2</td><td>Contract id</td></tr><tr><td>contractName</td><td>string</td><td>E-BTC-USDT</td><td>Uppercase contract name</td></tr><tr><td>contractOtherName</td><td>string</td><td>BTC-USDT</td><td>Currency alias</td></tr><tr><td>contractSymbol</td><td>string</td><td>BTC-USDT</td><td>Contract currency pair</td></tr><tr><td>positions</td><td>[ ]</td><td></td><td>Position detail information</td></tr></tbody></table>
{% endtab %}

{% tab title="Positions field" %}

<table><thead><tr><th>Parameter</th><th width="134">Type</th><th width="139">Example</th><th>Describe</th></tr></thead><tbody><tr><td>id</td><td>integer</td><td>2</td><td>Position id</td></tr><tr><td>uid</td><td>integer</td><td>10023</td><td>User ID</td></tr><tr><td>contractId</td><td>integer</td><td>1</td><td>Contract ID</td></tr><tr><td>positionType</td><td>integer</td><td>1</td><td>Position type (1: Cross position, 2: isolated position)</td></tr><tr><td>side</td><td>string</td><td>SELL</td><td>Position side (BUY: long position, SELL: short position)</td></tr><tr><td>volume</td><td>float</td><td>1.05</td><td>Position quantity</td></tr><tr><td>openPrice</td><td>float</td><td>1.05</td><td>Opening price</td></tr><tr><td>avgPrice</td><td>float</td><td>1.05</td><td>Average position price</td></tr><tr><td>closePrice</td><td>float</td><td>1.05</td><td>Average closing price</td></tr><tr><td>leverageLevel</td><td>float</td><td>1.05</td><td>Leverage multiple</td></tr><tr><td>openAmount</td><td>float</td><td>1.05</td><td>Opening margin</td></tr><tr><td>holdAmount</td><td>float</td><td>1.05</td><td>Position margin</td></tr><tr><td>closeVolume</td><td>float</td><td>1.05</td><td>Quantity of positions closed</td></tr><tr><td>pendingCloseVolume</td><td>float</td><td>1.05</td><td>Volume of orders pending closure</td></tr><tr><td>realizedAmount</td><td>float</td><td>1.05</td><td>Realized profit and loss</td></tr><tr><td>historyRealizedAmount</td><td>float</td><td>1.05</td><td>Historical accumulated profit and loss</td></tr><tr><td>tradeFee</td><td>float</td><td>1.05</td><td>Transaction fees</td></tr><tr><td>capitalFee</td><td>float</td><td>1.05</td><td>Funding charges</td></tr><tr><td>closeProfit</td><td>float</td><td>1.05</td><td>Position closing profit and loss</td></tr><tr><td>shareAmount</td><td>float</td><td>1.05</td><td>Sharing amount</td></tr><tr><td>freezeLock</td><td>integer</td><td>0</td><td>Position frozen status (0: normal, 1: liquidation frozen, 2: delivery frozen)</td></tr><tr><td>status</td><td>integer</td><td>0</td><td>Position validity (0: invalid, 1: valid)</td></tr><tr><td>ctime</td><td>time</td><td>2023-12-05T13:53:04</td><td>Creation time</td></tr><tr><td>mtime</td><td>time</td><td>2023-12-05T13:53:04</td><td>Update time</td></tr><tr><td>brokerId</td><td>integer</td><td>1023</td><td>Broker id</td></tr><tr><td>lockTime</td><td>time</td><td></td><td>Liquidation lock time</td></tr><tr><td>marginRate</td><td>float</td><td>1.05</td><td>Margin rate</td></tr><tr><td>reducePrice</td><td>float</td><td>1.05</td><td>Forced price reduction</td></tr><tr><td>returnRate</td><td>float</td><td>1.05</td><td>Rate of return (yield)</td></tr><tr><td>unRealizedAmount</td><td>float</td><td>1.05</td><td>Unrealized profit or loss</td></tr><tr><td>openRealizedAmount</td><td>float</td><td>1.05</td><td>Unrealized profit and loss on opening a position</td></tr><tr><td>positionBalance</td><td>float</td><td>1.05</td><td>Position value</td></tr><tr><td>settleProfit</td><td>float</td><td>1.05</td><td>Position settlement</td></tr><tr><td>indexPrice</td><td>float</td><td>1.05</td><td>Latest index price</td></tr><tr><td>keepRate</td><td>float</td><td>1.05</td><td>Tiered minimum maintenance margin rate</td></tr><tr><td>maxFeeRate</td><td>float</td><td>1.05</td><td>Maximum handling fee for closing the position</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/account.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.