# Authentication

[API Key Guide](https://www.pionex.com/docs/api-docs/references/api-key-guide)

Private endpoints require HMAC SHA256 signature authentication.

**Required headers:**

* `PIONEX-KEY`: Your API Key
* `PIONEX-SIGNATURE`: HMAC SHA256 hex signature

**Required query parameter:**

* `timestamp`: Current time in milliseconds (valid within +/-20 seconds)

#### API Key Permissions

Each API Key can be configured with **Bot reading**, **Bot trading**, and/or **Enable reading** permissions. Make sure your API Key has the appropriate permission enabled before calling the following endpoints.

**Endpoints requiring `Bot reading` permission:**

* `GET /api/v1/bot/orders` — Get bot order list
* `GET /api/v1/bot/orders/futuresGrid/order` — Get futures grid order
* `GET /api/v1/bot/orders/spotGrid/order` — Get spot grid order
* `GET /api/v1/bot/orders/spotGrid/aiStrategy` — Get spot grid AI strategy
* `POST /api/v1/bot/orders/futuresGrid/checkParams` — Check futures grid parameters
* `POST /api/v1/bot/orders/spotGrid/checkParams` — Check spot grid parameters
* `POST /api/v1/bot/orders/smartCopy/checkParams` — Check smart copy parameters
* `GET /api/v1/bot/orders/smartCopy/order` — Get smart copy order

**Endpoints requiring `Enable reading` permission:**

* `POST /api/v1/bot/signal/listener` — Push custom trading signal

**Endpoints requiring `Bot trading` permission:**

* `POST /api/v1/bot/orders/futuresGrid/create` — Create futures grid order
* `POST /api/v1/bot/orders/futuresGrid/adjustParams` — Adjust futures grid (add investment / modify range)
* `POST /api/v1/bot/orders/futuresGrid/reduce` — Reduce futures grid position
* `POST /api/v1/bot/orders/futuresGrid/cancel` — Cancel futures grid order
* `POST /api/v1/bot/orders/spotGrid/create` — Create spot grid order
* `POST /api/v1/bot/orders/spotGrid/adjustParams` — Adjust spot grid parameters
* `POST /api/v1/bot/orders/spotGrid/investIn` — Add investment to spot grid
* `POST /api/v1/bot/orders/spotGrid/cancel` — Cancel spot grid order
* `POST /api/v1/bot/orders/spotGrid/profit` — Extract profit from spot grid
* `POST /api/v1/bot/orders/smartCopy/create` — Create smart copy order
* `POST /api/v1/bot/orders/smartCopy/cancel` — Cancel smart copy order


---

# 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://www.pionex.com/docs/api-docs/bot-api/general-info/authentication.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.