> AgentWallet Protocol

1{
2  "email": "dev@example.com",
3  "password": "s3cure_p@ss",
4  "name": "Alice"
5}

1{
2  "user": { "id": "usr_abc123", "email": "dev@example.com" },
3  "access_token": "eyJhbG...",
4  "token_type": "bearer"
5}

1{
2  "email": "dev@example.com",
3  "password": "s3cure_p@ss"
4}

1{
2  "access_token": "eyJhbG...",
3  "token_type": "bearer",
4  "expires_in": 3600
5}

1{
2  "name": "production-key",
3  "scopes": ["agents:write", "wallets:read", "transactions:write"]
4}

1{
2  "id": "key_xyz",
3  "api_key": "aw_live_k8f2...",
4  "name": "production-key",
5  "created_at": "2026-02-12T10:00:00Z"
6}

1{
2  "name": "trading-bot-alpha",
3  "type": "trading",
4  "metadata": { "model": "gpt-4", "version": "1.0" }
5}

1{
2  "id": "agt_a1b2c3",
3  "name": "trading-bot-alpha",
4  "type": "trading",
5  "status": "active",
6  "wallet_id": "wal_x9y8z7",
7  "created_at": "2026-02-12T10:00:00Z"
8}

1{
2  "data": [{ "id": "agt_a1b2c3", "name": "trading-bot-alpha", "status": "active" }],
3  "total": 1,
4  "page": 1,
5  "per_page": 20
6}

1{
2  "name": "trading-bot-beta",
3  "status": "paused"
4}

1{
2  "agent_id": "agt_a1b2c3",
3  "chain": "solana",
4  "label": "hot-wallet"
5}

1{
2  "id": "wal_x9y8z7",
3  "agent_id": "agt_a1b2c3",
4  "chain": "solana",
5  "address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
6  "label": "hot-wallet"
7}

1{
2  "wallet_id": "wal_x9y8z7",
3  "native": { "symbol": "SOL", "balance": "2.450000000" },
4  "tokens": []
5}

1{
2  "from_wallet": "wal_x9y8z7",
3  "to_address": "9aE2Cj...",
4  "amount_sol": 0.5,
5  "memo": "Payment for data feed"
6}

1{
2  "id": "tx_m3n4o5",
3  "status": "confirmed",
4  "signature": "5UfgJ3...",
5  "amount_sol": 0.5,
6  "fee_sol": 0.000005
7}

1{
2  "from_wallet": "wal_x9y8z7",
3  "transfers": [
4    { "to_address": "9aE2...", "amount_sol": 0.1 },
5    { "to_address": "4bF7...", "amount_sol": 0.2 }
6  ]
7}

1{
2  "payer_wallet": "wal_x9y8z7",
3  "payee_wallet": "wal_p4q5r6",
4  "amount_sol": 1.0,
5  "conditions": { "type": "task_completion" },
6  "expires_at": "2026-02-20T00:00:00Z"
7}

1{
2  "id": "esc_j1k2l3",
3  "status": "funded",
4  "amount_sol": 1.0,
5  "payer_wallet": "wal_x9y8z7",
6  "payee_wallet": "wal_p4q5r6"
7}

1{
2  "action": "release",
3  "reason": "Task completed successfully"
4}

1{
2  "name": "conservative-limits",
3  "agent_id": "agt_a1b2c3",
4  "rules": [
5    { "type": "max_transaction_amount", "value": 10.0 },
6    { "type": "daily_limit", "value": 50.0 },
7    { "type": "whitelist", "addresses": ["9aE2..."] }
8  ]
9}

1{
2  "total_volume_sol": 1842.5,
3  "total_transactions": 347,
4  "active_agents": 12,
5  "active_wallets": 18
6}

1{
2  "data": [
3    {
4      "id": "log_001",
5      "actor": "agt_a1b2c3",
6      "action": "transaction.create",
7      "resource": "tx_m3n4o5",
8      "timestamp": "2026-02-12T10:30:00Z"
9    }
10  ]
11}

1{
2  "url": "https://myapp.com/webhooks/aw",
3  "events": ["transaction.confirmed", "escrow.released"],
4  "secret": "whsec_..."
5}

1{
2  "agent_id": "agt_a1b2c3",
3  "name": "Sentiment Analysis",
4  "description": "Real-time crypto sentiment from X/Twitter",
5  "price_sol": 0.01,
6  "category": "data"
7}

1{
2  "service_id": "svc_d4e5f6",
3  "payer_wallet": "wal_x9y8z7",
4  "parameters": { "query": "$SOL sentiment" }
5}

1{
2  "wallet_id": "wal_x9y8z7",
3  "target_url": "https://api.example.com/data",
4  "max_price_sol": 0.001
5}

1{
2  "authority_wallet_id": "uuid-of-authority-wallet",
3  "agent_id_seed": "trading-bot-v1",
4  "spending_limit_per_tx": 500000000,
5  "daily_limit": 2000000000,
6  "agent_id": "uuid-of-agent (optional)"
7}

 1{
 2  "id": "pda-wallet-uuid",
 3  "org_id": "org-uuid",
 4  "pda_address": "7xKXtg2CW87d97TXJSDpbD...",
 5  "authority_wallet_id": "uuid",
 6  "agent_id_seed": "trading-bot-v1",
 7  "spending_limit_per_tx": 500000000,
 8  "daily_limit": 2000000000,
 9  "bump": 254,
10  "is_active": true,
11  "tx_signature": "5UfgJ3vBxTG...",
12  "created_at": "2026-02-16T10:00:00Z"
13}

1{
2  "data": [{ "id": "...", "pda_address": "...", "is_active": true }],
3  "total": 5
4}

 1{
 2  "pda_address": "7xKXtg2CW87d...",
 3  "authority": "AuthPubkey...",
 4  "org": "OrgPubkey...",
 5  "agent_id": "trading-bot-v1",
 6  "spending_limit_per_tx": 500000000,
 7  "daily_limit": 2000000000,
 8  "daily_spent": 100000000,
 9  "last_reset_day": 20504,
10  "is_active": true,
11  "bump": 254,
12  "sol_balance": 1.85
13}

1{
2  "recipient": "9aE2CjGpK4bD...",
3  "amount_lamports": 100000000
4}

1{
2  "signature": "4kR9vBxTG...",
3  "confirmed": true
4}

1{
2  "spending_limit_per_tx": 1000000000,
3  "daily_limit": 5000000000,
4  "is_active": true
5}

1{
2  "org_pubkey": "7xKXtg2CW87d...",
3  "agent_id_seed": "trading-bot-v1"
4}

1{
2  "pda_address": "DerivedPDAaddress...",
3  "bump": 254
4}

1pip install aw-protocol-sdk==0.4.0