Get historical balance snapshots
curl --request GET \
--url https://{host}/extern/svr/{accountTypeId}/account/{accountId}/balance/history \
--header 'X-API-Key: <api-key>'const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://{host}/extern/svr/{accountTypeId}/account/{accountId}/balance/history', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://{host}/extern/svr/{accountTypeId}/account/{accountId}/balance/history"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"status": "success",
"data": [
{
"id": "8e9f4d67-51ad-49aa-a502-2f569aaf7399",
"createdAt": "2023-11-07T05:31:56Z",
"totalValue": {
"USD": 1234.56,
"EUR": 1135.79
},
"totalUnderlyingValue": 123,
"totalYield": {
"USD": 1234.56,
"EUR": 1135.79
},
"totalYieldUnderlying": 123,
"primaryUnderlyingSymbol": "<string>",
"primaryUnderlyingDecimals": 1,
"primaryUnderlyingAddress": "0x1234567890abcdef1234567890abcdef12345678",
"breakdown": "<unknown>"
}
]
}{
"status": "error",
"code": "INTENT_WRONG_STATUS",
"message": "Session must be in OPEN status for this action."
}{
"status": "error",
"code": "INTENT_WRONG_STATUS",
"message": "Session must be in OPEN status for this action."
}{
"status": "error",
"code": "INTENT_WRONG_STATUS",
"message": "Session must be in OPEN status for this action."
}{
"status": "error",
"code": "INTENT_WRONG_STATUS",
"message": "Session must be in OPEN status for this action."
}{
"status": "error",
"code": "INTENT_WRONG_STATUS",
"message": "Session must be in OPEN status for this action."
}{
"status": "error",
"code": "INTENT_WRONG_STATUS",
"message": "Session must be in OPEN status for this action."
}{
"status": "error",
"code": "INTENT_WRONG_STATUS",
"message": "Session must be in OPEN status for this action."
}Get historical balance snapshots
GET
/
extern
/
svr
/
{accountTypeId}
/
account
/
{accountId}
/
balance
/
history
Get historical balance snapshots
curl --request GET \
--url https://{host}/extern/svr/{accountTypeId}/account/{accountId}/balance/history \
--header 'X-API-Key: <api-key>'const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://{host}/extern/svr/{accountTypeId}/account/{accountId}/balance/history', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://{host}/extern/svr/{accountTypeId}/account/{accountId}/balance/history"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"status": "success",
"data": [
{
"id": "8e9f4d67-51ad-49aa-a502-2f569aaf7399",
"createdAt": "2023-11-07T05:31:56Z",
"totalValue": {
"USD": 1234.56,
"EUR": 1135.79
},
"totalUnderlyingValue": 123,
"totalYield": {
"USD": 1234.56,
"EUR": 1135.79
},
"totalYieldUnderlying": 123,
"primaryUnderlyingSymbol": "<string>",
"primaryUnderlyingDecimals": 1,
"primaryUnderlyingAddress": "0x1234567890abcdef1234567890abcdef12345678",
"breakdown": "<unknown>"
}
]
}{
"status": "error",
"code": "INTENT_WRONG_STATUS",
"message": "Session must be in OPEN status for this action."
}{
"status": "error",
"code": "INTENT_WRONG_STATUS",
"message": "Session must be in OPEN status for this action."
}{
"status": "error",
"code": "INTENT_WRONG_STATUS",
"message": "Session must be in OPEN status for this action."
}{
"status": "error",
"code": "INTENT_WRONG_STATUS",
"message": "Session must be in OPEN status for this action."
}{
"status": "error",
"code": "INTENT_WRONG_STATUS",
"message": "Session must be in OPEN status for this action."
}{
"status": "error",
"code": "INTENT_WRONG_STATUS",
"message": "Session must be in OPEN status for this action."
}{
"status": "error",
"code": "INTENT_WRONG_STATUS",
"message": "Session must be in OPEN status for this action."
}Authorizations
Server API key (sk_live_...)
Headers
Optional ISO 4217 currency. Responses always include USD and add this currency when conversion is available.
Pattern:
^[A-Za-z]{3}$Example:
"EUR"
Path Parameters
Account Type slug
Minimum string length:
1RFC 4122 UUID
Example:
"8e9f4d67-51ad-49aa-a502-2f569aaf7399"
Last modified on July 24, 2026
Was this page helpful?