Embed Python Library

The Embed Python library provides an easy access to the Embed Investment API by Cowrywise. Embed is an investment-as-a-service API that allows you to integrate investment features in your products and offer financial services to your customers at scale. With Embed, developers can create investment accounts for their customers and expose them to a wide variety of investment products!

Documentation

See the Embed API docs.

Installation

Install the package directly via git

pip install git+https://github.com/cowrywise/embedpy.git

You could also install the library via pypi using the pip package manager.

$ pip install -U embedpy

Requirements

• Python3+

Usage

To get started, sign up for your developer credentials on the Embed Dashboard. Once you have signed up, you can retrieve your client_id and client_secret keys from the developer dashboard. Set your credentials in the environment variables before creating an instance of the Embed Client.

Initialization

from embed.client import Client

# Initialize with environment variables (CLIENT_ID, CLIENT_SECRET)
client = Client()

# Or initialize with explicit credentials
client = Client(
    client_id='your_client_id',
    client_secret='your_client_secret',
    base_url="https://sandbox.cowrywise.com"  # Optional
)

Example: Creating an Account and Investment

# 1. Create a user account
account = client.account.create_account(
    first_name="John",
    last_name="Doe",
    email="john.doe@example.com",
    terms_of_use_accepted=True
)
account_id = account['data']['account_id']

# 2. List available assets
assets = client.asset.list_assets(asset_type="tbills")

# 3. Create an investment
investment = client.investment.create_investment(
    account_id=account_id,
    asset_code="AST-TBILL-0001",
    amount=10000.0
)

Embed API REST Methods

Check the API reference document for all resources and their respective endpoints.

Contributions

We welcome contributions from everyone. Before submitting a pull request, kindly ensure:

• Necessary tests for the code changes requested are added
• Code is formatted according to PEP8
• There is clear commit messages