API

Get all vaults

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.

get

/v1/vaults

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://points.mellow.finance/v1/vaults'

200

200

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

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

Get DeFi protocol integrations

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

get

/v1/defi/protocols

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://points.mellow.finance/v1/defi/protocols'

200

200

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

Successful response containing DeFi protocol integrations

Get user's vaults positions

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.

get

/v1/users/{user_address}

Path parameters

user_addressstringrequired

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

Example: 0x1234567890123456789012345678901234567890

Pattern: ^0x[a-fA-F0-9]{40}$

Responses

application/json

text/plain

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://points.mellow.finance/v1/users/{user_address}'

200

500

200

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

Successful response containing user's positions across all vaults

Get user's vaults DeFi positions

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

get

/v1/defi/users/{user_address}

Path parameters

user_addressstringrequired

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

Example: 0xDB611d682cb1ad72fcBACd944a8a6e2606a6d158

Pattern: ^0x[a-fA-F0-9]{40}$

Responses

application/json

text/plain

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://points.mellow.finance/v1/defi/users/{user_address}'

200

500

200

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

Successful response containing user's positions in DeFi protocols