Data freshness

All addresses data we provided are synced on demand. It means that the first time you will load an address, if we dont have any data for this address we'll sync it.

Portfolio data

The portfolio is updated on demand and the cache time is 10 min. If you call the portfolio endpoint and the data is fresh (last sync <10 min) we'll return you the cached data. If the portfolio is stale (last time > 10 min) we'll return you the cached data and sync the portfolio in the background. Next time you will call the portfolio we'll return you the fresh data (if the sync is over). If you prefer to wait for the sync and always get the fresh data, you can set the waitForSync param to true on the request. Calls on the portfolio endpoint only trigger the portoflio sync (not the transactions).

Transactions data

The transactions data are updated on demand and the cache time is 10 min. If you call the transactions endpoint and the data is fresh (last sync <10 min) we'll return you the cached data.

If the data are stale (last sync > 10 min), a call on the transactions endpoint will trigger the transactions sync and the cached data will be returned until the synchronization is done.

As we sync addresses on demand, the first time you call the transactions endpoint, it's possible that we return you an empty array (we're syncing). You can check the sync status with the Statusendpoint.

Sync Status

At any moment, you can check the status of an address by calling the Status endpoint. If the last sync time is > 10 min, a call on this endpoint will automatically trigger the full sync process (Transactions + Portfolio). During the sync, all endpoint will return you the cached data until the sync process is over.