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>"
      },
      "metadata": "<string>",
      "created_at": "2023-11-07T05:31:56Z"
    }
  ],
  "total": 123,
  "has_more": true
}
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.