List MicroVault activity

List subscriptions, rebalances, and redemptions

curl --request GET \
  --url https://sandbox.groundtech.co/v2/microvaults/vaults/{vaultId}/activity \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://sandbox.groundtech.co/v2/microvaults/vaults/{vaultId}/activity"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

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

fetch('https://sandbox.groundtech.co/v2/microvaults/vaults/{vaultId}/activity', 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/microvaults/vaults/{vaultId}/activity",
  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/microvaults/vaults/{vaultId}/activity"

	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/microvaults/vaults/{vaultId}/activity")

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

{
  "items": [
    {
      "id": "8c415937-77dd-4d92-a600-5a40a34b4114",
      "createdAt": "2026-09-10T18:41:00.000Z",
      "kind": "subscription",
      "status": "confirmed",
      "actor": "0x76f8fc6667e239f83a547d4e16225d6a34f6fa22",
      "txHash": "0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
      "details": {
        "amountAssets": "1000000",
        "shares": "997600000000000000"
      }
    }
  ],
  "nextCursor": null
}

{
  "error": "Unauthenticated request",
  "message": "Missing or invalid bearer token"
}

GET

microvaults

vaults

{vaultId}

activity

List subscriptions, rebalances, and redemptions

curl --request GET \
  --url https://sandbox.groundtech.co/v2/microvaults/vaults/{vaultId}/activity \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://sandbox.groundtech.co/v2/microvaults/vaults/{vaultId}/activity"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

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

fetch('https://sandbox.groundtech.co/v2/microvaults/vaults/{vaultId}/activity', 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/microvaults/vaults/{vaultId}/activity",
  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/microvaults/vaults/{vaultId}/activity"

	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/microvaults/vaults/{vaultId}/activity")

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

{
  "items": [
    {
      "id": "8c415937-77dd-4d92-a600-5a40a34b4114",
      "createdAt": "2026-09-10T18:41:00.000Z",
      "kind": "subscription",
      "status": "confirmed",
      "actor": "0x76f8fc6667e239f83a547d4e16225d6a34f6fa22",
      "txHash": "0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
      "details": {
        "amountAssets": "1000000",
        "shares": "997600000000000000"
      }
    }
  ],
  "nextCursor": null
}

{
  "error": "Unauthenticated request",
  "message": "Missing or invalid bearer token"
}

List subscription, rebalance, and redemption activity.

MicroVaults are in private preview for enabled sandbox organizations on Ethereum Sepolia.

Authorizations

Authorization

string

header

required

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

Path Parameters

vaultId

string<uuid>

required

Ground identifier of the MicroVault. This is distinct from its onchain contract address.

Pattern: ^[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}$

Example:

"8f4c52d7-62ab-4db9-a964-92f481f6b851"

Query Parameters

limit

integer

default:25

Maximum number of records to return in this page.

Required range: 1 <= x <= 100

cursor

string

Opaque continuation token from the preceding response's nextCursor. Omit for the first page.

Maximum string length: 512

Response

Activity in reverse chronological order.

items

object[]

required

Subscriptions, rebalances, and redemptions in reverse chronological order.

Show child attributes

nextCursor

string | null

required

Continuation token for the next page, or null when this is the last page.

Vaults and Sources

Performance and Activity

Shareholders

Redemptions

List MicroVault activity

Authorizations

Path Parameters

Query Parameters

Response