Skip to main content

​
Overview

Server-managed Ethereum wallets. Camino Treasury holds the keys and can sign transactions on your behalf. Each organization can create multiple wallets with labels.

​
Prerequisites

API keys are scoped to a single organization. All wallets and data returned are isolated to that organization.

​
List Wallets

Optional query params: sort (created_at or label, default created_at) and order (asc or desc, default asc). 
const response = await fetch('https://api.caminotreasury.com/v1/wallets', {
  headers: { 'x-api-key': 'your-api-key' }
});

const { data, count } = await response.json();
// {
//   "data": [
//     {
//       "address": "0x742d35cc6634c0532925a3b844bc454e4438f44e",
//       "label": "Main Treasury",
//       "createdAt": "2024-01-15T10:30:00.000Z",
//       "updatedAt": "2024-01-15T10:30:00.000Z"
//     }
//   ],
//   "count": 1
// }
Wallets are identified by their on-chain address across every endpoint.

​
Get a Single Wallet

const address = '0x742d35cc6634c0532925a3b844bc454e4438f44e';
const response = await fetch(`https://api.caminotreasury.com/v1/wallets/${address}`, {
  headers: { 'x-api-key': 'your-api-key' }
});

const wallet = await response.json();
// {
//   "address": "0x742d35cc6634c0532925a3b844bc454e4438f44e",
//   "label": "Main Treasury",
//   "createdAt": "2024-01-15T10:30:00.000Z",
//   "updatedAt": "2024-01-15T10:30:00.000Z"
// }
Returns 404 if the wallet doesn’t exist or belongs to another organization. Returns 400 if the address doesn’t match ^0x[a-fA-F0-9]{40}$.

​
Create a Wallet

Create a new server-managed wallet. The address is generated automatically. 
const response = await fetch('https://api.caminotreasury.com/v1/wallets', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'your-api-key'
  },
  body: JSON.stringify({
    label: 'Deposit Wallet'
  })
});

const wallet = await response.json();
// {
//   "address": "0x742d35cc6634c0532925a3b844bc454e4438f44e",
//   "label": "Deposit Wallet",
//   "createdAt": "2024-01-16T08:00:00.000Z",
//   "updatedAt": "2024-01-16T08:00:00.000Z"
// }

​
Auto-labeled wallets

If you omit label (or send an empty body), the server assigns Wallet N where N is the next number for your organization. The counter includes deleted wallets so numbers are never reused. 
// Both forms create a wallet labeled "Wallet 1" (assuming an empty org)
await fetch('https://api.caminotreasury.com/v1/wallets', {
  method: 'POST',
  headers: { 'x-api-key': 'your-api-key' },
});

// Or with an empty JSON body
await fetch('https://api.caminotreasury.com/v1/wallets', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'your-api-key',
  },
  body: '{}',
});
You can rename any wallet later via Update a Wallet.
FieldTypeDescription
labelstring (optional, 1–100 chars)Human-readable name. If omitted, the server assigns Wallet N.

​
Update a Wallet

Renames a wallet. label is the only updatable field — the address is permanent. 
const address = '0x742d35cc6634c0532925a3b844bc454e4438f44e';
const response = await fetch(`https://api.caminotreasury.com/v1/wallets/${address}`, {
  method: 'PATCH',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'your-api-key'
  },
  body: JSON.stringify({
    label: 'Updated Name'
  })
});

const wallet = await response.json();
// Returns the full updated wallet (same shape as Get a Single Wallet).
Returns 404 if the wallet doesn’t exist or belongs to another organization. Returns 400 if the address is malformed or label is missing/empty/oversized.

​
Wallet Fields

FieldTypeDescription
addressstringEthereum wallet address (lowercase). Identifier across all wallet endpoints.
labelstring | nullHuman-readable name
createdAtstringISO 8601 timestamp
updatedAtstringISO 8601 timestamp

​
Next Steps

Deposit and Start Earning

Deposit USDC into C0 and start earning yield

Platform Overview

Learn how Camino Treasury is organized