---
title: "Get agent wallets"
method: GET
path: "/agent-wallets"
tags: ["hyperliquid"]
---

# Get agent wallets

`GET /agent-wallets`

## Request

- Base URL: `https://api.copper.co/platform`
- URL: `https://api.copper.co/platform/agent-wallets`
- Auth: none declared
- TypeScript: <https://skmtc.dev/copper-co/apis/copper-platform-api/docs/agent-wallets/get.ts> (a function with typed inputs; its response is checked against the schema)

Get the active Hyperliquid agent (hot) wallets for a portfolio, or for every portfolio in an organization

## Response `200`

OK

- HyperliquidAgentWallet
  - `address` string: Agent (public) key address
  - `createdAt` string: Creation timestamp of the originating activation order
  - `createdBy` string: Creator user id of the originating activation order
  - `id` string: Stable id for this wallet: the agent (public) key address for active keys, the order id for pending keys
  - `name` string: Key name (agent name)
  - `orderId` string: Id of the originating activation order
  - `orderStatus` 'new' | 'waiting-funds' | 'reserving' | 'reserved' | 'queued' | 'validating-funds' | 'working' | 'waiting-approve' | 'co-sign-require' | 'approved' | 'processing' | 'executed' | 'canceled' | 'rejecting' | 'rejected' | 'declining' | 'declined' | 'suspending' | 'suspended' | 'blocked' | 'action-required' | 'accepting' | 'accepted' | 'require-initializer-approve' | 'waiting-counterparty-approve' | 'require-counterparty-approve' | 'ready-for-settlement' | 'settled' | 'part-signed-tx-added' | 'full-signed-tx-added' | 'rejected-part-signed-tx-added' | 'rejected-full-signed-tx-added' | 'accepted-part-signed-tx-added' | 'accepted-full-signed-tx-added' | 'awaiting-settlement' | 'master-password-required' | 'manual-resolving' | 'error' | 'pending-atomic-settlement-confirmation' | 'atomic-settlement-reservation-completed' | 'require-finalize' | 'waiting-accept-deposit' | 'waiting-reject-deposit'
  - `portfolioId` string: Portfolio this agent wallet belongs to
  - `revokeOrderId` string: Id of a pending revoke order targeting this agent wallet, if one exists (the key is being deleted)
  - `status` 'pending' | 'active' | 'inactive'
  - `validUntil` string: Raw expiry from the activation step (unix-seconds); null/0 means no expiry

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `409`: Conflict

---

[API](https://skmtc.dev/copper-co/apis/copper-platform-api.md) - [All operations](https://skmtc.dev/copper-co/apis/copper-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/copper-co/apis/copper-platform-api/revisions/44296120fc7d?raw)