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

/v1/vaults

HTTPcURLJavaScriptPython

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

/v1/defi/protocols

HTTPcURLJavaScriptPython

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

500

Internal server error

text/plain

get

/v1/users/{user_address}

HTTPcURLJavaScriptPython

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

500

Internal server error

text/plain

get

/v1/defi/users/{user_address}

HTTPcURLJavaScriptPython

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"
  }
]