List cash-aware account holdings
curl --request GET \
--url https://api.tuyo.com/public/holdings \
--header 'Authorization: Bearer <token>' \
--header 'Tuyo-API-Version: <tuyo-api-version>'import requests
url = "https://api.tuyo.com/public/holdings"
headers = {
"Tuyo-API-Version": "<tuyo-api-version>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'Tuyo-API-Version': '<tuyo-api-version>', Authorization: 'Bearer <token>'}
};
fetch('https://api.tuyo.com/public/holdings', 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://api.tuyo.com/public/holdings",
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>",
"Tuyo-API-Version: <tuyo-api-version>"
],
]);
$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://api.tuyo.com/public/holdings"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Tuyo-API-Version", "<tuyo-api-version>")
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://api.tuyo.com/public/holdings")
.header("Tuyo-API-Version", "<tuyo-api-version>")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.tuyo.com/public/holdings")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Tuyo-API-Version"] = '<tuyo-api-version>'
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"summary": {
"portfolioValue": "<unknown>",
"cashValue": "<unknown>",
"stablecoinValue": "<unknown>",
"cryptoValue": "<unknown>",
"investmentVaultValue": "<unknown>",
"matchingValue": "<unknown>"
},
"items": [
{
"id": "<unknown>",
"kind": "cash",
"group": "<unknown>",
"quantity": "<unknown>",
"value": "<unknown>",
"cash": {
"interest": "<unknown>"
},
"location": [
"<unknown>"
]
}
],
"page": {
"endCursor": "<string>",
"hasNextPage": true
},
"meta": {
"apiVersion": "<string>",
"observedFrom": "2023-11-07T05:31:56Z",
"observedTo": "2023-11-07T05:31:56Z",
"sourceCoverage": {
"status": "<unknown>",
"unavailableSources": [
"<string>"
]
},
"asOf": "<unknown>",
"blocks": "<unknown>"
},
"benefits": {
"status": "<unknown>",
"asOf": "2023-11-07T05:31:56Z",
"cardCredits": [
{
"id": "<unknown>",
"source": "<string>",
"available": "<unknown>",
"reserved": "<unknown>",
"expiresAt": "2023-11-07T05:31:56Z",
"usage": "card_only"
}
]
},
"cardCapacity": {
"status": "<unknown>",
"asOf": "2023-11-07T05:31:56Z",
"eligibleCustomerFunding": "<unknown>",
"availableCardCredit": "<unknown>",
"total": "<unknown>",
"basis": "card_eligible_funding_after_settlements_and_release_locks",
"authorizationGuaranteed": false
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true
},
"meta": {
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true
},
"meta": {
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true
},
"meta": {
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true
},
"meta": {
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true
},
"meta": {
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true
},
"meta": {
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true
},
"meta": {
"requestId": "<string>"
}
}API Reference
List cash-aware account holdings
Cash is one balance per currency, wherever Tuyo keeps it, with its interest setting and rate. Token and chain filters select whole matching groups. Summary spans all holdings, independent of page. Group and portfolio totals sum available valuations; individual unpriced values remain null. Benefits and card capacity are separate from assets. Yield is optional current-rate enrichment. Pages share a short-lived account-scoped snapshot.
GET
/
holdings
List cash-aware account holdings
curl --request GET \
--url https://api.tuyo.com/public/holdings \
--header 'Authorization: Bearer <token>' \
--header 'Tuyo-API-Version: <tuyo-api-version>'import requests
url = "https://api.tuyo.com/public/holdings"
headers = {
"Tuyo-API-Version": "<tuyo-api-version>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'Tuyo-API-Version': '<tuyo-api-version>', Authorization: 'Bearer <token>'}
};
fetch('https://api.tuyo.com/public/holdings', 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://api.tuyo.com/public/holdings",
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>",
"Tuyo-API-Version: <tuyo-api-version>"
],
]);
$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://api.tuyo.com/public/holdings"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Tuyo-API-Version", "<tuyo-api-version>")
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://api.tuyo.com/public/holdings")
.header("Tuyo-API-Version", "<tuyo-api-version>")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.tuyo.com/public/holdings")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Tuyo-API-Version"] = '<tuyo-api-version>'
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"summary": {
"portfolioValue": "<unknown>",
"cashValue": "<unknown>",
"stablecoinValue": "<unknown>",
"cryptoValue": "<unknown>",
"investmentVaultValue": "<unknown>",
"matchingValue": "<unknown>"
},
"items": [
{
"id": "<unknown>",
"kind": "cash",
"group": "<unknown>",
"quantity": "<unknown>",
"value": "<unknown>",
"cash": {
"interest": "<unknown>"
},
"location": [
"<unknown>"
]
}
],
"page": {
"endCursor": "<string>",
"hasNextPage": true
},
"meta": {
"apiVersion": "<string>",
"observedFrom": "2023-11-07T05:31:56Z",
"observedTo": "2023-11-07T05:31:56Z",
"sourceCoverage": {
"status": "<unknown>",
"unavailableSources": [
"<string>"
]
},
"asOf": "<unknown>",
"blocks": "<unknown>"
},
"benefits": {
"status": "<unknown>",
"asOf": "2023-11-07T05:31:56Z",
"cardCredits": [
{
"id": "<unknown>",
"source": "<string>",
"available": "<unknown>",
"reserved": "<unknown>",
"expiresAt": "2023-11-07T05:31:56Z",
"usage": "card_only"
}
]
},
"cardCapacity": {
"status": "<unknown>",
"asOf": "2023-11-07T05:31:56Z",
"eligibleCustomerFunding": "<unknown>",
"availableCardCredit": "<unknown>",
"total": "<unknown>",
"basis": "card_eligible_funding_after_settlements_and_release_locks",
"authorizationGuaranteed": false
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true
},
"meta": {
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true
},
"meta": {
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true
},
"meta": {
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true
},
"meta": {
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true
},
"meta": {
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true
},
"meta": {
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true
},
"meta": {
"requestId": "<string>"
}
}Headers
Query Parameters
Read holdings as they were at this instant: balances at the last block before it on each network, vault shares converted at that block, valued at prices of that time. Must not be in the future. Only include=yield is accepted and yields are then omitted; card locks are reconstructed from settlement records.
Pattern:
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$