Assets Menu View

The assets menu view allows users to review and interact with the assets that they currently own.

Accessing the Assets View

  curl --request POST \
    --url https://api.staging.pipevest.com/v1/ussd/process \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Bearer <access-token>' \
    --header 'x-client-id: <client-id>' \
    --data '{"sessionId": "<session-id>", "choice": "1"}'

Example Response

{
    "message": "USSD request processed successfully",
    "data": {
        "sessionId": "ussd_2231df057f1f8f5269f0a268249ac104",
        "currentState": "VIEW_ASSETS",
        "menu": {
            "state": "VIEW_ASSETS",
            "text": "My Assets:\n\nTotal: ZK1012.97\nChange: +1.12%\n\nSelect asset to view details:\n",
            "options": [
                {
                    "key": "1",
                    "label": "Apple Inc. - ZK592.45",
                    "nextState": "ASSET_DETAIL",
                    "data": {
                        "assetId": "cmhkp4jkw0005zxfok9m0kiwg",
                        "symbol": "AAPL",
                        "name": "Apple Inc."
                    }
                },
                {
                    "key": "2",
                    "label": "Tesla Inc. - ZK420.52",
                    "nextState": "ASSET_DETAIL",
                    "data": {
                        "assetId": "cmhkp4km20009zxfoyv85kkij",
                        "symbol": "TSLA",
                        "name": "Tesla Inc."
                    }
                },
                {
                    "key": "0",
                    "label": "Back to Portfolio",
                    "nextState": "MY_PORTFOLIO"
                }
            ],
            "isEndState": false
        },
        "ussdText": "My Assets:\n\nTotal: ZK1012.97\nChange: +1.12%\n\nSelect asset to view details:\n\n\n1. Apple Inc. - ZK592.45\n2. Tesla Inc. - ZK420.52\n0. Back to Portfolio",
        "expiresAt": "2025-11-10T14:56:05.356Z"
    }
}

What the customer sees

My Assets:

Total: ZK1012.97
Change: +1.12%

Select asset to view details:


1. Apple Inc. - ZK592.45
2. Tesla Inc. - ZK420.52
0. Back to Portfolio

Viewing individual asset

Assets View Example

USSD Assets View

Check out an example of the ussd assets view