The individual asset menu view allows users to general asset performance, more detailed stock information and transaction history.

Accessing the Assets View

  curl --request GET \
    --url https://api.staging.pipevest.com/v1/ussd/assets?customerId=123456&assetId=123456
    --header 'Authorization: Bearer 123456' \
    --header 'Signature: sig1=:OTEyMjY4...A5NTNDMEQ=:' \
    --header 'Signature-Input: sig1=("Authorization" "X-Client-Id" "@method" "@target-uri" "@path" "@query");keyid="staging-pipevest-ed25519";created=1732893484;expires=1732893584' \
    --header 'X-Client-Id: 123456' \

Example Response

{
  "data": {
    "ussdMessage": "Apple (APPL)\n Own: 550ZK Yield: +5.50%\n 1.More Stock Details\n 2.Asset Transaction History\n 3. Sell Asset\n 4 .Back",
    "ussdOptions": [
      {
        "option": 1,
        "requestUrl": "https://api.staging.pipevest.com/v1/ussd/stocks?customerId=123456&symbol=AAPL&detailMode=true",
        "requestType": "GET"
      },
      {
        "option": 2,
        "requestUrl": "https://api.staging.pipevest.com/v1/ussd/transactions?customerId=123456&assetId=123456",
        "requestType": "GET"
      },
      {
        "option": 3,
        "requestUrl": "https://api.staging.pipevest.com/v1/ussd/requests?customerId=123456&symbol=AAPL&orderType=SELL",
        "requestType": "POST"
      },
      {
        "option": 4,
        "requestUrl": "https://api.staging.pipevest.com/v1/ussd/assets?customerId=123456",
        "requestType": "GET"
      }
    ]
  },
  "code": 200,
  "message": "Success"
}

Viewing asset transactions

Enabling detail mode

See the guide on enabling detail mode

Creating a sell order request

See the guide on order requests

Query parameters

queryDefinitionRequired
customerIdThe unique customer identiferYes
assetIdThe unique asset identiferYes

Assets View Example

USSD Individual Assets View

Check out an example of the ussd individual asset view