# Basic Info

**Base URL:** `https://api.pionex.com`

**Request Format:**

* For private requests, the `timestamp` parameter (in milliseconds) must be included in the query string. The timestamp is valid within a range of ±20 seconds.
* Private requests require `PIONEX-KEY` (API Key) and `PIONEX-SIGNATURE` headers.
* GET requests: additional parameters are passed in the query string.
* POST/DELETE requests: parameters are passed in the request body as JSON (`application/json`).
* Zero-valued number parameters are disregarded.

**Signature Construction:**

* GET: `METHOD + PATH_URL + QUERY + TIMESTAMP`
* POST/DELETE: `METHOD + PATH_URL + QUERY + TIMESTAMP + body`

**Response Format:**

All responses are JSON objects containing:

* `result` (boolean): success indicator
* `timestamp` (number): response timestamp in milliseconds
* On success: `data` object with business information
* On failure: `code` (string) and `message` (string) with error details

Success example:

```json
{"result": true, "data": {"orderId": 123456789}, "timestamp": 1566691672311}
```

Failure example:

```json
{"result": false, "code": "TRADE_INVAILD_SYMBOL", "message": "Invalid symbol", "timestamp": 1566691672311}
```

**Error Codes:**

| Code                 | Description                |
| -------------------- | -------------------------- |
| APIKEY\_LOST         | API Key is missing         |
| SIGNATURE\_LOST      | Signature is missing       |
| IP\_NOT\_WHITELISTED | IP is not in the whitelist |
| INVALID\_APIKEY      | Invalid API Key            |
| INVALID\_SIGNATURE   | Invalid signature          |
| APIKEY\_EXPIRED      | API Key has expired        |
| INVALID\_TIMESTAMP   | Invalid timestamp          |
| PERMISSION\_DENIED   | Permission denied          |


---

# 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/trade-api/general-info/basic-info.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.
