Get vault historical data

Fetch combined APY, TVL, and share-price history.

GEThttps://api-v2.syncrone.fi/api/catalog/historical/{network}/{vaultId}

APY, TVL and share price per point, oldest first.

Try it#

GET

/historical/mainnet/0x98C23E9d8f34FEFb1B7BD6a91B7FF122F4e16F5c?perPage=7&fromTimestamp=1790035200&toTimestamp=1790640000&granularity=1day&apyInterval=7day

API keyx-api-key

Kept in this browser tab only, and sent to Syncrone with each request. No key yet? Create one ↗

Example vaults

Parameters

networkpathrequired

vaultIdpathrequired

pagequery

perPagequery

fromTimestampquery

toTimestampquery

granularityquery

apyIntervalquery

Response

Paste an API key, then press Send. The parameters are pre-filled with a real example.

curl

curl "https://api-v2.syncrone.fi/api/catalog/historical/mainnet/0x98C23E9d8f34FEFb1B7BD6a91B7FF122F4e16F5c?perPage=7&fromTimestamp=1790035200&toTimestamp=1790640000&granularity=1day&apyInterval=7day" \
  -H "x-api-key: $SYNCRONE_API_KEY"

Example#

A real response to the pre-filled Try it request, recorded from Syncrone data. Values move with every indexing run.

200

GET /historical/mainnet/0x98C23E9d8f34FEFb1B7BD6a91B7FF122F4e16F5c?perPage=7&fromTimestamp=1790035200&toTimestamp=1790640000&granularity=1day&apyInterval=7day

{
  "itemsOnPage": 7,
  "nextPage": 1,
  "data": [
    {
      "timestamp": 1790035200,
      "blockNumber": "26029315",
      "apy": {
        "base": 0.039627723811949345,
        "reward": 0,
        "total": 0.039627723811949345
      },
      "tvl": {
        "usd": "2229556888",
        "native": "2229779866117466"
      },
      "sharePrice": 1.1865527191848566
    },
    {
      "timestamp": 1790121600,
      "blockNumber": "26036463",
      "apy": {
        "base": 0.04031720088026147,
        "reward": 0,
        "total": 0.04031720088026147
      },
      "tvl": {
        "usd": "2238883644",
        "native": "2239107555682230"
      },
      "sharePrice": 1.1866914072286456
    },
    {
      "timestamp": 1790208000,
      "blockNumber": "26043610",
      "apy": {
        "base": 0.04055513451119497,
        "reward": 0,
        "total": 0.04055513451119497
      },
      "tvl": {
        "usd": "2215698122",
        "native": "2215919714157352"
      },
      "sharePrice": 1.1868201736381487
    },
    {
      "timestamp": 1790294400,
      "blockNumber": "26050748",
      "apy": {
        "base": 0.04055261693289447,
        "reward": 0,
        "total": 0.04055261693289447
      },
      "tvl": {
        "usd": "2233251851",
        "native": "2233475198878785"
      },
      "sharePrice": 1.1869445413998565
    },
    {
      "timestamp": 1790380800,
      "blockNumber": "26057904",
      "apy": {
        "base": 0.04056883230223729,
        "reward": 0,
        "total": 0.04056883230223729
      },
      "tvl": {
        "usd": "2197902088",
        "native": "2198121901132660"
      },
      "sharePrice": 1.1870708848099985
    },
    {
      "timestamp": 1790467200,
      "blockNumber": "26065069",
      "apy": {
        "base": 0.04039966251598859,
        "reward": 0,
        "total": 0.04039966251598859
      },
      "tvl": {
        "usd": "2206938269",
        "native": "2207158985762319"
      },
      "sharePrice": 1.1871944308861433
    },
    {
      "timestamp": 1790553600,
      "blockNumber": "26072221",
      "apy": {
        "base": 0.04023782817275712,
        "reward": 0,
        "total": 0.04023782817275712
      },
      "tvl": {
        "usd": "2215711458",
        "native": "2215933051647722"
      },
      "sharePrice": 1.1873174035210805
    }
  ]
}

Parameters#

Name	Type	Description
networkpathrequired	`string`	Network name (`mainnet`, `base`, `arbitrum`…), CAIP-2 id (`eip155:1`) or chain id (`1`).
vaultIdpathrequired	`string`	Vault address (the share or receipt token, any case). A vault listed without an address is addressed by its `slug`.
pagequery	`integer`	Page number, starting from 0. default: 0
perPagequery	`integer`	Items per page, 1 to 1000. default: 50
fromTimestampquery	`integer`	Start of the period, Unix seconds, inclusive. default: 0
toTimestampquery	`integer`	End of the period, Unix seconds, inclusive. Defaults to now.
granularityquery	`string`1day \| 1week	Spacing of points. Vaults are indexed once a day at 00:00 UTC, so `1day` is the finest granularity. `1week` points fall on epoch-aligned weeks (Thursdays 00:00 UTC). default: 1day
apyIntervalquery	`string`1day \| 7day \| 30day	Trailing window of the APY at each point. Null until the vault has that much history. default: 7day

Response#

200 returns JSON with these fields. APY values are fractions (0.04 = 4%); timestamps are Unix seconds.

Field	Type	Description
itemsOnPage	`integer`	Number of items in `data`.
nextPage	`integer`	Next page number. Absent on the last page.
data[].timestamp	`integer`	Point time, Unix seconds.
data[].blockNumber	`string \| null`	Block the point was read at.
data[].apy	`object \| null`	APY over the `apyInterval` window ending at the point. Null until the vault is that old.
data[].apy.base	`number`	TVL-weighted share-price APY, fraction.
data[].apy.reward	`number`	Mean reward APY over the window: on-chain emissions plus counted off-chain programs (Merkl).
data[].apy.total	`number`	`base + reward`.
data[].tvl.usd	`string \| null`	TVL in USD, whole dollars.
data[].tvl.native	`string \| null`	TVL in the asset's base units (wei for an 18-decimal token).
data[].sharePrice	`number \| null`	Assets per share since the vault opened, a multiplier (Aave aUSDC ~1.19). Null on bars indexed before the field was stored.

Errors#

Status	Meaning
400	Invalid query or path parameter, or unknown network.
401	Missing or rejected API key.
404	No vault with this id on this network.
429	Too many requests from the docs playground. Wait a minute.
500	The service failed.

Error bodies carry error and, for invalid parameters, details.

← PreviousGet vault allocation Next →Get historical APY