curl --request PATCH \
--url https://sandbox.groundtech.co/v2/gvaults/{gVaultId}/fees \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"feeRecipientAddress": "0x2222222222222222222222222222222222222222",
"managementFeeBps": 20,
"performanceFeeBps": 1500
}
'import requests
url = "https://sandbox.groundtech.co/v2/gvaults/{gVaultId}/fees"
payload = {
"feeRecipientAddress": "0x2222222222222222222222222222222222222222",
"managementFeeBps": 20,
"performanceFeeBps": 1500
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
feeRecipientAddress: '0x2222222222222222222222222222222222222222',
managementFeeBps: 20,
performanceFeeBps: 1500
})
};
fetch('https://sandbox.groundtech.co/v2/gvaults/{gVaultId}/fees', 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/gvaults/{gVaultId}/fees",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'feeRecipientAddress' => '0x2222222222222222222222222222222222222222',
'managementFeeBps' => 20,
'performanceFeeBps' => 1500
]),
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/gvaults/{gVaultId}/fees"
payload := strings.NewReader("{\n \"feeRecipientAddress\": \"0x2222222222222222222222222222222222222222\",\n \"managementFeeBps\": 20,\n \"performanceFeeBps\": 1500\n}")
req, _ := http.NewRequest("PATCH", 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.patch("https://sandbox.groundtech.co/v2/gvaults/{gVaultId}/fees")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"feeRecipientAddress\": \"0x2222222222222222222222222222222222222222\",\n \"managementFeeBps\": 20,\n \"performanceFeeBps\": 1500\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox.groundtech.co/v2/gvaults/{gVaultId}/fees")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"feeRecipientAddress\": \"0x2222222222222222222222222222222222222222\",\n \"managementFeeBps\": 20,\n \"performanceFeeBps\": 1500\n}"
response = http.request(request)
puts response.read_body{
"status": "confirmed"
}{
"status": "awaiting_approval",
"activityId": "01a1c873-a53b-7c26-8922-752334ca46d1"
}{
"error": "<string>",
"code": "validation_error"
}{
"error": "Unauthenticated request",
"message": "Missing or invalid bearer token"
}{
"error": "Gtoken access is not enabled for your organization. Please contact Ground admin.",
"code": "product_not_enabled"
}{
"error": "<string>",
"code": "validation_error"
}{
"error": "<string>",
"code": "validation_error"
}{
"error": "Service temporarily unavailable",
"code": "service_temporarily_unavailable",
"retryable": true
}Update customer fees
Updates your fees. Before signing is enabled, changes execute automatically; afterward, your configured signer quorum must approve.
curl --request PATCH \
--url https://sandbox.groundtech.co/v2/gvaults/{gVaultId}/fees \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"feeRecipientAddress": "0x2222222222222222222222222222222222222222",
"managementFeeBps": 20,
"performanceFeeBps": 1500
}
'import requests
url = "https://sandbox.groundtech.co/v2/gvaults/{gVaultId}/fees"
payload = {
"feeRecipientAddress": "0x2222222222222222222222222222222222222222",
"managementFeeBps": 20,
"performanceFeeBps": 1500
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
feeRecipientAddress: '0x2222222222222222222222222222222222222222',
managementFeeBps: 20,
performanceFeeBps: 1500
})
};
fetch('https://sandbox.groundtech.co/v2/gvaults/{gVaultId}/fees', 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/gvaults/{gVaultId}/fees",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'feeRecipientAddress' => '0x2222222222222222222222222222222222222222',
'managementFeeBps' => 20,
'performanceFeeBps' => 1500
]),
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/gvaults/{gVaultId}/fees"
payload := strings.NewReader("{\n \"feeRecipientAddress\": \"0x2222222222222222222222222222222222222222\",\n \"managementFeeBps\": 20,\n \"performanceFeeBps\": 1500\n}")
req, _ := http.NewRequest("PATCH", 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.patch("https://sandbox.groundtech.co/v2/gvaults/{gVaultId}/fees")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"feeRecipientAddress\": \"0x2222222222222222222222222222222222222222\",\n \"managementFeeBps\": 20,\n \"performanceFeeBps\": 1500\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox.groundtech.co/v2/gvaults/{gVaultId}/fees")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"feeRecipientAddress\": \"0x2222222222222222222222222222222222222222\",\n \"managementFeeBps\": 20,\n \"performanceFeeBps\": 1500\n}"
response = http.request(request)
puts response.read_body{
"status": "confirmed"
}{
"status": "awaiting_approval",
"activityId": "01a1c873-a53b-7c26-8922-752334ca46d1"
}{
"error": "<string>",
"code": "validation_error"
}{
"error": "Unauthenticated request",
"message": "Missing or invalid bearer token"
}{
"error": "Gtoken access is not enabled for your organization. Please contact Ground admin.",
"code": "product_not_enabled"
}{
"error": "<string>",
"code": "validation_error"
}{
"error": "<string>",
"code": "validation_error"
}{
"error": "Service temporarily unavailable",
"code": "service_temporarily_unavailable",
"retryable": true
}feeRecipientAddress, managementFeeBps and
performanceFeeBps. Omitted fields stay unchanged. Your recipient receives both
management and performance fee shares; Ground’s allocation stays unchanged.
Before signing is enabled, fee changes execute automatically. Once enabled,
approve the returned activityId with your configured signer quorum through
the portal or approval API.
Wait for feeUpdate.status: confirmed before treating the change as effective. See
configure fees.Authorizations
Path Parameters
Organization gVault UUID returned by discovery. Existing approved direct integrations retain their source slug.
^(?:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|ground-ustb-vault|ground-tempo-prime-vault)$"8f4c52d7-62ab-4db9-a964-92f481f6b851"
Body
Update your management rate, performance rate or fee recipient. Updates execute automatically before customer signing is enabled. After enablement, the configured customer quorum approves through the existing Turnkey endpoints. Ground's fee is already configured; changes initiated by Ground follow the same customer signing requirements. Omitted fields retain their current values. Only one update may be active per gVault.
Recipient of your management and performance fee shares. Set a recipient distinct from Ground before enabling either customer fee. Changing it preserves your rates.
42^0x(?!0{40}$)[0-9a-fA-F]{40}$"0x3bf25a73a1f1033c2d50ac65f3c9d6a44123db81"
Response
Already confirmed.