API
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.
Successful response containing an array of all active vaults with their complete details
GET /v1/vaults HTTP/1.1
Host: points.mellow.finance
Accept: */*
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"
}
]
Retrieves information about all DeFi protocol integrations and their points distribution across different chains.
Successful response containing DeFi protocol integrations
GET /v1/defi/protocols HTTP/1.1
Host: points.mellow.finance
Accept: */*
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"
}
]
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.
Ethereum address of the user (must be a valid Ethereum address)
0x1234567890123456789012345678901234567890
Pattern: ^0x[a-fA-F0-9]{40}$
Successful response containing user's positions across all vaults
Internal server error
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"
}
]
Retrieves detailed information about a user's positions across all integrated DeFi protocols, including points earned, balances, and protocol-specific details.
Ethereum address of the user (must be a valid Ethereum address)
0xDB611d682cb1ad72fcBACd944a8a6e2606a6d158
Pattern: ^0x[a-fA-F0-9]{40}$
Successful response containing user's positions in DeFi protocols
Internal server error
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