API — Wallets

Wallets are the monitored addresses in your organisation. Each wallet tracks a single address on a single chain.

List wallets

bash

GET /api/wallets

curl https://api.opsion.xyz/api/wallets \
  -H "Authorization: Bearer opsk_your_key_here"

json

{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
      "chain": "ethereum",
      "label": "Treasury",
      "type": "eoa",
      "tags": ["treasury"],
      "isArchived": false,
      "createdAt": "2025-01-15T09:41:00Z"
    }
  ]
}

Add a wallet

bash

POST /api/wallets

curl -X POST https://api.opsion.xyz/api/wallets \
  -H "Authorization: Bearer opsk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "chain": "ethereum",
    "label": "Treasury",
    "type": "eoa",
    "tags": ["treasury"]
  }'

Field	Type	Required	Description
`address`	`string`	Yes	EVM (0x… 40 hex chars), Solana (base58 public key 32–44 chars), or XRP (starts with r)
`chain`	`string`	Yes	Chain identifier — see Supported Chains
`label`	`string`	Yes	Human-readable name (max 64 chars)
`type`	`string`	No	eoa \| safe \| fireblocks \| contract (default: eoa)
`description`	`string`	No	Optional notes (max 256 chars)
`tags`	`string[]`	No	Up to 10 tags for grouping

Returns 201 Created with the new wallet object. Returns 409 Conflict if the address + chain combination already exists in your organisation.

Update a wallet

bash

PATCH /api/wallets/:id

curl -X PATCH https://api.opsion.xyz/api/wallets/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer opsk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "label": "Cold Storage", "tags": ["cold", "treasury"] }'

Archive / restore

Archiving pauses monitoring without deleting the wallet or its history.

bash

# Archive
curl -X PATCH https://api.opsion.xyz/api/wallets/550e8400-e29b-41d4-a716-446655440000/archive \
  -H "Authorization: Bearer opsk_your_key_here"

# Restore
curl -X PATCH https://api.opsion.xyz/api/wallets/550e8400-e29b-41d4-a716-446655440000/unarchive \
  -H "Authorization: Bearer opsk_your_key_here"