Example: Treasury Portfolio

const baseUrl = "https://sandbox.groundtech.co";
const apiToken = process.env.GROUND_API_TOKEN!;

type YieldSource = {
  id: string;
  name: string;
  depositToken: "usdc" | "usdt";
  apyBps: number | null;
};

const response = await fetch(`${baseUrl}/v2/wallets/yield-sources`, {
  headers: { Authorization: `Bearer ${apiToken}` },
});

if (!response.ok) throw new Error(await response.text());
const catalog = (await response.json()) as { data: YieldSource[] };

type Wallet = {
  id: string;
  autoRebalance: boolean;
  status: string;
  depositAddresses: Record<string, string>;
  positions: Array<{
    id: string;
    kind: string;
    label: string;
    valueUsd: string;
  }>;
};

const response = await fetch(`${baseUrl}/v2/wallets`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${apiToken}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    requestId: crypto.randomUUID(),
    label: "Corporate Treasury",
    autoRebalance: true,
    strategy: {
      allocations: {
        usdc: [
          { yieldSourceId: "morpho-august-usdc-v2", pct: 60 },
          { yieldSourceId: "syrup-usdc", pct: 40 },
        ],
      },
    },
  }),
});

if (!response.ok) throw new Error(await response.text());
const treasuryWallet = (await response.json()) as Wallet;

const response = await fetch(
  `${baseUrl}/v2/wallets/${treasuryWallet.id}`,
  { headers: { Authorization: `Bearer ${apiToken}` } },
);

if (!response.ok) throw new Error(await response.text());
const currentTreasury = (await response.json()) as Wallet;

console.log(currentTreasury.positions);

type WalletYield = {
  walletId: string;
  earnedUsd: string;
  annualizedUsd: string;
  currentBalanceUsd: string;
  positions: Array<{
    yieldSourceId: string;
    name: string;
    apyBps: number | null;
    deployedValueUsd: string;
  }>;
};

const response = await fetch(
  `${baseUrl}/v2/wallets/${treasuryWallet.id}/yield`,
  { headers: { Authorization: `Bearer ${apiToken}` } },
);

if (!response.ok) throw new Error(await response.text());
const treasuryYield = (await response.json()) as WalletYield;

console.log({
  earnedUsd: treasuryYield.earnedUsd,
  annualizedUsd: treasuryYield.annualizedUsd,
  positions: treasuryYield.positions,
});

const withdrawalRequest = {
  amountUsd: 1_000,
  token: "usdc",
  destinationChain: "ethereum_sepolia",
};

const previewResponse = await fetch(
  `${baseUrl}/v2/wallets/${treasuryWallet.id}/withdrawal-preview`,
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${apiToken}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify(withdrawalRequest),
  },
);

if (!previewResponse.ok) throw new Error(await previewResponse.text());
const preview = await previewResponse.json();

const withdrawalResponse = await fetch(
  `${baseUrl}/v2/wallets/${treasuryWallet.id}/withdrawals`,
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${apiToken}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      ...withdrawalRequest,
      requestId: crypto.randomUUID(),
      destinationAddress: "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
    }),
  },
);

if (!withdrawalResponse.ok) throw new Error(await withdrawalResponse.text());
const withdrawal = await withdrawalResponse.json();

console.log({ preview, withdrawal });