Chuyển đến nội dung chính
GET
/
api
/
v1
/
agents
List Agents
curl --request GET \
  --url https://api.agentwallex.com/api/v1/agents \
  --header 'X-API-Key: <api-key>'
{
  "data": [
    {
      "id": "<string>",
      "agent_name": "<string>",
      "agent_description": "<string>",
      "wallet": {
        "address": "<string>",
        "chain": "<string>"
      },
      "status": "active",
      "metadata": "<string>",
      "created_at": "2023-11-07T05:31:56Z"
    }
  ],
  "total": 123,
  "has_more": true
}

Documentation Index

Fetch the complete documentation index at: https://docs.agentwallex.com/llms.txt

Use this file to discover all available pages before exploring further.

Lấy danh sách phân trang các tác nhân liên kết với tài khoản của bạn. Hỗ trợ lọc theo trạng thái và chuỗi.

​
Tham số Truy vấn

​
page_num
integer
mặc định:"1"
Số trang (bắt đầu từ 1).
​
page_size
integer
mặc định:"20"
Số mục trên mỗi trang. Tối đa: 100.
​
status
string
Lọc theo trạng thái tác nhân. Giá trị: active, inactive.
​
chain
string
Lọc theo định danh chuỗi CAIP-2 (ví dụ: eip155:84532).

​
Phản hồi

​
Ví dụ

curl -X GET "https://api.agentwallex.com/api/v1/agents?page_num=1&page_size=20&status=active&chain=eip155:84532" \
  -H "X-API-Key: awx_your_api_key"
Response
{
  "data": [
    {
      "id": "agent_abc123",
      "agent_name": "research-bot",
      "wallet": {
        "address": "0x1234...5678",
        "chain": "eip155:84532"
      },
      "status": "active",
      "created_at": "2025-06-01T10:00:00Z"
    }
  ],
  "total": 3,
  "has_more": false
}

Ủy quyền

​
X-API-Key
string
header
bắt buộc

API key authentication. Keys are prefixed with awx_.

Tham số truy vấn

​
page_num
integer
mặc định:1

Page number (1-indexed).

Phạm vi bắt buộc: x >= 1
​
page_size
integer
mặc định:20

Number of items per page.

Phạm vi bắt buộc: 1 <= x <= 100
​
status
enum<string>

Filter by agent status.

Tùy chọn có sẵn:
active,
inactive
​
chain
string

Filter by CAIP-2 chain identifier (e.g., eip155:84532).

Phản hồi

Paginated list of agents.

Standard paginated response wrapper.

​
data
object[]

Array of resource objects.

​
total
integer

Total number of items matching the query.

​
has_more
boolean

Whether more pages are available.