Bamboo is an African investment platform providing REST APIs for fractional stock investing, dollar investments, portfolio management, and access to US and Nigerian capital markets. The APIs enable fintech partners to integrate brokerage account creation, money movement, stock trading, and portfolio tracking into their own financial services applications.
Bamboo Invest publishes 21 APIs on the APIs.io network, including Account Management API, Authentication API, Deposits API, and 18 more. Tagged areas include Investments, Stocks, Fractional Shares, Africa, and Nigeria.
The Bamboo Invest catalog on APIs.io includes 1 Spectral governance ruleset.
Bamboo Invest’s developer surface includes documentation, engineering blog, pricing, and 10 more developer resources.
Account creation enables users to invest on Bamboo. Ensure KYC has been completed and each user’s identity verified before creating a brokerage account. **Best Practice:** To av...
Before you start making requests, you’ll need to generate an access token. Every request to the API must be authenticated using access tokens and user context headers — this ens...
Deposits fund user brokerage accounts for stock purchases. All deposits require verification through your webhook endpoint before funds are credited. On the
The exchange rate section provides you with an endpoint that fetches real-time exchange rates effortlessly, enabling accurate currency conversions and financial calculations.
Stocks are grouped into various categories which help users explore and filter stocks based on common themes, sectors, or other criteria. The endpoints in this section allow you...
Access various financial documents required for user account management, tax reporting, and regulatory compliance through secure document retrieval endpoints. ##### Document Typ...
The market activity section provides you with endpoints that return the opening and closing times for markets we support, allowing you to check when market is open/closed. This ...
The stock trading section details all the endpoints needed to calculate and make trade orders for all NG stock available on Bamboo. Please note that trade charges are applicable...
The user's portfolio provides comprehensive views of investment performance, cash positions, and account status. Understanding the different cash types and portfolio calculation...
The section provides comprehensive information about available US stocks, including real-time pricing, company details, and market data. Stock themes also help users discover in...
Users can buy and sell US securities, with support for multiple order types and fractional shares. Understanding order calculations, execution timing, and fees is crucial for in...
Withdrawals allow users to extract funds from their brokerage accounts after successful trades. Understanding the settlement timeline is essential. #### Settlement Timeline - St...
aid: bamboo
name: Bamboo Invest
description: Bamboo is an African investment platform providing REST APIs for fractional stock investing, dollar investments,
portfolio management, and access to US and Nigerian capital markets. The APIs enable fintech partners to integrate brokerage
account creation, money movement, stock trading, and portfolio tracking into their own financial services applications.
accessModel:
pricing: unknown
onboarding: unknown
trial: false
try_now: false
public: false
label: Unknown
confidence: low
source:
- plans
generated: '2026-07-22'
method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/bamboo.png
url: https://raw.githubusercontent.com/api-evangelist/bamboo/refs/heads/main/apis.yml
created: '2026-06-13'
modified: '2026-06-13'
specificationVersion: '0.19'
tags:
- Investments
- Stocks
- Fractional Shares
- Africa
- Nigeria
- Portfolio Management
- Brokerage
- Fintech
apis:
- aid: bamboo:bamboo-account-management-api
name: Bamboo Invest Account Management API
description: "Account creation enables users to invest on Bamboo. Ensure KYC has been completed and each user’s identity\
\ verified before creating a brokerage account.\n\n**Best Practice:** To avoid maintenance fees on inactive accounts,\
\ create and fund brokerage accounts **only when users initiate their first trade**. You may collect account details in\
\ advance but delay sending the request until they’re ready to buy.\n\n##### Prerequisites\n- **Minimum Age:** 18 years\
\ (verified via government-issued ID)\n- **Compliance:** Must meet local investment regulations\n\n##### Document Requirements\n\
<table>\n <thead>\n <tr>\n <th>Country</th>\n <th>Primary ID</th>\n <th>Image Requirements</th>\n \
\ </tr>\n </thead>\n <tbody>\n <tr>\n <th>Nigeria</th>\n <td>BVN</td>\n <td>Passport photo</td>\n\
\ </tr>\n <tr>\n <th>Ghana</th>\n <td>National ID</td>\n <td>Front & back ID images</td>\n </tr>\n\
\ <tr>\n <th>South Africa</th>\n <td>National ID</td>\n <td>Front & back ID images</td>\n </tr>\n\
\ </tbody>\n</table>\n\n**Note:** Images must be in Base64 format. The `front_id_image` and `back_id_image` fields apply\
\ only to Ghana and South Africa.\n\n##### Phone Number Format\n- Must be in international format (e.g., +2347083864023)\n\
- Country code must match user’s residence\n- Used for notifications and account security"
humanURL: https://docs.investbamboo.com/
baseURL: https://api.investbamboo.com
tags:
- Account Management
properties:
- type: OpenAPI
url: openapi/bamboo-account-management-api-openapi.yml
- type: Documentation
url: https://docs.investbamboo.com/
- aid: bamboo:bamboo-authentication-api
name: Bamboo Invest Authentication API
description: "Before you start making requests, you’ll need to generate an access token. Every request to the API must be\
\ authenticated using access tokens and user context headers — this ensures secure and authorized access to your resources.\n\
\nHere are a few quick tips to help you integrate smoothly and keep your tokens active:\n - **x-client-token:** A tenant-level\
\ access token that expires after 24 hours. You can generate\nup to 3 tokens per hour. - **Refresh Strategy:** Generate\
\ a new token before the current one expires to keep your requests running without interruption.\n\nEach endpoint’s required\
\ headers are outlined throughout this documentation, so you always know what’s needed to make a successful call."
humanURL: https://docs.investbamboo.com/
baseURL: https://api.investbamboo.com
tags:
- Authentication
properties:
- type: OpenAPI
url: openapi/bamboo-authentication-api-openapi.yml
- type: Documentation
url: https://docs.investbamboo.com/
- aid: bamboo:bamboo-deposits-api
name: Bamboo Invest Deposits API
description: "Deposits fund user brokerage accounts for stock purchases. All deposits require verification through your\
\ webhook endpoint before funds are credited.\n\nOn the <a href=\"#tag/US-Stock-Portfolio/operation/Web.Api.PortfolioController.portfolio\"\
>Portfolio endpoint</a>, different cash fields serve specific purposes as explained below:\n<table>\n <thead>\n <tr>\n\
\ <th>Field</th>\n <th>Description</th>\n </tr>\n </thead>\n <tbody>\n <tr>\n <th>cash</th>\n \
\ <td>Total cash in the user's brokerage account available for investment (buying power). Includes\ndeposits, stock\
\ sales, cancelled and rejected trades.</td>\n </tr>\n <tr>\n <th>unsettled_cash</th>\n <td>Funds from\
\ stock sales pending settlement; not yet available for withdrawal.</td>\n </tr>\n <tr>\n <th>withdrawal_cash</th>\n\
\ <td>Settled funds available for withdrawal from the user brokerage account.</td>\n </tr>\n <tr>\n <th>actual_value</th>\n\
\ <td>Total portfolio value, calculated as sum of US stock holdings, unsettled_cash, and cash\nbalance.</td>\n \
\ </tr>\n </tbody>\n</table>\n\n**Note:** Your `withdrawal_cash` and `unsettled_cash` are components within your total\
\ cash balance. But those fields are used to specifically distinguish between cash settled/unsettled for withdrawal."
humanURL: https://docs.investbamboo.com/
baseURL: https://api.investbamboo.com
tags:
- Deposits
properties:
- type: OpenAPI
url: openapi/bamboo-deposits-api-openapi.yml
- type: Documentation
url: https://docs.investbamboo.com/
- aid: bamboo:bamboo-exchange-rate-api
name: Bamboo Invest Exchange Rate API
description: The exchange rate section provides you with an endpoint that fetches real-time exchange rates effortlessly,
enabling accurate currency conversions and financial calculations.
humanURL: https://docs.investbamboo.com/
baseURL: https://api.investbamboo.com
tags:
- Exchange Rate
properties:
- type: OpenAPI
url: openapi/bamboo-exchange-rate-api-openapi.yml
- type: Documentation
url: https://docs.investbamboo.com/
- aid: bamboo:bamboo-featured-themes-api
name: Bamboo Invest Featured Themes API
description: Stocks are grouped into various categories which help users explore and filter stocks based on common themes,
sectors, or other criteria. The endpoints in this section allow you to retrieve a list of categories that group different
stocks together and also view details about these categories.
humanURL: https://docs.investbamboo.com/
baseURL: https://api.investbamboo.com
tags:
- Featured Themes
properties:
- type: OpenAPI
url: openapi/bamboo-featured-themes-api-openapi.yml
- type: Documentation
url: https://docs.investbamboo.com/
- aid: bamboo:bamboo-financial-documents-api
name: Bamboo Invest Financial Documents API
description: "Access various financial documents required for user account management, tax reporting, and regulatory compliance\
\ through secure document retrieval endpoints.\n\n##### Document Types and Generation\nThe system generates three primary\
\ document categories to meet regulatory requirements and provide users with comprehensive account records.\n\n**Trade\
\ Confirmations:**\n- **Generation:** Generated for users who have engaged in stock trades at the end of each trading\
\ day\n- **Content:** Trade details, execution prices, fees, settlement dates \n- **Purpose:** Legal confirmation of executed\
\ trades\n\n**Account Statements:** \n- **Generation:** Generated at the end of each month\n- **Content:** Portfolio holdings,\
\ cash balances, transaction history \n- **Purpose:** Comprehensive account activity summary\n\n**Tax Documents:** \n\
- **Generation:** Generated once, at the end of each year\n- **Content:** Realized gains/losses, dividend income, tax\
\ obligations \n- **Purpose:** Support user tax filing requirements"
humanURL: https://docs.investbamboo.com/
baseURL: https://api.investbamboo.com
tags:
- Financial Documents
properties:
- type: OpenAPI
url: openapi/bamboo-financial-documents-api-openapi.yml
- type: Documentation
url: https://docs.investbamboo.com/
- aid: bamboo:bamboo-https-api
name: 'Bamboo Invest Https: API'
description: 'The Https: API from Bamboo Invest — 1 operation(s) for https:.'
humanURL: https://docs.investbamboo.com/
baseURL: https://api.investbamboo.com
tags:
- 'Https:'
properties:
- type: OpenAPI
url: openapi/bamboo-https-api-openapi.yml
- type: Documentation
url: https://docs.investbamboo.com/
- aid: bamboo:bamboo-lsx-api
name: Bamboo Invest Lsx API
description: The Lsx API from Bamboo Invest — 1 operation(s) for lsx.
humanURL: https://docs.investbamboo.com/
baseURL: https://api.investbamboo.com
tags:
- Lsx
properties:
- type: OpenAPI
url: openapi/bamboo-lsx-api-openapi.yml
- type: Documentation
url: https://docs.investbamboo.com/
- aid: bamboo:bamboo-market-activity-api
name: Bamboo Invest Market Activity API
description: "The market activity section provides you with endpoints that return the opening and closing times for markets\
\ we support, allowing you to check when market is open/closed. \n\nThis endpoint supports **US Stock extended trading\
\ hours**, allowing users to place trades during pre-market and post-market sessions in addition to regular market hours.\n\
\n**Response Fields**\n\n`market_session` - Indicates which market session is currently open:\n - `pre_market` - Pre-market\
\ session (4:00 AM to 9:30 AM ET)\n - `core_market` - Regular market hours (9:30 AM - 4:00 PM ET)\n - `post_market`\
\ - Post-market session (4:00 PM to 8:00 PM ET)\n\nEach field returns a boolean value (true if that session is currently\
\ open, false otherwise).\n\n`open_date` - Provides Unix timestamps for when each market session opens on the current\
\ trading day.\n\n`market_session_timestamp` - Provides Unix timestamps indicating when each market session opens for\
\ the current day."
humanURL: https://docs.investbamboo.com/
baseURL: https://api.investbamboo.com
tags:
- Market Activity
properties:
- type: OpenAPI
url: openapi/bamboo-market-activity-api-openapi.yml
- type: Documentation
url: https://docs.investbamboo.com/
- aid: bamboo:bamboo-ng-deposits-api
name: Bamboo Invest NG Deposits API
description: The NG Deposits API from Bamboo Invest — 2 operation(s) for ng deposits.
humanURL: https://docs.investbamboo.com/
baseURL: https://api.investbamboo.com
tags:
- NG Deposits
properties:
- type: OpenAPI
url: openapi/bamboo-ng-deposits-api-openapi.yml
- type: Documentation
url: https://docs.investbamboo.com/
- aid: bamboo:bamboo-ng-securities-api
name: Bamboo Invest NG Securities API
description: The section provides us endpoints that allows a client to fetch all the information pertaining to the NG stocks
available on Bamboo.
humanURL: https://docs.investbamboo.com/
baseURL: https://api.investbamboo.com
tags:
- NG Securities
properties:
- type: OpenAPI
url: openapi/bamboo-ng-securities-api-openapi.yml
- type: Documentation
url: https://docs.investbamboo.com/
- aid: bamboo:bamboo-ng-stock-portfolio-api
name: Bamboo Invest NG Stock Portfolio API
description: This section provides all the information a tenant needs to know about a user's investment portfolio values
and general user performance.
humanURL: https://docs.investbamboo.com/
baseURL: https://api.investbamboo.com
tags:
- NG Stock Portfolio
properties:
- type: OpenAPI
url: openapi/bamboo-ng-stock-portfolio-api-openapi.yml
- type: Documentation
url: https://docs.investbamboo.com/
- aid: bamboo:bamboo-ng-stock-trading-api
name: Bamboo Invest NG Stock Trading API
description: The stock trading section details all the endpoints needed to calculate and make trade orders for all NG stock
available on Bamboo. Please note that trade charges are applicable and should be agreed upon with the business team.
During system setup, the agreed charges would be applied by the integration team.
humanURL: https://docs.investbamboo.com/
baseURL: https://api.investbamboo.com
tags:
- NG Stock Trading
properties:
- type: OpenAPI
url: openapi/bamboo-ng-stock-trading-api-openapi.yml
- type: Documentation
url: https://docs.investbamboo.com/
- aid: bamboo:bamboo-ng-withdrawals-api
name: Bamboo Invest NG Withdrawals API
description: The NG Withdrawals API from Bamboo Invest — 2 operation(s) for ng withdrawals.
humanURL: https://docs.investbamboo.com/
baseURL: https://api.investbamboo.com
tags:
- NG Withdrawals
properties:
- type: OpenAPI
url: openapi/bamboo-ng-withdrawals-api-openapi.yml
- type: Documentation
url: https://docs.investbamboo.com/
- aid: bamboo:bamboo-one-step-registration-api
name: Bamboo Invest One Step Registration API
description: The One Step Registration API from Bamboo Invest — 1 operation(s) for one step registration.
humanURL: https://docs.investbamboo.com/
baseURL: https://api.investbamboo.com
tags:
- One Step Registration
properties:
- type: OpenAPI
url: openapi/bamboo-one-step-registration-api-openapi.yml
- type: Documentation
url: https://docs.investbamboo.com/
- aid: bamboo:bamboo-portfolio-reporting-api
name: Bamboo Invest Portfolio Reporting API
description: 'The user''s portfolio provides comprehensive views of investment performance, cash positions, and account
status. Understanding the different cash types and portfolio calculations is essential for presenting accurate information
to users.
##### Key Portfolio Terms
#### Cash Categories:
- **cash:** Total cash in the user’s brokerage account available for investment (buying power). All funds from deposits,
stock sales, and cancelled or rejected trades are credited here.
- **unsettled_cash:** Funds from stock sale are accounted for here, pending when they settle into withdrawal_cash
- **withdrawal_cash:** Settled cash available for withdrawal from a user brokerage account. (Funds settle here after successful
stock sale)
- **actual_value:** Total portfolio value—sum of US stock holdings, unsettled cash, and cash balance
#### Performance Metrics:
- **value:** Current total portfolio value
- **value_change:** Dollar change from previous close
- **value_percent_change:** Percentage change from previous close
- **total_return:** Lifetime gains/losses across all investments
- **total_invested:** Cumulative amount invested by user'
humanURL: https://docs.investbamboo.com/
baseURL: https://api.investbamboo.com
tags:
- Portfolio Reporting
properties:
- type: OpenAPI
url: openapi/bamboo-portfolio-reporting-api-openapi.yml
- type: Documentation
url: https://docs.investbamboo.com/
- aid: bamboo:bamboo-stock-trading-api
name: Bamboo Invest Stock Trading API
description: The Stock Trading API from Bamboo Invest — 1 operation(s) for stock trading.
humanURL: https://docs.investbamboo.com/
baseURL: https://api.investbamboo.com
tags:
- Stock Trading
properties:
- type: OpenAPI
url: openapi/bamboo-stock-trading-api-openapi.yml
- type: Documentation
url: https://docs.investbamboo.com/
- aid: bamboo:bamboo-tenant-api
name: Bamboo Invest Tenant API
description: The Tenant API from Bamboo Invest — 1 operation(s) for tenant.
humanURL: https://docs.investbamboo.com/
baseURL: https://api.investbamboo.com
tags:
- Tenant
properties:
- type: OpenAPI
url: openapi/bamboo-tenant-api-openapi.yml
- type: Documentation
url: https://docs.investbamboo.com/
- aid: bamboo:bamboo-us-securities-api
name: Bamboo Invest US Securities API
description: "The section provides comprehensive information about available US stocks, including real-time pricing, company\
\ details, and market data. \n\nStock themes also help users discover investment opportunities based on trends, sectors,\
\ and investment strategies. See the [Featured Themes section](#tag/Featured-Themes) for detailed information about theme-based\
\ stock discovery and categorization."
humanURL: https://docs.investbamboo.com/
baseURL: https://api.investbamboo.com
tags:
- US Securities
properties:
- type: OpenAPI
url: openapi/bamboo-us-securities-api-openapi.yml
- type: Documentation
url: https://docs.investbamboo.com/
- aid: bamboo:bamboo-us-stock-trading-api
name: Bamboo Invest US Stock Trading API
description: "Users can buy and sell US securities, with support for multiple order types and fractional shares. Understanding\
\ order calculations, execution timing, and fees is crucial for integration.\n### Trading Fundamentals\n- **Fractional\
\ Shares:** Users can buy/sell portions of expensive stocks (e.g., 0.1 shares of a $3,000 stock), with minimum investment\
\ of $1 today. *Note* that fractional shares are supported for only MARKET orders to enable portfolio diversification\
\ for users with smaller capital.\n- **Market Hours and Execution:** Bamboo supports trading during US Stock extended\
\ hours, allowing users to place trades during pre and post market sessions alongside the regular trading hours. Orders\
\ placed outside trading hours wait for market to open and no active session on US market holidays, but users are able\
\ to still send in their trade requests.\n- **Settlement and Cash Impact:** Trades settle T+1; i.e., trade date + 1 business\
\ days. Buy orders immediately reduce buying power, sale proceeds appear as unsettled cash immediately and become withdrawable\
\ after T+1, while failed orders return funds to buying power instantly.\n\n<table>\n <thead>\n <tr>\n <th>Order\
\ Types</th>\n <th>Behaviours</th>\n <th>Use Cases</th>\n <th>Risks</th>\n <th>Duration</th>\n \
\ </tr>\n </thead>\n <tbody>\n <tr>\n <td>Market</td>\n <td>Execute immediately at current market price</td>\n\
\ <td>When speed of execution matters more than exact price</td>\n <td>Price may move between order submission\
\ and execution</td>\n <td>Immediately during market open</td>\n </tr>\n <tr>\n <td>Limit</td>\n \
\ <td>Execute only at specified price</td>\n <td>`Buy` at specific price below current market or `SELL` at a price\
\ higher than market price</td>\n <td>May never execute if price doesn't reach limit</td>\n <td>Good Till Canceled\
\ (GTC) or specific expiration date (default OF 90 days)</td>\n </tr>\n <tr>\n <td>Stop</td>\n <td>Execute\
\ when stock reaches trigger price</td>\n <td>`Buy` at specific price above current market or `SELL` at a price lower\
\ than market price</td>\n <td>May never execute if price doesn't reach the set price</td>\n <td>Good Till Canceled\
\ (GTC) or specific expiration date (default OF 90 days)</td>\n </tr>\n </tbody>\n</table>\n\n**NB:** Trading fees\
\ apply to all order types, are deducted from the user’s cash balance (upfront for buy orders, from proceeds for sell\
\ orders), and vary based on partnership agreements; use the <a href=\"#tag/US-Stock-Trading/operation/Web.Api.OrderController.calculate_market_order\"\
> calculate order endpoint </a> to determine exact fees before <a href=\"#tag/US-Stock-Trading/operation/Web.Api.OrderController.place_market_order\"\
> order placement</a>."
humanURL: https://docs.investbamboo.com/
baseURL: https://api.investbamboo.com
tags:
- US Stock Trading
properties:
- type: OpenAPI
url: openapi/bamboo-us-stock-trading-api-openapi.yml
- type: Documentation
url: https://docs.investbamboo.com/
- aid: bamboo:bamboo-withdrawals-api
name: Bamboo Invest Withdrawals API
description: 'Withdrawals allow users to extract funds from their brokerage accounts after successful trades. Understanding
the settlement timeline is essential.
#### Settlement Timeline
- Stock sale proceeds settle at T+1 business day.
- `unsettled_cash` indicates funds that are pending settlement.
- Once settled, funds move to `withdrawal_cash` and become available for withdrawal.
Remember that cash represents total funds in the user''s brokerage account from all sources—deposits, stock sales, cancelled
and rejected trades. All cash components (`cash`, `unsettled_cash`, `withdrawal_cash`) are available under the <a href="#tag/Portfolio-Reporting/operation/Web.Api.PortfolioController.portfolio">Portfolio
endpoint</a>.'
humanURL: https://docs.investbamboo.com/
baseURL: https://api.investbamboo.com
tags:
- Withdrawals
properties:
- type: OpenAPI
url: openapi/bamboo-withdrawals-api-openapi.yml
- type: Documentation
url: https://docs.investbamboo.com/
common:
- type: AgenticAccess
url: agentic-access/bamboo-agentic-access.yml
- type: DomainSecurity
url: security/bamboo-domain-security.yml
- type: Website
url: https://investbamboo.com/
- type: Documentation
url: https://docs.investbamboo.com/
- type: GitHubOrg
url: https://github.com/investbamboo
- type: LinkedIn
url: https://ng.linkedin.com/company/investbamboo
- type: Blog
url: https://learn.investbamboo.com/
- type: Pricing
url: https://faq.investbamboo.com/en/collections/1988034-fees
- type: StatusPage
url: https://status.investbamboo.com/
- type: X
url: https://twitter.com/investbamboo
- type: Plans
url: plans/bamboo-plans-pricing.yml
- type: RateLimits
url: rate-limits/bamboo-rate-limits.yml
- type: FinOps
url: finops/bamboo-finops.yml
maintainers:
- FN: Kin Lane
email: kin@apievangelist.com
Kin Score
How this is scored →