List source positions
curl --request GET \
--url https://sandbox.groundtech.co/v2/microvaults/vaults/{vaultId}/sources \
--header 'Authorization: Bearer <token>'import requests
url = "https://sandbox.groundtech.co/v2/microvaults/vaults/{vaultId}/sources"
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}/sources', 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}/sources",
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}/sources"
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))
}HttpResponse<String> response = Unirest.get("https://sandbox.groundtech.co/v2/microvaults/vaults/{vaultId}/sources")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox.groundtech.co/v2/microvaults/vaults/{vaultId}/sources")
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{
"sources": [
{
"id": "e6c8b358-34cb-49ef-a7f0-e8e2ef7a619b",
"sourceId": "0x1111111111111111111111111111111111111111111111111111111111111111",
"sourceAddress": "0x2222222222222222222222222222222222222222",
"positionTokenAddress": "0x2222222222222222222222222222222222222222",
"baseAssetAddress": "0x1c7d4b196cb0c7b01d743fbc6116a902379c7238",
"positionKey": "ethereum_morpho_steakhouse_usdc",
"displayName": "Morpho Steakhouse USDC",
"providerName": "Morpho",
"tickerLabel": "Steakhouse USDC",
"mode": "active",
"apyBps": 500,
"expectedProcessingSeconds": null,
"maxProcessingSeconds": null,
"minimumDepositUnits": "1000000",
"valuationAdapterAddress": "0x7777777777777777777777777777777777777777",
"sourceKind": "direct_erc4626",
"capabilities": {
"syncDeposit": true,
"syncRedeem": true,
"asyncDeposit": false,
"asyncRedeem": false
},
"enabled": true,
"depositsEnabled": true,
"withdrawalsEnabled": true,
"globallyEnabled": true,
"globallyWithdrawalsEnabled": true,
"onchainEnabled": true,
"activePositionUnits": "99750000",
"positionValueAssets": "100000000",
"pendingDepositAssets": "0",
"claimableBaseAssets": "0",
"componentFailure": null,
"pendingOperations": 0,
"operations": []
}
]
}{
"error": "Unauthenticated request",
"message": "Missing or invalid bearer token"
}Vaults and Sources
List MicroVault source positions
Returns each source attached to the vault with its permission mode, current position value, APY, and pending or claimable operations.
GET
/
v2
/
microvaults
/
vaults
/
{vaultId}
/
sources
List source positions
curl --request GET \
--url https://sandbox.groundtech.co/v2/microvaults/vaults/{vaultId}/sources \
--header 'Authorization: Bearer <token>'import requests
url = "https://sandbox.groundtech.co/v2/microvaults/vaults/{vaultId}/sources"
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}/sources', 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}/sources",
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}/sources"
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))
}HttpResponse<String> response = Unirest.get("https://sandbox.groundtech.co/v2/microvaults/vaults/{vaultId}/sources")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox.groundtech.co/v2/microvaults/vaults/{vaultId}/sources")
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{
"sources": [
{
"id": "e6c8b358-34cb-49ef-a7f0-e8e2ef7a619b",
"sourceId": "0x1111111111111111111111111111111111111111111111111111111111111111",
"sourceAddress": "0x2222222222222222222222222222222222222222",
"positionTokenAddress": "0x2222222222222222222222222222222222222222",
"baseAssetAddress": "0x1c7d4b196cb0c7b01d743fbc6116a902379c7238",
"positionKey": "ethereum_morpho_steakhouse_usdc",
"displayName": "Morpho Steakhouse USDC",
"providerName": "Morpho",
"tickerLabel": "Steakhouse USDC",
"mode": "active",
"apyBps": 500,
"expectedProcessingSeconds": null,
"maxProcessingSeconds": null,
"minimumDepositUnits": "1000000",
"valuationAdapterAddress": "0x7777777777777777777777777777777777777777",
"sourceKind": "direct_erc4626",
"capabilities": {
"syncDeposit": true,
"syncRedeem": true,
"asyncDeposit": false,
"asyncRedeem": false
},
"enabled": true,
"depositsEnabled": true,
"withdrawalsEnabled": true,
"globallyEnabled": true,
"globallyWithdrawalsEnabled": true,
"onchainEnabled": true,
"activePositionUnits": "99750000",
"positionValueAssets": "100000000",
"pendingDepositAssets": "0",
"claimableBaseAssets": "0",
"componentFailure": null,
"pendingOperations": 0,
"operations": []
}
]
}{
"error": "Unauthenticated request",
"message": "Missing or invalid bearer token"
}Read registered source modes, current positions, and in-flight source amounts.
MicroVaults are in private preview for enabled sandbox organizations on Ethereum Sepolia.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
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"
Response
Configured sources and positions.
Sources attached to the vault, including permissions, positions, valuation, and in-flight operations.
Show child attributes
Show child attributes