Get suggestions

Retrieve metric recommendations based on a specified wallet address

Description

This endpoint facilitates obtaining metric suggestions for a list of wallet addresses. Leveraging the Debank API, it retrieves asset holdings and positions for the aggregations of the address list, generating metric recommendations for all supported assets within the list. Users have the option to filter out minor positions, focusing solely on suggestions for the most significant assets.

Endpoint

GET https://sentry.aleno.ai/suggestions

Query parameters

Name	required	Type	Description
addresses	required	string list	A list of portfolios for which metric suggestions are sought.
assetUsdThreshold	optional	number	Specifies the minimum asset holding size, measured in USD, necessary for the asset to be considered for inclusion in the suggestions. The default value is set to 100 USD.
positionUsdThreshold	optional	number	Specifies the minimum position size, measured in USD, necessary for the position to be considered for inclusion in the suggestions. The default value is set to 100 USD.
chainId	optional	string	Id of the considered chain. The default value is set to "eth".

Payload

No payload.

CURL example

Curl

curl -X GET \
  'https://sentry.aleno.ai/suggestions?addresses=0x634B41C246F9afCE16dE397424704130b588139f' \
  -H 'Authorization: YOUR_API_KEY'

Result

Returns a list of Metric objects representing suggested metrics for the aggregated address list.

It also returns a list of Assets as :

Name	Type	Description
tokenAddresses	string	Address of the asset
amount	number	amount of token held
usdAmount	number	amount of token held in USD

and a list of Positions for the aggregated wallet as :

Name	Type	Description
tokenAddresses	string	Address of the token in the position
amount	number	amount of token held in the position
usdAmount	number	amount of token held in the position in USD
contractAddress	string	contract address where the position is held
positionType	string	type of the position
protocolId	string	Id of the protocol as returned by debank
protocolName	string	Name of the protocol

{
    "data": {
        "metrics": [
            {
                "key": "token_total_tvl_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                "type": "token_total_tvl",
                "name": "WETH total tvl",
                "info": {
                    "token": {
                        "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                        "name": "Wrapped Ether",
                        "symbol": "WETH",
                        "decimals": 18,
                        "isTracked": true
                    }
                }
            },
            {
                "key": "token_total_supply_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                "type": "token_total_supply",
                "name": "WETH total supply",
                "info": {
                    "token": {
                        "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                        "name": "Wrapped Ether",
                        "symbol": "WETH",
                        "decimals": 18,
                        "isTracked": true
                    }
                }
            },
            ...
        ],
        "assets": [
            {
                "tokenAddress": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                "amount": 0.6843785711644949,
                "usdAmount": 2363.7546155879136
            },
            ...
        ],
        "positions": [
            {
                "protocolId": "uniswap3",
                "protocolName": "Uniswap V3",
                "positionType": "Liquidity Pool",
                "contractAddress": "0x127452f3f9cdc0389b0bf59ce6131aa3bd763598",
                "tokenAddress": "eth",
                "amount": 27.681389081545227,
                "usdAmount": 95607.9193070766
            },
            ...
        ],
    }
}