Sommelier Finance API Information

Daily Data

A snapshot of a vault at midnight UTC.

Request Structure:

https://api.sommelier.finance/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 on the the snapshot.
• cellar_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.sommelier.finance/dailyData/ethereum/0xd33dAd974b938744dAC81fE00ac67cb5AA13958E/0/latest

https://api.sommelier.finance/dailyData/ethereum/0xb5b29320d2Dde5BA5BAFA1EbcD270052070483ec/1692921600/1693094400

Example Response:

{
  "Response": [
    {
        "block_number": 18002283,
        "cellar_address": "0xb5b29320d2Dde5BA5BAFA1EbcD270052070483ec",
        "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,
        "cellar_address": "0xb5b29320d2Dde5BA5BAFA1EbcD270052070483ec",
        "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.sommelier.finance/hourlyData/ethereum/0xd33dAd974b938744dAC81fE00ac67cb5AA13958E/0/latest

https://api.sommelier.finance/hourlyData/ethereum/0xb5b29320d2Dde5BA5BAFA1EbcD270052070483ec/1693087200/1693090800

TVL

Get the total value locked (TVL) across all cellars.

Request Structure:

https://api.sommelier.finance/tvl

Example Requests:

https://api.sommelier.finance/tvl

Example Response:

{
  "Response": {
    "total_tvl": 123456789.0,
    "eth-tvl": 98765432.1,
    "other-chain-tvl": 24681012.0
  }
}

Kelp Data

Get kelp data for a specific cellar.

Request Structure:

https://api.sommelier.finance/kelp/<chain>/<cellar_address>/<block_number>

Request Params:

• chain - The blockchain network (e.g., ethereum).
• cellar_address - The address of the cellar.
• block_number - The block number to get the kelp data for.

Example Request:

https://api.sommelier.finance/kelp/ethereum/0x1dffb366b5c5a37a12af2c127f31e8e0ed86bdbe/19971333

Example Response:

{
  "Response": {
    "0x1234567890abcdef1234567890abcdef12345678": 0.1234,
    "0xabcdef1234567890abcdef1234567890abcdef12": 0.5678
  }
}

Etherfi Data

Get etherfi data for a specific user or all users.

Request Structure:

https://api.sommelier.finance/etherfi/<network>/<user_address>

https://api.sommelier.finance/etherfi/<network>

Request Params:

• network - The blockchain network (e.g., ethereum).
• user_address - (Optional) The address of the user.

Example Request:

https://api.sommelier.finance/etherfi/ethereum/0x1234567890abcdef1234567890abcdef12345678

https://api.sommelier.finance/etherfi/ethereum

Example Response:

{
  "Response": {
    "address": "0x1234567890abcdef1234567890abcdef12345678",
    "eigenlayerPoints": 1000,
    "loyaltyPoints": 500
  }
}

Etherfi Balances

Get etherfi balances data for a specific block or the latest block.

Request Structure:

https://api.sommelier.finance/etherfi/<network>/balances/<block_number>

https://api.sommelier.finance/etherfi/<network>/balances

Request Params:

• network - The blockchain network (e.g., ethereum).
• block_number - (Optional) The block number to get the balances data for.

Example Request:

https://api.sommelier.finance/etherfi/ethereum/balances/19971333

https://api.sommelier.finance/etherfi/ethereum/balances

Example Response:

{
  "Response": {
    "balances": {
      "0x1234567890abcdef1234567890abcdef12345678": 0.1234,
      "0xabcdef1234567890abcdef1234567890abcdef12": 0.5678
    }
  }
}

Snapshot Data

Get a snapshot of data for a specific cellar.

Request Structure:

https://api.sommelier.finance/snapshot/<network>/<cellar_address>

Request Params:

• network - The blockchain network (e.g., ethereum).
• cellar_address - The address of the cellar.

Example Request:

https://api.sommelier.finance/snapshot/ethereum/0xb5b29320d2Dde5BA5BAFA1EbcD270052070483ec

Example Response:

{
  "Response": {
    "usd_tvl": 1234567.89,
    "base_asset_tvl": 9876.54321,
    "somm_price_usd": 2.34,
    "somm_per_day": 123.45,
    "somm_incentive_apy": 5.67
  }
}

All Cellars Daily Data

Get daily data for all cellars.

Request Structure:

https://api.sommelier.finance/dailyData/<network>/allCellars/<start_unix_timestamp>/<end_unix_timestamp>

Request Params:

• network - The blockchain network (e.g., ethereum).
• 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.

Example Request:

https://api.sommelier.finance/dailyData/ethereum/allCellars/1692921600/1693094400

Example Response:

{
  "Response": {
    "0xb5b29320d2Dde5BA5BAFA1EbcD270052070483ec": [
      {
        "block_number": 18002283,
        "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
      }
    ]
  }
}