# Query Account

### API Overview

This API retrieves a list of accounts in the system and supports paginated queries.

* **Request Method：**`GET`
* **Request URL：**`https://openapi.elven.com/open/v3/entityAccount`

### Request Headers

<table><thead><tr><th width="202">Parameter Name</th><th width="90">Type</th><th width="100">Required</th><th>Description</th></tr></thead><tbody><tr><td>elven-api-key</td><td>String</td><td>Yes</td><td>The API key assigned to you</td></tr><tr><td>elven-api-sign</td><td>String</td><td>Yes</td><td>Request signature, used to verify the legitimacy of the request</td></tr><tr><td>elven-api-timestamp</td><td>String</td><td>Yes</td><td>Request timestamp, in milliseconds</td></tr></tbody></table>

[View Details](https://docs.elven.com/v3/~/changes/YkdBoYHdjwadymwIANKf/openapi/obtaining-api-authorization?r=LJbAoiJKFX1i7Py2GCYr)

### Request Parameters

#### Query 参数

<table><thead><tr><th width="184">Parameter Name</th><th width="119">Type</th><th width="102">Required</th><th>Description</th></tr></thead><tbody><tr><td>page</td><td>Number</td><td>No</td><td>The page number to retrieve. Defaults to 1 if not provided.</td></tr><tr><td>limit</td><td>Number</td><td>No</td><td>The number of records per page. Defaults to 10 if not provided.</td></tr></tbody></table>

#### Example Request

```bash
GET https://openapi.elven.com/open/v3/entityAccount?page=1&limit=10
```

### Response Parameters

<table><thead><tr><th width="183">Parameter Name</th><th width="111">Type</th><th>Description</th></tr></thead><tbody><tr><td>total</td><td>Number</td><td>Total number of accounts in the system.</td></tr><tr><td>list</td><td>Array</td><td>A list of account details. Each element is a JSON object containing account information.</td></tr></tbody></table>

#### list 数组元素

<table><thead><tr><th width="183">Parameter Name</th><th width="112">Type</th><th>Description</th></tr></thead><tbody><tr><td>entityAccountId</td><td>String</td><td>Account  Primary Key</td></tr><tr><td>name</td><td>String</td><td>Account Name</td></tr><tr><td>platformId</td><td>String</td><td>PlatformId Primary Key</td></tr><tr><td>identity</td><td>String</td><td>Account Address</td></tr><tr><td>memo</td><td>String</td><td>memo</td></tr></tbody></table>

#### Example Response

```json
{
    "total": 100,
    "list": [
        {
            "entityAccountId": "xxxx",
            "name": "account1",
            "platformId": "xxx",
            "identity": "xxx",
            "memo": ""
        },
        {
            "entityAccountId": "yyyy",
            "name": "account2",
            "platformId": "yyy",
            "identity": "yyy",
            "memo": "this is memo"
        }
    ]
}
```

### **Notes**

* The following headers are required for all requests to ensure security and validity: elven-api-key,elven-api-sign,elven-api-timestamp
* **Pagination:** The page and limit parameters are optional. If omitted, the API will default to returning the first page with 10 records per page.
* **Response Format:**  The list array in the response contains detailed account information, with each element matching the structure of the return value from the Add Account API.


---

# 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://docs.elven.com/v3/openapi/query-account.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.