Get a portfolio wallet

Get a Wallet

curl --request GET \
  --url https://sandbox.groundtech.co/v2/wallets/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://sandbox.groundtech.co/v2/wallets/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://sandbox.groundtech.co/v2/wallets/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://sandbox.groundtech.co/v2/wallets/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://sandbox.groundtech.co/v2/wallets/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "b1c2d3e4-0000-4000-8000-000000000001",
  "label": "Corporate Treasury",
  "createdAt": "2025-09-01T00:00:00Z",
  "status": "idle",
  "failureReason": null,
  "depositAddresses": {
    "arbitrum": "0xAbC1230000000000000000000000000000000001",
    "base": "0xAbC1230000000000000000000000000000000001",
    "ethereum": "0xAbC1230000000000000000000000000000000001",
    "polygon": "0xAbC1230000000000000000000000000000000001",
    "solana": "7vFgKxM3bP4oEFbqkPmA5E2rYJ8HqKz8abc1",
    "stellar": "GAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAWHF",
    "tron": "TBXSw8fM4jpQkGc6zZjsVABFpVN7UvXPdV"
  },
  "balance": {
    "totalUsd": "100.000000",
    "withdrawableUsd": "100.000000",
    "reservedUsd": "0.000000",
    "earnedUsd": "5.000000"
  },
  "positions": [
    {
      "id": "syrup-usdc",
      "kind": "yield_source",
      "label": "Syrup USDC",
      "valueUsd": "40.000000",
      "pct": 40,
      "chain": "ethereum",
      "token": "usdc",
      "allocationGroup": "usdc",
      "withdrawableUsd": "40.000000",
      "mode": "active",
      "denominationCurrency": "USD",
      "apyBps": null,
      "navUpdateMode": "continuous",
      "priceAsOf": "2026-10-19T12:00:00.000Z"
    },
    {
      "id": "morpho-gauntlet-usdc",
      "kind": "yield_source",
      "label": "Morpho Gauntlet USDC Prime",
      "valueUsd": "30.000000",
      "pct": 30,
      "chain": "ethereum",
      "token": "usdc",
      "allocationGroup": "usdc",
      "withdrawableUsd": "30.000000",
      "mode": "active",
      "denominationCurrency": "USD",
      "apyBps": null,
      "navUpdateMode": "continuous",
      "priceAsOf": "2026-10-19T12:00:00.000Z"
    },
    {
      "id": "morpho-steakhouse-usdc",
      "kind": "yield_source",
      "label": "Morpho Steakhouse USDC Prime",
      "valueUsd": "30.000000",
      "pct": 30,
      "chain": "ethereum",
      "token": "usdc",
      "allocationGroup": "usdc",
      "withdrawableUsd": "30.000000",
      "mode": "active",
      "denominationCurrency": "USD",
      "apyBps": null,
      "navUpdateMode": "continuous",
      "priceAsOf": "2026-10-19T12:00:00.000Z"
    }
  ],
  "autoRebalance": true,
  "strategyAllocations": {
    "usdc": [
      {
        "yieldSourceId": "syrup-usdc",
        "targetWeightBps": 4000,
        "chain": "ethereum",
        "token": "usdc",
        "allocationGroup": "usdc"
      },
      {
        "yieldSourceId": "morpho-gauntlet-usdc",
        "targetWeightBps": 3000,
        "chain": "ethereum",
        "token": "usdc",
        "allocationGroup": "usdc"
      },
      {
        "yieldSourceId": "morpho-steakhouse-usdc",
        "targetWeightBps": 3000,
        "chain": "ethereum",
        "token": "usdc",
        "allocationGroup": "usdc"
      }
    ],
    "usdt": [
      {
        "yieldSourceId": "cash",
        "targetWeightBps": 10000,
        "token": "usdt",
        "chain": "ethereum",
        "allocationGroup": "usdt"
      }
    ],
    "usdt:tron": [
      {
        "yieldSourceId": "cash",
        "targetWeightBps": 10000,
        "token": "usdt",
        "chain": "tron",
        "allocationGroup": "usdt:tron"
      }
    ]
  }
}

GET

wallets

{id}

Get a Wallet

curl --request GET \
  --url https://sandbox.groundtech.co/v2/wallets/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://sandbox.groundtech.co/v2/wallets/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://sandbox.groundtech.co/v2/wallets/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://sandbox.groundtech.co/v2/wallets/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://sandbox.groundtech.co/v2/wallets/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "b1c2d3e4-0000-4000-8000-000000000001",
  "label": "Corporate Treasury",
  "createdAt": "2025-09-01T00:00:00Z",
  "status": "idle",
  "failureReason": null,
  "depositAddresses": {
    "arbitrum": "0xAbC1230000000000000000000000000000000001",
    "base": "0xAbC1230000000000000000000000000000000001",
    "ethereum": "0xAbC1230000000000000000000000000000000001",
    "polygon": "0xAbC1230000000000000000000000000000000001",
    "solana": "7vFgKxM3bP4oEFbqkPmA5E2rYJ8HqKz8abc1",
    "stellar": "GAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAWHF",
    "tron": "TBXSw8fM4jpQkGc6zZjsVABFpVN7UvXPdV"
  },
  "balance": {
    "totalUsd": "100.000000",
    "withdrawableUsd": "100.000000",
    "reservedUsd": "0.000000",
    "earnedUsd": "5.000000"
  },
  "positions": [
    {
      "id": "syrup-usdc",
      "kind": "yield_source",
      "label": "Syrup USDC",
      "valueUsd": "40.000000",
      "pct": 40,
      "chain": "ethereum",
      "token": "usdc",
      "allocationGroup": "usdc",
      "withdrawableUsd": "40.000000",
      "mode": "active",
      "denominationCurrency": "USD",
      "apyBps": null,
      "navUpdateMode": "continuous",
      "priceAsOf": "2026-10-19T12:00:00.000Z"
    },
    {
      "id": "morpho-gauntlet-usdc",
      "kind": "yield_source",
      "label": "Morpho Gauntlet USDC Prime",
      "valueUsd": "30.000000",
      "pct": 30,
      "chain": "ethereum",
      "token": "usdc",
      "allocationGroup": "usdc",
      "withdrawableUsd": "30.000000",
      "mode": "active",
      "denominationCurrency": "USD",
      "apyBps": null,
      "navUpdateMode": "continuous",
      "priceAsOf": "2026-10-19T12:00:00.000Z"
    },
    {
      "id": "morpho-steakhouse-usdc",
      "kind": "yield_source",
      "label": "Morpho Steakhouse USDC Prime",
      "valueUsd": "30.000000",
      "pct": 30,
      "chain": "ethereum",
      "token": "usdc",
      "allocationGroup": "usdc",
      "withdrawableUsd": "30.000000",
      "mode": "active",
      "denominationCurrency": "USD",
      "apyBps": null,
      "navUpdateMode": "continuous",
      "priceAsOf": "2026-10-19T12:00:00.000Z"
    }
  ],
  "autoRebalance": true,
  "strategyAllocations": {
    "usdc": [
      {
        "yieldSourceId": "syrup-usdc",
        "targetWeightBps": 4000,
        "chain": "ethereum",
        "token": "usdc",
        "allocationGroup": "usdc"
      },
      {
        "yieldSourceId": "morpho-gauntlet-usdc",
        "targetWeightBps": 3000,
        "chain": "ethereum",
        "token": "usdc",
        "allocationGroup": "usdc"
      },
      {
        "yieldSourceId": "morpho-steakhouse-usdc",
        "targetWeightBps": 3000,
        "chain": "ethereum",
        "token": "usdc",
        "allocationGroup": "usdc"
      }
    ],
    "usdt": [
      {
        "yieldSourceId": "cash",
        "targetWeightBps": 10000,
        "token": "usdt",
        "chain": "ethereum",
        "allocationGroup": "usdt"
      }
    ],
    "usdt:tron": [
      {
        "yieldSourceId": "cash",
        "targetWeightBps": 10000,
        "token": "usdt",
        "chain": "tron",
        "allocationGroup": "usdt:tron"
      }
    ]
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

string<uuid>

required

Wallet ID

Response

Wallet details

string<uuid>

required

autoRebalance

boolean

required

Whether Ground automatically deploys deposits and maintains the wallet's percentage targets.

label

string | null

required

createdAt

string<date-time>

required

status

enum<string>

required

Compact wallet lifecycle and active-workflow status.

Available options:

creating,

idle,

withdrawal_active,

rebalance_active,

withdrawal_and_rebalance_active,

failed

failureReason

string | null

required

depositAddresses

object

required

Deposit addresses keyed by chain. Sandbox wallets use ethereum_sepolia and solana_devnet, plus tron_shasta and stellar_testnet; production wallets use arbitrum, base, ethereum, polygon, and solana, plus tron and stellar. New wallets prepare Stellar automatically in the background; only ready addresses are returned. Production wallets also prepare tempo (USDC.e); its address is returned only after setup and deposit monitoring are ready. The Tempo address can differ from the Ethereum address. Tempo is not available in sandbox.

Show child attributes

Example:

{
  "arbitrum": "0xAbC1230000000000000000000000000000000001",
  "base": "0xAbC1230000000000000000000000000000000001",
  "ethereum": "0xAbC1230000000000000000000000000000000001",
  "polygon": "0xAbC1230000000000000000000000000000000001",
  "solana": "7vFgKxM3bP4oEFbqkPmA5E2rYJ8HqKz8abc1",
  "stellar": "GAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAWHF",
  "tron": "TBXSw8fM4jpQkGc6zZjsVABFpVN7UvXPdV"
}

balance

object

required

Show child attributes

positions

object[]

required

Show child attributes

strategyAllocations

object | null

required

Percentage targets when automatic rebalancing is enabled. Always null when it is disabled.

Show child attributes

Getting Started

Wallet Lifecycle

Fees

Approvals

Monitoring & Webhooks

Security

Resources

API Reference

Get a portfolio wallet

Authorizations

Path Parameters

Response