跳转到主要内容
POST
/
api
/
v1
/
policies
Create Policy
curl --request POST \
  --url https://api.agentwallex.com/api/v1/policies \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "agent_id": "agent_abc123",
  "type": "spending_limit",
  "rules": {
    "max_transaction_amount": "500",
    "daily_limit": "5000",
    "monthly_limit": "50000"
  }
}
'
{
  "id": "<string>",
  "agent_id": "<string>",
  "rules": {
    "max_transaction_amount": "<string>",
    "daily_limit": "<string>",
    "monthly_limit": "<string>",
    "allowed_addresses": [
      "<string>"
    ],
    "blocked_addresses": [
      "<string>"
    ],
    "allowed_tokens": [
      "<string>"
    ],
    "max_count": 123,
    "window_seconds": 123,
    "timezone": "<string>",
    "allowed_hours": {
      "start": 11,
      "end": 11
    },
    "allowed_days": [
      4
    ],
    "threshold": "<string>",
    "timeout_seconds": 123,
    "approvers": [
      "jsmith@example.com"
    ]
  },
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}
策略控制代理被允许执行的交易类型。每笔交易在 MPC 签名之前都会根据代理的策略进行评估。

​
请求体

​
agent_id
string
必填
要附加此策略的代理。
​
type
string
必填
策略类型。值：spending_limit、address_control、token_control、velocity_control、schedule、human_approval。
​
rules
object
必填
策略规则对象。结构取决于 type。

​
示例

curl -X POST https://api.agentwallex.com/api/v1/policies \
  -H "X-API-Key: awx_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agent_abc123",
    "type": "spending_limit",
    "rules": {
      "max_transaction_amount": "500",
      "daily_limit": "5000",
      "monthly_limit": "50000"
    }
  }'

授权

​
X-API-Key
string
header
必填

API key authentication. Keys are prefixed with awx_.

请求体

application/json
​
agent_id
string
必填

Agent to attach this policy to.

​
type
enum<string>
必填

Policy type.

可用选项:
spending_limit,
address_control,
token_control,
velocity_control,
schedule,
human_approval
​
rules
object
必填

Policy rules object. Structure depends on the policy type.

响应

Policy created successfully.

A policy that controls what transactions an agent is allowed to execute.

​
id
string

Unique policy identifier (e.g., pol_abc123).

​
agent_id
string

Agent this policy is attached to.

​
type
enum<string>

Policy type.

可用选项:
spending_limit,
address_control,
token_control,
velocity_control,
schedule,
human_approval
​
rules
object

Policy rules object. Structure depends on the policy type.

​
created_at
string<date-time>

ISO 8601 creation timestamp.

​
updated_at
string<date-time>

ISO 8601 last-update timestamp.