Chuyển đến nội dung chính
GET
/
api
/
v1
/
transactions
List Transactions
curl --request GET \
  --url https://api.agentwallex.com/api/v1/transactions \
  --header 'X-API-Key: <api-key>'
{
  "data": [
    {
      "id": "<string>",
      "hash": "<string>",
      "agent_id": "<string>",
      "direction": "outbound",
      "type": "transfer",
      "from_address": "<string>",
      "to_address": "<string>",
      "amount": "<string>",
      "token": "<string>",
      "chain": "<string>",
      "fee": "<string>",
      "status": "pending",
      "memo": "<string>",
      "created_at": "2023-11-07T05:31:56Z"
    }
  ],
  "total": 123,
  "has_more": true
}
Liệt kê giao dịch trên toàn tài khoản hoặc lọc theo tác nhân và trạng thá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.
agent_id
string
Lọc theo ID tác nhân.
status
string
Lọc theo trạng thái giao dịch. Giá trị: pending, confirmed, failed.

Phản hồi

Ví dụ

curl -X GET "https://api.agentwallex.com/api/v1/transactions?agent_id=agent_abc123&status=confirmed&page_size=50" \
  -H "X-API-Key: awx_your_api_key"
Response
{
  "data": [
    {
      "id": "tx_xyz789",
      "hash": "0xabc123def456...",
      "agent_id": "agent_abc123",
      "direction": "outbound",
      "to_address": "0xabcd...ef12",
      "amount": "10.5",
      "token": "USDC",
      "chain": "eip155:84532",
      "status": "confirmed",
      "created_at": "2025-06-15T14:30:00Z"
    }
  ],
  "total": 25,
  "has_more": true
}

Ủ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
agent_id
string

Filter by agent ID.

status
enum<string>

Filter by transaction status.

Tùy chọn có sẵn:
pending,
confirmed,
failed

Phản hồi

Paginated list of transactions.

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.