API

Get all vaults

get

Retrieves comprehensive information about all available vaults in the Mellow Protocol ecosystem. Each vault represents a smart contract that manages liquidity across different DeFi protocols. The response includes vault configurations, associated tokens, current performance metrics, and operational parameters.

Responses
200
Successful response containing an array of all active vaults with their complete details
application/json
get
GET /v1/vaults HTTP/1.1
Host: points.mellow.finance
Accept: */*
200

Successful response containing an array of all active vaults with their complete details

[
  {
    "id": "ethereum-dvsteth",
    "chain_id": 1,
    "address": "0x5E362eb2c0706Bd1d134689eC75176018385430B",
    "symbol": "DVstETH",
    "decimals": 18,
    "name": "Decentralized Validator Vault",
    "layer": "lido_simple_dvt",
    "points": [
      {
        "id": "mellow",
        "value": "17049600.467"
      }
    ],
    "base_token": {
      "address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
      "symbol": "WETH",
      "decimals": 18
    },
    "underlying_tokens": [
      {
        "address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
        "symbol": "WETH",
        "decimals": 18
      }
    ],
    "deposit_tokens": [
      {
        "address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
        "symbol": "WETH",
        "decimals": 18
      }
    ],
    "withdraw_tokens": [
      {
        "address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
        "symbol": "WETH",
        "decimals": 18
      }
    ],
    "withdraw_avg_time_seconds": 345600,
    "collector": "0x240Fbe0790D5B25366BF88EE14AE8Dde72BfE312",
    "price": 3519.90723976,
    "apr": 2.886142857142857,
    "tvl_usd": 24991702.73953098,
    "tvl_base_token": "7177311992681062422621",
    "limit_usd": 48398724.54674784,
    "limit_base_token": "13899522963290482556503",
    "total_supply": "7100102655321765400668"
  }
]

Get DeFi protocol integrations

get

Retrieves information about all DeFi protocol integrations and their points distribution across different chains.

Responses
200
Successful response containing DeFi protocol integrations
application/json
get
GET /v1/defi/protocols HTTP/1.1
Host: points.mellow.finance
Accept: */*
200

Successful response containing DeFi protocol integrations

[
  {
    "chain_id": 48900,
    "vault_address": "0x5fD13359Ba15A84B76f7F87568309040176167cd",
    "defi_protocol_address": "0x7d8311839eB44Dd5194abd2dd3998722455A24E0_0x9eFdE41A87fa4dD47BAa584954e8Abd5b8bdBfE7",
    "user_mellow_points": "6223.551000000001",
    "user_symbiotic_points": "6223.549319787699",
    "user_referal_points": "0.0",
    "user_vault_balance": "5035533496859123083549",
    "name": "inwstETHs amphrETH",
    "protocol": "Zircuit",
    "pool_id": "pool-zircuit-l2-staking-inwsteths-amphreth",
    "url": "https://app.zircuit.com/liquidity-hub",
    "boost": "2"
  }
]

Get user's vaults positions

get

Retrieves detailed information about a specific user's positions across all Mellow Protocol vaults. This includes their liquidity provisions, earned profits, and current holdings as a Liquidity Provider.

Path parameters
user_addressstringRequired

Ethereum address of the user (must be a valid Ethereum address)

Example: 0x1234567890123456789012345678901234567890Pattern: ^0x[a-fA-F0-9]{40}$
Responses
200
Successful response containing user's positions across all vaults
application/json
get
GET /v1/users/{user_address} HTTP/1.1
Host: points.mellow.finance
Accept: */*
[
  {
    "chain_id": 1,
    "user_address": "0x7F43fDe12A40dE708d908Fb3b9BFB8540d9Ce444",
    "user_mellow_points": "0",
    "user_symbiotic_points": "0",
    "user_referal_points": "0",
    "user_vault_balance": 10000000000000,
    "timestamp": 1737151835,
    "vault_address": "0x7F43fDe12A40dE708d908Fb3b9BFB8540d9Ce444"
  }
]

Get user's vaults DeFi positions

get

Retrieves detailed information about a user's positions across all integrated DeFi protocols, including points earned, balances, and protocol-specific details.

Path parameters
user_addressstringRequired

Ethereum address of the user (must be a valid Ethereum address)

Example: 0xDB611d682cb1ad72fcBACd944a8a6e2606a6d158Pattern: ^0x[a-fA-F0-9]{40}$
Responses
200
Successful response containing user's positions in DeFi protocols
application/json
get
GET /v1/defi/users/{user_address} HTTP/1.1
Host: points.mellow.finance
Accept: */*
[
  {
    "chain_id": 1,
    "vault_address": "0x4f3Cc6359364004b245ad5bE36E6ad4e805dC961",
    "defi_protocol_address": "0x104b3E3ACD2396a7292223B5778Ea1caCdB68ec9",
    "user_mellow_points": "94678.511",
    "user_symbiotic_points": "92911.0138859653",
    "user_referal_points": "0.0",
    "user_vault_balance": "0",
    "timestamp": 1737403835,
    "name": "urLRT / wstETH",
    "protocol": "Uniswap v3",
    "pool_id": "pool-uniswap-urlrt-wsteth",
    "url": "https://app.uniswap.org/explore/pools/ethereum/0x104b3E3ACD2396a7292223B5778Ea1caCdB68ec9",
    "boost": "3"
  }
]

Last updated