Seven Seas Capital API Information

Daily Data

A snapshot of a vault at midnight UTC.

Request Structure:

https://api.sevenseas.capital/dailyData/<network>/<vault_address>/<start_unix_timestamp>/<end_unix_timestamp>

Request Params:

• network - The network the vault is on. Currently supports: ethereum.
• vault_address - The address of the vault you want data for.
• start_unix_timestamp - The unix timestamp of the start of the data you want.
• end_unix_timestamp - The unix timestamp of the end of the data you want. You can replace this with the word latest to get all of the data up to the present time.

Response Params:

• block_number - Block number of the snapshot.
• vault_address - Address of the vault.
• daily_apy - APY of the vault on that day (note this are already decimal adjusted, so a value of 13.5 indicates 13.5% APY) .
• price_usd - Price of the base asset of the vault in USD at the timestamp.
• share_price - Share price of the vault at the timestamp.
• timestamp - Human readable datetime of the snapshot.
• total_assets - Decimal adjusted TVL in terms of the base asset (e.g. for Real Yield ETH a value of 10000.0 would indicate 10,000 units of WETH in TVL).
• tvl - USD denominated TVL of the vault (e.g. for Real Yield ETH a value of 10000000.0 would indicate $10,000,000 worth of TVL).
• unix_seconds - The timestamp of the snapshot in unix seconds.

Example Requests:

https://api.sevenseas.capital/dailyData/ethereum/0xdAdC82e26b3739750E036dFd9dEfd3eD459b877A/0/latest

https://api.sevenseas.capital/dailyData/ethereum/0xdAdC82e26b3739750E036dFd9dEfd3eD459b877A/1692921600/1693094400

Example Response:

{
  "Response": [
    {
        "block_number": 18002283,
        "vault_address": "0xdAdC82e26b3739750E036dFd9dEfd3eD459b877A",
        "daily_apy": 75.01029330056662,
        "price_usd": "1646.089999999999918145476840436458587646484375",
        "share_price": 1.0342082927801795,
        "timestamp": "Sun, 27 Aug 2023 00:00:00 GMT",
        "total_assets": "7709.674497742499402588",
        "tvl": "12690818.09398895021053435119",
        "unix_seconds": 1693094400
    },
    {
        "block_number": 17995139,
        "vault_address": "0xdAdC82e26b3739750E036dFd9dEfd3eD459b877A",
        "daily_apy": -15.439423963983618,
        "price_usd": "1653.26267000000007101334631443023681640625",
        "share_price": 1.0320829155918145,
        "timestamp": "Sat, 26 Aug 2023 00:00:00 GMT",
        "total_assets": "7690.050064043300642797",
        "tvl": "12713672.70131389876241947286",
        "unix_seconds": 1693008000
    }
}

Hourly Data

Hourly snapshots of a vault. All parameters are exactly the same as that of the daily data endpoint above, aside from the response not including an APY and the request path being hourlyData instead of dailyData.

Example Requests:

https://api.sevenseas.capital/hourlyData/ethereum/0xdAdC82e26b3739750E036dFd9dEfd3eD459b877A/0/latest

https://api.sevenseas.capital/hourlyData/ethereum/0xdAdC82e26b3739750E036dFd9dEfd3eD459b877A/1693087200/1693090800

Historical Performance

Daily aggregated apy performance and composition of a vault by protocol.

Request Structure:

https://api.sevenseas.capital/apy/<network>/<vault_address>

Request Params:

• network - The network the vault is on. Currently supports: ethereum.
• vault_address - The address of the vault you want data for.

Response Params:

• address - Address of the vault.
• block_number - Block number of the snapshot.
• timestamp - The timestamp of the snapshot formatted in human readable time, i.e. Thu, 13 Jun 2024 00:00:00 GMT
• apy - Daily APY of each protocols being used by the vault on that day in decimal, i.e. a value of 0.13 means 13% APY.
• 7_day_apy - Average daily apy of each protocol being used by the vault over the previous 7 days.
• 14_day_apy - Average daily apy of each protocol being used by the vault over the previous 14 days.
• 30_day_apy - Average daily apy of each protocol being used by the vault over the previous 30 days.
• allocation - Allocation of vault assets across protocols in decimal.

Example Requests:

https://api.sevenseas.capital/apy/ethereum/0xdAdC82e26b3739750E036dFd9dEfd3eD459b877A

Example Response:

{
    "Response": [
        {
            "address": "0xdAdC82e26b3739750E036dFd9dEfd3eD459b877A",
            "block": 20079185,
            "timestamp": "Thu, 13 Jun 2024 00:00:00 GMT",
            "apy": {
                "aavev3": 0.0469917703545692,
                "pendle": 0.017247368232903664,
                "univ3": 0.037647448553013226
            },
            "7_day_apy": {
                "aavev3": 0.04365619008363107,
                "pendle": 0.1501284105913717,
                "univ3": 0.042652390471503814
            },
            "14_day_apy": {
                "aavev3": 0.05133998547873105,
                "pendle": 0.15526280349825103,
                "univ3": 0.03815445472921643
            },
            "30_day_apy": {
                "aavev3": 0.0484723663688657,
                "pendle": 0.15440402906962616,
                "univ3": 0.04191734543974198
            },
            "allocation": {
                "aavev3": 0.26,
                "pendle": 0.50,
                "univ3": 0.24
            }
        }, ...
    ]
}
        

Vault Description

Vault description including the protocols used by the vault

Request Structure:

https://api.sevenseas.capital/vault/<network>/<vault_address>

Request Params:

• network - The network the vault is on. Currently supports: ethereum.
• vault_address - The address of the vault you want data for.

Response Params:

• vault_address - Address of the vault.
• protocols - List of protocols used by vault with relevant information (name, logo, etc.)

Example Requests:

https://api.sevenseas.capital/vault/ethereum/0xdAdC82e26b3739750E036dFd9dEfd3eD459b877A

Example Response:

{
    "protocols":[
       {
            "display_name":"Pendle",
            "id":"pendle",
            "logo":{
                "png":"https://content.sevenseas.capital/protocol/pendle/pendle-icon.png",
                "svg":"https://content.sevenseas.capital/protocol/pendle/pendle-icon.svg"
            }
        }
    ],
    "vault_address":"0x917ceE801a67f933F2e6b33fC0cD1ED2d5909D88"
}