> ## 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 Tác nhân
> Truy xuất một tác nhân theo ID, bao gồm địa chỉ ví và trạng thái hiện tại.
Truy xuất chi tiết đầy đủ của một tác nhân, bao gồm địa chỉ ví, trạng thái, metadata và dấu thời gian tạo.
## Tham số Đường dẫn
Định danh tác nhân duy nhất (ví dụ: `agent_abc123`).
## Phản hồi
Định danh tác nhân duy nhất.
Tên hiển thị tác nhân.
Mô tả tác nhân.
Địa chỉ ví on-chain.
Định danh chuỗi CAIP-2.
Trạng thái hiện tại: `active` hoặc `inactive`.
Chuỗi metadata mã hóa JSON.
Dấu thời gian tạo ISO 8601.
## Ví dụ
```bash cURL theme={null}
curl -X GET https://api.agentwallex.com/api/v1/agents/agent_abc123 \
-H "X-API-Key: awx_your_api_key"
```
```typescript TypeScript theme={null}
const agent = await aw.agents.get("agent_abc123");
```
```python Python theme={null}
agent = await aw.agents.get("agent_abc123")
```
```json Response theme={null}
{
"id": "agent_abc123",
"agent_name": "research-bot",
"agent_description": "Market research automation agent",
"wallet": {
"address": "0x1234567890abcdef1234567890abcdef12345678",
"chain": "eip155:84532"
},
"status": "active",
"metadata": "{\"team\":\"growth\"}",
"created_at": "2025-06-01T10:00:00Z"
}
```
## OpenAPI
````yaml GET /api/v1/agents/{id}
openapi: 3.1.0
info:
title: AgentWallex API
description: >-
REST API for managing AI agent wallets, on-chain transactions, spending
policies, webhooks, and x402 micropayments.
version: 1.0.0
contact:
name: AgentWallex Support
url: https://agentwallex.com
servers:
- url: https://api.agentwallex.com
description: Production
- url: https://api-sandbox.agentwallex.com
description: Sandbox
security:
- ApiKeyAuth: []
- BearerAuth: []
tags:
- name: Agents
description: Create and manage AI agent wallets.
- name: Transactions
description: Send payments and query transaction history.
- name: Policies
description: Configure spending limits and access controls.
- name: Webhooks
description: Register and manage webhook endpoints.
- name: x402
description: x402 micropayment negotiation and session management.
paths:
/api/v1/agents/{id}:
get:
tags:
- Agents
summary: Get Agent
description: >-
Retrieve the full details of a single agent, including wallet address,
status, metadata, and creation timestamp.
operationId: getAgent
parameters:
- name: id
in: path
required: true
description: The unique agent identifier (e.g., `agent_abc123`).
schema:
type: string
responses:
'200':
description: Agent details.
content:
application/json:
schema:
$ref: '#/components/schemas/Agent'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'
'500':
$ref: '#/components/responses/InternalError'
components:
schemas:
Agent:
type: object
description: An AI agent with an MPC-secured wallet.
properties:
id:
type: string
description: Unique agent identifier (e.g., `agent_abc123`).
agent_name:
type: string
description: Agent display name.
agent_description:
type: string
description: Agent description.
wallet:
$ref: '#/components/schemas/Wallet'
status:
type: string
enum:
- active
- inactive
description: Agent status.
metadata:
type: string
description: JSON-encoded metadata string.
created_at:
type: string
format: date-time
description: ISO 8601 creation timestamp.
Wallet:
type: object
description: An on-chain wallet associated with an agent.
properties:
address:
type: string
description: On-chain wallet address.
chain:
type: string
description: CAIP-2 chain identifier.
ErrorResponse:
type: object
description: Standard error response.
required:
- code
- type
- message
properties:
code:
type: string
description: Machine-readable error code.
type:
type: string
enum:
- invalid_request_error
- authentication_error
- authorization_error
- not_found_error
- rate_limit_error
- internal_error
description: Error type category.
message:
type: string
description: Human-readable error description.
responses:
Unauthorized:
description: Missing or invalid credentials.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
code: authentication_failed
type: authentication_error
message: The provided API key is invalid or expired.
Forbidden:
description: Insufficient permissions.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
code: insufficient_permissions
type: authorization_error
message: You do not have permission to perform this action.
NotFound:
description: Resource does not exist.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
code: resource_not_found
type: not_found_error
message: The requested resource was not found.
RateLimited:
description: Rate limit exceeded.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
code: rate_limit_exceeded
type: rate_limit_error
message: Too many requests. Please retry after a short delay.
InternalError:
description: Server-side error.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
code: server_error
type: internal_error
message: An unexpected error occurred. Please try again later.
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
description: API key authentication. Keys are prefixed with `awx_`.
BearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: JWT bearer token authentication.
````