Retrieve synchronization status for addresses to check when portfolio and transaction data were last updated.
Endpoint
GET https://api.octav.fi/v1/status
Parameters
Comma-separated list of addressesaddresses=0x6426af179aabebe47666f345d69fd9079673f6cd
Example
curl "https://api.octav.fi/v1/status?addresses=0x6426af..." \
-H "Authorization: Bearer YOUR_API_KEY"
Response
ISO 8601 timestamp of last portfolio synchronization
Example: "2025-05-08T14:43:12.020Z"
ISO 8601 timestamp of last transaction synchronization
Example: "2025-05-08T14:38:15.920Z"
Whether transactions are currently syncing
true = sync in progress, false = no active sync
Example Response
[
{
"address": "0x6426af179aabebe47666f345d69fd9079673f6cd",
"portfolioLastSync": "2025-05-08T14:43:12.020Z",
"transactionsLastSync": "2025-05-08T14:38:15.920Z",
"syncInProgress": false
}
]
Use Cases
Check Freshness
Wait for Sync
Monitor Multiple
Check if data is fresh enough:async function isDataFresh(address, maxAgeMinutes = 10) {
const response = await fetch(
`https://api.octav.fi/v1/status?addresses=${address}`,
{ headers: { 'Authorization': `Bearer ${apiKey}` } }
);
const [status] = await response.json();
const lastSync = new Date(status.portfolioLastSync);
const now = new Date();
const ageMinutes = (now - lastSync) / 1000 / 60;
return ageMinutes <= maxAgeMinutes;
}
const isFresh = await isDataFresh(address);
if (!isFresh) {
console.log('Data is stale, consider syncing');
}
Wait for sync to complete:async function waitForSync(address, timeoutSeconds = 60) {
const start = Date.now();
while (true) {
const response = await fetch(
`https://api.octav.fi/v1/status?addresses=${address}`,
{ headers: { 'Authorization': `Bearer ${apiKey}` } }
);
const [status] = await response.json();
if (!status.syncInProgress) {
console.log('Sync completed!');
return status;
}
if ((Date.now() - start) / 1000 > timeoutSeconds) {
throw new Error('Sync timeout');
}
await new Promise(resolve => setTimeout(resolve, 2000));
}
}
// Trigger sync then wait
await fetch('https://api.octav.fi/v1/sync-transactions', {
method: 'POST',
headers: {
'Authorization': `Bearer ${apiKey}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({ addresses: [address] })
});
await waitForSync(address);
Monitor multiple addresses:async function monitorAddresses(addresses) {
const addressList = addresses.join(',');
const response = await fetch(
`https://api.octav.fi/v1/status?addresses=${addressList}`,
{ headers: { 'Authorization': `Bearer ${apiKey}` } }
);
const statuses = await response.json();
statuses.forEach(status => {
const lastSync = new Date(status.transactionsLastSync);
const ageMinutes = (Date.now() - lastSync) / 1000 / 60;
console.log(`${status.address}:`);
console.log(` Last sync: ${ageMinutes.toFixed(1)} minutes ago`);
console.log(` Syncing: ${status.syncInProgress ? 'Yes' : 'No'}`);
});
return statuses;
}
const statuses = await monitorAddresses([
'0x123...',
'0x456...',
'0x789...'
]);
Best Practices
This endpoint costs 0 credits, so call it freely:
- Check before expensive operations
- Monitor sync status
- Verify data freshness
Understanding sync times:
- Portfolio: 1-minute cache
- Transactions: 10-minute cache
- Check
syncInProgress before triggering new sync
Query multiple addresses in one call:?addresses=0x123...,0x456...,0x789...
