Create a Wallet
curl --request POST \
--url https://sandbox.groundtech.co/v2/wallets \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"requestId": "a1b2c3d4-0000-4000-8000-000000000001",
"label": "Corporate Treasury",
"autoRebalance": true,
"strategy": {
"allocations": {
"usdc": [
{
"yieldSourceId": "cash",
"pct": 20
},
{
"yieldSourceId": "morpho-gauntlet-usdc",
"pct": 80
}
],
"usdt": [
{
"yieldSourceId": "cash",
"pct": 100
}
]
}
}
}
'import requests
url = "https://sandbox.groundtech.co/v2/wallets"
payload = {
"requestId": "a1b2c3d4-0000-4000-8000-000000000001",
"label": "Corporate Treasury",
"autoRebalance": True,
"strategy": { "allocations": {
"usdc": [
{
"yieldSourceId": "cash",
"pct": 20
},
{
"yieldSourceId": "morpho-gauntlet-usdc",
"pct": 80
}
],
"usdt": [
{
"yieldSourceId": "cash",
"pct": 100
}
]
} }
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
requestId: 'a1b2c3d4-0000-4000-8000-000000000001',
label: 'Corporate Treasury',
autoRebalance: true,
strategy: {
allocations: {
usdc: [
{yieldSourceId: 'cash', pct: 20},
{yieldSourceId: 'morpho-gauntlet-usdc', pct: 80}
],
usdt: [{yieldSourceId: 'cash', pct: 100}]
}
}
})
};
fetch('https://sandbox.groundtech.co/v2/wallets', 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",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'requestId' => 'a1b2c3d4-0000-4000-8000-000000000001',
'label' => 'Corporate Treasury',
'autoRebalance' => true,
'strategy' => [
'allocations' => [
'usdc' => [
[
'yieldSourceId' => 'cash',
'pct' => 20
],
[
'yieldSourceId' => 'morpho-gauntlet-usdc',
'pct' => 80
]
],
'usdt' => [
[
'yieldSourceId' => 'cash',
'pct' => 100
]
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://sandbox.groundtech.co/v2/wallets"
payload := strings.NewReader("{\n \"requestId\": \"a1b2c3d4-0000-4000-8000-000000000001\",\n \"label\": \"Corporate Treasury\",\n \"autoRebalance\": true,\n \"strategy\": {\n \"allocations\": {\n \"usdc\": [\n {\n \"yieldSourceId\": \"cash\",\n \"pct\": 20\n },\n {\n \"yieldSourceId\": \"morpho-gauntlet-usdc\",\n \"pct\": 80\n }\n ],\n \"usdt\": [\n {\n \"yieldSourceId\": \"cash\",\n \"pct\": 100\n }\n ]\n }\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://sandbox.groundtech.co/v2/wallets")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"requestId\": \"a1b2c3d4-0000-4000-8000-000000000001\",\n \"label\": \"Corporate Treasury\",\n \"autoRebalance\": true,\n \"strategy\": {\n \"allocations\": {\n \"usdc\": [\n {\n \"yieldSourceId\": \"cash\",\n \"pct\": 20\n },\n {\n \"yieldSourceId\": \"morpho-gauntlet-usdc\",\n \"pct\": 80\n }\n ],\n \"usdt\": [\n {\n \"yieldSourceId\": \"cash\",\n \"pct\": 100\n }\n ]\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox.groundtech.co/v2/wallets")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"requestId\": \"a1b2c3d4-0000-4000-8000-000000000001\",\n \"label\": \"Corporate Treasury\",\n \"autoRebalance\": true,\n \"strategy\": {\n \"allocations\": {\n \"usdc\": [\n {\n \"yieldSourceId\": \"cash\",\n \"pct\": 20\n },\n {\n \"yieldSourceId\": \"morpho-gauntlet-usdc\",\n \"pct\": 80\n }\n ],\n \"usdt\": [\n {\n \"yieldSourceId\": \"cash\",\n \"pct\": 100\n }\n ]\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"id": "b1c2d3e4-0000-4000-8000-000000000001",
"autoRebalance": true,
"label": "Corporate Treasury",
"createdAt": "2025-09-01T00:00:00Z",
"status": "creating",
"failureReason": null,
"depositAddresses": {},
"balance": {
"totalUsd": "0.000000",
"withdrawableUsd": "0.000000",
"reservedUsd": "0.000000",
"earnedUsd": "0.000000"
},
"positions": [],
"strategyAllocations": {
"usdc": [
{
"yieldSourceId": "cash",
"targetWeightBps": 2000,
"token": "usdc"
},
{
"yieldSourceId": "morpho-gauntlet-usdc",
"targetWeightBps": 8000
}
],
"usdt": [
{
"yieldSourceId": "cash",
"targetWeightBps": 10000,
"token": "usdt",
"chain": "ethereum"
}
]
}
}
Wallets
Create a portfolio wallet
Creates a wallet that either invests deposits automatically or keeps them in cash. Reusing requestId returns the same wallet.
POST
/
v2
/
wallets
Create a Wallet
curl --request POST \
--url https://sandbox.groundtech.co/v2/wallets \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"requestId": "a1b2c3d4-0000-4000-8000-000000000001",
"label": "Corporate Treasury",
"autoRebalance": true,
"strategy": {
"allocations": {
"usdc": [
{
"yieldSourceId": "cash",
"pct": 20
},
{
"yieldSourceId": "morpho-gauntlet-usdc",
"pct": 80
}
],
"usdt": [
{
"yieldSourceId": "cash",
"pct": 100
}
]
}
}
}
'import requests
url = "https://sandbox.groundtech.co/v2/wallets"
payload = {
"requestId": "a1b2c3d4-0000-4000-8000-000000000001",
"label": "Corporate Treasury",
"autoRebalance": True,
"strategy": { "allocations": {
"usdc": [
{
"yieldSourceId": "cash",
"pct": 20
},
{
"yieldSourceId": "morpho-gauntlet-usdc",
"pct": 80
}
],
"usdt": [
{
"yieldSourceId": "cash",
"pct": 100
}
]
} }
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
requestId: 'a1b2c3d4-0000-4000-8000-000000000001',
label: 'Corporate Treasury',
autoRebalance: true,
strategy: {
allocations: {
usdc: [
{yieldSourceId: 'cash', pct: 20},
{yieldSourceId: 'morpho-gauntlet-usdc', pct: 80}
],
usdt: [{yieldSourceId: 'cash', pct: 100}]
}
}
})
};
fetch('https://sandbox.groundtech.co/v2/wallets', 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",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'requestId' => 'a1b2c3d4-0000-4000-8000-000000000001',
'label' => 'Corporate Treasury',
'autoRebalance' => true,
'strategy' => [
'allocations' => [
'usdc' => [
[
'yieldSourceId' => 'cash',
'pct' => 20
],
[
'yieldSourceId' => 'morpho-gauntlet-usdc',
'pct' => 80
]
],
'usdt' => [
[
'yieldSourceId' => 'cash',
'pct' => 100
]
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://sandbox.groundtech.co/v2/wallets"
payload := strings.NewReader("{\n \"requestId\": \"a1b2c3d4-0000-4000-8000-000000000001\",\n \"label\": \"Corporate Treasury\",\n \"autoRebalance\": true,\n \"strategy\": {\n \"allocations\": {\n \"usdc\": [\n {\n \"yieldSourceId\": \"cash\",\n \"pct\": 20\n },\n {\n \"yieldSourceId\": \"morpho-gauntlet-usdc\",\n \"pct\": 80\n }\n ],\n \"usdt\": [\n {\n \"yieldSourceId\": \"cash\",\n \"pct\": 100\n }\n ]\n }\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://sandbox.groundtech.co/v2/wallets")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"requestId\": \"a1b2c3d4-0000-4000-8000-000000000001\",\n \"label\": \"Corporate Treasury\",\n \"autoRebalance\": true,\n \"strategy\": {\n \"allocations\": {\n \"usdc\": [\n {\n \"yieldSourceId\": \"cash\",\n \"pct\": 20\n },\n {\n \"yieldSourceId\": \"morpho-gauntlet-usdc\",\n \"pct\": 80\n }\n ],\n \"usdt\": [\n {\n \"yieldSourceId\": \"cash\",\n \"pct\": 100\n }\n ]\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox.groundtech.co/v2/wallets")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"requestId\": \"a1b2c3d4-0000-4000-8000-000000000001\",\n \"label\": \"Corporate Treasury\",\n \"autoRebalance\": true,\n \"strategy\": {\n \"allocations\": {\n \"usdc\": [\n {\n \"yieldSourceId\": \"cash\",\n \"pct\": 20\n },\n {\n \"yieldSourceId\": \"morpho-gauntlet-usdc\",\n \"pct\": 80\n }\n ],\n \"usdt\": [\n {\n \"yieldSourceId\": \"cash\",\n \"pct\": 100\n }\n ]\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"id": "b1c2d3e4-0000-4000-8000-000000000001",
"autoRebalance": true,
"label": "Corporate Treasury",
"createdAt": "2025-09-01T00:00:00Z",
"status": "creating",
"failureReason": null,
"depositAddresses": {},
"balance": {
"totalUsd": "0.000000",
"withdrawableUsd": "0.000000",
"reservedUsd": "0.000000",
"earnedUsd": "0.000000"
},
"positions": [],
"strategyAllocations": {
"usdc": [
{
"yieldSourceId": "cash",
"targetWeightBps": 2000,
"token": "usdc"
},
{
"yieldSourceId": "morpho-gauntlet-usdc",
"targetWeightBps": 8000
}
],
"usdt": [
{
"yieldSourceId": "cash",
"targetWeightBps": 10000,
"token": "usdt",
"chain": "ethereum"
}
]
}
}
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Response
Wallet returned. New wallets may still be provisioning with status: creating.
Whether Ground automatically deploys deposits and maintains the wallet's percentage targets.
Percentage targets when automatic rebalancing is enabled. Always null when it is disabled.
Show child attributes
Show child attributes
Compact wallet lifecycle and active-workflow status.
Available options:
creating, idle, withdrawal_active, rebalance_active, withdrawal_and_rebalance_active, failed Deposit address setup state across supported networks, independent of wallet activity. Addresses already present remain usable while other addresses are prepared.
Show child attributes
Show child attributes
Deposit addresses keyed by chain. Sandbox wallets use ethereum_sepolia and solana_devnet, plus tron_shasta and opt-in stellar_testnet; production wallets use arbitrum, base, ethereum, polygon, and solana, plus tron and opt-in stellar in beta-enabled environments.
Show child attributes
Show child attributes
Example:
{ "arbitrum": "0xAbC1230000000000000000000000000000000001", "base": "0xAbC1230000000000000000000000000000000001", "ethereum": "0xAbC1230000000000000000000000000000000001", "polygon": "0xAbC1230000000000000000000000000000000001", "solana": "7vFgKxM3bP4oEFbqkPmA5E2rYJ8HqKz8abc1", "stellar": "GAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAWHF" }
Show child attributes
Show child attributes
Show child attributes
Show child attributes