Skip to content
Pipevest Developers

Individual Stock View

The individual stocks view contains the available operations/options for a given stock.

Accessing the individual stock view

Section titled “Accessing the individual stock view”
Terminal window
  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_5310deea137a9cd999b02ae68a7bbbec",
        "currentState": "SELECT_STOCK",
        "menu": {
            "state": "SELECT_STOCK",
            "text": "Apple Inc. (AAPL)\nPrice: ZK6058.00\nChange: $-0.53 (-0.20%)",
            "options": [
                {
                    "key": "1",
                    "label": "Buy",
                    "nextState": "BUY_STOCK"
                },
                {
                    "key": "2",
                    "label": "Details",
                    "nextState": "MORE_STOCK_DETAIL"
                },
                {
                    "key": "0",
                    "label": "Back",
                    "nextState": "STOCKS"
                }
            ],
            "isEndState": false
        },
        "ussdText": "Apple Inc. (AAPL)\nPrice: ZK6058.00\nChange: $-0.53 (-0.20%)\n\n1. Buy\n2. Details\n0. Back",
        "expiresAt": "2025-11-06T14:58:33.942Z"
    }
}
What the customer sees
Apple Inc. (AAPL)
Price: ZK6058.00
Change: $-0.53 (-0.20%)

1. Buy
2. Details
0. Back

Stocks View Example

Section titled “Stocks View Example”
USSD Individual Stock View

Check out an example of the ussd individual stock view