Bamboo Invest · Schema

Portfolio response

InvestmentsStocksFractional SharesAfricaNigeriaPortfolio ManagementBrokerageFintech

Properties

Name Type Description
withdrawal_cash integer Withdrawal cash
withdraw_details array withdraw details
value_percent_change integer Equity value percent change
value_change integer Equity value change
value integer Portfolio value cash + equity value
user_currency_to_usd integer User currency to USD exchange rate
user_currency_symbol string User currency symbol based on residence country
usd_to_user_currency integer USD to user currency exchange rate
usd_to_naira integer USD to Naira exchange rate
extended_hours_status string Indicates the user's extended hours trading status. - `null`: Returned for existing users or when `extended_hours_opt_in` was not included during onboarding. - `ENABLED`: Returned when the user's brok
unsettled_cash integer The amount of Unsettled cash a user has after stock sale
total_cash integer Total cash
residence_country string Residence country of user: GHA, NGA or KEN
reserved_cash integer Reserved cash (mostly unsettled cash)
referral_cashback_blocked_value integer Non-withdrawal referral cashback until after 30 days
processing_withdrawal integer Processing withdrawal money
processing_gift_sent integer Processing gift sent
processing_gift_received integer Processing gift received
pending_deposit integer Pending deposit money
naira_to_usd integer Naira to USD exchange rate
dollar_cash integer Cash available to invest aka buying power always in $
dollar_balance integer dollar balance
currency_symbol string Prices currency symbol
currency_name string Naira, Shilling or Cedi
currency_code string NGN, KES or GHS
cash number Total cash in user's brokerage account. (Also the cash available for user to invest aka buying power)
carrot_held_value number Carrot held value most likely for liquidation
base_wallet_balance number Base wallet Balance
actual_value number Total sum of a user's portfolio. i.e, a sum of the amount of US Stocks they own, amount in unsettled cash and amount in their brokerage account
account_restricted boolean Account restricted
View JSON Schema on GitHub

JSON Schema

portfolioresponse.json Raw ↑
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://api.investbamboo.com/schemas/PortfolioResponse",
  "title": "Portfolio response",
  "required": [
    "account_restricted",
    "actual_value",
    "base_wallet_balance",
    "carrot_held_value",
    "cash",
    "currency_code",
    "currency_name",
    "currency_symbol",
    "dollar_balance",
    "dollar_cash",
    "naira_to_usd",
    "pending_deposit",
    "processing_gift_received",
    "processing_gift_sent",
    "processing_withdrawal",
    "referral_cashback_blocked_value",
    "reserved_cash",
    "residence_country",
    "total_cash",
    "unsettled_cash",
    "usd_to_naira",
    "extended_hours_status",
    "usd_to_user_currency",
    "user_currency_symbol",
    "user_currency_to_usd",
    "value",
    "value_change",
    "value_percent_change",
    "withdraw_details",
    "withdrawal_cash"
  ],
  "type": "object",
  "properties": {
    "withdrawal_cash": {
      "type": "integer",
      "description": "Withdrawal cash",
      "example": 0
    },
    "withdraw_details": {
      "type": "array",
      "description": "withdraw details",
      "items": {
        "title": "withdraw details response",
        "type": "object",
        "properties": {
          "country": {
            "type": "string",
            "description": "country required for mobile money details i.e only for GHA users",
            "example": "Nigeria"
          },
          "name": {
            "type": "string",
            "description": "name required for mobile money details i.e only for GHA users",
            "example": "John"
          },
          "network": {
            "type": "string",
            "description": "network required for mobile money details i.e only for GHA users"
          },
          "phone_number": {
            "type": "string",
            "description": "phone_number required for mobile money details i.e only for GHA users"
          },
          "user_id": {
            "type": "integer",
            "description": "user_id required for mobile money details i.e only for GHA users"
          },
          "bank_code": {
            "type": "string",
            "description": "bank_code for bank details i.e for NGA users"
          },
          "bank_fw_id": {
            "type": "string",
            "description": "bank_fw_id required for bank details i.e for NGA users"
          },
          "bank_name": {
            "type": "string",
            "description": "bank_name required for bank details i.e for NGA users",
            "example": "Sterling Bank"
          },
          "account_number": {
            "type": "string",
            "description": "account_number required for bank details i.e for NGA users",
            "example": "0211873910"
          },
          "beneficiary_name": {
            "type": "string",
            "description": "beneficiary_name for bank details i.e for NGA users",
            "example": "John Doe"
          }
        }
      }
    },
    "value_percent_change": {
      "type": "integer",
      "description": "Equity value percent change",
      "example": 0
    },
    "value_change": {
      "type": "integer",
      "description": "Equity value change",
      "example": 0
    },
    "value": {
      "type": "integer",
      "description": "Portfolio value cash + equity value",
      "example": 0
    },
    "user_currency_to_usd": {
      "type": "integer",
      "description": "User currency to USD exchange rate",
      "example": 0.001152073732718894
    },
    "user_currency_symbol": {
      "type": "string",
      "description": "User currency symbol based on residence country",
      "example": "\u20a6"
    },
    "usd_to_user_currency": {
      "type": "integer",
      "description": "USD to user currency exchange rate",
      "example": 868
    },
    "usd_to_naira": {
      "type": "integer",
      "description": "USD to Naira exchange rate",
      "example": 868
    },
    "extended_hours_status": {
      "type": "string",
      "enum": [
        "ENABLED",
        "DISABLED"
      ],
      "nullable": true,
      "description": "Indicates the user's extended hours trading status.\n- `null`: Returned for existing users or when `extended_hours_opt_in` was not included during onboarding.\n- `ENABLED`: Returned when the user's brokerage account is successfully created or they later opt in via the extended_hours opt_in endpoint.\n- `DISABLED`: Returned when the user opts out via the extended_hours opt_in endpoint.\n"
    },
    "unsettled_cash": {
      "type": "integer",
      "description": "The amount of Unsettled cash a user has after stock sale",
      "example": 0
    },
    "total_cash": {
      "type": "integer",
      "description": "Total cash",
      "example": 0
    },
    "residence_country": {
      "type": "string",
      "description": "Residence country of user: GHA, NGA or KEN",
      "example": "NGA"
    },
    "reserved_cash": {
      "type": "integer",
      "description": "Reserved cash (mostly unsettled cash)",
      "example": 0
    },
    "referral_cashback_blocked_value": {
      "type": "integer",
      "description": "Non-withdrawal referral cashback until after 30 days",
      "example": 0
    },
    "processing_withdrawal": {
      "type": "integer",
      "description": "Processing withdrawal money",
      "example": 0
    },
    "processing_gift_sent": {
      "type": "integer",
      "description": "Processing gift sent",
      "example": 0
    },
    "processing_gift_received": {
      "type": "integer",
      "description": "Processing gift received",
      "example": 0
    },
    "pending_deposit": {
      "type": "integer",
      "description": "Pending deposit money",
      "example": 0
    },
    "naira_to_usd": {
      "type": "integer",
      "description": "Naira to USD exchange rate",
      "example": 0.001152073732718894
    },
    "dollar_cash": {
      "type": "integer",
      "description": "Cash available to invest aka buying power always in $",
      "example": 0
    },
    "dollar_balance": {
      "type": "integer",
      "description": "dollar balance",
      "example": 0
    },
    "currency_symbol": {
      "type": "string",
      "description": "Prices currency symbol",
      "example": "\u20a6"
    },
    "currency_name": {
      "type": "string",
      "description": "Naira, Shilling or Cedi",
      "example": "Nigerian Naira"
    },
    "currency_code": {
      "type": "string",
      "description": "NGN, KES or GHS",
      "example": "NGN"
    },
    "cash": {
      "type": "number",
      "description": "Total cash in user's brokerage account. (Also the cash available for user to invest aka buying power)",
      "example": 0
    },
    "carrot_held_value": {
      "type": "number",
      "description": "Carrot held value most likely for liquidation",
      "example": 0
    },
    "base_wallet_balance": {
      "type": "number",
      "description": "Base wallet Balance",
      "example": 0
    },
    "actual_value": {
      "type": "number",
      "description": "Total sum of a  user's portfolio. i.e, a sum of the amount of US Stocks they own, amount in unsettled cash and amount in their brokerage account",
      "example": 0
    },
    "account_restricted": {
      "type": "boolean",
      "description": "Account restricted",
      "example": false
    }
  }
}