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.
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.
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}$
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}$
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