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

# Account Data

Sign private GET requests as described in [Authentication](/api-trading/authentication.md). Require `read` scope and check both HTTP status and the JSON `success` field.

| Endpoint                               | Use                                                                                                                 |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| `GET /v1/client/key_info`              | Registered keys, scope, expiry and IP restrictions; match the current public key rather than assuming the first row |
| `GET /v1/client/info`                  | Account configuration and fee rates                                                                                 |
| `GET /v1/client/holding`               | Token holdings and frozen amounts                                                                                   |
| `GET /v1/positions`                    | Positions, account value and free collateral                                                                        |
| `GET /v1/orders?status=INCOMPLETE`     | Open/pending orders; include the query when signing and handle pagination                                           |
| `GET /v1/order/{order_id}`             | Reconcile an individual order after submission                                                                      |
| `GET /v1/public/info/PERP_ETH_USDC`    | Public market constraints; no key required                                                                          |
| `GET /v1/public/futures/PERP_ETH_USDC` | Public market snapshot; no key required                                                                             |

## Interpret balances correctly

Holdings are not free collateral. Unrealized/unsettled PnL, frozen funds and margin affect what can be used for a new order. Use current risk fields from the positions response; do not calculate spendable margin from the USDC holding alone.

A returned position row can have `position_qty = 0`. Only nonzero quantity represents an open position. Positive quantity is long; negative quantity is short. Check pending quantities separately. Unsettled PnL can remain after quantity returns to zero and is not necessarily profit from the latest trade.

Keep financial/account responses private. User-facing summaries should not dump credentials, other registered keys, email addresses or full internal response objects into logs.


---

# 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://docs.fluvion.io/api-trading/account-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.